AudioSession: state-Eigenschaft
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die state-Eigenschaft der AudioSession-Schnittstelle gibt den aktuellen Zustand der Audiositzung zurück.
Wert
Ein String, dessen Wert einer der folgenden ist:
"active"-
Die Audiositzung spielt derzeit Ton ab, nimmt Audio auf oder beides.
"interrupted"-
Die Audiositzung war aktiv, wurde jedoch vorübergehend vom System unterbrochen, beispielsweise wegen eines eingehenden Anrufs oder weil eine andere Anwendung die exklusive Kontrolle über das Audio übernommen hat. Die Sitzung kann nach Ende der Unterbrechung wieder in den Zustand
"active"zurückkehren. "inactive"-
Die Audiositzung spielt oder nimmt derzeit kein Audio auf und ist nicht unterbrochen. Dies ist der Standardzustand.
Beschreibung
Das System aktualisiert den state-Zustand als Reaktion auf die eigene Audioaktivität der Seite (Start oder Stopp der Wiedergabe oder Aufnahme) und auf Systemereignisse wie eine andere Anwendung, die die exklusive Kontrolle über das Audio übernimmt, oder einen eingehenden Anruf.
Das statechange-Ereignis kann überwacht werden, um Benachrichtigungen zu erhalten, wenn sich der Wert ändert.
Die Eigenschaft spiegelt den Zustand jeder Audiowequelle und jedes -sinks wider, die oder das die Seite erstellt hat, einschließlich <audio>- und <video>-Elementen, AudioContext-Instanzen und Mikrofon-MediaStreamTracks, die mit MediaDevices.getUserMedia() abgerufen wurden.
Die Sitzung wird "active", wenn eines dieser Elemente hörbaren Ton produziert oder aufnimmt, und kehrt zu "inactive" zurück, wenn alle gestoppt sind.
Das Starten oder Stoppen einer einzelnen Quelle ändert ansonsten nicht den gemeldeten Zustand.
Wenn der Zustand "interrupted" wird, weil etwas anderes die exklusive Kontrolle über das Audio übernommen hat, pausiert der Browser automatisch die Medienwiedergabe, setzt AudioContexts aus und stummt Mikrofonspuren, die zur Sitzung gehören.
Diese werden dann automatisch fortgesetzt, wenn der Zustand wieder zu "active" zurückkehrt.
Beachten Sie, dass dies nur für Elemente gilt, die hörbare Ausgaben produzieren, wenn der Zustand unterbrochen wird; ein stummgeschaltetes oder stilles Element wird niemals betroffen und muss bei Bedarf explizit pausiert oder fortgesetzt werden.
Siehe die statechange-Ereignisseite für ein Beispiel.
Der Wert von state hindert Sie nicht daran, HTMLMediaElement.play() oder andere Mechanismen zu verwenden, um Audio zu starten, aber ein solcher Aufruf wird wahrscheinlich fehlschlagen, wenn eine andere App noch die exklusive Kontrolle über das Audio hat.
In diesem Fall bleibt der state-Zustand "inactive" oder "interrupted", die Methode kehrt ohne Fehler zurück, aber es wird möglicherweise kein Ton produziert.
Sie sollten stattdessen auf das statechange-Ereignis warten, das meldet, dass state von selbst zu "active" zurückgekehrt ist.
Beispiele
Grundlegende Verwendung
navigator.audioSession.addEventListener("statechange", () => {
statusElement.textContent = `Audio session: ${navigator.audioSession.state}`;
});