Obter Imagem

Tira uma foto usando a câmera ou recupera uma foto do álbum de fotos do dispositivo.

Parâmetros

NomeTipoDoc
Parâmetro 1InteiroTipo de destino
Parâmetro 2InteiroFonte da imagem

A função para obter uma imagem contém, além dos dois parâmetros acima, dois parâmetros adicionais: Sucesso e Erro. Esses parâmetros recebem uma ou mais instruções a serem executadas a depender do resultado da obtenção da imagem. Caso esta seja obtida com sucesso o fluxo de execução é direcionado para os comandos contidos no parâmetro Sucesso, caso contrário os comandos em Erro são executados. 

NomeTipoDoc
Parâmetro 3ComandoAções a serem executados caso a obtenção da imagem seja realizada com sucesso
Parâmetro 4ComandoAções a serem executadas caso ocorra erro na obtenção da imagem

Compatibilidade

 Cliente

Exemplo 1

A função abaixo em destaque permite que o usuário capture uma imagem através da câmera do dispositivo móvel e obtenha sua representação URI.

 

Sobre o bloco: Tipo de destino

Esta função permite a escolha entre três formatos de saída referentes a imagem a ser manipulada, são eles:

DATA_URL: Retorna uma string codificada em base64. Nota: A codificação base 64 pode consumir memória em excesso, ocasionando falhas na aplicação ou erros de memória insuficiente. É indicado o uso do FILEURI ou NATIVE_URI se possível. Aconselha-se utilizar para a visualização com o prefixo data:image/png;base64, e o dado obtido em base64

FILE_URI: Retona o URI de uma imagem. Ex.: "file:///tmp/imagem.JPG" (Android)

NATIVE_URI: Retorna uma URI nativa. Ex.: "assets-library://asset/imagem.JPG" (IOS)

Sobre o bloco: Fonte da Imagem

Esta função permite a obtenção de uma imagem a partir de três tipos de fontes através do parâmetro "Fonte da imagem". São elas:

PHOTOLIBRARY: Abre um tela de seleção que permite ao usuário escolher qualquer imagem existente no dispositivo;

SAVEDPHOTOALBUM: Abre um tela de seleção que permite ao usuário escolher apenas imagens tiradas pela câmera do dispositivo (IOS);

CAMERA: Abre a câmera padrão do dispositivo para que o usuário tire uma fotografia. Após tirada a fotografia, o usuário pode confirmar ou apagar a imagem, no primeiro caso a câmera é fechada e retorna para aplicação, no segundo caso a imagem é descartada e a câmera fica disponível para captura de uma nova imagem.

Para dispositivos Android, a opção SAVEDPHOTOALBUM funciona da mesma forma que a opção PHOTOLIBRARY.