Entspricht NSObject
Deklariert in OTAudioKit.h

Übersicht

Definiert einen Audio-Session-Manager zur Verwendung mit Anrufdiensten wie CallKit. Die Implementierung dieses Protokolls ist optional. Benutzerdefinierte Audiogeräte können diese Methoden implementieren, um die AVAudioSession zu verwalten. Das Standard-Audiogerät im SDK bietet eine funktionsfähige Implementierung.

Weitere Informationen finden Sie unter diese Dokumentation.

– enableCallingServicesMode erforderliche Methode

Aktiviert die manuelle Aktivierung für die AVAudioSession.

- (void)enableCallingServicesMode

Diskussion

Diese Methode bereitet das SDK für die Integration mit Anrufdiensten wie CallKit vor und ermöglicht so eine korrekte Audioweiterleitung und Sitzungsverwaltung.

Das SDK verwaltet die Konfiguration der AVAudioSession, während die Anwendung oder CallKit für die Aktivierung der Sitzung zuständig ist.

Anmerkung: Rufen Sie diese Funktion frühzeitig im Lebenszyklus der App auf, in der Regel beim Start oder bevor Anrufe getätigt werden.

Angemeldet in

OTAudioKit.h

– preconfigureAudioSessionForCallWithMode: erforderliche Methode

Konfiguriert die Audiositzung mit den entsprechenden Einstellungen für einen CallKit-basierten Anruf.

- (void)preconfigureAudioSessionForCallWithMode:(AVAudioSessionMode _Nullable)mode

Parameter
mode Der AVAudioSessionMode, der bei der Konfiguration angewendet werden soll. Im Allgemeinen gilt: AVAudioSessionModeVoiceChat sollte für VoIP-Anrufe verwendet werden, um die Audioqualität zu optimieren. Wenn für ein nicht standardmäßiges Audiogerät ein benutzerdefinierter Modus zur Verfügung steht, wird dieser Modus verwendet; andernfalls AVAudioSessionModeVoiceChat wird als Standard verwendet.

Diskussion

Diese Methode richtet die AVAudioSession mit für den angegebenen Modus optimierten Einstellungen, einschließlich Audiokategorie, Modus und Routing-Konfiguration. Allerdings wird nicht aktiviert die Sitzung. Die Sitzung wird im Voraus konfiguriert, damit sie korrekt aktiviert werden kann, wenn sie durch eine CallKit-Aktion ausgelöst wird.

Anmerkung: Diese Methode sollte vor der Aktivierung der Sitzung aufgerufen werden, in der Regel als Reaktion auf CallKits CXAnswerCallAction oder CXStartCallAction. Dadurch wird eine korrekte Konfiguration für die spätere Aktivierung durch das System sichergestellt. Siehe Apple-Entwicklerforum für weitere Einzelheiten.

Angemeldet in

OTAudioKit.h

– audioSessionDidActivate: erforderliche Methode

Teilt dem SDK mit, dass die Audiositzung aktiviert wurde.

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

Parameter
session Der aktive AVAudioSession Instanz, die vom System aktiviert wurde.

Diskussion

Diese Methode sollte aufgerufen werden, wenn das System (beispielsweise über CallKit) die Audiositzung aktiviert hat. Sie teilt dem SDK mit, dass Audio nun einsatzbereit ist und dass die Sitzung aktiv ist.

Anmerkung: Diese Methode ist nur bei Verwendung von OTAudioSessionManagerModeCallingServices. Wird die Funktion in anderen Modi aufgerufen, wie beispielsweise OTAudioSessionManagerModeVideoChat, wird dies ignoriert, da das SDK die Aktivierung der Audiositzung automatisch übernimmt.

Angemeldet in

OTAudioKit.h

– audioSessionDidDeactivate: erforderliche Methode

Teilt dem SDK mit, dass die Audiositzung deaktiviert wurde.

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

Parameter
session Die AVAudioSession Instanz, die deaktiviert wurde.

Diskussion

Diese Methode sollte aufgerufen werden, wenn das System (z. B. CallKit) die Audiositzung deaktiviert hat. Sie weist das SDK an, Audio-Ressourcen freizugeben oder seinen internen Zustand entsprechend anzupassen.

Anmerkung: Diese Methode ist nur bei Verwendung von OTAudioSessionManagerModeCallingServices. In Modi wie OTAudioSessionManagerModeVideoChat, wird dieser Aufruf ignoriert, da das SDK den Lebenszyklus der Audiositzung automatisch verwaltet.

Angemeldet in

OTAudioKit.h