Inicio
Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-audio-session`, `@capgo/capacitor-audiosession`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/audiosession/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Instalar
Sección titulada “Instalar”Puede utilizar nuestra configuración asistida por inteligencia artificial para instalar el complemento. Agregue las Capgo habilidades a su herramienta de inteligencia artificial utilizando el siguiente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsEntonces utilice la siguiente solicitud:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-audio-session` plugin in my project.Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siguiendo las instrucciones específicas del plataforma a continuación:
bun add @capgo/capacitor-audio-sessionbunx cap syncImportar
Sección titulada “Importación”import { AudioSession } from '@capgo/capacitor-audio-session';API Resumen
Sección titulada “API Resumen”currentOutputs
Sección titulada “salidas actuales”Obtenga las rutas de salida de audio activas actuales.
En plataformas web y no-iOS, esto se resuelve en un array vacío.
import { AudioSession } from '@capgo/capacitor-audio-session';
await AudioSession.currentOutputs();overrideOutput
Sección titulada “sobreescribir salida”Sobreescriba la ruta de salida de audio actual.
Use speaker para forzar la reproducción a través del altavoz incorporado,
default to restore el recorrido seleccionado por el sistema.
import { AudioSession } from '@capgo/capacitor-audio-session';
await AudioSession.overrideOutput({} as OutputOverrideType);Referencia de tipo
Sección titulada “Referencia de tipo”AudioSessionPorts
Sección titulada “AudioSessionPorts”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',}OutputOverrideType
Sección titulada “Tipo de sobrescritura de salida”Tipo de sobrescritura de salida. - default: Utilizar el recorrido seleccionado por el sistema. - speaker: Forzar la reproducción a través del altavoz incorporado.
export type OutputOverrideType = 'default' | 'speaker';OverrideResult
Sección titulada “OverrideResult”Resultado de una solicitud de sobrescritura de salida.
export type OverrideResult = { success: boolean; message: string;};RouteChangeListener
Sección titulada “RouteChangeListener”Escuchador llamado cuando cambia la ruta de audio.
export type RouteChangeListener = (reason: RouteChangeReasons) => void;InterruptionListener
Sección titulada “InterruptionListener”Escuchador llamado cuando la sesión de audio es interrumpida o termina.
export type InterruptionListener = (type: InterruptionTypes) => void;RouteChangeReasons
Sección titulada “RouteChangeReasons”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',}InterruptionTypes
Sección titulada “InterruptionTypes”export enum InterruptionTypes { BEGAN = 'began', ENDED = 'ended',}Fuente de Verdad
Sección titulada “Fuente de Verdad”Esta página se genera a partir del plugin’s src/definitions.tsRe-ejecutar la sincronización cuando el público API cambie en la fuente.
Seguir adelante desde Getting Started
Sección titulada “Seguir adelante desde Getting Started”Si estás utilizando Getting Started para planificar el comportamiento de medios y interfaz nativa, conecta con Usando @capgo/capacitor-audio-session para la capacidad nativa en Usando @capgo/capacitor-audio-session, Usando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Usando @capgo/capacitor-actividades-en-vivo, @capgo/capacitor-actividades-en-vivo para el detalle de implementación en @capgo/capacitor-actividades-en-vivo, Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos, y @capgo/capacitor-reproductor-de-videos para el detalle de implementación en @capgo/capacitor-reproductor-de-videos.