AudioDeviceManager

Paquete	flash.media
Clase	public final class AudioDeviceManager
Herencia	AudioDeviceManager EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 27, AIR 28 - (Desktop)

Utilice la clase AudioDeviceManager para obtener del sistema información sobre los dispositivos de audio y seleccione un dispositivo para la reproducción de audio. El usuario puede cambiar el dispositivo de salida de audio mediante la interfaz de configuración de Flash Player o la API AudioDeviceManager. Ambos métodos están sincronizados con la configuración de salida de audio. La API AudioDeviceManager se habilitó en Flash Player 27. Está habilitada para AIR Desktop desde AIR 28.

El dispositivo de audio seleccionado en una aplicación AIR no afecta al audio de otras aplicaciones AIR o instancias de Flash Player.

Restricción de privacidad

La API AudioDeviceManager está sometida a la restricción User Invoked Action (UIA), es decir, solo puede invocarse mediante alguna interacción del usuario. Si esta API no se invoca por interacción del usuario, Flash Player devuelve el error de tiempo de ejecución IllegalOperationError, con el código de error 2176. En el caso de aplicaciones AIR, la comprobación UIA se realiza al cargar un SWF/HTML externo alojado en una red. Si el SWF/HTML cargado externamente intenta cambiar el dispositivo de salida de audio sin mediar acción del usuario, el tiempo de ejecución de AIR devuelve el error IllegalOperationError, con el código de error 2176.

Acceso a la instancia AudioDeviceManager

La instancia AudioDeviceManager es un objeto simple que está sincronizado con la configuración de salida de audio de Flash Player. El cliente debe utilizar AudioDeviceManager.audioDeviceManager para obtener una referencia a este objeto simple.

Obtención de los dispositivos de audio disponibles en el sistema

Utilice AudioDeviceManager.deviceNames para obtener todos los dispositivos de salida de audio disponibles en el sistema.

Obtención del dispositivo de audio seleccionado

Utilice AudioDeviceManager.selectedDeviceIndex para determinar el índice del dispositivo de salida de audio actual. Con este índice puede encontrar el nombre del dispositivo en la lista devuelta por AudioDeviceManager.deviceNames.

Selección de un dispositivo de salida de audio

Establecer AudioDeviceManager.selectedDeviceIndex en un valor distinto puede convertir el dispositivo introducido en el dispositivo de reproducción de audio seleccionado.

Supervisión de cambios en el dispositivo de salida de audio

El dispositivo de salida de audio puede cambiar debido a que el usuario seleccione un dispositivo diferente en la interfaz de configuración de Flash Player, a la configuración de contenido AudioDeviceManager.selectedDeviceIndex o a que se haya añadido o eliminado un dispositivo de audio del sistema. La aplicación cliente puede registrar un detector del evento AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE para recibir una notificación cuando se produzca un cambio en el dispositivo de salida de audio. La propiedad reason del objeto del evento indica qué provocó dicho cambio. Hay 2 posibles valores para la propiedadreason: AudioOutputChangeReason.USER_SELECTION indica que el usuario selecciona un dispositivo de salida de audio distinto en la interfaz de configuración de Flash Player, o mediante la configuración de contenido AudioDeviceManager.selectedDeviceIndex. AudioOutputChangeReason.DEVICE_CHANGE indica que se añadió o eliminó un dispositivo de audio del sistema.

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		audioDeviceManager : AudioDeviceManager [estática] [solo lectura] Instancia simple del objeto AudioDeviceManager.	AudioDeviceManager
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		deviceNames : Array [solo lectura] Matriz de cadenas que incluye los nombres de todos los dispositivos de salida de audio disponibles.	AudioDeviceManager
		isSupported : Boolean [estática] [solo lectura] Si AudioDeviceManager está activado.	AudioDeviceManager
		selectedDeviceIndex : int El índice del dispositivo de salida de audio seleccionado, tal y como se refleja en la matriz que devuelve AudioDeviceManager.deviceNames.	AudioDeviceManager

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
audioOutputChange	Se distribuye cuando el dispositivo de salida de audio cambia por los motivos que se indican a continuación. (1) Selección del usuario: el usuario elige un dispositivo mediante la interfaz de configuración de Flash Player o la configuración de contenido AudioDeviceManager.selectedDeviceIndex; (2) Cambio de dispositivo: se añade o elimina un dispositivo de audio del sistema.	AudioDeviceManager
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher

Información sobre propiedades

propiedad

audioDeviceManager:AudioDeviceManager [solo lectura]

Instancia simple del objeto AudioDeviceManager.

Implementación
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

propiedad

deviceNames:Array [solo lectura]

Matriz de cadenas que incluye los nombres de todos los dispositivos de salida de audio disponibles. Esta matriz proporciona mediante la propiedad AudioDeviceManager.deviceNames.length el índice basado en cero de cada dispositivo de salida de audio y el número de dispositivos de salida de audio en el sistema. Para obtener más información, consulte la entrada de la clase Array. Esta lista de nombres de dispositivo es idéntica a la de Configuración de salida de audio.

Nota para el navegador Chrome: Chrome requiere que el usuario otorgue permiso de acceso al micrófono para poder enumerar los dispositivos de salida de audio, ya que Salida de audio y Entrada de audio comparten el mismo permiso; solo se mostrará al usuario el aviso de permiso de Entrada de audio.

Implementación
public function get deviceNames():Array

isSupported

propiedad

isSupported:Boolean [solo lectura]

Si AudioDeviceManager está activado.

Implementación
public static function get isSupported():Boolean

selectedDeviceIndex

propiedad

selectedDeviceIndex:int

El índice del dispositivo de salida de audio seleccionado, tal y como se refleja en la matriz que devuelve AudioDeviceManager.deviceNames. Este índice está sincronizado con la configuración de salida de audio.

Implementación
public function get selectedDeviceIndex():int
public function set selectedDeviceIndex(value:int):void

Información sobre eventos

audioOutputChange

Evento

Tipo de objeto de evento: flash.events.AudioOutputChangeEvent
propiedad AudioOutputChangeEvent.type = flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 27, AIR 28 - (Desktop)

Se distribuye cuando el dispositivo de salida de audio cambia por los motivos que se indican a continuación. (1) Selección del usuario: el usuario elige un dispositivo mediante la interfaz de configuración de Flash Player o la configuración de contenido AudioDeviceManager.selectedDeviceIndex; (2) Cambio de dispositivo: se añade o elimina un dispositivo de audio del sistema.

Compruebe la propiedad reason de este evento para averiguar las causas del cambio. Los posibles motivos son: AudioOutputChangeReason.USER_SELECTION AudioOutputChangeReason.DEVICE_CHANGE.

Define el valor de la propiedad type para un objeto de evento AudioOutputchangeEvent.

Avisos legales | Política de privacidad en línea

AudioDeviceManager - AS3

Clases x