Avvia una sessione che scade dopo un intervallo fisso. Blocca la videocamera in che richiede il cliente e si assicura che la videocamera rimanga attiva. Tieni presente che a partire da dovrebbe essere sempre consentita una nuova sessione. Se esiste già una sessione, dovrebbe essere chiuso automaticamente dalla videocamera prima di iniziare la nuova sessione. Questo comando è stato deprecato nel livello API 2.
Parametri
- timeout: (facoltativo) timeout di sessione richiesto in secondi. Se omesso (la richiesta HTTP non ha un corpo), la fotocamera dovrebbe determinare una timeout.
Risultati
- sessionId: identificatore di sessione univoco della stringa di tipo.
- timeout:timeout della sessione confermato in secondi.
Errori
- invalidParameterName:nome del parametro di input non riconosciuto.
- invalidParameterValue: il nome del parametro di input è riconosciuto, ma il valore trasmesso non è valido. Ad esempio, il valore non rientra nell'intervallo o i relativi dati il tipo non è corretto.
I/O comando | |
---|---|
Input comando | { "parameters": { "timeout": 50 } } |
Output comando | { "results": { "sessionId": "12ABC3", "timeout": 50 } } |
Output comando (errore) | { "error": { "code": "cameraInExclusiveUse", "message": "Camera already in exclusive use, new session can't be started." } } |