| 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