Informações

A API /osc/info retorna informações básicas sobre a câmera e a funcionalidade dela. com suporte.

Entrada

  • Esse comando não exige entrada.

Saída

Nome Tipo Descrição
manufacturer String Fabricante da câmera
model String O modelo da câmera.
serialNumber String Número de série.
firmwareVersion String Versão atual do firmware.
supportUrl String URL da página da Web de suporte da câmera.
gps Booleano Verdadeiro se a câmera tiver GPS.
gyro Booleano Verdadeiro se a câmera tiver giroscópio.
uptime Número inteiro Número de segundos desde a inicialização da câmera.
api Matriz de strings Lista de APIs com suporte.
endpoints Objeto Um objeto JSON contendo informações sobre os endpoints da câmera. Consulte a próxima tabela.
apiLevel Matriz de números inteiros É [1] por padrão quando este 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 no nível 2 da API. Use também 2 se tiver suporte para a API 2.1.
cameraId String Um ID exclusivo que representa a câmera. Esse campo foi adicionado no nível 2.1 da API e é relevante para o upload direto.
_vendorSpecific type Outras informações específicas do fornecedor sobre a câmera. Adicione um sublinhado ( _ ) antes das chaves específicas do fornecedor para evitar conflitos de namespace.

Objeto endpoints

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

Observação: os endpoints HTTPS são opcionais.

Nome Tipo Descrição
httpPort Número inteiro Porta para o servidor HTTP. (Padrão 80)
httpUpdatesPort Número inteiro Porta para receber atualizações por HTTP
httpsPort Número inteiro (Opcional) Porta para o servidor HTTPs. (Padrão 443)
httpsUpdatesPort Número inteiro (Opcional) Porta para 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"
        ]
}