Se usó la API de Cloud Translation para traducir esta página.

Estado

La API de /osc/state muestra atributos state de la cámara. Diferencias entre esto y la API de info es que state contiene valores mutables que representa el estado de la cámara (batteryLevel, por ejemplo), mientras que info contiene solo atributos estáticos de la cámara (por ejemplo, manufacturer o que no cambian con frecuencia, como firmwareVersion).

Entrada

Este comando no admite entradas.

Salida

Nombre	Tipo	Descripción
`fingerprint`	String	Huella digital (identificador único) del estado actual de la cámara.
`state`	Objeto	Un objeto JSON que contiene la condición de varios de los estados de la cámara. Consulta la siguiente tabla.

Objeto `state`

Este objeto JSON proporciona la condición de varios de los estados de la cámara. Los fabricantes pueden Proporcionar estados personalizados nuevos, que deben incluir el prefijo de un guion bajo ( _ ) para evitar colisiones de espacios de nombres.

Nombre	Tipo	Descripción
`sessionId`	String	Es el ID de la sesión actual. Este campo dejó de estar disponible en el nivel de API 2.
`batteryLevel`	Número	Se expresa como un valor de punto flotante de la batería restante, p.ej., 0,5
`storageChanged`	Booleano	Verdadero si se inserta o se quita un nuevo tipo de almacenamiento (p.ej., una tarjeta SD o una unidad USB). Este campo dejó de estar disponible en el nivel de API 2.
`storageUri`	String	Es un identificador único para distinguir almacenamientos diferentes. Se usa para decir si el almacenamiento ha cambiado o no. Este campo se agregó en el nivel de API 2.
`_vendorSpecific`	[tipo](opcional)	Estado adicional específico del proveedor de la cámara. Usa el prefijo con un guion bajo ( _ ) para evitar colisiones de espacio de nombres.

Error

Este comando no muestra errores.

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

Ejemplo

Solicitud

POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1

Respuesta

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