Controlo Câmara no Power Apps

Um controlo que permite que os utilizadores tirem fotografias utilizando a câmara num dispositivo.

Descrição

Utilize o controlo da Câmara para capturar imagens com a câmara de um dispositivo. O dispositivo tem de ter uma câmara e o utilizador tem de autorizar a aplicação a utilizar a câmara.

A imagem capturada mais recentemente está disponível através da propriedade Fotografia. Com esta propriedade, as imagens podem ser:

  • Visualizadas com o controlo de imagem. Utilize o controlo de Imagem para ver a imagem capturada. Para mais informações, consulte os exemplos.
  • Coloque temporariamente uma variável ou uma coleção. Utilize as funções Definir ou Recolher para armazenar imagens numa variável ou numa coleção. Tenha atenção ao utilizar várias imagens numa coleção ao mesmo tempo que consome a memória limitada do dispositivo. Utilize as funções SaveData e LoadData para mover imagens para o armazenamento local no dispositivo e para cenários offline.
  • Armazenados numa base de dados. Utilize a função Patch para armazenar imagens numa base de dados.
  • Transmitido como cadeia de texto codificada base64. Utilize a função JSON para codificar imagens base64.

Utilize as propriedades Fluxo, StreamRate e OnStream para capturar automaticamente imagens num temporizador, por exemplo, tirar uma imagem a cada minuto para criar uma sequência de lapso de tempo.

O multimédia capturado é referenciado por um URI da cadeia de texto. Para mais informações, leia a documentação do tipo de dados.

As imagens geradas pelo controlo de câmara não têm normalmente a resolução máxima da câmara. Se precisar de imagens com a resolução máxima, use o controlo Add picture.

Nota

O controlo de câmara é suportado apenas nos browsers Microsoft Edge, Chrome, Firefox e Opera, e nos dispositivos Android e iOS. Todos os outros browsers e plataformas mostrarão um aviso de que algumas funcionalidades da aplicação não funcionarão.

Propriedades principais

AvailableDevices – tabela das câmaras disponíveis no dispositivo.

A tabela contém duas colunas:

  • Número de ID a utilizar com a propriedade Câmara
  • Nome fornecido pelo dispositivo para identificar a câmara. Algumas plataformas poderão incluir o modo frontal ou posterior para ajudar a localizar a câmara.

Nota: nem todos os dispositivos na tabela podem ser utilizáveis na sua aplicação. Alguns podem ser drivers ou aplicações especializadas destinados a fins específicos.

Câmara – o ID numérico da câmara a utilizar. Útil para dispositivos com mais do que uma câmara.

OnStream – como a aplicação responde quando a propriedade Fluxo é atualizada.

Fotografia – a imagem capturada quando o utilizador tira uma fotografia.

Fluxo – uma imagem atualizada automaticamente com base na propriedade StreamRate.

StreamRate – a frequência de atualização da imagem na propriedade Fluxo, em milissegundos. Este valor pode ir de 100 (1/10 de um segundo) até 3,600,000 (1 hora).

Propriedades adicionais

AccessibleLabel – a etiqueta para os leitores de ecrãs. Deve descrever a finalidade de tirar uma fotografia.

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

Luminosidade – a quantidade de luz que o utilizador poderá ver numa imagem.

Contraste – a facilidade com que o utilizador poderá distinguir entre cores semelhantes numa imagem.

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).

FocusedBorderColor– a cor do limite de um controlo quando o controlo é destacado.

FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.

Altura – a distância entre as margens superiores e inferiores de um controlo.

OnSelect – como a aplicação responde quando o utilizador toca ou clica num controlo.

TabIndex – a ordem de navegação no teclado em comparação com outros controlos.

Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.

Visible – se um controlo é apresentado ou está oculto.

Largura – a distância entre as margens esquerda e direita de um controlo.

X - a distância entre o limite esquerdo do componente de um controlo e o limite esquerdo do contentor ou ecrã principal.

Y - a distância entre o limite superior do componente de um controlo e o limite superior do contentor ou ecrã principal.

Exemplos

Para estes exemplos, necessita de um dispositivo com uma câmara. Para testar a sua aplicação, utilize uma web cam acessível a partir do seu browser. Alternativamente, pode guardar a sua aplicação e carregá-la para um dispositivo iOS ou Android com uma câmara.

Apresentação simples de uma imagem capturada

  1. Adicione um controlo de Câmara.

  2. Autorize a aplicação a utilizar a câmara do dispositivo, se for pedido.

  3. Adicionar um controlo de Imagem.

  4. Defina a propriedade Imagem do controlo de Imagem para a seguinte fórmula:

    Camera1.Photo
    

    Nota

    Substitua o nome do controlo de câmara Câmara conforme adequado.

  5. Prima F5 para pré-visualizar a sua aplicação.

  6. Tirar uma fotografia selecionando ou tocando no controlo da câmara. Deverá ver o resultado no controlo da imagem.

  1. Adicione um controlo Câmara, dê-lhe o nome MyCamera e defina a respetiva propriedade OnSelect de acordo com esta fórmula:

    Collect( MyPix, MyCamera.Photo )
    

    Para mais informações:

  2. Prima F5 e, em seguida, tire uma fotografia ao selecionar ou tocar em MyCamera.

  3. Adicionar um controlo de Vertical gallery. E, em seguida, redimensione o respetivo controlo Image e o seu modelo, e o próprio controlo Image gallery para que se ajustem ao ecrã.

  4. Defina a propriedade Items do controlo Image gallery para esta fórmula:

    MyPix
    
  5. Defina a propriedade da Imagem do controlo de Imagem na galeria para esta fórmula:

    ThisItem.Url
    

    A fotografia que tirou aparece no controlo Image gallery.

  6. Tire quantas fotografias quiser e, em seguida, volte à área de trabalho predefinida, premindo Esc.

  7. (opcional) Defina a propriedade OnSelect do controlo da Imagem no controlo da Image gallery para a fórmula:

    Remove( MyPix, ThisItem )
    
  8. Prima F5 e, em seguida, selecione a fotografia para a remover.

Utilize a função SaveData para guardar as fotografias localmente, ou a função Patch para atualizar uma origem de dados.

Alterar a câmara ativa de uma lista pendente

  1. Adicione um controlo de Câmara.

  2. Autorize a aplicação a utilizar a câmara do dispositivo, se for pedido.

  3. Adicionar um controlo Drop down.

  4. Definir a propriedade Itens da lista pendente para:

    Camera1.AvailableDevices
    

    Nota

    Substitua o nome do controlo de câmara Câmara conforme adequado.

  5. Defina a propriedade da Câmara para:

    Dropdown1.Selected.Id
    

    Nota

    Substitua o nome do controlo pendente Dropdown1 conforme adequado.

  6. Prima F5 e, em seguida, selecione um item na lista pendente para alterar a câmara.

Diretrizes de acessibilidade

O controlo Câmara mostra a alimentação de câmaras e também funciona como um botão que tira uma fotografia. Assim, existem considerações de acessibilidade semelhantes tal como acontece com os botões.

Alternativas de vídeo

Considere adicionar uma forma de entrada alternativa para os utilizadores com deficiências visuais. Por exemplo, Add picture para permitir que os utilizadores carreguem uma imagem dos dispositivos.

Contraste de cor

Tem de haver um contraste de cores adequado entre FocusedBorderColor e a cor externa.

Suporte a leitor de ecrã

AccessibleLabel deve estar presente.

Suporte de teclado

  • TabIndex tem de ser zero ou superior para que os utilizadores do teclado possam navegar nele.

  • Os indicadores de foco têm de estar claramente visíveis. Utilize FocusedBorderColor e FocusedBorderThickness para atualizar a visibilidade de indicadores de foco.

Consulte também

Limitações de controlos no Power Apps

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).