AudioDeviceManager

Package	flash.media
Classe	public final class AudioDeviceManager
Héritage	AudioDeviceManager EventDispatcher Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 27, AIR 28 - (Desktop)

Utilisez la classe AudioDeviceManager pour obtenir des informations sur le périphérique audio du système, puis sélectionnez un périphérique pour la lecture audio. L’utilisateur peut changer de périphérique de sortie audio au moyen de l’interface des paramètres de Flash Player ou de l’API AudioDeviceManager. Toutes deux sont synchronisées avec les paramètres de sortie audio. L’API AudioDeviceManager a été activée pour Flash Player 27. Elle l’est désormais pour AIR (bureau) depuis la version AIR 28.

Le périphérique audio sélectionné dans une application AIR n’affecte pas le contenu d’autres applications AIR ou instances de Flash Player.

Restriction en matière de confidentialité

Une restriction UIA (User Invoked Action) est appliquée à l’API AudioDeviceManager. Cela signifie que l’API ne peut être invoquée que par une action de l’utilisateur. Si elle n’est pas invoquée par une action de l’utilisateur, Flash Player génère une erreur d’exécution IllegalOperationError avec le code 2176. Dans le cas des applications AIR, la vérification UIA est appliquée lors du chargement d’un fichier SWF/HTML externe hébergé sur un réseau. Si le fichier SWF/HTML chargé en externe tente de modifier le périphérique de sortie audio sans la moindre action invoquée par l’utilisateur, le moteur d’exécution AIR génère une erreur IllegalOperationError avec le code 2176.

Accéder à l’instance AudioDeviceManager

Une instance AudioDeviceManager est un objet singleton ; elle est synchronisée avec les paramètres de sortie audio de Flash Player. Le client doit utiliser AudioDeviceManager.audioDeviceManager pour obtenir une référence à cet objet singleton.

Obtenir la liste des périphériques audio actuellement disponibles sur le système

Utilisez AudioDeviceManager.deviceNames pour obtenir la liste de tous les périphériques de sortie audio disponibles sur le système.

Obtenir le périphérique audio actuellement sélectionné

Utilisez AudioDeviceManager.selectedDeviceIndex pour connaître l’index du périphérique de sortie audio actuellement utilisé. Utilisez cet index pour connaître le nom du périphérique renvoyé par la liste de périphériques à partir de AudioDeviceManager.deviceNames.

Sélectionner un périphérique de sortie audio

Définir AudioDeviceManager.selectedDeviceIndex sur une autre valeur peut faire en sorte que ce périphérique soit le périphérique de lecture audio actuellement sélectionné.

Surveiller le changement du périphérique sortie audio

Le périphérique de sortie audio peut changer lorsque l’utilisateur en sélectionne un autre dans l’interface des paramètres de Flash Player du paramètre de contenu AudioDeviceManager.selectedDeviceIndex, ou en cas d’ajout ou de retrait d’un périphérique audio du système. L’application cliente peut enregistrer l’écouteur d’un événement AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE de manière à recevoir une notification en cas de changement du périphérique de sortie audio. La propriété reason de l’objet d’événement indique le motif de déclenchement de cette modification. Deux valeurs sont possibles pour la propriété reason : AudioOutputChangeReason.USER_SELECTION, qui indique que l’utilisateur sélectionne un autre périphérique de sortie audio via l’interface des paramètres de Flash Player, et Contenu, qui définit AudioDeviceManager.selectedDeviceIndex. AudioOutputChangeReason.DEVICE_CHANGE indique que le périphérique de sortie audio a été ajouté au système ou en a été retiré.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		audioDeviceManager : AudioDeviceManager [statique] [lecture seule] Instance singleton de l’objet AudioDeviceManager.	AudioDeviceManager
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		deviceNames : Array [lecture seule] Tableau de chaînes contenant les noms de tous les périphériques de sortie audio disponibles.	AudioDeviceManager
		isSupported : Boolean [statique] [lecture seule] Indique si AudioDeviceManager est activé.	AudioDeviceManager
		selectedDeviceIndex : int Index du périphérique de sortie audio actuellement sélectionné, tel qu’indiqué dans le tableau renvoyé par AudioDeviceManager.deviceNames.	AudioDeviceManager

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
audioOutputChange	Distribué en cas de changement du périphérique de sortie audio pour l’une des raisons suivantes : (1) Sélection par l’utilisateur – L’utilisateur effectue une sélection au moyen du paramètre Contenu AudioDeviceManager.selectedDeviceIndex de l’interface des paramètres de Flash Player (2) Changement de périphérique – Un périphérique audio est ajouté au système ou en est retiré.	AudioDeviceManager
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher

Détails de la propriété

propriété

audioDeviceManager:AudioDeviceManager [lecture seule]

Instance singleton de l’objet AudioDeviceManager.

Implémentation
public static function get audioDeviceManager():AudioDeviceManager

deviceNames

propriété

deviceNames:Array [lecture seule]

Tableau de chaînes contenant les noms de tous les périphériques de sortie audio disponibles. Ce tableau indique l’index (commençant à zéro) de chaque périphérique de sortie audio, ainsi que le nombre de ces périphériques présents dans le système, par le biais de la propriété suivante : AudioDeviceManager.deviceNames.length. Pour plus d’informations, voir l’entrée de la classe Array. Cette liste des noms de périphérique est identique à celle qui est disponible dans les paramètres de sortie audio.

Remarque concernant le navigateur Chrome : Chrome exige que l’utilisateur accorde l’autorisation d’accès au microphone pour énumérer les périphériques de sortie audio, car Sortie audio et Entrée audio partagent la même autorisation, et seul l’avertissement d’autorisation Entrée audio est présenté à l’utilisateur.

Implémentation
public function get deviceNames():Array

isSupported

propriété

isSupported:Boolean [lecture seule]

Indique si AudioDeviceManager est activé.

Implémentation
public static function get isSupported():Boolean

selectedDeviceIndex

propriété

selectedDeviceIndex:int

Index du périphérique de sortie audio actuellement sélectionné, tel qu’indiqué dans le tableau renvoyé par AudioDeviceManager.deviceNames. Cet index est synchronisé avec les paramètres de sortie audio.

Implémentation
public function get selectedDeviceIndex():int
public function set selectedDeviceIndex(value:int):void

Détails de l’événement

audioOutputChange

Evénement

Type d’objet d’événement: flash.events.AudioOutputChangeEvent
propriété AudioOutputChangeEvent.type = flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 27, AIR 28 - (Desktop)

Distribué en cas de changement du périphérique de sortie audio pour l’une des raisons suivantes : (1) Sélection par l’utilisateur – L’utilisateur effectue une sélection au moyen du paramètre Contenu AudioDeviceManager.selectedDeviceIndex de l’interface des paramètres de Flash Player (2) Changement de périphérique – Un périphérique audio est ajouté au système ou en est retiré.

Vérifiez la propriété reason de cet événement pour déterminer la cause du changement. Les motifs possibles sont les suivants : AudioOutputChangeReason.USER_SELECTION AudioOutputChangeReason.DEVICE_CHANGE.

Définit la valeur de la propriété type d’un objet d’événement AudioOutputchangeEvent.

Informations juridiques | Politique de confidentialité en ligne

AudioDeviceManager - AS3

Classes x