camera.updateSession

Aktualisiert das Sitzungszeitlimit. Eine Sitzung wird bei jeder Interaktion mit der Kamera automatisch aktualisiert. Beispielsweise sollte eine Sitzung, die mit einem Zeitlimit von 10 Minuten beginnt, auf die vollen 10 Minuten zurückgesetzt werden, wenn ein takePicture-Befehl ausgeführt wird. Dieser Befehl wurde in API-Level 2 verworfen.

Parameter

  • sessionId::Eindeutige Sitzungs-ID des Typs „String“.
  • 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: Bestätigter Sitzungs-ID-String, der an den Befehl übergeben wurde.
  • timeout:Das bestätigte Zeitlimit für Sitzungen in Sekunden.

Fehler

  • missingParameter: sessionId fehlt; beispielsweise ist sessionId nicht angegeben.
  • invalidParameterName:Ein oder mehrere Eingabeparameternamen werden nicht erkannt.
  • invalidParameterValue: Namen von Eingabeparametern werden erkannt, aber mindestens einer der übergebenen Werte ist ungültig. Beispiel: sessionId existiert nicht, ist nicht mehr aktiv, der Datentyp ist falsch oder timeout hat den falschen Datentyp.

Befehls-E/A

Befehlseingabe
{
    "parameters": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
Befehlsausgabe
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
Befehlsausgabe (Fehler)
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter sessionId is missing."
    }
}