Saltar al contenido

Primeros pasos

GitHub

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

Ventana de terminal
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego usa el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-audio-session` plugin in my project.

Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:

Ventana de terminal
npm install @capgo/capacitor-audio-session
npx cap sync
import { AudioSession } from '@capgo/capacitor-audio-session';
import { AudioSession } from '@capgo/capacitor-audio-session';
await AudioSession.overrideOutput('speaker');
  • foco de iOS: routing APIs target iOS audio session behavior.
  • Restaurar: llama a overrideOutput('default') después de que terminen las llamadas.
  • Orden: configúralo antes de iniciar Twilio o los plugins de medios.

Obtiene las rutas de salida de audio activas actuales.

En web y plataformas no iOS, esto resuelve a un array vacío.

import { AudioSession } from '@capgo/capacitor-audio-session';
const result = await AudioSession.currentOutputs();
console.log(result);

Sobrescribe la ruta de salida de audio actual.

Usa speaker para forzar la reproducción por el altavoz integrado, o default para restaurar la ruta seleccionada por el sistema.

import { AudioSession } from '@capgo/capacitor-audio-session';
const result = await AudioSession.overrideOutput('default');
console.log(result);

Rutas de salida de audio disponibles en iOS.

export enum AudioSessionPorts {
AIR_PLAY = 'airplay',
BLUETOOTH_LE = 'bluetooth-le',
BLUETOOTH_HFP = 'bluetooth-hfp',
BLUETOOTH_A2DP = 'bluetooth-a2dp',
BUILT_IN_SPEAKER = 'builtin-speaker',
BUILT_IN_RECEIVER = 'builtin-receiver',
HDMI = 'hdmi',
HEADPHONES = 'headphones',
LINE_OUT = 'line-out',
}

Tipo de override de salida. - default: Usa la ruta seleccionada por el sistema. - speaker: Fuerza la reproducción a través del altavoz integrado.

export type OutputOverrideType = 'default' | 'speaker';

Resultado de una solicitud de override de salida.

export type OverrideResult = {
success: boolean;
message: string;
};

Listener que se ejecuta cuando cambia la ruta de audio.

export type RouteChangeListener = (reason: RouteChangeReasons) => void;

Listener que se ejecuta cuando la sesión de audio se interrumpe o termina.

export type InterruptionListener = (type: InterruptionTypes) => void;
export enum RouteChangeReasons {
NEW_DEVICE_AVAILABLE = 'new-device-available',
OLD_DEVICE_UNAVAILABLE = 'old-device-unavailable',
CATEGORY_CHANGE = 'category-change',
OVERRIDE = 'override',
WAKE_FROM_SLEEP = 'wake-from-sleep',
NO_SUITABLE_ROUTE_FOR_CATEGORY = 'no-suitable-route-for-category',
ROUTE_CONFIGURATION_CHANGE = 'route-config-change',
UNKNOWN = 'unknown',
}
export enum InterruptionTypes {
BEGAN = 'began',
ENDED = 'ended',
}

Esta página se genera a partir del plugin src/definitions.ts. Vuelve a ejecutar el sync cuando el API público cambie en upstream.

Si estás usando Primeros pasos para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con Uso de @capgo/capacitor-audio-session para la capacidad nativa en Uso de @capgo/capacitor-audio-session, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para los detalles de implementación en @capgo/capacitor-live-activities, Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player, y @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player.