Compartilhar via

Controle Microfone no Power Apps

  • Artigo

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

Descrição

Use o controle Microfone 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 Áudio. Use o controle de Áudio 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 cadeia 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.

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 a essa plataforma:
    • Você pode reproduzir vídeos em vários controles Video ao mesmo tempo em todas as plataformas, exceto dispositivos iPhone.
    • Você pode gravar áudio com vários controles Microphone ao mesmo tempo em todas as plataformas, exceto o player da Web.

Principais propriedades

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 Imagem, Áudio ou Microfone.

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 Microfone a um controle de Áudio para reprodução imediata:

  1. Adicionar um controle 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 Media do controle de Áudio à fórmula:

    Microphone1.Audio

    Observação

    Substitua o nome do controle Microfone Microphone1, conforme apropriado.

  5. Visualize o aplicativo.

  6. Selecione o controle Microfone para começar a gravar.

  7. Fale para gravar o áudio.

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

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

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 Microfone.

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

    Collect( MySounds, MyMic.Audio )

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

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

    MySounds

  5. No modelo do controle de Galeria personalizada, adicione um controle de Áudio.

  6. Defina a propriedade do Media controle Áudio para esta fórmula:

    ThisItem.Url

  7. Pressione F5 para visualizar o aplicativo.

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

  9. No controle Galeria, selecione o botão reproduzir no controle de Áudio para reproduzir novamente sua gravação.

  10. Adicione quantas gravações quiser e então volte para o espaço de trabalho padrão, pressionando a tecla Esc.

  11. (opcional) No modelo de controle Galeria, adicione um controle de Botão.

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

    Remove( MySounds, ThisItem )

  13. Pressione F5 e remova uma gravação selecionando o controle de 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 Botão se aplicam porque o Microfone é 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, Entrada de texto para permitir que os usuários insiram texto.

Contraste de cores

Suporte ao leitor de tela

Confira também

Limitações de controles no Power Apps

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).