camera.startSession
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Startet eine Sitzung, die nach einem festen Intervall abläuft. Sperrt die Kamera am
Client anfordern und dafür sorgen, dass die Kamera aktiv bleibt. Hinweis:
sollte immer erlaubt sein. Ist bereits eine Sitzung vorhanden,
sollte vor Beginn der neuen Sitzung automatisch von der Kamera geschlossen werden.
Dieser Befehl wurde in API-Level 2 eingestellt.
Parameter
- timeout (optional): Angefordertes Zeitlimit für Sitzungen in Sekunden.
Wird er weggelassen (HTTP-Anfrage ohne Textkörper), sollte die Kamera einen sinnvollen
Timeout festlegen.
Ergebnisse
- sessionId::Eindeutige Sitzungs-ID des Typs String.
- timeout:Bestätigtes Zeitlimit für Sitzungen in Sekunden.
Fehler
- invalidParameterName:Der Name des Eingabeparameters wurde nicht erkannt.
- invalidParameterValue::Der Name des Eingabeparameters wird erkannt, aber der Parameter
Der übergebene Wert ist ungültig. Beispiel: Der Wert liegt außerhalb des zulässigen Bereichs oder die zugehörigen Daten
-Typ 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."
}
} |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-08-21 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-08-21 (UTC)."],[[["\u003cp\u003eStarts a session that locks the camera to the requesting client and keeps it awake, timing out after a specified or default interval.\u003c/p\u003e\n"],["\u003cp\u003eA new session can always be started, automatically closing any existing session.\u003c/p\u003e\n"],["\u003cp\u003eThis command, deprecated in API level 2, returns a unique session ID and the confirmed timeout duration.\u003c/p\u003e\n"],["\u003cp\u003ePossible errors include invalid parameter names or values, or the camera already being in exclusive use.\u003c/p\u003e\n"]]],["The core action initiates a timed camera session, locking the camera to the client and ensuring it remains active. A new session is always permitted, automatically ending any existing session. The user can optionally specify a session timeout in seconds; otherwise, the camera sets a default. The output includes a unique session ID and the confirmed timeout. Errors can occur if parameter names or values are invalid. This command has been deprecated after API level 2.\n"],null,["# camera.startSession\n\nStarts a session that times out after a fixed interval. Locks the camera to the\nrequesting client and makes sure the camera stays awake. Please note, starting\na new session should always be allowed. If there is an existing session, it\nshould be closed automatically by the camera before starting the new session.\n**This command was deprecated in API level 2.**\n\nParameters\n----------\n\n- **timeout:** (Optional) Requested session timeout in seconds. If omitted (HTTP request has no body), the camera should determine a reasonable timeout.\n\nResults\n-------\n\n- **sessionId:** Unique session identifier of type string.\n- **timeout:** Confirmed session timeout in seconds.\n\nErrors\n------\n\n- **invalidParameterName:** The input parameter name is unrecognized.\n- **invalidParameterValue:** The input parameter name is recognized, but the passed value is invalid; for example, the value is out of range or its data type is incorrect.\n\n| Command I/O ----------- ||\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| **Command Input** | ```text { \"parameters\": { \"timeout\": 50 } } ``` |\n| **Command Output** | ```text { \"results\": { \"sessionId\": \"12ABC3\", \"timeout\": 50 } } ``` |\n| **Command Output (Error)** | ```povray { \"error\": { \"code\": \"cameraInExclusiveUse\", \"message\": \"Camera already in exclusive use, new session can't be started.\" } } ``` |"]]
