Opções

A tabela a seguir mostra todas as opções disponíveis para configurar e receber camera.setOptions e camera.getOptions. Uma opção não pode ser alterada quando o suporte correspondente está vazio ou contém apenas uma opção.

Nome Tipo Descrição Leitura/gravação
captureMode String Modo de captura atual. O valor padrão é image.. rw
captureModeSupport Matriz de strings Lista de modos de captura disponíveis no momento. O requisito mínimo para a API de nível 1 é ["image"], e o requisito mínimo para a API de nível 2 é ["image", "interval"], em que "interval" representa o modo de captura de uma série de imagens espaçadas em um determinado intervalo. Consulte também captureInterval e captureIntervalSupport. Dois modos adicionais ("video" and "walkaround") são compatíveis com o nível 2 da API. Portanto, o conjunto completo compatível com o nível 2 da API é ["image", "interval", "video", "walkaround"], em que "video" representa o modo de captura de vídeo e "walkaround" representa o modo de captura de duas imagens em sequência, a primeira com os usuários em pé em qualquer lugar relativo à câmera e o segundo com os usuários em pé no lado oposto (relativo ao primeiro ponto em pé) da câmera. Isso permite que a câmera remova os usuários da imagem final combinando as duas imagens. Quando o "walkaround" tiver suporte da câmera e for definido como o modo de captura atual, o cliente deverá enviar dois comandos takePicture para a câmera, sendo que a resposta do primeiro comando (quando terminar) indica que a câmera está pronta para tirar a segunda imagem, enquanto o segundo comando precisa retornar a imagem final quando terminar.

Para adicionar mais modos de captura que ainda não são compatíveis, adicione um sublinhado ( _ ) aos modos específicos do fornecedor.

Essa opção foi modificada no nível 2 da API.

 r
captureStatus String Status de captura atual. O padrão é "idle". Isso é útil para determinar o status da câmera quando se conecta a um app pela primeira vez. Se a câmera estiver durante o processo de gravação de um vídeo, poderá ser necessário interrompê-la antes de executar outras ações, por exemplo, a gravação de outro vídeo.

Esta opção foi adicionada no nível 2.1 da API.

 rw
captureStatusSupport Matriz de strings Lista dos status de captura disponíveis no momento. Por padrão, ele deverá ser ["idle", "shooting"] se a gravação de vídeo for compatível. Outras estátuas também podem ser fornecidas, como "downloading".

Esta opção foi adicionada no nível 2.1 da API.

 r
exposureProgram Número Programa de exposição atual. rw
exposureProgramSupport Matriz de números Lista de programas de exposição disponíveis no momento, por exemplo, [0, 1, 2, 3, 4]. Cada número inteiro representa um programa de exposição diferente:
  • 0 = não definido
  • 1 = Manual
  • 2 = Programa normal
  • 3 = Prioridade de abertura
  • 4 = Prioridade do obturador
Clique no link a seguir para fazer o download de mais detalhes sobre ExposureProgram. 		r
iso Número Configuração atual de velocidade ISO. rw
isoSupport Matriz de números

API de nível 1: lista de configurações de ISO disponíveis atualmente. Por exemplo, [100, 200, 400, 800,1600] ou [] quando está no modo auto.

API de nível 2:lista de configurações de ISO disponíveis atualmente. Por exemplo, [0, 100, 200, 400, 800, 1600], em que 0 representa o modo auto.

Essa opção foi modificada no nível 2 da API.

 r
shutterSpeed Número Configuração atual da velocidade do obturador. rw
shutterSpeedSupport Matriz de números

API de nível 1:lista de velocidades do obturador disponíveis no momento. Por exemplo, [0.067, 0.033, 0.017,0.008] ou [] quando ele está no modo auto.

API de nível 2: lista de velocidades do obturador disponíveis, por exemplo, [0, 0.067, 0.033, 0.017, 0.008], em que 0 representa o modo auto.

Essa opção foi modificada no nível 2 da API.

 r
aperture Número Configuração de abertura atual, em f-stops. rw
apertureSupport Matriz de números

API de nível 1:lista de configurações de abertura disponíveis atualmente, expressas em f/number. Por exemplo, [1.4, 2, 2.8, 4, 5.6, 8, 11] ou [] quando estiver no modo auto.

API de nível 2: lista de configurações de abertura disponíveis atualmente, expressas em f/number. Por exemplo, [0, 1.4, 2, 2.8, 4, 5.6, 8, 11], em que 0 representa o modo auto.

 r
whiteBalance String Configuração atual de saldo de branco, por exemplo, daylight. O valor padrão é auto. rw
whiteBalanceSupport Matriz de strings Lista de configurações de balanço de branco disponíveis no momento. Pode ser um subconjunto da lista predefinida: [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Valores para cada um:
  • incandescent, cerca de 3.200
  • fluorescent, cerca de 4.000
  • datalight, cerca de 5.000
  • cloudy-daylight, cerca de 6.000
  • shade, aproximadamente 7.000
  • twilight, cerca de 12.000
Adicione um sublinhado aos nomes das configurações específicas do fornecedor, por exemplo: _vendor-setting		 r
exposureCompensation Número Compensação de exposição atual. rw
exposureCompensationSupport Matriz de números Lista de compensações de exposição disponíveis atualmente, normalmente na etapa 0.33 ou 0.5; por exemplo: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Objeto

Tipo e resolução atuais de arquivos. O formato precisa refletir o valor atual de captureMode. Por exemplo, se captureMode for image, uma resposta adequada poderá ser:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Se captureMode for video, uma resposta adequada poderá ser: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Essa opção foi modificada no nível 2 da API.

 rw
fileFormatSupport Matriz de objetos

Lista dos formatos de arquivo disponíveis no momento. Por exemplo:

[
    {
    "type": "jpeg",
    "width": 2000,
    "height": 1000
    },
    {
    "type": "jpeg",
    "width": 200,
    "height": 100
    },
    {
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 24
    },
    {
    "type": "mp4",
    "width": 1280,
    "height": 720,
    "framerate": 30
    },
    ...
]
Selecione o link a seguir para saber mais sobre todos os tipos.

Essa opção foi modificada no nível 2 da API.

 r
exposureDelay Número Atraso atual entre o comando takePicture e quando a exposição é iniciada, em segundos. rw
exposureDelaySupport Matriz de números Lista de atrasos de exposição atualmente disponíveis, em segundos, por exemplo: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Número Atraso atual antes de a câmera entrar em suspensão, em segundos. rw
sleepDelaySupport Matriz de números Lista dos atrasos de sono disponíveis no momento, em segundos. Por exemplo, [30, 60, 120, 300, 600, 1800, 65535], em que 65535 desativa o modo de sono (a câmera não entra em suspensão até ser desligada) e precisa ser compatível. r
offDelay Número Atraso atual em segundos antes de a câmera desligar. rw
offDelaySupport Matriz de números Lista de atrasos de energia atualmente disponíveis, em segundos. Por exemplo, [1800, 3600, 7200, 65535], em que 65535 desativa o modo de desativação (a câmera não desliga até que a bateria esteja esgotada ou desligada manualmente) e precisa ser compatível. r
totalSpace Número Somente leitura: número de bytes do armazenamento total. r
remainingSpace Número Somente leitura: número de bytes de armazenamento sem custo financeiro. r
remainingPictures Número Somente leitura: número estimado de imagens restantes com base na configuração atual de captura. r
gpsInfo Objeto

Informações atuais do GPS. Definir usando setOptions usando o GPS do smartphone:

{
    "lat": 23.532,
    "lng": -132.35
}
As propriedades lat e lng são graus decimais, com lat no intervalo, [-90, 90] e lng no intervalo, [-180, 180]. Observe que cada local do GPS é válido apenas até a próxima atualização. O smartphone precisa determinar quando atualizar a localização do GPS, por exemplo, antes de cada comando takePicture. 65535 notifica a câmera de que a localização atual do GPS é inválida. A câmera precisará ignorá-la e usar o próprio GPS, se houver. Por exemplo, setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) significa que a localização de GPS é inválida.		 rw
dateTimeZone String Informações atuais de data e hora. Definido por setOptions usando a data, a hora e o fuso horário do smartphone. O formato é, YYYY:MM:DD HH:MM:SS+(-)HH:MM. O horário está no formato de 24 horas, a data e a hora são separadas por um espaço em branco, e o fuso horário é um deslocamento do horário UTC. Por exemplo, 2014:05:18 01:04:29+8:00 é o fuso horário da China (UTC+8:00) rw
hdr

API de nível 1: booleano

API de nível 2:string

API de nível 1:ativar/desativar o modo de captura HDR. O valor é true para ativar o HDR ou false para desativá-lo. O valor padrão é false. A configuração pode ser true apenas quando hdrSupport também for true.

API de nível 2:modo HDR atual do tipo String.

Essa opção foi modificada no nível 2 da API.

 rw
hdrSupport

API de nível 1:booleano

API de nível 2:matriz de strings

API de nível 1:um valor de true significa que a câmera é compatível com HDR. Uma configuração false identifica uma câmera sem HDR.

API de nível 2:se você não oferecer suporte ao modo HDR, ele será [“off”]. Caso seja compatível com um modo HDR, o método será [“off”, “hdr”]. Se vários modos HDR (com diferentes algoritmos baseados) forem compatíveis, ele será [“off”, “hdr”, “hdr1”, “hdr2”, ...].

Essa opção foi modificada no nível 2 da API.

 r
exposureBracket Objeto Configuração atual da faixa de exposição. Disponível apenas quando hdrSupport == true (API de nível 1) ou hdrSupport contém pelo menos um modo HDR (API de nível 2). Se a câmera usar o colchete de exposição manual, o objeto vai conter duas entradas:
  1. shots, um número inteiro com o número de fotos a serem tiradas.
  2. increment, um número que contém um incremento de VE entre as fotos.
Por exemplo: 
{
    "shots": 3,
    "increment": 1.33
}
se a câmera usa o controle de exposição automático, o objeto contém: 
{
    "autoMode": true
}

API de nível 1: o padrão será {} vazio quando hdrSupport == false. Os fabricantes decidem valores padrão (por exemplo, o controle de exposição automático), quando hdr é true.

Nível 2 da API: o padrão será {} vazio quando hdrSupport contiver apenas "off". Caso contrário, os fabricantes decidirão os valores padrão (por exemplo, o controle de exposição automático).

Essa opção foi modificada no nível 2 da API.

 rw
exposureBracketSupport Objeto

Configurações de colchetes de exposição disponíveis no momento. Por exemplo:

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

Nível 1 da API:defina {} como padrão se estiver hdrSupport == false. Quando hdrSupport == true, mas o colchetes de exposição automática não for compatível, autoMode será false.

API de nível 2: o padrão será {} vazio se hdrSupport contiver apenas "off". Quando hdrSupport contém qualquer modo HDR, mas os colchetes de exposição automática não são compatíveis, autoMode será false.

Essa opção foi modificada no nível 2 da API.

 r
gyro Booleano Defina como true para ativar o módulo de giroscópio da câmera ou false para desativar esse recurso. O padrão será true se a câmera for compatível. Caso contrário, será false. Essa configuração pode ser true apenas quando gyroSupport == true. rw
gyroSupport Booleano Se a câmera tiver um giroscópio, o valor deverá ser true. Caso contrário, será false. r
gps Booleano Ativa/desativa o módulo GPS da câmera. O valor precisa ser true para ativar ou false para desativar. O valor padrão é true se a câmera for compatível. Caso contrário, será false. A configuração é true apenas quando gpsSupport == true. rw
gpsSupport Booleano Esse valor deverá ser true se a câmera tiver o próprio módulo de GPS. Caso contrário, será false. r
imageStabilization String Operação de estabilização de imagem atual. Por exemplo, off. rw
imageStabilizationSupport Matriz de strings Opções de estabilização de imagem disponíveis no momento. A lista predefinida é ["off", "on"]. Se ela não for compatível com a estabilização de imagem, retorne ["off"]. Caso contrário, retorne ["off", "on"]. Adicione prefixos às strings específicas do fornecedor com um sublinhado ( _). Por exemplo, [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
Pelo menos oito caracteres, contendo letras, números, símbolos, mas sem espaços. Ele só pode ser alterado quando a câmera estiver conectada a um dispositivo cliente. Após mudar, a câmera precisará ser desconectada para que o usuário precise se reconectar usando o novo wifiPassword.
A câmera precisa fornecer um mecanismo de redefinição caso a senha seja esquecida, por exemplo, um botão de redefinição para restaurar a senha padrão de fábrica.
 w
previewFormat Objeto

Resolução atual da visualização dinâmica, por exemplo:

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

Esta opção foi adicionada no nível 2 da API.

 rw
previewFormatSupport Matriz de objetos

Formatos de visualização em tempo real atualmente compatíveis. Por exemplo:

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

Esta opção foi adicionada no nível 2 da API.

 r
captureInterval Número Intervalo atual entre a captura de duas imagens consecutivas, em seconds.

Esta opção foi adicionada no nível 2 da API.

 rw
captureIntervalSupport Objeto

Intervalos mínimos e máximos permitidos entre a captura de duas imagens consecutivas em segundos, por exemplo:

{
    "minInterval": 10,
    "maxInterval": 60
}
Pode variar dependendo de fileFormat.

Esta opção foi adicionada no nível 2 da API.

 r
captureNumber Número Número de imagens a serem capturadas para uma sessão de captura de intervalo. O padrão é 0, o que significa que a captura precisa ser encerrada explicitamente pelo comando stopCapture. Caso contrário, a captura será interrompida automaticamente depois de capturar imagens do número especificado. A captura também pode ser interrompida quando a câmera estiver sem bateria ou desligada intencionalmente.

Esta opção foi adicionada no nível 2 da API.

 rw
captureNumberSupport Objeto

Números mínimo e máximo de imagens que podem ser capturadas durante uma captura de intervalo. Por exemplo:

{
    "minNumber": 2,
    "maxNumber": 50
}
Pode mudar dependendo do armazenamento restante.

Esta opção foi adicionada no nível 2 da API.

 r
remainingVideoSeconds Número Número estimado de seconds para vídeo restante com base na configuração de captura atual.

Esta opção foi adicionada no nível 2 da API.

 r
pollingDelay Número Intervalo mínimo em segundos entre duas solicitações de pesquisa de status consecutivas. Os clientes devem usar esse campo para orientar o comportamento de pesquisa de status. Por exemplo, ao unir uma imagem, os clientes podem precisar pesquisar a câmera periodicamente para ver se ela termina de unir. Câmeras diferentes têm compatibilidades distintas. Por exemplo, algumas câmeras processam pesquisas de status a cada segundo, enquanto outras permitem intervalos mais longos.

Esta opção foi adicionada no nível 2 da API.

 r
delayProcessing Booleano True quando o processamento (por exemplo, agrupamento) tem uma prioridade mais baixa do que a de captura. Em outras palavras, outra captura é permitida antes do processamento da imagem capturada anterior. Isso é altamente recomendado, especialmente para câmeras que exigem um longo tempo de processamento.

Esta opção foi adicionada no nível 2 da API.

 rw
delayProcessingSupport Matriz booleana

[true] significa que o processamento (por exemplo, agrupamento) tem uma prioridade mais baixa do que a captura e é sempre atrasado por padrão.

[false] significa que o processamento acontece logo após a captura.

[true, false] significa que há uma escolha entre esses dois modos.

Esta opção foi adicionada no nível 2 da API.

 r
clientVersion Número

O nível da API que o cliente decide usar. O padrão é 1 se a câmera for compatível com o nível 1 e 2 da API para que os clientes gravados para a API de nível 1 continuem funcionando com a câmera. Padrão como 2 se a câmera for compatível apenas com o nível 2 da API, o que não é recomendado antes que os clientes migrem para o nível 2 da API. Se a câmera for compatível apenas com o nível de API 2, a solicitação que tenta definir como 1 falhará. Se clientVersion for definido como 2 e um comando descontinuado da API de nível 1 for solicitado, a solicitação falhará com o código de erro unknownCommand.

Esta opção foi adicionada no nível 2 da API.

 rw
photoStitchingSupport Matriz de strings

Lista de opções de agrupamento de fotos. Retorne [ondevice] se as fotos forem sempre costuradas na câmera, [none] se a câmera não puder costurar fotos e [none,ondevice] se a agrupamento for configurável pelo usuário. Adicione um sublinhado aos nomes das configurações específicas do fornecedor, por exemplo, _vendor-setting.

Esta opção foi adicionada no nível 2.1 da API.

 r
photoStitching String

Opção de agrupamento atual para fotos, por exemplo, ondevice. O padrão será ondevice, se compatível.

Esta opção foi adicionada no nível 2.1 da API.

 rw
videoStitchingSupport Matriz de strings

Lista de opções de agrupamento de vídeos. Retorne [ondevice] se os vídeos forem sempre integrados na câmera, [none] se a câmera não puder unir vídeos e [none,ondevice] se a agrupamento for configurável pelo usuário. Adicione um sublinhado aos nomes das configurações específicas do fornecedor, por exemplo, _vendor-setting.

Esta opção foi adicionada no nível 2.1 da API.

 r
videoStitching String

Opção de agrupamento atual para vídeos, por exemplo, ondevice. O padrão será ondevice, se compatível.

Esta opção foi adicionada no nível 2.1 da API.

 rw
videoGPSSupport Matriz de strings

Lista de opções de GPS durante a captura de vídeo. Retorne [continuous] se a câmera puder capturar GPS continuamente durante a captura de vídeo e incorporar os locais no vídeo. Retornará [none] se não for possível e [none,continuous] se a compatibilidade com GPS por vídeo for configurável pelo usuário. Adicione um sublinhado aos nomes das configurações específicas do fornecedor, por exemplo, _vendor-setting.

Esta opção foi adicionada no nível 2.1 da API.

 r
videoGPS String

Opção atual para suporte a GPS durante a captura de vídeo, por exemplo, continuous. O padrão será continuous, se compatível.

Esta opção foi adicionada no nível 2.1 da API.

 rw
_vendorSpecific [type] (opcional) Opções de câmera adicionais específicas do fornecedor. Adicione um sublinhado ( _ ) às strings específicas do fornecedor.