Info

La API de /osc/info muestra información básica sobre la cámara y la funcionalidad. que admite.

Entrada

  • Este comando no admite entradas.

Salida

Nombre Tipo Descripción
manufacturer String El fabricante de la cámara
model String El modelo de la cámara
serialNumber String Número de serie
firmwareVersion String Versión de firmware actual.
supportUrl String URL de la página web de asistencia de la cámara.
gps Booleano Verdadero si la cámara tiene GPS.
gyro Booleano Verdadero si la cámara tiene giroscopio.
uptime Número entero Cantidad de segundos desde que se inició la cámara.
api Array de cadenas Lista de APIs compatibles.
endpoints Objeto Un objeto JSON que contiene información sobre los extremos de la cámara. Consulta la siguiente tabla.
apiLevel Array de enteros Es [1] de forma predeterminada cuando falta este campo. [1, 2] representa la admisión de las API 1 y 2 mientras [2] representa la admisión de la API 2 únicamente. Es responsabilidad del desarrollador recuperar esta información y realizar la implementación de forma diferente según el valor. Este campo se agregó en el nivel de API 2. También usa 2 si admites la API 2.1.
cameraId String Es un ID único que representa la cámara. Este campo se agregó en el nivel de API 2.1 y es relevante para la carga directa.
_vendorSpecific tipo Información adicional específica del proveedor sobre la cámara. Para las claves específicas de proveedores, usa un prefijo de guion bajo ( _ ) para evitar colisiones de espacios de nombres.

Objeto endpoints

Este objeto JSON proporciona información sobre los puertos que usa la cámara para los extremos.

Nota: Los extremos HTTPS son opcionales.

Nombre Tipo Descripción
httpPort Número entero Puerto para el servidor HTTP. (El valor predeterminado es 80).
httpUpdatesPort Número entero Puerto para recibir actualizaciones a través de HTTP
httpsPort Número entero Puerto para el servidor HTTPS (opcional). (Predeterminado 443)
httpsUpdatesPort Número entero Puerto para recibir actualizaciones a través de HTTPS (opcional).

Error

  • Este comando no muestra errores.

Ejemplo
Solicitud 
GET /osc/info HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Respuesta (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]
}
Respuesta (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"
        ]
}