State

L'API /osc/state renvoie les attributs state de l'appareil photo. La différence entre cette API et l'API info est que state contient des valeurs modifiables représentant l'état de l'appareil photo (batteryLevel, par exemple), tandis que info ne contient que des attributs statiques de l'appareil photo (par exemple, manufacturer ou qui changent rarement, comme firmwareVersion).

Entrée

  • Cette commande ne nécessite aucune entrée.

Sortie

Nom Type Description
fingerprint Chaîne Empreinte (identifiant unique) de l'état actuel de l'appareil photo.
state Objet Objet JSON contenant l'état des différents états de la caméra. Consultez le tableau suivant.

Objet state

Cet objet JSON fournit le statut des différents états de l'appareil photo. Les fabricants peuvent Fournir de nouveaux états personnalisés, précédés d'un trait de soulignement ( _ ) pour éviter les conflits d'espaces de noms.

Nom Type Description
sessionId Chaîne ID de la session en cours. Ce champ a été abandonné dans le niveau d'API 2.
batteryLevel Nombre Exprimée en tant que valeur à virgule flottante de l'autonomie restante de la batterie, par ex. 0,5
storageChanged Booléen Ce paramètre est défini sur "true" si un nouveau type de mémoire de stockage (par exemple, une carte SD ou une clé USB) est inséré ou retiré. Ce champ a été abandonné dans le niveau d'API 2.
storageUri Chaîne Identifiant unique permettant de distinguer les différents espaces de stockage. Il est utilisé pour indiquer si le stockage a changé ou non. Ce champ a été ajouté au niveau d'API 2.
_vendorSpecific [type](facultatif) État supplémentaire spécifique au fournisseur concernant la caméra. Ajoutez le préfixe d'un trait de soulignement ( _) pour éviter les conflits d'espaces de noms.

Erreur

  • Cette commande ne renvoie aucune erreur.

Exemple
Requête 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Réponse 
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
    }
}