Controle de microfone no Power Apps

Um controle que permite que os usuários do aplicativo gravem sons de seu dispositivo.

Description

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

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

• Reproduzido com o controle de áudio. Use o controle De áudio para ouvir a gravação. Para obter mais informações, consulte os exemplos.
• Coloque temporariamente uma variável ou uma coleção. Use as funções Definir ou Coletar para armazenar clipes de áudio em uma variável ou coleção. Tenha cuidado com vários clipes de áudio em uma coleção ao mesmo tempo com a 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.
• Armazenado 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:

• Formato 3gp para Android.
• Formato do AAC para iOS.
• Formato OGG para navegadores da Web.

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

Limitações

O controle de microfone tem estas limitações:

• O Power Apps Mobile é executado em vários tipos de dispositivos e alguns deles têm limitações específicas para essa plataforma:
  • Você pode reproduzir vídeos em vários controles de vídeo ao mesmo tempo em todas as plataformas, exceto dispositivos iPhone.
  • Você pode gravar áudio com vários controles de microfone ao mesmo tempo em todas as plataformas, exceto no player da Web.

Principais propriedades

Áudio – O clipe de áudio capturado quando o usuário grava com o microfone do dispositivo.

Microfone – ID numérica do microfone em um dispositivo que tem mais de um microfone.

OnStop – Ações a serem executadas 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 de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

Color – a cor do texto em um controle.

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

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

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

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

Preenchimento – A cor da tela de fundo de um controle.

FocusedBorderColor – A cor da borda de um controle quando o controle está focado.

FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.

Altura – a distância entre as bordas superior e inferior de um controle.

HoverBorderColor – A cor da borda de um 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.

Imagem – O nome da imagem que aparece em uma imagem, áudio ou controle de microfone.

ImagePosition – A posição (Fill, Fit, Stretch, Tile ou Center) de uma imagem em uma tela ou 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 executadas quando o usuário começa a gravar com um controle de microfone.

PressedBorderColor – A cor da borda de um 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.

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

TabIndex – Ordem de navegação do teclado em comparação com outros controles.

Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Visível – se um controle aparece ou está oculto.

Largura – 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 de seu contêiner ou tela pai.

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

Exemplos

Reprodução direta simples

Neste exemplo, conectaremos diretamente um controle De microfone com um controle de áudio para reprodução imediata:

1. Adicione um controle De microfone ao seu aplicativo.

2. Autorize o aplicativo a usar o microfone do dispositivo, se solicitado.

3. Adicione um controle de áudio ao seu aplicativo.

4. Defina a propriedade Mídia do controle de áudio como a fórmula:

   Microphone1.Audio
   

   Observação

   Substitua o nome do controle de microfone Microphone1 conforme apropriado.

5. Visualizar o aplicativo.

6. Selecione o controle Microfone para iniciar a gravação.

7. Fale para gravar áudio.

8. Selecione o controle Microfone novamente para encerrar a gravação.

9. Selecione o controle de áudio para ouvir a gravação.

Adicionar sons a um controle da Galeria

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

1. Adicione um controle De microfone .

2. Defina sua propriedade OnStop para esta fórmula usando a função Collect :

   Collect( MySounds, MyMic.Audio )
   

3. Adicione um controle da Galeria , mova-o para baixo do MyMic.

4. Defina a propriedade Items para a galeria com esta fórmula:

   MySounds
   

5. No modelo para o controle de galeria personalizado , adicione um controle de áudio .

6. Defina a propriedade Mídia do controle de áudio como esta fórmula:

   ThisItem.Url
   

7. Pressione F5 para visualizar o aplicativo.

8. Selecione MyMic para iniciar a gravação e selecione-a novamente para interromper a gravação.

9. No controle Galeria , selecione o botão Reproduzir no controle Áudio para reproduzir a gravação.

10. Adicione quantas gravações desejar e retorne ao workspace padrão pressionando a chave Esc.

11. (opcional) No modelo do controle Galeria , adicione um controle Button .

12. Defina sua propriedade OnSelect como a fórmula:

    Remove( MySounds, ThisItem )
    

13. Pressione F5 e remova uma gravação selecionando o controle botão 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 Microfone é apenas um botão especializado. Além disso, considere:

Alternativas de áudio

Considere adicionar uma forma alternativa de entrada para usuários com deficiência de fala ou sem microfone. Por exemplo, entrada de texto para permitir que os usuários insiram texto.

Contraste de cores

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

Suporte ao leitor de tela

• AccessibleLabel deve estar presente.

Consulte também

Limitações de controles no Power Apps