OTAudioSessionManager

Define un gestor de sesiones de audio para su uso con servicios de llamadas como CallKit. La implementación de este protocolo es opcional. Los dispositivos de audio personalizados pueden implementar estos métodos para gestionar la AVAudioSession. El dispositivo de audio predeterminado del SDK ofrece una implementación operativa.

Para más información, consulte esta documentación.

Métodos

Nombre Descripción
enableCallingServicesMode() Habilita la activación manual de AVAudioSession.
preconfigureAudioSessionForCallWithMode:(mode) Configura la sesión de audio con los ajustes adecuados para una llamada basada en CallKit.
audioSessionDidActivate:(session) Notifica al SDK que se ha activado la sesión de audio.
audioSessionDidDeactivate:(session) Notifica al SDK que la sesión de audio se ha desactivado.

enableCallingServicesMode()

Habilita la activación manual de AVAudioSession.

Este método prepara el SDK para su integración con servicios de llamadas como CallKit, lo que permite un enrutamiento de audio y una gestión de sesiones adecuados.

El SDK gestiona la configuración de AVAudioSession, mientras que la aplicación o CallKit se encarga de activar la sesión.

Nota: Llama a esta función en una fase temprana del ciclo de vida de la aplicación, normalmente al iniciarla o antes de iniciar cualquier llamada.

preconfigureAudioSessionForCallWithMode:(modo)

Configura la sesión de audio con los ajustes adecuados para una llamada basada en CallKit.

Este método configura el AVAudioSession con ajustes optimizados para el modo especificado, incluyendo la categoría de audio, el modo y la configuración de enrutamiento. Sin embargo, esto no se activa la sesión. La sesión se configura con antelación para que pueda activarse correctamente cuando se active mediante una acción de CallKit.

Nota: Este método debe invocarse antes de activar la sesión, normalmente en respuesta a la llamada de CallKit CXAnswerCallAction o CXStartCallAction. Esto garantiza una configuración adecuada para su posterior activación por parte del sistema. Véase Foro de desarrolladores de Apple Para más información.

Parámetros:
Nombre Tipo Descripción
mode AVAudioSessionMode El AVAudioSessionMode que se debe aplicar durante la configuración. En general, AVAudioSessionModeVoiceChat debe utilizarse para las llamadas VoIP con el fin de optimizar el rendimiento del audio. Si se ofrece un modo personalizado para un dispositivo de audio que no sea el predeterminado, se utilizará dicho modo; de lo contrario, AVAudioSessionModeVoiceChat se utilizará por defecto.

audioSessionDidActivate:(session)

Notifica al SDK que se ha activado la sesión de audio.

Este método debe invocarse cuando el sistema (por ejemplo, a través de CallKit) haya activado la sesión de audio. Informa al SDK de que el audio ya está listo para su uso y de que la sesión está activa.

Nota: Este método solo es aplicable cuando se utiliza OTAudioSessionManagerModeCallingServices. Si se invoca en otros modos, como por ejemplo OTAudioSessionManagerModeVideoChat, se ignorará, ya que el SDK se encarga automáticamente de activar la sesión de audio.

Parámetros:
Nombre Tipo Descripción
session AVAudioSession * El activo AVAudioSession instancia que fue activada por el sistema.

audioSessionDidDeactivate:(session)

Notifica al SDK que la sesión de audio se ha desactivado.

Este método debe invocarse cuando el sistema (por ejemplo, CallKit) haya desactivado la sesión de audio. Indica al SDK que libere los recursos de audio o que actualice su estado interno en consecuencia.

Nota: Este método solo es aplicable cuando se utiliza OTAudioSessionManagerModeCallingServices. En modos como OTAudioSessionManagerModeVideoChat, esta llamada se ignorará, ya que el SDK gestiona automáticamente el ciclo de vida de la sesión de audio.

Parámetros:
Nombre Tipo Descripción
session AVAudioSession * El AVAudioSession instancia que se ha desactivado.