camera.startSession

Startet eine Sitzung, die nach einem festen Intervall abläuft. Sperrt die Kamera für den anfordernden Client und sorgt dafür, dass die Kamera aktiv bleibt. Das Starten einer neuen Sitzung sollte immer erlaubt sein. Wenn bereits eine Sitzung vorhanden ist, sollte sie vor dem Start der neuen Sitzung automatisch von der Kamera geschlossen werden. Dieser Befehl wurde in API-Level 2 verworfen.

Parameter

  • timeout (optional): Angefordertes Zeitlimit für Sitzungen in Sekunden. Wird sie weggelassen (HTTP-Anfrage enthält keinen Text), sollte die Kamera ein angemessenes Zeitlimit ermitteln.

Ergebnisse

  • sessionId::Eindeutige Sitzungs-ID des Typs „String“.
  • timeout:Das bestätigte Zeitlimit für Sitzungen in Sekunden.

Fehler

  • invalidParameterName:Der Name des Eingabeparameters wurde nicht erkannt.
  • invalidParameterValue: Der Name des Eingabeparameters wird erkannt, aber der übergebene Wert ist ungültig. Beispiel: Der Wert liegt außerhalb des zulässigen Bereichs oder sein Datentyp ist falsch.

Befehls-E/A
Befehlseingabe 
{
    "parameters": {
        "timeout": 50
    }
}
Befehlsausgabe 
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
Befehlsausgabe (Fehler) 
{
    "error": {
        "code": "cameraInExclusiveUse",
        "message": "Camera already in exclusive use, new
        session can't be started."
    }
}