camera.startSession

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