Abre o aplicativo de câmera do smartphone ou recupera uma imagem do álbum de fotos do dispositivo.


Figura 1 - Bloco Obter Imagem

Compatibilidade

  • Bloco cliente mobile: cronapi.cordova.camera.getPicture()

Retorno

Dependendo do valor selecionado para o parâmetro Tipo de destino, o bloco retornará o endereço da imagem obtida ou uma string codificada em Base64.

Parâmetros

Sucesso

Executa uma ação caso a imagem seja obtida com sucesso.

  • Posição: 1
  • Inglês: Success
  • Tipo: Comando com retorno ("item") / Command with return ("item")
  • Exemplo: uso do bloco Exibir Notificação

Erro

Executa uma ação caso ocorra um erro durante a obtenção da imagem.

  • Posição: 2
  • Inglês: Error
  • Tipo: Comando com retorno ("item") / Command with return ("item")
  • Exemplo: uso do bloco Exibir Notificação

Tipo de destino

Permite a escolha do formato de saída da imagem a ser manipulada.

  • Posição: 3
  • Inglês: Target type
  • Tipo: Texto / String
  • Exemplo: "FILE_URI"
  • Opções:
    • DATA_URL: Retorna uma string codificada em Base64. Visto que a codificação Base64 pode consumir memória em excesso, ocasionando falhas na aplicação ou erros de memória insuficiente, é recomendado o uso dos demais parâmetros. 
    • FILE_URI: Configuração específica para Android que retorna o URI da imagem obtida no diretório do dispositivo do usuário (Exemplo: "http://localhost/_app_file_/data/user/0/io.cronapp.apps.imagem/cache/1687676346587.jpg"). 
    • NATIVE_URI: Configuração específica para iOS que retorna uma URI nativa (Exemplo: "assets-library://asset/imagem.JPG").

Fonte da imagem

Permite a escolha da fonte da imagem a ser obtida.

  • Posição: 4
  • Inglês: Imagem Source
  • Tipo: Texto / String
  • Exemplo: "CAMERA"
  • Opções:
    • PHOTOLIBRARY: Abre um tela de seleção que permite ao usuário escolher qualquer imagem existente no dispositivo.
    • CAMERA: Abre a câmera padrão do dispositivo para que o usuário tire uma foto. Após tirada a foto, 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. 
    • SAVEDPHOTOALBUM: Em dispositivos iOS, abre um tela de seleção que permite ao usuário escolher apenas imagens tiradas pela câmera do dispositivo. Para dispositivos Android, essa opção funciona da mesma forma que a opção PHOTOLIBRARY.

Tipo de mídia

Defina o tipo de mídia que será selecionada.

  • Posição: 5
  • Inglês: Media Type
  • Tipo: Texto / String
  • Exemplo: "PICTURE"
  • Opções:
    • PICTURE: Permite a seleção apenas de fotos.
    • VIDEO: Permite a seleção apenas de vídeos.
    • ALLMEDIA: Permite a seleção tanto de fotos como vídeos.

Permitir edição

Define se a após a captura ou escolha da imagem será possível editá-la ou não antes de salvar. A edição permite selecionar uma área da imagem para cortar. Essa configuração faz uso do aplicativo nativo do Android ou iOS, o que significa que esse recurso não estará disponível, por exemplo, em um PWA (Progressive Web App).

  • Posição: 6
  • Inglês: Allow Edition
  • Tipo: Texto / String
  • Exemplo: "Verdadeiro"
  • Opções:
    • Falso: Não permite a edição da imagem.
    • Verdadeiro: Permite que a imagem seja editada.

Comprimir

Define se a imagem poderá ser comprimida ou não. Ao utilizar esse recurso, dependendo da resolução da câmera, se percebe um significativo aumento no tamanho da imagem.

  • Posição: 7
  • Inglês: Compress
  • Tipo: Texto / String
  • Exemplo: "Verdadeiro"
  • Opções:
    • Verdadeiro: Permite que a imagem seja comprimida.
    • Falso: Não permite a compressão da imagem.

Exemplo

A imagem abaixo mostra um exemplo de uso do bloco Obter Imagem. Este bloco possui duas entradas de comando, uma para ser executada em caso de sucesso e outra em caso de erro, na obtenção da imagem. No exemplo abaixo, em caso de sucesso, o bloco Exibir Notificação exibirá na tela uma mensagem contendo o endereço do tipo FILE_URI da imagem (Figura 2.1). Caso contrário, será exibida uma mensagem de erro.


Figura 2 - Exemplo de uso do bloco Obter Imagem


Para testar a aplicação corretamente, será necessário compilar e instalar o aplicativo no dispositivo móvel Android ou iOS. 


Executando a função da Figura 2, a câmera do dispositivo será aberta para tirar uma foto, após a captura e edição da imagem será exibida uma notificação contendo o endereço da imagem.


Figura 2.1 - Resultado de execução da função da Figura 2


Nesta página