Informações

A /osc/info API retorna informações básicas sobre a câmera e seus recursos.

Entrada

  • Esse comando não exige entrada.

Saída

Nome Tipo Descrição
manufacturer String O fabricante da câmera.
model String O modelo da câmera.
serialNumber String O número de série.
firmwareVersion String A versão atual do firmware.
supportUrl String O URL para a página de suporte da câmera.
gps Booleano True se a câmera tiver GPS.
gyro Booleano True se a câmera tiver giroscópio.
uptime Número inteiro O número de segundos desde a inicialização da câmera.
api Matriz de strings Lista de APIs compatíveis.
endpoints Objeto Um objeto JSON que contém informações sobre os terminais da câmera. Consulte a tabela a seguir.
apiLevel Matriz de inteiros É [1] por padrão quando esse campo está ausente. [1, 2] representa que as APIs 1 e 2 são suportadas, enquanto que [2] representa que apenas a API 2 é suportada. É responsabilidade do desenvolvedor recuperar essas informações e implementar diferentemente com base no valor. Esse campo foi adicionado na API de nível 2.
_vendorSpecific [type] (opcional) Informações adicionais específicas do fornecedor sobre a câmera. Adicione um sublinhado ( _ ) antes de chaves específicas de fornecedor para evitar conflitos de espaço de nome.

Objeto endpoints

Esse objeto JSON fornece informações sobre as portas que a câmera usa para terminais.

Nome Tipo Descrição
httpPort Número inteiro Porta para o servidor HTTP. (a padrão é a 80)
httpUpdatesPort Número inteiro A porta que receberá atualizações por HTTP
httpsPort Número inteiro (opcional) Porta para o servidor HTTPS. (a padrão é a 443)
httpsUpdatesPort Número inteiro (opcional) Porta que receberá atualizações por HTTPS.

Erro

  • Esse comando não retorna erros.

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

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ],
        "apiLevel": [1, 2]
}
Resposta (API 1) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ]
}