Pacote | flash.media |
Classe | public final class AudioDeviceManager |
Herança | AudioDeviceManager EventDispatcher Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 27, AIR 28 - (Desktop) |
O dispositivo de áudio selecionado de um aplicativo AIR não afeta o áudio de outros aplicativos AIR ou de outras instâncias do Flash Player.
Restrição de privacidade
A API AudioDeviceManager está sob restrição da Ação invocada pelo usuário (UIA, User Invoked Action), ou seja, só pode ser invocada por alguma interação do usuário. Se esta API não for invocada por interação do usuário, o Flash Player gera um erro de tempo de execução IllegalOperationError com código de erro definido como 2176. No caso de aplicativos AIR, a verificação UIA será aplicada ao carregar um SWF/HTML externo hospedado por uma rede. Se o SWF/HTML carregado externamente tentar alterar o dispositivo de saída de áudio sem qualquer ação invocada pelo usuário, o tempo de execução gerará um erro IllegalOperationError com código de erro 2176.
Acessar instância AudioDeviceManager
A instância AudioDeviceManager é um objeto singleton, que está sincronizado com as configurações de saída de áudio do Flash Player. O cliente deve usar AudioDeviceManager.audioDeviceManager
para obter uma referência desse objeto singleton.
Obter os dispositivos de áudio atuais disponíveis no sistema
Use o AudioDeviceManager.deviceNames
para obter todos os dispositivos de saída de áudio disponíveis no sistema.
Obter o dispositivo de áudio atualmente selecionado
Use o AudioDeviceManager.selectedDeviceIndex
para encontrar o índice do dispositivo de saída de áudio usado atualmente. Use este índice para encontrar o nome de dispositivo retornado pela lista do dispositivo do AudioDeviceManager.deviceNames
Selecionar um dispositivo de saída de áudio
Definir o AudioDeviceManager.selectedDeviceIndex
com um valor diferente pode fazer com que este dispositivo se torne o dispositivo de reprodução de áudio selecionado atualmente.
Monitorar a alteração da saída do dispositivo de áudio
O dispositivo de saída de áudio pode alterar devido a usuários selecionarem um dispositivo diferente na interface do usuário das configurações do Flash Player, nas Configurações do conteúdo AudioDeviceManager.selectedDeviceIndex
ou devido a um dispositivo de áudio ser adicionado/removido do sistema. O aplicativo do cliente pode registrar o ouvinte do evento: AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE
para receber notificações quando ocorrer alteração do dispositivo de saída de áudio. A propriedade reason
do objeto de evento indica como essa alteração é acionada. Há 2 valores possíveis para a propriedade reason
: AudioOutputChangeReason.USER_SELECTION
indica que o usuário seleciona um dispositivo de saída de áudio diferente por meio da interface do usuário das configurações do Flash Player, ou o conteúdo define AudioDeviceManager.selectedDeviceIndex
. AudioOutputChangeReason.DEVICE_CHANGE
indica que o dispositivo de saída de áudio foi adicionado ou removido do sistema.
Propriedade | Definido por | ||
---|---|---|---|
audioDeviceManager : AudioDeviceManager [estático] [somente leitura]
A ocorrência singleton do objeto AudioDeviceManager. | AudioDeviceManager | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
deviceNames : Array [somente leitura]
Uma matriz de sequências de caracteres contendo os nomes de todos os dispositivos de saída de som disponíveis. | AudioDeviceManager | ||
isSupported : Boolean [estático] [somente leitura]
Se o AudioDeviceManager está ativado. | AudioDeviceManager | ||
selectedDeviceIndex : int
O índice do dispositivo de saída de áudio selecionado atualmente, como refletido na matriz retornada pelo AudioDeviceManager.deviceNames. | AudioDeviceManager |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Despachado quando o dispositivo de saída de áudio é alterado pelos seguintes motivos: (1) Seleção do usuário - o usuário seleciona por meio da interface do usuário de configurações do Flash Player a configuração de conteúdo AudioDeviceManager.selectedDeviceIndex; (2) Alteração de dispositivo - o dispositivo de áudio é adicionado/removido do sistema. | AudioDeviceManager | |||
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher |
audioDeviceManager | propriedade |
audioDeviceManager:AudioDeviceManager
[somente leitura] A ocorrência singleton do objeto AudioDeviceManager.
Implementação
public static function get audioDeviceManager():AudioDeviceManager
deviceNames | propriedade |
deviceNames:Array
[somente leitura]
Uma matriz de sequências de caracteres contendo os nomes de todos os dispositivos de saída de som disponíveis. Essa matriz fornece o índice inicial de cada dispositivo de saída de áudio e o número de dispositivos de saída de áudio no sistema, por meio da seguinte propriedade: AudioDeviceManager.deviceNames.length
. Para obter mais informações, consulte a entrada de classe Matriz. Essa lista de nomes de dispositivo é a mesma das Configurações de saída de áudio.
Observação para o navegador Chrome: o Chrome requer que o usuário conceda permissão de acesso ao microfone para enumerar os dispositivos de saída de áudio, porque a Saída e a Entrada de áudio compartilham a mesma permissão, e somente o aviso da permissão de Entrada de áudio será exibido para o usuário.
Implementação
public function get deviceNames():Array
isSupported | propriedade |
selectedDeviceIndex | propriedade |
selectedDeviceIndex:int
O índice do dispositivo de saída de áudio selecionado atualmente, como refletido na matriz retornada pelo AudioDeviceManager.deviceNames
. Este índice está sincronizado com as configurações de saída de áudio.
Implementação
public function get selectedDeviceIndex():int
public function set selectedDeviceIndex(value:int):void
audioOutputChange | Evento |
flash.events.AudioOutputChangeEvent
propriedade AudioOutputChangeEvent.type =
flash.events.AudioOutputChangeEvent.AUDIO_OUTPUT_CHANGE
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 27, AIR 28 - (Desktop) |
Despachado quando o dispositivo de saída de áudio é alterado pelos seguintes motivos: (1) Seleção do usuário - o usuário seleciona por meio da interface do usuário de configurações do Flash Player a configuração de conteúdo AudioDeviceManager.selectedDeviceIndex
; (2) Alteração de dispositivo - o dispositivo de áudio é adicionado/removido do sistema.
Verifique a propriedade reason
deste evento para descobrir o que causa a alteração. Os motivos possíveis são: AudioOutputChangeReason.USER_SELECTION
e AudioOutputChangeReason.DEVICE_CHANGE
.
type
de um objeto de evento AudioOutputchangeEvent
.
Wed Jun 13 2018, 11:10 AM Z