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." } } |