Controlo Câmara no Power Apps

Artigo
04/20/2024

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.

Selecione o controlo da câmara para capturar uma imagem da câmara.

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

Visualizadas com o controlo Imagem. Utilize o controlo 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 Set ou Collect 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 Stream, 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.

Nota

O controlo 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.
As imagens geradas pelo controlo da câmara têm uma resolução máxima de 640 x 480 px. Se precisar de imagens com a resolução máxima, utilize o controlo Adicionar imagem.
Dependendo do modelo e marca do seu dispositivo móvel, a câmara do dispositivo poderá demorar alguns segundos a iniciar quando utilizar o controlo Câmara.

Limitações

O controlo da câmara tem as seguintes limitações:

Ao utilizar o controlo camera, a imagem não contém informações de metadados. Isto deve-se a uma limitação da forma como capturamos imagens com a câmara. Para mitigar este problema, utilize o controlo Adicionar imagem
Se tiver com pouca memória no seu dispositivo móvel, a câmara é desativada temporariamente para evitar provocar falhas no dispositivo.
O Power Apps para Windows pode falhar se abrir uma aplicação que utiliza um controlo camera. Para evitar este problema, utilize o leitor Web na plataforma Windows. Não são também suportadas diversas câmaras.

Propriedades chave

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 – Ações a executar quando a propriedade Stream é atualizada.

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

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

StreamRate – a frequência de atualização da imagem na propriedade Stream, 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.

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

Contrast – 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.

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

OnSelect – Ações a realizar 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.

Width – 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 num dispositivo iOS ou Android com uma câmara.

Apresentação simples de uma imagem capturada

Adicione um controlo de Câmara.
Autorize a aplicação a utilizar a câmara do dispositivo, se for pedido.
Adicionar um controlo Imagem.
Defina a propriedade Image do controlo de Image para a seguinte fórmula:
```
Camera1.Photo
```
Nota

Substitua o nome do controlo Câmara Câmara1 conforme adequado.
Prima F5 para pré-visualizar a sua aplicação.
Tirar uma fotografia selecionando ou tocando no controlo da câmara. Deverá ver o resultado no controlo da imagem.

Adicionar imagens a um controlo Galeria de imagens

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:
- Como adicionar nome e configurar um controlo?
- Obter mais informações sobre a função de Collect ou outras funções.
Prima F5 e, em seguida, tire uma fotografia ao selecionar ou tocar em MyCamera.
Adicionar um controlo de Galeria vertical. E, em seguida, redimensione o respetivo controlo Imagem e o seu modelo, e o próprio controlo Galeria de imagens para que se ajustem ao ecrã.
Defina a propriedade Items do controlo Galeria de imagens para esta fórmula:
```
MyPix
```
Defina a propriedade Image do controlo Imagem na galeria para esta fórmula:
```
ThisItem.Url
```
A fotografia que tirou aparece no controlo Galeria de imagens.
Tire quantas fotografias quiser e, em seguida, volte à área de trabalho predefinida, premindo Esc.
(opcional) Defina a propriedade OnSelect do controlo da Image no controlo da Galeria de imagens para a fórmula:
```
Remove( MyPix, ThisItem )
```
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

Adicione um controlo de Câmara.
Autorize a aplicação a utilizar a câmara do dispositivo, se for pedido.
Adicionar um controlo Lista pendente.
Definir a propriedade Items da lista pendente para:
```
Camera1.AvailableDevices
```
Nota

Substitua o nome do controlo Câmara Câmara1 conforme adequado.
Defina a propriedade da Câmara para:
```
Dropdown1.Selected.Id
```
Nota

Substitua o nome do controlo Lista pendente Lista pendente1 conforme adequado.
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, Adicionar imagem 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