セッション タイムアウトを更新します。セッションはカメラに対してなんらかの操作を行うと自動的に更新されます。たとえば、10 分間のタイムアウトで開始されたセッションは、takePicture
コマンドを実行すると 10 分間にリセットされます。このコマンドは API レベル 2 で非推奨になりました。
パラメータ
- sessionId: 文字列型の一意のセッション ID。
- timeout:(省略可)リクエストされたセッション タイムアウト(秒単位)。 省略した場合(HTTP リクエストに本文がない場合)、カメラは妥当なタイムアウトを判断します。
結果
- sessionId: コマンドに渡された確認済みのセッション識別子の文字列。
- timeout: 確認済みのセッション タイムアウト(秒単位)。
エラー
- missingParameter:
sessionId
がありません(たとえば、sessionId
が指定されていません)。 - invalidParameterName: 1 つ以上の入力パラメータ名を認識できません。
- invalidParameterValue: 入力パラメータ名は認識されましたが、渡された値が 1 つ以上無効です。たとえば、
sessionId
が存在しない、アクティブでなくなっている、データ型が正しくない、timeout
のデータ型が間違っているなど。
コマンド I/O | |
---|---|
コマンド入力 | { "parameters": { "sessionId": "12ABC3", "timeout": 50 } } |
コマンド出力 | { "results": { "sessionId": "12ABC3", "timeout": 50 } } |
コマンド出力(エラー) | { "error": { "code": "missingParameter", "message": "Parameter sessionId is missing." } } |