State

A API /osc/state retorna atributos state da câmera. A diferença entre isso e a API info é que state contém valores mutáveis que representa o status da câmera (batteryLevel, por exemplo), enquanto a função info contém apenas atributos estáticos da câmera (por exemplo, manufacturer ou atributos que não mudam com frequência, como firmwareVersion).

Entrada

  • Esse comando não exige entrada.

Saída

Nome Tipo Descrição
fingerprint String Impressão digital (identificador exclusivo) do estado atual da câmera.
state Objeto Um objeto JSON que contém o status dos vários estados da câmera. Consulte a próxima tabela.

Objeto state

Esse objeto JSON fornece o status de vários estados da câmera. Os fabricantes podem fornecer estados novos e personalizados, que devem ser precedidos por um sublinhado ( _ ) para evitar conflitos de namespace.

Nome Tipo Descrição
sessionId String ID da sessão atual. Esse campo foi descontinuado no nível 2 da API.
batteryLevel Número Definido como um valor de ponto flutuante da bateria restante. Por exemplo: 0,5
storageChanged Booleano Verdadeiro se um novo tipo de armazenamento (por exemplo, um cartão SD ou uma unidade USB) for inserido/removido. Esse campo foi descontinuado no nível 2 da API.
storageUri String Um identificador exclusivo para distinguir armazenamentos diferentes. É usado para informar se o armazenamento foi alterado ou não. Esse campo foi adicionado no nível 2 da API.
_vendorSpecific [type](opcional) Estado adicional específico do fornecedor sobre a câmera. Adicione um sublinhado ( _ ) para evitar conflitos de namespace.

Erro

  • Esse comando não retorna erros.

Exemplo
Solicitação 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Resposta 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "fingerprint": "12EGA33",
    "state": {
        "sessionId": "12ABC3",
        "batteryLevel": 0.5,
        "storageChanged": false
    }
}