Avvia una sessione che scade dopo un intervallo fisso. Blocca la videocamera sul client che ha inviato la richiesta e si assicura che la videocamera rimanga attiva. Tieni presente che l'avvio di una nuova sessione deve essere sempre consentito. Se è già in corso, la sessione deve essere chiusa automaticamente dalla videocamera prima di iniziare la nuova sessione. Questo comando è stato ritirato nel livello API 2.
Parametri
- timeout: (facoltativo) timeout della sessione richiesto in secondi. Se omesso (la richiesta HTTP non ha un corpo), la fotocamera dovrebbe determinare un timeout ragionevole.
Risultati
- sessionId: identificatore di sessione univoco di una stringa di tipo.
- timeout:timeout di sessione confermato in secondi.
Errori
- invalidParameterName: il nome del parametro di input non è riconosciuto.
- invalidParameterValue: il nome del parametro di input viene riconosciuto, ma il valore passato non è valido; ad esempio, il valore non è compreso nell'intervallo o il tipo di dati non è corretto.
I/O comando | |
|---|---|
| Input dei comandi | {
"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."
}
} |