Partilhar via


captureImage (referência da API do cliente)

Invoca a câmera do dispositivo para capturar uma imagem.

Disponível para

Este método é suportado apenas para os clientes móveis.

Sintaxe

Xrm.Device.captureImage(imageOptions).then(successCallback, errorCallback)

Parâmetros

Nome do parâmetro Tipo Obrigatório Description
imageOptions Objeto Não Um objeto com os seguintes valores:
- allowEdit: Indica se a imagem deve ser editada antes de salvar. Booleano.
- quality: Qualidade do arquivo de imagem em porcentagem. Número.
- height: Altura da imagem a capturar. Número.
- width: Largura da imagem a capturar. Número.
Nota: As dimensões de altura e largura devem ser especificadas, se utilizadas.
successCallback Função Yes Uma função para chamar quando a imagem é retornada. Um objeto de imagem codificado em base64 com os seguintes valores é passado para a função:
- fileContent: Conteúdo do arquivo de imagem. String
- fileName: Nome do arquivo de imagem. String.
- fileSize: Tamanho do arquivo de imagem em KB. Número.
- mimeType: Tipo MIME de arquivo de imagem. String.
errorCallback Função Yes Uma função para chamar quando a operação falhar.

Valor de retorno

Quando for bem-sucedido, retorna um objeto de imagem codificada em base64 com os valores especificados anteriormente.

Exceptions

Consulte os códigos de erro do serviço Web

Xrm.Device