AudioDeviceManager

Pakiet	flash.media
Klasa	public final class AudioDeviceManager
Dziedziczenie	AudioDeviceManager EventDispatcher Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 27, AIR 28 - (Desktop)

Klasa AudioDeviceManager umożliwia pobranie informacji o systemowych urządzeniach audio oraz wybranie urządzenia do odtwarzania dźwięku. Użytkownik może zmienić urządzenie wyjściowe audio w interfejsie ustawień wtyczki Flash Player oraz przy użyciu interfejsu API AudioDeviceManager. Obie metody są zsynchronizowane z ustawieniami wyjścia audio. Interfejs API AudioDeviceManager został udostępniony we wtyczce Flash Player 27. Teraz jest dostępny w środowisku AIR na komputery (od wersji AIR 28).

Wybór urządzenia audio w jednej aplikacji AIR nie wpływa na odtwarzanie dźwięku w innych aplikacjach AIR ani wystąpieniach wtyczki Flash Player.

Ograniczenie prywatności

Na interfejs API AudioDeviceManager jest nałożone ograniczenie operacji wywołanych przez użytkownika (UIA, User Invoked Action) — można go wywołać tylko pod warunkiem interakcji z użytkownikiem. Jeśli ten interfejs API nie zostanie wywołany w wyniku interakcji z użytkownikiem, wtyczka Flash Player wygeneruje błąd czasu wykonywania IllegalOperationError z kodem błędu 2176. W przypadku aplikacji AIR test UIA jest stosowany podczas wczytywania zewnętrznego pliku SWF/HTML dostępnego w sieci. Jeśli wczytywany zewnętrzny plik SWF/HTML spróbuje zmienić wyjściowe urządzenie audio bez operacji wywołanej przez użytkownika, środowisko wykonawcze AIR wygeneruje błąd IllegalOperationError z kodem 2176.

Dostęp do wystąpienia klasy AudioDeviceManager

Wystąpienie klasy AudioDeviceManager jest to pojedynczy obiekt synchronizowany z ustawieniami wyjścia audio wtyczki Flash Player. Aby uzyskać odniesienie do tego obiektu, klient powinien użyć zmiennej AudioDeviceManager.audioDeviceManager.

Sprawdzanie urządzeń audio dostępnych obecnie w systemie

Zmienna AudioDeviceManager.deviceNames pozwala pobrać wszystkie dostępne wyjściowe urządzenia audio dostępne w systemie.

Pobieranie wybranego obecnie urządzenia audio

Zmienna AudioDeviceManager.selectedDeviceIndex pozwala sprawdzić indeks używanego obecnie wyjściowego urządzenia audio. Ten indeks umożliwia sprawdzenie nazwy urządzenia na liście zwracanej przez zmienną AudioDeviceManager.deviceNames.

Wybór wyjściowego urządzenia audio

Ustawienie innej wartości AudioDeviceManager.selectedDeviceIndex pozwala zmienić wybrane obecnie urządzenie do odtwarzania dźwięku.

Monitorowanie zmian wyjściowego urządzenia audio

Wyjściowe urządzenie audio może ulec zmianie, kiedy użytkownik wybierze inne urządzenie w interfejsie ustawień wtyczki Flash Player, zawartość ustawi zmienną AudioDeviceManager.selectedDeviceIndex lub nastąpi dodanie/usunięcie urządzenia audio w systemie. Aplikacja kliencka może zarejestrować detektor zdarzenia AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE, aby otrzymać powiadomienie o zmianie wyjściowego urządzenia audio. Właściwość reason (przyczyna) obiektu tego zdarzenia wskazuje, w jaki sposób nastąpiło wywołanie zmiany. Właściwość reason (przyczyna) ma dwie możliwe wartości: AudioOutputChangeReason.USER_SELECTION wskazuje, że użytkownik wybrał inne wyjściowe urządzenie audio w interfejsie ustawień wtyczki Flash lub zawartość ustawiła zmienną AudioDeviceManager.selectedDeviceIndex. AudioOutputChangeReason.DEVICE_CHANGE wskazuje, że dodano lub usunięto wyjściowe urządzenie audio w systemie.

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		audioDeviceManager : AudioDeviceManager [statyczny] [tylko do odczytu] Pojedyncze wystąpienie obiektu AudioDeviceManager.	AudioDeviceManager
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		deviceNames : Array [tylko do odczytu] Tablica ciągów zawierająca nazwy wszystkich dostępnych urządzeń wyjściowych audio.	AudioDeviceManager
		isSupported : Boolean [statyczny] [tylko do odczytu] Czy obiekt AudioDeviceManager jest włączony.	AudioDeviceManager
		selectedDeviceIndex : int Indeks wybranego obecnie wyjściowego urządzenia audio zgodnie z tablicą zwracaną przez zmienną AudioDeviceManager.deviceNames.	AudioDeviceManager

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	EventDispatcher
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
audioOutputChange	To zdarzenie jest wyzwalane przy zmianie wyjściowego urządzenia audio z jednego z następujących powodów: 1) Wybór użytkownika — użytkownik wybrał opcję w interfejsie ustawień wtyczki Flash Player lub zawartość ustawiła zmienną AudioDeviceManager.selectedDeviceIndex. 2) Zmiana urządzenia — w systemie dodano lub usunięto urządzenie audio.	AudioDeviceManager
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher

Szczegół właściwości

właściwość

audioDeviceManager:AudioDeviceManager [tylko do odczytu]

Pojedyncze wystąpienie obiektu AudioDeviceManager.

Implementacja
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

właściwość

deviceNames:Array [tylko do odczytu]

Tablica ciągów zawierająca nazwy wszystkich dostępnych urządzeń wyjściowych audio. Ta tablica zawiera indeks (od zera) wszystkich wyjściowych urządzeń audio oraz liczbę tych urządzeń w systemie (właściwość AudioDeviceManager.deviceNames.length). Więcej informacji można znaleźć w opisie klasy Array. Lista urządzeń jest taka sama jak w ustawieniach wyjścia audio.

Uwaga dotycząca przeglądarki Chrome: W celu wyliczenia wyjściowych urządzeń audio przeglądarka Chrome wymaga, aby użytkownik przyznał dostęp do mikrofonu. Dzieje się tak, ponieważ wejścia i wyjścia audio dotyczy w niej to samo uprawnienie. Użytkownik widzi tylko ostrzeżenie dotyczące wejścia audio.

Implementacja
public function get deviceNames():Array

isSupported

właściwość

isSupported:Boolean [tylko do odczytu]

Czy obiekt AudioDeviceManager jest włączony.

Implementacja
public static function get isSupported():Boolean

selectedDeviceIndex

właściwość

selectedDeviceIndex:int

Indeks wybranego obecnie wyjściowego urządzenia audio zgodnie z tablicą zwracaną przez zmienną AudioDeviceManager.deviceNames. Ten indeks jest zsynchronizowany z ustawieniami wyjścia audio.

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

Szczegół zdarzenia

audioOutputChange

Zdarzenie

Typ obiektu zdarzenia: flash.events.AudioOutputChangeEvent
właściwość AudioOutputChangeEvent.type = flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 27, AIR 28 - (Desktop)

To zdarzenie jest wyzwalane przy zmianie wyjściowego urządzenia audio z jednego z następujących powodów: 1) Wybór użytkownika — użytkownik wybrał opcję w interfejsie ustawień wtyczki Flash Player lub zawartość ustawiła zmienną AudioDeviceManager.selectedDeviceIndex. 2) Zmiana urządzenia — w systemie dodano lub usunięto urządzenie audio.

Aby dowiedzieć się, co spowodowało zmianę, należy sprawdzić właściwość reason (przyczyna) tego zdarzenia. Możliwe przyczyny:AudioOutputChangeReason.USER_SELECTION (wybó użytkownika) AudioOutputChangeReason.DEVICE_CHANGE (zmiana urządzenia).

Definiuje wartość właściwości type (typ) obiektu zdarzenia AudioOutputchangeEvent.

Informacje prawne | Zasady prywatności online

AudioDeviceManager - AS3

Klasy x