Conforme à NSObject
Déclaré dans OTAudioKit.h

Vue d'ensemble

Définit un gestionnaire de session audio destiné à être utilisé avec des services d'appel tels que CallKit. L'implémentation de ce protocole est facultative. Les périphériques audio personnalisés peuvent implémenter ces méthodes pour gérer l'AVAudioSession. Le périphérique audio par défaut du SDK fournit une implémentation fonctionnelle.

Pour plus d'informations, voir cette documentation.

– enableCallingServicesMode méthode obligatoire

Permet l'activation manuelle de l'AVAudioSession.

- (void)enableCallingServicesMode

Discussion

Cette méthode prépare le SDK en vue de son intégration avec des services d'appel tels que CallKit, permettant ainsi un acheminement audio et une gestion des sessions corrects.

Le SDK gère la configuration de l'AVAudioSession, tandis que l'application ou CallKit est chargé d'activer la session.

Remarque : Appelez cette méthode dès le début du cycle de vie de l'application, généralement au démarrage ou avant de lancer tout appel.

Déclaré à

OTAudioKit.h

– preconfigureAudioSessionForCallWithMode: méthode obligatoire

Configure la session audio avec les paramètres adaptés à un appel utilisant CallKit.

- (void)preconfigureAudioSessionForCallWithMode:(AVAudioSessionMode _Nullable)mode

Paramètres

mode Le paramètre AVAudioSessionMode à appliquer lors de la configuration. En général, AVAudioSessionModeVoiceChat doit être utilisé pour les appels VoIP afin d'optimiser les performances audio. Si un mode personnalisé est prévu pour un périphérique audio autre que celui par défaut, ce mode sera utilisé ; sinon, AVAudioSessionModeVoiceChat sera utilisé par défaut.

Discussion

Cette méthode configure le AVAudioSession avec des paramètres optimisés pour le mode spécifié, notamment la catégorie audio, le mode et la configuration du routage. Cependant, il ne s'active pas la session. La session est configurée à l'avance afin de pouvoir être activée correctement lorsqu'elle est déclenchée par une action CallKit.

Remarque : Cette méthode doit être appelée avant l'activation de la session, généralement en réponse à CallKit’s CXAnswerCallAction ou CXStartCallAction. Cela garantit une configuration correcte en vue d'une activation ultérieure par le système. Voir Forum des développeurs Apple pour plus de détails.

Déclaré à

OTAudioKit.h

– audioSessionDidActivate: méthode obligatoire

Indique au SDK que la session audio a été activée.

- (void)audioSessionDidActivate:(AVAudioSession *_Nonnull)session

Paramètres

session L'actif AVAudioSession instance activée par le système.

Discussion

Cette méthode doit être appelée lorsque le système (par exemple, via CallKit) a activé la session audio. Elle indique au SDK que l'audio est désormais prêt à être utilisé et que la session est active.

Remarque : Cette méthode n'est pertinente que lorsque l'on utilise OTAudioSessionManagerModeCallingServices. Si elle est appelée dans d'autres modes, tels que OTAudioSessionManagerModeVideoChat, elle sera ignorée, car le SDK gère automatiquement l'activation de la session audio.

Déclaré à

OTAudioKit.h

– audioSessionDidDeactivate: méthode obligatoire

Indique au SDK que la session audio a été désactivée.

- (void)audioSessionDidDeactivate:(AVAudioSession *_Nonnull)session

Paramètres

session Les AVAudioSession instance qui a été désactivée.

Discussion

Cette méthode doit être appelée lorsque le système (par exemple, CallKit) a désactivé la session audio. Elle indique au SDK de libérer les ressources audio ou de mettre à jour son état interne en conséquence.

Remarque : Cette méthode n'est pertinente que lorsque l'on utilise OTAudioSessionManagerModeCallingServices. Dans des modes tels que OTAudioSessionManagerModeVideoChat, cet appel sera ignoré, car le SDK gère automatiquement le cycle de vie de la session audio.

Déclaré à

OTAudioKit.h