Estado

A API /osc/state retorna atributos state da câmera. A diferença entre essa API e a API info é que state contém valores mutáveis que representam o status da câmera (batteryLevel, por exemplo), e 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 da câmera atual.
state Objeto Um objeto JSON que contém o status dos vários estados da câmera. Consulte a tabela a seguir.

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 se tornou obsoleto na API de nível 2.
batteryLevel Número Expressado como um valor de ponto flutuante da bateria restante. Por exemplo: 0,5
storageChanged Booleano True se um novo tipo de armazenamento (como um cartão SD ou uma unidade USB) for inserido/removido. Esse campo se tornou obsoleto na API de nível 2.
storageUri String Um identificador único para distinguir armazenamentos diferentes. É usado para informar se o armazenamento foi alterado ou não. Esse campo foi adicionado na API de nível 2.
_vendorSpecific [type](optional) Estado adicional específico do fornecedor sobre a câmera. Adicione um sublinhado ( _ ) para evitar conflitos de espaço de nome.

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
    }
}