一定の間隔でタイムアウトするセッションを開始します。カメラをリクエスト元のクライアントにロックし、カメラが動作状態を維持します。新しいセッションの開始は常に許可される必要があります。既存のセッションがある場合は、新しいセッションを開始する前に、カメラによって自動的に閉じる必要があります。このコマンドは API レベル 2 で非推奨になりました。
パラメータ
- timeout:(省略可)リクエストされたセッション タイムアウト(秒単位)。 省略した場合(HTTP リクエストに本文がない場合)、カメラは妥当なタイムアウトを判断します。
結果
- sessionId: 文字列型の一意のセッション ID。
- timeout: 確認済みのセッション タイムアウト(秒単位)。
エラー
- invalidParameterName: 入力パラメータ名を認識できません。
- invalidParameterValue: 入力パラメータ名は認識されましたが、渡された値が無効です。たとえば、値が範囲外であるか、データ型が正しくありません。
コマンド I/O | |
---|---|
コマンド入力 | { "parameters": { "timeout": 50 } } |
コマンド出力 | { "results": { "sessionId": "12ABC3", "timeout": 50 } } |
コマンド出力(エラー) | { "error": { "code": "cameraInExclusiveUse", "message": "Camera already in exclusive use, new session can't be started." } } |