Inicia uma sessão que expira após um intervalo fixo. Trava a câmera no o cliente solicitante e garante que a câmera permaneça ativa. A partir de uma nova sessão sempre deve ser permitida. Se já houver uma sessão, devem ser fechados automaticamente pela câmera antes de iniciar a nova sessão. Esse comando foi descontinuado no nível 2 da API.
Parâmetros
- timeout: (opcional) o tempo limite da sessão solicitado em segundos. Se omitido (a solicitação HTTP não tem corpo), a câmera deve determinar um valor tempo limite.
Resultados
- sessionId::identificador exclusivo de sessão do tipo string.
- tempo limite:tempo limite confirmado da sessão em segundos.
Erros
- invalidParameterName:o nome do parâmetro de entrada não foi reconhecido.
- invalidParameterValue: o nome do parâmetro de entrada é reconhecido, mas o o valor passado é inválido; por exemplo, o valor está fora do intervalo ou os dados está incorreto.
E/S de comando | |
|---|---|
| Entrada de comando | {
"parameters": {
"timeout": 50
}
} |
| Resposta ao comando | {
"results": {
"sessionId": "12ABC3",
"timeout": 50
}
} |
| Resposta ao comando (erro) | {
"error": {
"code": "cameraInExclusiveUse",
"message": "Camera already in exclusive use, new
session can't be started."
}
} |