AudioDeviceManager

Pacchetto	flash.media
Classe	public final class AudioDeviceManager
Ereditarietà	AudioDeviceManager EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 27, AIR 28 - (Desktop)

Utilizzate la classe AudioDeviceManager per ottenere informazioni sul dispositivo audio del sistema e selezionate un dispositivo per la riproduzione audio. L’utente può cambiare il dispositivo di output audio tramite le impostazioni dell’interfaccia utente di Flash Player o tramite l’API AudioDeviceManager. Entrambe sono sincronizzate con le impostazioni di output audio. L’API AudioDeviceManager era abilitata per Flash Player 27. Ora è abilitata per AIR Desktop a partire da AIR 28.

Il dispositivo audio selezionato da un’applicazione AIR non influisce sull’audio di altre applicazioni AIR o istanze di Flash Player.

Limitazione per privacy

L’API AudioDeviceManager è sotto la restrizione di un’azione chiamata dall’utente (UIA), ovvero può essere richiamata solo tramite un’interazione dell’utente. Se l’API non viene chiamata da un’interazione dell’utente, Flash Player genera un errore di runtime IllegalOperationError con codice di errore 2176. Per le applicazioni AIR, il controllo UAI viene applicato quando si carica un file SWF/HTML esterno ospitato su una rete. Se il file SWF/HTML caricato dall’esterno tenta di cambiare il dispositivo di output audio senza alcuna azione invocata dall’utente, il runtime AIR genera un errore IllegalOperationError con codice di errore 2176.

Accedere all’istanza AudioDeviceManager

L’istanza AudioDeviceManager è un oggetto singleton sincronizzato con le impostazioni di output audio di Flash Player. Il client deve utilizzare AudioDeviceManager.audioDeviceManager per ottenere un riferimento a tale oggetto singleton.

Ottenere i dispositivi audio correnti disponibili nel sistema

Utilizzate AudioDeviceManager.deviceNames per ottenere tutti i dispositivi di output audio disponibili nel sistema.

Ottenere il dispositivo audio attualmente selezionato

Utilizzate AudioDeviceManager.selectedDeviceIndex per ottenere l’indice del dispositivo di output audio attualmente utilizzato. Con questo indice potete trovare il nome del dispositivo nell’elenco dei dispositivi restituito da AudioDeviceManager.deviceNames

Selezionare un dispositivo di output audio

Impostate AudioDeviceManager.selectedDeviceIndex su un altro valore affinché tale dispositivo diventi il dispositivo di riproduzione audio attualmente selezionato.

Monitorare la modifica del dispositivo di output audio

Il dispositivo di output audio può cambiare per diversi motivi: se l’utente seleziona un altro dispositivo dall’interfaccia delle impostazioni di Flash Player; a causa dell’impostazione AudioDeviceManager.selectedDeviceIndex nel contenuto; oppure se un dispositivo audio viene aggiunto o rimosso dal sistema. L’applicazione client può registrare il listener per l’evento AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE in modo da ricevere una notifica quando si verifica un cambiamento nel dispositivo di output audio. La proprietà reason dell’oggetto evento indica in che modo è stata attivata tale modifica. Sono disponibili 2 possibili valori per la proprietà reason: AudioOutputChangeReason.USER_SELECTION indica che l’utente seleziona un altro dispositivo di output audio mediante l’interfaccia delle impostazioni di Flash Player, oppure il contenuto imposta AudioDeviceManager.selectedDeviceIndex. AudioOutputChangeReason.DEVICE_CHANGE indica che un dispositivo di output audio è stato aggiunto o rimosso dal sistema.

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		audioDeviceManager : AudioDeviceManager [statico] [sola lettura] L’istanza Singleton dell’oggetto AudioDeviceManager.	AudioDeviceManager
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		deviceNames : Array [sola lettura] Serie di stringhe contenente i nomi di tutti i dispositivi di output audio disponibili.	AudioDeviceManager
		isSupported : Boolean [statico] [sola lettura] Se AudioDeviceManager è attivato.	AudioDeviceManager
		selectedDeviceIndex : int L’indice del dispositivo di output audio attualmente selezionato, rispecchiato nell’array restituito da AudioDeviceManager.deviceNames.	AudioDeviceManager

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
audioOutputChange	Inviato quando il dispositivo di output audio viene cambiato per i seguenti motivi: (1) selezione da parte dell’utente - l’utente ha selezionato il dispositivo tramite l’interfaccia delle impostazioni di Flash Player oppure è stata usata l’impostazione di contenuto AudioDeviceManager.selectedDeviceIndex (2) modifica a livello di dispositivo - un dispositivo audio è stato aggiunto o rimosso dal sistema.	AudioDeviceManager
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher

Descrizione delle proprietà

proprietà

audioDeviceManager:AudioDeviceManager [sola lettura]

L’istanza Singleton dell’oggetto AudioDeviceManager.

Implementazione
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

proprietà

deviceNames:Array [sola lettura]

Serie di stringhe contenente i nomi di tutti i dispositivi di output audio disponibili. Questo array fornisce l’indice a base zero di ogni dispositivo di output audio e il numero dei dispositivi di questo tipo presenti nel sistema tramite la proprietà AudioDeviceManager.deviceNames.length. Per ulteriori informazioni, consultate la voce della classe Array. Questo elenco di nomi di dispositivi è lo stesso di quello disponibile nelle impostazioni di output audio.

Nota per browser Chrome: per consentire l’enumerazione dei dispositivi di output audio, Chrome richiede all’utente di fornire autorizzazioni di accesso per il microfono, perché l’output e l’input audio condividono la stessa autorizzazione e verrà visualizzato solo il messaggio di avvertenza relativo all’input audio.

Implementazione
public function get deviceNames():Array

isSupported

proprietà

isSupported:Boolean [sola lettura]

Se AudioDeviceManager è attivato.

Implementazione
public static function get isSupported():Boolean

selectedDeviceIndex

proprietà

selectedDeviceIndex:int

L’indice del dispositivo di output audio attualmente selezionato, rispecchiato nell’array restituito da AudioDeviceManager.deviceNames. Questo indice è sincronizzato con le impostazioni di output audio.

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

Descrizione degli eventi

audioOutputChange

Evento

Tipo di oggetto evento: flash.events.AudioOutputChangeEvent
proprietà AudioOutputChangeEvent.type = flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 27, AIR 28 - (Desktop)

Inviato quando il dispositivo di output audio viene cambiato per i seguenti motivi: (1) selezione da parte dell’utente - l’utente ha selezionato il dispositivo tramite l’interfaccia delle impostazioni di Flash Player oppure è stata usata l’impostazione di contenuto AudioDeviceManager.selectedDeviceIndex (2) modifica a livello di dispositivo - un dispositivo audio è stato aggiunto o rimosso dal sistema.

Per conoscere la causa, controllate la proprietà reason di questo evento. I motivi possibili sono: AudioOutputChangeReason.USER_SELECTION AudioOutputChangeReason.DEVICE_CHANGE.

Definisce il valore della proprietà type di un oggetto evento AudioOutputchangeEvent.

Note legali | Informativa sulla privacy online

AudioDeviceManager - AS3

Classi x