inicia uma sessão que expira após um intervalo fixo; Bloqueia a câmera para o cliente que fez a solicitação e garante que ela permaneça ativa. É sempre permitido iniciar uma nova sessão. Se já houver uma sessão, ela precisa ser fechada automaticamente pela câmera antes de iniciar a nova. Esse comando foi descontinuado na API de nível 2.
Parâmetros
- timeout: (opcional) tempo limite da sessão solicitada em segundos. Se omitido (a solicitação HTTP não tem corpo), a câmera precisa determinar um tempo limite razoável.
Resultados
- sessionId::identificador de sessão exclusivo do tipo string.
- timeout:tempo limite da sessão confirmada 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 valor transmitido é inválido. Por exemplo, o valor está fora do intervalo ou o tipo de dados está incorreto.
E/S do 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." } } |