AudioDeviceManager

Пакет	flash.media
Класс	public final class AudioDeviceManager
Наследование	AudioDeviceManager EventDispatcher Object

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 27, AIR 28 - (Desktop)

Используйте класс AudioDeviceManager, чтобы получить из системы данные об аудиоустройстве, и выберите устройство для воспроизведения звука. Пользователь может изменить устройство аудиовывода через интерфейс настроек Flash Player или с помощью API-интерфейса AudioDeviceManager. И тот и другой синхронизируется с настройками аудиовывода. API-интерфейс AudioDeviceManager включен для Flash Player 27. Сейчас он включен для AIR Desktop начиная с AIR 28.

Аудиоустройство, выбранное в одном приложении AIR, не влияет на звук других приложений AIR или экземпляров Flash Player.

Ограничение для обеспечения конфиденциальности

API-интерфейс AudioDeviceManager имеет ограничения UIA (действие вызывается пользователем), то есть он может быть вызван только в рамках взаимодействия с пользователем. Если этот API-интерфейс не вызван в результате взаимодействия с пользователем, Flash Player выдает ошибку среды выполнения IllegalOperationError с кодом ошибки 2176. В случае приложений AIR будет применяться проверка UIA при загрузке внешнего кода SWF/HTML, размещенного в сети. Если загружаемый извне код SWF/HTML пытается изменить устройство аудиовывода без взаимодействия с пользователем, то среда выполнения AIR выдает ошибку IllegalOperationError с кодом 2176.

Доступ к экземпляру AudioDeviceManager

Экземпляр AudioDeviceManager является единичным объектом и синхронизируется с настройками аудиовывода в Flash Player. Клиент должен использовать AudioDeviceManager.audioDeviceManager для получения ссылки на этот единичный объект.

Получение текущих аудиоустройств, доступных в системе

Используйте AudioDeviceManager.deviceNames для получения всех доступных устройств аудиовывода в системе.

Получение текущего выбранного аудиоустройства

Используйте AudioDeviceManager.selectedDeviceIndex для поиска индекса текущего используемого устройства аудиовывода. Используйте этот индекс для поиска имени устройства в списке, возвращенном из AudioDeviceManager.deviceNames

Выбор устройства вывода звука

Установка для AudioDeviceManager.selectedDeviceIndex другого значения может сделать это устройство текущим выбранным устройством для воспроизведения звука.

Отслеживание изменений устройств вывода звука

Устройство аудиовывода может измениться, так как пользователь выбрал другое устройство в интерфейсе настроек Flash Player, в настройках «Содержимое» задается AudioDeviceManager.selectedDeviceIndex или происходит добавление или удаление аудиоустройства из системы. Клиентское приложение может зарегистрировать прослушиватель события: AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE, чтобы получать уведомления об изменении устройства аудиовывода. Свойство reason объекта события указывает на причину этого изменения. Свойство reason может иметь одно из двух значений: AudioOutputChangeReason.USER_SELECTION указывает, что пользователь выбирает другое устройство аудиовывода в интерфейсе настроек Flash Player или в настройках «Содержимое» задается AudioDeviceManager.selectedDeviceIndex; AudioOutputChangeReason.DEVICE_CHANGE указывает, что устройство аудиовывода добавлено или удалено из системы.

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		audioDeviceManager : AudioDeviceManager [статические] [только для чтения] Единичный экземпляр объекта AudioDeviceManager.	AudioDeviceManager
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		deviceNames : Array [только для чтения] Массив строк, содержащих имена всех доступных устройств аудиовывода.	AudioDeviceManager
		isSupported : Boolean [статические] [только для чтения] Включен ли AudioDeviceManager.	AudioDeviceManager
		selectedDeviceIndex : int Индекс текущего выбранного устройства аудиовывода в соответствии с содержимым массива, возвращенного AudioDeviceManager.deviceNames.	AudioDeviceManager

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
audioOutputChange	Отправляется, когда устройство аудиовывода изменяется по следующим причинам: (1) Выбор пользователя — пользователь выбирает устройство в интерфейсе настроек Flash Player с помощью настройки «Содержимое» AudioDeviceManager.selectedDeviceIndex (2) Изменение устройства — аудиоустройство добавляется или удаляется из системы.	AudioDeviceManager
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher

Сведения о свойстве

свойство

audioDeviceManager:AudioDeviceManager [только для чтения]

Единичный экземпляр объекта AudioDeviceManager.

Реализация
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

свойство

deviceNames:Array [только для чтения]

Массив строк, содержащих имена всех доступных устройств аудиовывода. Этот массив передает индекс от нуля для каждого устройства аудиовывода и количество устройств аудиовывода в системе с помощью свойства AudioDeviceManager.deviceNames.length. Дополнительные сведения см. в разделе в описании класса Array. Этот список имен устройств совпадает со списком в настройках аудиовывода.

Примечание для браузера Chrome: Chrome требует, чтобы пользователь дал разрешение на доступ к микрофону, чтобы получить список устройств аудиовывода аудио, поскольку для вывода и ввода аудио используется одно и то же разрешение, и пользователю отображается только предупреждение о разрешении на аудиоввод.

Реализация
public function get deviceNames():Array

isSupported

свойство

isSupported:Boolean [только для чтения]

Включен ли AudioDeviceManager.

Реализация
public static function get isSupported():Boolean

selectedDeviceIndex

свойство

selectedDeviceIndex:int

Индекс текущего выбранного устройства аудиовывода в соответствии с содержимым массива, возвращенного AudioDeviceManager.deviceNames. Этот индекс синхронизируется с настройками аудиовывода.

Реализация
public function get selectedDeviceIndex():int
public function set selectedDeviceIndex(value:int):void

Сведения о событии

audioOutputChange

Событие

Тип объекта события: flash.events.AudioOutputChangeEvent
свойство AudioOutputChangeEvent.type = flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 27, AIR 28 - (Desktop)

Отправляется, когда устройство аудиовывода изменяется по следующим причинам: (1) Выбор пользователя — пользователь выбирает устройство в интерфейсе настроек Flash Player с помощью настройки «Содержимое» AudioDeviceManager.selectedDeviceIndex (2) Изменение устройства — аудиоустройство добавляется или удаляется из системы.

Проверьте свойство reason этого события, чтобы выяснить причину изменения. Возможные причины: AudioOutputChangeReason.USER_SELECTION AudioOutputChangeReason.DEVICE_CHANGE.

Определяет значение свойства type объекта события AudioOutputchangeEvent.

Юридическая информация | Политика конфиденциальности онлайн

AudioDeviceManager - AS3

Классы x