| Paket | flash.media |
| Klasse | public final class AudioDeviceManager |
| Vererbung | AudioDeviceManager  EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 27, AIR 28 - (Desktop) |
Das in einer AIR-Anwendung ausgewählte Audiogerät wirkt sich nicht auf die Audiodaten aus anderen AIR-Anwendungen oder Flash Player-Instanzen aus.
Datenschutzbeschränkung
Die AudioDeviceManager-API fällt unter die UIA-Beschränkung. Das heißt, sie kann nur über eine Benutzerinteraktion aufgerufen werden. Wenn diese API nicht durch eine Benutzeraktion aufgerufen wird, gibt Flash Player den Laufzeitfehler „IllegalOperationError“ mit dem Fehlercode 2176 aus. Im Falle von AIR-Anwendungen wird beim Laden von externen SWF/HTML-Dateien, die über ein Netzwerk gehostet werden, die UIA-Kontrolle angewendet. Wenn die extern geladene SWF-/HTML-Datei versucht, das Audioausgabegerät ohne eine vom Benutzer aufgerufene Aktion zu ändern, wird bei der AIR-Laufzeit der Fehler „IllegalOperationError“ mit dem Fehlercode 2176 ausgegeben.
Zugriff auf die AudioDeviceManager-Instanz
Bei der AudioDeviceManager-Instanz handelt es sich um ein Singleton-Objekt, das mit den Audioausgangseinstellungen von Flash Player synchron ist. Der Kunde sollte AudioDeviceManager.audioDeviceManager verwenden, um einen Verweis auf dieses Singleton-Objekt zu erhalten.
Aktuell im System verfügbare Audiogeräte abrufen
Verwenden Sie AudioDeviceManager.deviceNames, um alle verfügbaren Audioausgabegeräte im System abzurufen.
Aktuell ausgewähltes Audiogerät abrufen
Verwenden Sie AudioDeviceManager.selectedDeviceIndex, um den Index des aktuell verwendeten Audioausgabegeräts zu finden. Verwenden Sie diesen Index, um den Gerätenamen in der von AudioDeviceManager.deviceNames zurückgegebenen Geräteliste zu ermitteln.
Wählen Sie ein Audio-Ausgabegerät aus.
Wenn Sie AudioDeviceManager.selectedDeviceIndex auf einen anderen Wert festlegen, kann dieses Gerät zum aktuell ausgewählten Audiowiedergabegerät werden.
Änderung des Audioausgabegeräts überwachen
Das Audioausgabegerät ändert sich möglicherweise, weil der Benutzer auf der Benutzeroberfläche mit den Flash Player-Einstellungen ein anderes Gerät oder unter AudioDeviceManager.deviceNames eine andere Inhaltseinstellung auswählt oder weil dem System ein Audiogerät hinzugefügt bzw. daraus entfernt wird. Die Clientanwendung kann Listener des Ereignisses registrieren: AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE, um Benachrichtigungen zu erhalten, wenn sich das Audioausgangsgerät ändert. Die Eigenschaft reason des Ereignisobjekts gibt an, wie diese Änderung ausgelöst wird. Es gibt zwei mögliche Werte für die Eigenschaft reason: AudioOutputChangeReason.USER_SELECTION gibt an, dass der Benutzer über die Benutzeroberfläche der Flash Player-Einstellungen ein anderes Audioausgabegerät oder unter AudioDeviceManager.selectedDeviceIndex andere Inhaltssätze ausgewählt hat. AudioOutputChangeReason.DEVICE_CHANGE gibt an, dass ein Audioausgabegerät dem System hinzugefügt bzw. daraus entfernt wurde.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| audioDeviceManager : AudioDeviceManager [statisch] [schreibgeschützt]
Die Singleton-Instanz des AudioDeviceManager-Objekts. | AudioDeviceManager | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| deviceNames : Array [schreibgeschützt]
Ein Zeichenfolgen-Array mit den Namen aller verfügbaren Audioausgabegeräte. | AudioDeviceManager | ||
| isSupported : Boolean [statisch] [schreibgeschützt]
Ob AudioDeviceManager aktiviert ist. | AudioDeviceManager | ||
| selectedDeviceIndex : int
Der Index des aktuell ausgewählten Audioausgabegeräts, der in dem durch AudioDeviceManager.deviceNames zurückgegebenen Array angegeben wird. | AudioDeviceManager | ||
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn das Audioausgabegerät aus folgenden Gründen geändert wird: (1) Benutzerauswahl – Benutzer wählt auf der Benutzeroberfläche der Flash Player-Einstellungen die Inhaltseinstellung AudioDeviceManager.selectedDeviceIndex aus (2) Änderung des Geräts – Dem System wird ein Audiogerät hinzugefügt bzw. ein Gerät wird daraus entfernt. | AudioDeviceManager | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
audioDeviceManager | Eigenschaft |
audioDeviceManager:AudioDeviceManager [schreibgeschützt] Die Singleton-Instanz des AudioDeviceManager-Objekts.
Implementierung
public static function get audioDeviceManager():AudioDeviceManagerdeviceNames | Eigenschaft |
deviceNames:Array [schreibgeschützt]
Ein Zeichenfolgen-Array mit den Namen aller verfügbaren Audioausgabegeräte. Dieses Array stellt über die folgende Eigenschaft den auf null basierenden Index aller Audioausgabegeräte und die Anzahl der Audioausgabegeräte im System bereit: AudioDeviceManager.deviceNames.length. Weitere Informationen hierzu finden Sie im Array-Klasseneintrag. Diese Liste der Gerätenamen ist dieselbe wie die in den Audioausgabeeinstellungen.
Hinweis für Chrome-Browser: Chrome fordert zum Aufzählen der Audioausgabegeräte vom Benutzer die Erteilung von Zugriffsberechtigungen auf das Mikrofon, weil Audioeingang und Audioausgang dieselbe Berechtigung verwenden und dem Benutzer nur eine Warnung für die Audioeingangsberechtigung angezeigt wird.
Implementierung
public function get deviceNames():ArrayisSupported | Eigenschaft |
selectedDeviceIndex | Eigenschaft |
selectedDeviceIndex:int
Der Index des aktuell ausgewählten Audioausgabegeräts, der in dem durch AudioDeviceManager.deviceNames zurückgegebenen Array angegeben wird. Dieser Index ist mit den Audioausgangseinstellungen synchron.
Implementierung
public function get selectedDeviceIndex():int public function set selectedDeviceIndex(value:int):voidaudioOutputChange | Ereignis |
flash.events.AudioOutputChangeEventEigenschaft AudioOutputChangeEvent.type =
flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 27, AIR 28 - (Desktop) |
Wird ausgelöst, wenn das Audioausgabegerät aus folgenden Gründen geändert wird: (1) Benutzerauswahl – Benutzer wählt auf der Benutzeroberfläche der Flash Player-Einstellungen die Inhaltseinstellung AudioDeviceManager.selectedDeviceIndex aus (2) Änderung des Geräts – Dem System wird ein Audiogerät hinzugefügt bzw. ein Gerät wird daraus entfernt.
Überprüfen Sie die Eigenschaft reason dieses Ereignisses, um die Ursache der Änderung zu bestimmen. Mögliche Ursachen sind: AudioOutputChangeReason.USER_SELECTION AudioOutputChangeReason.DEVICE_CHANGE.
type eines AudioOutputchangeEvent-Ereignisobjekts.
Tue Jun 12 2018, 10:04 AM Z