Opções

A tabela a seguir mostra todas as opções disponíveis para definir e receber por 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 padrão é image. rw
captureModeSupport Matriz de strings Lista dos modos de captura disponíveis no momento. O requisito mínimo para o nível 1 da API é ["image"], e o requisito mínimo para o 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 outros modos ("video" and "walkaround") são compatíveis com a API de nível 2. Portanto, o conjunto completo com suporte do 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 capturar duas imagens em sequência, o primeiro com os usuários em qualquer lugar em relação à câmera e o segundo com os usuários de pé no lado oposto (em relação 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 "walkaround" for compatível com a câmera e estiver definido como o modo de captura atual, o cliente precisará enviar dois comandos TakePicture à câmera, em que a resposta do primeiro comando (quando concluído) indica que a câmera está pronta para tirar a segunda imagem, enquanto o segundo comando deve retornar a imagem final quando ela é concluída.

Para adicionar mais modos de captura ainda não compatíveis, coloque um sublinhado ( _ ) antes dos modos específicos do fornecedor.

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

 r
captureStatus String Status atual da captura. O padrão é "idle". Isso é útil para determinar o status da câmera quando ela é conectada a um app pela primeira vez. Se a câmera estiver no meio da gravação de um vídeo, pode ser necessário interrompê-la antes de receber ordens para realizar outras ações, por exemplo, outra gravação de vídeo.

Essa 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 for compatível com gravação de vídeo. Também é possível fornecer outras estátuas, como "downloading":

Essa 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 atualmente; 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
. Selecione o 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

Nível 1 da API:lista das configurações ISO disponíveis no momento. por exemplo, [100, 200, 400, 800,1600] ou [] quando está no modo auto.

Nível 2 da API:lista das configurações ISO disponíveis no momento. 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 de velocidade do obturador. rw
shutterSpeedSupport Matriz de números

Nível 1 da API:lista das velocidades do obturador disponíveis no momento. por exemplo, [0.067, 0.033, 0.017,0.008] ou [] quando está no modo auto.

Nível 2 da API:lista das velocidades do obturador disponíveis no momento. 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 atual da abertura, em f-stops. rw
apertureSupport Matriz de números

Nível 1 da API:lista das configurações de abertura disponíveis no momento, expressas em f/number. para 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 no momento, 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 balanço de branco por exemplo, daylight. O padrão é auto. rw
whiteBalanceSupport Matriz de strings A lista de configurações de balanço de branco atualmente disponíveis pode ser um subconjunto da lista predefinida:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Valores para cada um:
  • incandescent, cerca de 3.200 mil
  • fluorescent, cerca de 4.000 mil
  • datalight, cerca de 5.200 mil
  • cloudy-daylight, cerca de 6.000 mil
  • shade, cerca de 7.000 mil
  • twilight, cerca de 12.000 mil
. Adicione um sublinhado aos nomes de 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 atualmente disponível, geralmente na etapa 0,33 ou 0,5; Por exemplo: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Objeto

Tipo de arquivo e resolução atuais. O formato precisa refletir o valor atual de captureMode. Por exemplo, se captureMode for image, uma resposta apropriada poderia ser:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Se captureMode for video, uma resposta apropriada poderia 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 atualmente. 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 mais informações 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 o momento em que 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, em segundos, antes da câmera entrar no modo de suspensão. rw
sleepDelaySupport Matriz de números Lista dos atrasos de sono atualmente disponíveis, em segundos; por exemplo, [30, 60, 120, 300, 600, 1800, 65535], em que 65535 desativa o modo de espera (a câmera não entra em modo de suspensão até que seja 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 no desligamento atualmente disponíveis, em segundos; por exemplo, [1800, 3600, 7200, 65535], em que 65535 desativa o modo de desligamento (a câmera não é desligada até que a bateria descarregue ou seja 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 livre. r
remainingPictures Número Somente leitura: número estimado de fotos restantes com base na captura atual do ambiente. r
gpsInfo Objeto

Informações atuais de GPS. Definir usando setOptions com 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]. Cada localização de GPS é válida apenas quando for fornecida por um telefone. até a próxima atualização pelo telefone. O telefone deve determinar quando atualizar a localização do GPS; por exemplo, logo antes de cada comando takePicture. 65535 notifica a câmera de que a localização atual do GPS é inválida e que a câmera deve ignorá-lo e usar seu próprio GPS, se houver; por exemplo, setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) significa que a localização do GPS é inválido.		 rw
dateTimeZone String Informações de data e hora atuais. 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. A hora está no formato de 24 horas, a data e a hora são separadas por um espaço em branco, e fuso horário é uma diferença 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:ativa/desativa 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 só poderá ser true 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

Nível 1 da API:um valor true significa que a câmera oferece suporte a HDR. A configuração false identifica uma câmera sem HDR.

API de nível 2:se você não oferece suporte ao modo HDR, é [“off”] Se você oferecer suporte a um modo HDR, será [“off”, “hdr”]. Se vários modos de HDR (com base em algoritmos diferentes) forem compatíveis, o padrão vai ser [“off”, “hdr”, “hdr1”, “hdr2”, ...].

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

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

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

API de nível 2: o padrão é vazio {} quando hdrSupport contém apenas "off". Caso contrário, os fabricantes decidem os valores padrão (por exemplo, controle de exposição automático).

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

 rw
exposureBracketSupport Objeto

Configurações de faixa 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]
}

API de nível 1:o padrão será vazio {} se hdrSupport == false. Quando hdrSupport == true, mas o controle de exposição automático 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 tiver qualquer modo HDR, mas o controle de exposição automático não for compatível, 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 do giroscópio da câmera ou false para desativar esse recurso. O padrão será true se a câmera oferecer suporte. Caso contrário, será false. Esta configuração só pode ser true quando gyroSupport == true. rw
gyroSupport Booleano Se a câmera tiver um giroscópio, esse valor será true. Caso contrário, 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 será true se a câmera permitir. Caso contrário, será false. A configuração é true apenas quando gpsSupport == true. rw
gpsSupport Booleano Esse valor precisa ser true se a câmera tiver um módulo de GPS próprio. Caso contrário, será false. r
imageStabilization String Operação atual de estabilização de imagem por exemplo, off. rw
imageStabilizationSupport Matriz de strings As opções de estabilização de imagem estão disponíveis no momento. A lista predefinida é ["off", "on"]. Se a câmera não oferecer suporte à estabilização de imagem, retorne ["off"]. Caso contrário, retorne ["off", "on"]. Adicione um sublinhado ( _ ) ao prefixo de strings específicas do fornecedor. por exemplo, [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
Pelo menos oito caracteres, contendo letras, números, símbolos, mas sem espaços. Ela só pode ser alterada quando a câmera está conectada a um dispositivo cliente. Depois da mudança, a câmera precisa ser desconectada para que o usuário se reconecte usando o novo wifiPassword.
A câmera precisa ter um mecanismo de redefinição caso a senha seja esquecida. por exemplo, um botão de redefinição para restaurar a senha padrão.
 w
previewFormat Objeto

Resolução atual da visualização ao vivo. Por exemplo:

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

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

 rw
previewFormatSupport Matriz de objetos

Formatos de visualização ao vivo compatíveis atualmente. Por exemplo:

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

Essa 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.

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

 rw
captureIntervalSupport Objeto

Intervalos mínimo e máximo permitidos entre a captura de duas imagens consecutivas, em segundos. Por exemplo:

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

Essa 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 quando ela for desligada intencionalmente.

Essa 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
}
Ele pode mudar dependendo do armazenamento restante.

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

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

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

 r
pollingDelay Número Intervalo mínimo em segundos entre duas solicitações de sondagem de status consecutivas. Os clientes devem usar esse campo para orientar seu comportamento de pesquisa de status. por exemplo, quando ela está agrupando uma imagem, os clientes podem precisar consultar a câmera periodicamente para ver se ela terminou de ser unida. Câmeras diferentes têm suportes diferentes. por exemplo, algumas câmeras podem processar a pesquisa de status a cada segundo, enquanto outras permitem intervalos maiores.

Essa 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 captura, ou seja, outra captura é permitida antes que o processamento da imagem anterior seja concluído. Isso é altamente recomendado, especialmente para câmeras que exigem muito tempo de processamento.

Essa 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 ocorre logo após a captura.

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

Essa 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 será 1 se o Camera suporta os níveis de API 1 e 2, de modo que os clientes escritos para A API de nível 1 ainda funciona com a câmera sem qualquer mudança. padrão para 2 se a câmera só suporta o nível 2 da API, que não é recomendadas antes da migração para o nível 2 da API. Se a câmera oferece suporte somente ao nível 2 da API, a solicitação que tenta defini-lo como 1 deve falhar. Se clientVersion for definido como 2, e uma um comando descontinuado da API de nível 1 for solicitado, deve falhar com o código de erro unknownCommand.

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

 rw
photoStitchingSupport Matriz de strings

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

Essa 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 for suporte.

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

 rw
videoStitchingSupport Matriz de strings

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

Essa 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 for suporte.

Essa 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. Devolver [continuous]: se a câmera puder capturar GPS continuamente. durante a captura de vídeo e incorporar os locais no vídeo. Devolver [none], se não for possível, e [none,continuous] se o suporte para GPS de vídeo for configurável pelo usuário. Prefixo específico do fornecedor de configuração com sublinhado, por exemplo, _vendor-setting:

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

 r
videoGPS String

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

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

 rw
_vendorSpecific [type] (opcional) Outras opções de câmera específicas do fornecedor. Prefixar strings específicas do fornecedor com um sublinhado ( _ ).