camera.startSession

一定の間隔でタイムアウトするセッションを開始します。カメラをリクエスト元のクライアントにロックし、カメラが動作状態を維持します。新しいセッションの開始は常に許可される必要があります。既存のセッションがある場合は、新しいセッションを開始する前に、カメラによって自動的に閉じる必要があります。このコマンドは 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."
    }
}