AudioDeviceManager

Paket	flash.media
Klasse	public final class AudioDeviceManager
Vererbung	AudioDeviceManager EventDispatcher Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 27, AIR 28 - (Desktop)

Verwenden Sie die AudioDeviceManager-Klasse, um Audiogerätinformationen des Systems abzurufen, und wählen Sie ein Gerät für die Audiowiedergabe aus. Der Benutzer kann das Audioausgabegerät entweder über die Benutzeroberfläche der Flash Player-Einstellungen oder über die AudioDeviceManager-API ändern. Beide sind mit den Audioausgangeinstellungen synchron. AudioDeviceManager-API wurde für Flash Player 27 aktiviert. Sie ist jetzt für AIR Desktop von AIR 28 aktiviert.

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.

Öffentliche Eigenschaften

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
audioOutputChange	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
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Eigenschaftendetails

Eigenschaft

audioDeviceManager:AudioDeviceManager [schreibgeschützt]

Die Singleton-Instanz des AudioDeviceManager-Objekts.

Implementierung
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

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():Array

isSupported

Eigenschaft

isSupported:Boolean [schreibgeschützt]

Ob AudioDeviceManager aktiviert ist.

Implementierung
public static function get isSupported():Boolean

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):void

Ereignisdetails

audioOutputChange

Ereignis

Ereignisobjekttyp: flash.events.AudioOutputChangeEvent
Eigenschaft 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.

Definiert den Wert der Eigenschaft type eines AudioOutputchangeEvent-Ereignisobjekts.

Rechtliche Hinweise | Onlinedatenschutzerklärung

AudioDeviceManager - AS3

Klassen x