Versões comparadas

Versão antiga 1

changes.mady.by.user Laila Maria Vieira Souza

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Laila Maria Vieira Souza

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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
Nota
titleObs.:

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

Image Removed 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.

Image Removed

Sobre o bloco: Tipo de destino


Image Added

Figura 1 - Bloco Obter Imagem

Compatibilidade

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

Retorno

Retorna .

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

Esta função permite

a escolha entre três formatos de saída referentes a imagem a ser manipulada

, são eles:

Image Removed

ExpandirtitleClique para expandir as opções

.

  • Posição: 3
  • Inglês: Target type
  • Tipo: Texto / String
  • Exemplo:
  • Opções:
    • DATA_URL: Retorna uma string codificada em
base64
    • 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
    •  Retorna 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

imagem

Esta função permite PHOTOLIBRARY:

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: Expandir
titleClique para expandir as opções

.

  • 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;
    • dispositivos,
SAVEDPHOTOALBUM
    • CAMERA:
 Abre
    • Abre um tela de seleção que permite ao usuário escolher apenas imagens tiradas pela câmera do dispositivo (IOS)
;
    • .
CAMERA
    • SAVEDPHOTOALBM: 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
. NotatitleObs
    • .
:
    • Para dispositivos Android, a opção SAVEDPHOTOALBUM funciona da mesma forma que a opção PHOTOLIBRARY.

Tipo de mídia

.

  • Posição: 5
  • Inglês: Media Type
  • Tipo: Texto / String
  • Exemplo: "PICTURE"
  • Opções:
    • PICTURE:
    • VIDEO:
    • ALLMEDIA:

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.

Image Removed

  • 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

.

Nesta página

Índice