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

Figura 1 - Bloco Obter Imagem

Compatibilidade

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

Retorno

Retorna o endereço da imagem.

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 entre três formatos do formato de saída referentes a da imagem a ser manipulada.

• Posição: 3
• Inglês: Target type
• Tipo: Texto / String
• Exemplo:
• Opções:
  • DATA_URL: Retorna uma string codificada em Base64. A codificação base 64 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: Retorna o URI de uma imagem (Exemplo: "file:///tmp/imagem.JPG"). 
  • NATIVE_URI: Retorna uma URI nativa (Exemplo: "assets-library://asset/imagem.JPG").

Fonte da imagem

Permite a obtenção de uma imagem a partir de três tipos de fontesescolha 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 dispositivos,CAMERA: Abre um tela de seleção que permite ao usuário escolher apenas imagens tiradas pela câmera do dispositivo (IOS).
  • SAVEDPHOTOALBMCAMERA: 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. 
  • SAVEDPHOTOALBM: 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, a opção SAVEDPHOTOALBUM 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 imagem.
  • VIDEO: Permite a seleção apenas de vídeo.
  • ALLMEDIA: Permite a seleção de todos os tipos de mídia.

Permitir edição

Define se a imagem capturada pela câmera poderá ser editada ou não antes de salvar. A edição permite selecionar uma área da imagem para cortar.

• 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 se percebe um significativo aumento no tamanho da imagem dependendo da resolução da câmera.

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

Exemplo

.