Controle Microphone no Power Apps

Artigo
03/09/2022
3 minutos para o fim da leitura

Um controle que permite que os usuários do aplicativo registrem sons de seus dispositivos.

Descrição

Use o controle Microphone para capturar áudio com o microfone de um dispositivo. O dispositivo deve ter um microfone e o usuário precisa autorizar o aplicativo a usar o microfone.

O clipe de áudio gravado mais recentemente está disponível através da propriedade Audio. Com essa propriedade, o áudio gravado pode ser:

Reproduzido com o controle Audio. Use o controle de Audio para ouvir a gravação. Para obter mais informações, consulte os exemplos.
Colocar temporariamente uma variável ou uma coleção. Use as funções Set ou Collect para armazenar clipes de áudio em uma variável ou coleção. Tenha cuidado ao usar vários clipes de áudio em uma coleção, ao mesmo tempo, com memória limitada do dispositivo. Use as funções SaveData e LoadData para mover clipes de áudio para o armazenamento local no dispositivo e para cenários offline.
Armazenados em um banco de dados. Use a função Patch para armazenar clipes de áudio em um banco de dados.
Transmitido como uma cadeia de caracteres de texto codificada em base64. Use a função JSON para codificar clipes de áudio em base64.

Formato do áudio gravado:

3gp formato para Android.
AAC formato para iOS.
OGG formato para navegadores da web.

A mídia capturada é referenciada por uma URI de sequência de caracteres de texto. Para obter mais informações, leia a documentação do tipo de dados.

Observação

O controle do microfone é compatível apenas com o Microsoft Edge baseado nos navegadores Chromium, Chrome e Firefox; e nos dispositivos Android e iOS. Todos os outros navegadores e plataformas mostrarão um aviso de que alguns recursos do aplicativo não funcionarão.

Propriedades-chave

Audio - o clipe de áudio capturado quando o usuário grava com o microfone do dispositivo.

Mic – o ID numérico no microfone em um dispositivo que tem mais de um microfone.

OnStop – Ações a serem realizadas quando o usuário para de gravar com um controle de microfone.

Propriedades adicionais

AccessibleLabel — rótulo para leitores de tela. Deve descrever a finalidade do microfone.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

Color – a cor do texto em um controle.

DisplayMode – se o controle permite a entrada do usuário (Editar), apenas exibe dados (Exibir) ou está desabilitado (Desabilitado).

DisabledBorderColor – a cor da borda de um controle se a propriedade de controle DisplayMode estiver definida como Desabilitado.

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

Fill – a cor da tela de fundo de um controle.

FocusedBorderColor – a cor da borda do controle quando ele está focalizado.

FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.

Height – a distância entre a parte superior do controle e as bordas inferiores.

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Image – o nome da imagem exibido em um controle Image, Audio ou Microphone.

ImagePosition – a posição (Preencher, Ajustar, Ampliar, Organizar lado a lado ou Centralizar) de uma imagem em uma tela ou em um controle, se ela não tiver o mesmo tamanho da imagem.

OnSelect - Ações a serem executadas quando o usuário seleciona um controle.

OnStart – Ações a serem realizadas quando o usuário começa a gravar com um controle de microfone.

PressedBorderColor – a cor da borda do controle quando o usuário seleciona esse controle.

PressedColor – a cor do texto em um controle quando o usuário seleciona esse controle.

PressedFill – a cor da tela de fundo de um controle quando o usuário seleciona esse controle.

Reset – se um controle é revertido para seu valor padrão.

TabIndex – ordem de navegação do teclado comparada a outros controles.

Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre as bordas esquerda e direita de um controle.

X – a distância entre a borda esquerda de um controle e a borda esquerda da respectiva tela ou contêiner pai.

Y – a distância entre a borda superior de um controle e a borda superior da tela ou contêiner pai.

Exemplos

Reprodução direta simples

Neste exemplo, conectaremos diretamente um controle Microphone a um controle de Audio para reprodução imediata:

Adicionar um controle Microphone ao seu aplicativo.
Autorize o aplicativo a usar o microfone do dispositivo, se solicitado.
Adicione um controle de Audio ao seu aplicativo.
Defina a propriedade Media do controle de Audio à fórmula:
```
Microphone1.Audio
```
Observação

Substitua o nome do controle microphone Microphone1, conforme apropriado.
Visualize o aplicativo.
Selecione o controle Microphone para começar a gravar.
Fale para gravar o áudio.
Selecione o controle Microphone novamente para finalizar a gravação.
Selecione o controle de Audio para ouvir a gravação.

Adicionar sons a um controle Gallery

Neste exemplo, criaremos uma galeria de clipes de áudio armazenados em uma coleção que pode ser selecionada individualmente para reprodução:

Adicione um controle Microphone.
Defina sua propriedade OnStop para esta fórmula usando a função Collect:
```
Collect( MySounds, MyMic.Audio )
```
Adicione um controle Gallery, mova-o para baixo de MyMic.
Defina a propriedade Items para a galeria nesta fórmula:
```
MySounds
```
No modelo do controle de Custom gallery, adicione um controle de Audio.
Defina a propriedade de controle Audio Media para esta fórmula:
```
ThisItem.Url
```
Pressione F5 para visualizar o aplicativo.
Selecione MyMic para iniciar a gravação e selecione-o novamente para parar a gravação.
No controle Gallery, selecione o botão reproduzir no controle de Audio para reproduzir novamente sua gravação.
Adicione quantas gravações quiser e então volte para o espaço de trabalho padrão, pressionando a tecla Esc.
(opcional) No modelo de controle Gallery, adicione um controle de Button.
Defina sua propriedade OnSelect para a fórmula:
```
Remove( MySounds, ThisItem )
```
Pressione F5 e remova uma gravação selecionando o controle de Button correspondente.

Use a função SaveData para salvar as gravações localmente, ou a função Patch para atualizar uma fonte de dados.

Diretrizes de acessibilidade

As mesmas diretrizes para Button se aplicam porque o Microphone é apenas um botão especializado. Além disso, considere:

Alternativas de áudio

Adicione uma forma alternativa de entrada para os usuários com deficiências de fala ou que não têm um microfone. Por exemplo, Text input para permitir que os usuários insiram texto.

Contraste de cores

Leia os requisitos de contraste de cores padrão.
Garanta um contraste de cores adequado entre a Image e o texto e o ícone do botão (se aplicável).

AccessibleLabel precisa estar presente.

Consulte também

Limitações de controles no Power Apps