Démarre une session qui expire après un intervalle fixe. Verrouille la caméra du client demandeur et s'assure qu'elle reste activée. Notez qu'une nouvelle session doit toujours être autorisée. Si une session existe déjà, elle doit être fermée automatiquement par la caméra avant de lancer la nouvelle session. Cette commande est obsolète depuis le niveau d'API 2.
Paramètres
- timeout : (facultatif) délai avant expiration de la session demandé en secondes. En cas d'omission (la requête HTTP n'a pas de corps), la caméra doit déterminer un délai raisonnable.
Résultats
- sessionId : identifiant de session unique de type chaîne.
- timeout : confirmation du délai avant expiration de la session en secondes.
Erreurs
- invalidParameterName:le nom du paramètre d'entrée n'est pas 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 de commande | |
---|---|
Saisie 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." } } |