AudioDeviceManager

Paket	flash.media
Klass	public final class AudioDeviceManager
Arv	AudioDeviceManager EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 27, AIR 28 - (Desktop)

Använd klassen AudioDeviceManager för att hämta information om systemets ljudenheter och för att välja en enhet för uppspelning. Användaren kan ändra ljudutgångsenhet antingen via inställningsgränssnittet för Flash Player eller via AudioDeviceManager-API:t. Båda är synkroniserade med ljudutgångsinställningarna. AudioDeviceManager-API:t aktiverades för Flash Player 27. Det är nu aktiverat för AIR Desktop från AIR 28.

Den ljudenhet som väljs i ett AIR-program påverkar inte ljudet från andra AIR-program eller Flash Player-instanser.

Sekretessbegränsningar

AudioDeviceManager-API:t är begränsat till användaranropade åtgärder (UIA), vilket betyder att det bara kan anropas via någon typ av användarinteraktion. Om det här API:t inte anropas via en användaråtgärd genereras körningsfelet IllegalOperationError med felkoden 2176 i Flash Player. För AIR-program används UIA-kontrollen när en extern SWF-/HTML-fil läses in över nätverket. Om den externt inlästa SWF-/HTML-filen försöker ändra ljudutgångsenhet utan någon användaranropad åtgärd genereras felet IllegalOperationError med felkoden 2176 i AIR-miljön.

Komma åt AudioDeviceManager-instansen

AudioDeviceManager-instansen är ett singleton-objekt och är synkroniserat med Flash Players inställningar för ljudutgång. Klienten bör använda AudioDeviceManager.audioDeviceManager för att hämta en referens till det här singleton-objektet.

Hämta de aktuella ljudenheterna för systemet

Använd AudioDeviceManager.deviceNames för att hämta alla tillgängliga ljudutgångsenheter i systemet.

Hämta den valda ljudenheten

Använd AudioDeviceManager.selectedDeviceIndex för att hitta indexvärdet för den aktuella ljudutgångsenheten. Använd detta indexvärde för att hitta enhetsnamnet i den enhetslista som returneras av AudioDeviceManager.deviceNames.

Välja en ljudutgångsenhet

Ställ in AudioDeviceManager.selectedDeviceIndex på ett annat värde om du vill att den enheten ska användas som aktuell enhet för ljuduppspelning.

Övervaka ändringar av ljudutgångsenhet

Ljudutgångsenheten kan ändras för att användaren väljer en annan enhet i inställningsgränssnittet för Flash Player eller i innehållsinställningen AudioDeviceManager.selectedDeviceIndex eller för att en ljudenhet läggs till i eller tas bort från systemet. Klientprogrammet kan registrera en avlyssnare för händelsen AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE för att få aviseringar när ljudutgångsenheten ändras. Egenskapen reason i händelseobjektet anger hur den här ändringen utlöses. Det finns två möjliga värden för egenskapen reason: AudioOutputChangeReason.USER_SELECTION anger att användaren väljer en annan ljudutgångsenhet i inställningsgränssnittet för Flash Player eller i innehållsinställningen AudioDeviceManager.selectedDeviceIndex. AudioOutputChangeReason.DEVICE_CHANGE anger att en ljudutgångsenhet har lagts till i eller tagits bort från systemet.

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		audioDeviceManager : AudioDeviceManager [statisk] [skrivskyddad] Singleton-instansen av AudioDeviceManager-objektet.	AudioDeviceManager
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		deviceNames : Array [skrivskyddad] En array med strängar som innehåller namnen på alla tillgängliga ljudutgångsenheter.	AudioDeviceManager
		isSupported : Boolean [statisk] [skrivskyddad] Om AudioDeviceManager är aktiverat eller inte.	AudioDeviceManager
		selectedDeviceIndex : int Indexvärdet för den aktuella ljudutgångsenheten, enligt den array som returneras av AudioDeviceManager.deviceNames.	AudioDeviceManager

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.	EventDispatcher

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
audioOutputChange	Skickas när ljudutgångsenheten ändras av följande orsaker: (1) Användarval – Användaren väljer i inställningsgränssnittet för Flash Player eller i innehållsinställningen AudioDeviceManager.selectedDeviceIndex (2) Enhetsändring – Ljudenheten läggs till i eller tas bort från systemet.	AudioDeviceManager
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher

Egenskapsdetaljer

egenskap

audioDeviceManager:AudioDeviceManager [skrivskyddad]

Singleton-instansen av AudioDeviceManager-objektet.

Implementering
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

egenskap

deviceNames:Array [skrivskyddad]

En array med strängar som innehåller namnen på alla tillgängliga ljudutgångsenheter. Den här arrayen innehåller det nollbaserade indexvärdet för varje ljudutgångsenhet och antalet ljudutgångsenheter i systemet i följande egenskap: AudioDeviceManager.deviceNames.length Du hittar mer information i avsnittet om klassen Array. Den här listan med enhetsnamn är densamma som listan i inställningarna för ljudutgång.

Kommentar för webbläsaren Chrome: Chrome kräver att användaren beviljar mikrofonen åtkomstbehörighet för uppräkning av ljudutgångsenheter, eftersom ljudutgången och ljudingången använder samma behörighet och det bara är behörighetsvarningen för ljudingången som visas för användaren.

Implementering
public function get deviceNames():Array

isSupported

egenskap

isSupported:Boolean [skrivskyddad]

Om AudioDeviceManager är aktiverat eller inte.

Implementering
public static function get isSupported():Boolean

selectedDeviceIndex

egenskap

selectedDeviceIndex:int

Indexvärdet för den aktuella ljudutgångsenheten, enligt den array som returneras av AudioDeviceManager.deviceNames. Det här indexvärdet är synkroniserat med inställningarna för ljudutgång.

Implementering
public function get selectedDeviceIndex():int
public function set selectedDeviceIndex(value:int):void

Händelsedetaljer

audioOutputChange

Händelse

Typ av händelseobjekt: flash.events.AudioOutputChangeEvent
egenskap AudioOutputChangeEvent.type = flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 27, AIR 28 - (Desktop)

Skickas när ljudutgångsenheten ändras av följande orsaker: (1) Användarval – Användaren väljer i inställningsgränssnittet för Flash Player eller i innehållsinställningen AudioDeviceManager.selectedDeviceIndex (2) Enhetsändring – Ljudenheten läggs till i eller tas bort från systemet.

Kontrollera egenskapen reason för den här händelsen för att ta reda på vad som orsakat ändringen. Möjliga orsaker är: AudioOutputChangeReason.USER_SELECTION AudioOutputChangeReason.DEVICE_CHANGE.

Definierar värdet på type-egenskapen i ett AudioOutputchangeEvent-händelseobjekt.

Juridiska meddelanden | Onlinesekretesspolicy

AudioDeviceManager - AS3

Klasser x