AudioDeviceManager

Pakket	flash.media
Klasse	public final class AudioDeviceManager
Overerving	AudioDeviceManager EventDispatcher Object

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 27, AIR 28 - (Desktop)

Met de AudioDeviceManager-klasse kunt u audioapparaatgegevens ophalen van het systeem en een apparaat selecteren waarop u audio wilt afspelen. De gebruiker kan het audio-uitvoerapparaat wijzigen via de Flash Player-UI voor instellingen, of met behulp van de AudioDeviceManager-API. Beide opties lopen synchroon met de audio-uitvoerinstellingen. De AudioDeviceManager-API werd ingeschakeld voor Flash Player 27. En is nu ook ingeschakeld voor AIR voor het bureaublad vanaf AIR-versie 28.

Als u een audioapparaat selecteert in een AIR-toepassing, is dat niet van invloed op de audio van andere AIR-toepassingen of Flash Player-instanties.

Privacybeperking

Voor de AudioDeviceManager-API geldt een UIA-beperking (User Invoked Action, oftewel door gebruiker geactiveerde handeling). Dit houdt in dat de API alleen kan worden aangeroepen via een gebruikersinteractie. Als de API niet door een gebruikersinteractie wordt aangeroepen, genereert Flash Player een IllegalOperationError-runtimefout met foutcode 2176. Bij AIR-toepassingen wordt de UIA-controle uitgevoerd wanneer er een extern SWF/HTML-bestand wordt geladen dat via een netwerk wordt gehost. Als het extern geladen SWF/HTML-bestand probeert om een audio-uitvoerapparaat te wijzigen zonder dat de gebruiker een handeling daartoe uitvoert, dan genereert de AIR-runtime een IllegalOperationError-runtimefout met foutcode 2176.

Toegang tot de AudioDeviceManager-instantie

De AudioDeviceManager-instantie is een singleton-object dat is gesynchroniseerd met de audio-uitvoerinstellingen van Flash Player. De client moet AudioDeviceManager.audioDeviceManager gebruiken om een verwijzingen naar dit singleton-object op te halen.

Hiermee worden alle audioapparaten opgehaald die momenteel beschikbaar zijn op het systeem

Met AudioDeviceManager.deviceNames kunt u alle beschikbare audio-uitvoerapparaten in het systeem ophalen.

Hiermee wordt het momenteel geselecteerde audioapparaat opgehaald

Gebruik AudioDeviceManager.selectedDeviceIndex om de index van het huidige gebruikte audio-uitvoerapparaat te zoeken. Gebruik deze index om naar de apparaatnaam te zoeken in de lijst met apparaten die is geretourneerd met AudioDeviceManager.deviceNames

Een audio-uitvoerapparaat selecteren

Door AudioDeviceManager.selectedDeviceIndex op een andere waarde in te stellen kunt u aangeven op welk apparaat de audio moet worden afgespeeld.

Wijziging van het audio-uitvoerapparaat bewaken

Het audio-uitvoerapparaat kan worden gewijzigd doordat de gebruiker een ander apparaat kiest in de Flash Player-UI voor instellingen (AudioDeviceManager.selectedDeviceIndex-instelling voor inhoud), of doordat een audioapparaat uit het systeem wordt verwijderd of juist aan het systeem wordt toegevoegd. De clienttoepassing kan een listener registreren voor de gebeurtenis AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE om een melding te ontvangen wanneer een wijziging van het audio-uitvoerapparaat plaatsvindt. De eigenschap reason van het gebeurtenisobject geeft aan hoe deze wijziging is geactiveerd. Er zijn 2 mogelijke waarden voor de eigenschap reason: AudioOutputChangeReason.USER_SELECTION geeft aan dat de gebruiker een ander audio-uitvoerapparaat selecteert via de Flash Player-UI voor instellingen, of de inhoudswaarde van AudioDeviceManager.selectedDeviceIndex. wordt ingesteld. AudioOutputChangeReason.DEVICE_CHANGE geeft aan dat het audio-uitvoerapparaat is toegevoegd aan het systeem of juist uit het systeem verwijderd.

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		audioDeviceManager : AudioDeviceManager [statisch] [alleen-lezen] De singleton-instantie van het AudioDeviceManager-object.	AudioDeviceManager
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		deviceNames : Array [alleen-lezen] Een array van tekenreeksen die de namen van alle beschikbare audio-uitvoerapparaten bevat.	AudioDeviceManager
		isSupported : Boolean [statisch] [alleen-lezen] Geeft aan of AudioDeviceManager al dan niet is ingeschakeld.	AudioDeviceManager
		selectedDeviceIndex : int De index van het huidige geselecteerde audio-uitvoerapparaat, zoals aangegeven in de array die wordt geretourneerd door AudioDeviceManager.deviceNames.	AudioDeviceManager

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
audioOutputChange	Wordt verzonden wanneer het audio-uitvoerapparaat om de volgende redenen wordt gewijzigd: (1) Selectie door gebruiker: de gebruiker kiest een apparaat via de Flash Player-UI voor instellingen (AudioDeviceManager.selectedDeviceIndex-instelling voor inhoud) (2) Apparaat wordt gewijzigd: een audioapparaat wordt toegevoegd aan of juist verwijderd van het systeem.	AudioDeviceManager
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher

Eigenschapdetails

eigenschap

audioDeviceManager:AudioDeviceManager [alleen-lezen]

De singleton-instantie van het AudioDeviceManager-object.

Implementatie
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

eigenschap

deviceNames:Array [alleen-lezen]

Een array van tekenreeksen die de namen van alle beschikbare audio-uitvoerapparaten bevat. Deze array biedt de op nul gebaseerde index van elk audio-uitvoerapparaat alsook het aantal audio-uitvoerapparaten in het systeem. Dit gebeurt via de volgende eigenschap: AudioDeviceManager.deviceNames.length. Raadpleeg de Array-klasse voor meer informatie. Deze lijst met apparaatnamen is hetzelfde als die in de audio-uitvoerinstellingen.

Opmerking voor Chrome-browser: de gebruiker moet Chrome machtigen om toegang te krijgen tot de microfoon zodat alle audio-uitvoerapparaten in een lijst kunnen worden opgenomen. Apparaten voor audio-uitvoer en -invoer delen namelijk dezelfde machtiging en alleen de machtigingswaarschuwing voor audio-invoer wordt weergegeven aan de gebruiker.

Implementatie
public function get deviceNames():Array

isSupported

eigenschap

isSupported:Boolean [alleen-lezen]

Geeft aan of AudioDeviceManager al dan niet is ingeschakeld.

Implementatie
public static function get isSupported():Boolean

selectedDeviceIndex

eigenschap

selectedDeviceIndex:int

De index van het huidige geselecteerde audio-uitvoerapparaat, zoals aangegeven in de array die wordt geretourneerd door AudioDeviceManager.deviceNames. Deze index loopt synchroon met de audio-uitvoerinstellingen.

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

Gebeurtenisdetails

audioOutputChange

Gebeurtenis

Type gebeurtenisobject: flash.events.AudioOutputChangeEvent
eigenschap AudioOutputChangeEvent.type = flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 27, AIR 28 - (Desktop)

Wordt verzonden wanneer het audio-uitvoerapparaat om de volgende redenen wordt gewijzigd: (1) Selectie door gebruiker: de gebruiker kiest een apparaat via de Flash Player-UI voor instellingen (AudioDeviceManager.selectedDeviceIndex--instelling voor inhoud) (2) Apparaat wordt gewijzigd: een audioapparaat wordt toegevoegd aan of juist verwijderd van het systeem.

Controleer de eigenschap reason van deze gebeurtenis om de oorzaak van de wijziging te vinden. De mogelijke oorzaken zijn: AudioOutputChangeReason.USER_SELECTION AudioOutputChangeReason.DEVICE_CHANGE.

Definieert de waarde van de eigenschap type van een AudioOutputchangeEven-gebeurtenisobject.

Juridische kennisgeving | Online privacybeleid

AudioDeviceManager - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.media