| Cumple con | NSObject |
| Declarado en | OTAudioKit.h |
Visión general
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 proporciona una implementación funcional.
Para más información, consulte esta documentación.
– enableCallingServicesMode método obligatorio
Habilita la activación manual de AVAudioSession.
- (void)enableCallingServicesMode
Debate
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.
Declarado en
OTAudioKit.h
– preconfigureAudioSessionForCallWithMode: método obligatorio
Configura la sesión de audio con los ajustes adecuados para una llamada basada en CallKit.
- (void)preconfigureAudioSessionForCallWithMode:(AVAudioSessionMode _Nullable)mode
Parámetros
mode |
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. |
Debate
Este método configura el AVAudioSession con ajustes optimizados para el modo especificado,
incluida 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
CallKit’s 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.
Declarado en
OTAudioKit.h
– audioSessionDidActivate: método obligatorio
Notifica al SDK que se ha activado la sesión de audio.
- (void)audioSessionDidActivate:(AVAudioSession *_Nonnull)session
Parámetros
session |
El activo AVAudioSession instancia que fue activada por el sistema. |
Debate
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.
Declarado en
OTAudioKit.h
– audioSessionDidDeactivate: método obligatorio
Notifica al SDK que la sesión de audio se ha desactivado.
- (void)audioSessionDidDeactivate:(AVAudioSession *_Nonnull)session
Parámetros
session |
El AVAudioSession instancia que se ha desactivado. |
Debate
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.
Declarado en
OTAudioKit.h