camera.startSession

Démarre une session qui expire après un intervalle fixe. Verrouille la caméra sur le client à l'origine de la demande et s'assure qu'elle reste activée. Notez que vous devez toujours autoriser le démarrage d'une nouvelle session. S'il existe déjà une session, elle doit être fermée automatiquement par la caméra avant de démarrer la nouvelle session. Cette commande a été abandonnée au niveau d'API 2.

Paramètres

  • timeout (facultatif) : délai avant expiration de la session demandée, en secondes. En cas d'omission (la requête HTTP n'a pas de corps), l'appareil photo doit déterminer un délai raisonnable.

Résultats

  • sessionId::identifiant de session unique de type chaîne.
  • timeout:délai avant expiration de la session confirmé en secondes.

Erreurs

  • invalidParameterName:nom du paramètre d'entrée non reconnu.
  • invalidParameterValue:le nom du paramètre d'entrée est reconnu, mais la valeur transmise n'est pas valide. Par exemple, la valeur est hors plage ou son type de données est incorrect.

E/S des commandes

Entrée de commande
{
    "parameters": {
        "timeout": 50
    }
}
Résultat de la commande
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
Résultat de la commande (erreur)
{
    "error": {
        "code": "cameraInExclusiveUse",
        "message": "Camera already in exclusive use, new
        session can't be started."
    }
}