camera.processPicture

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

以前にキャプチャしたものの、まだ処理されていない画像を処理します。処理に時間がかかるため、このコマンドは delayProcessing をサポートしている場合にのみ使用できます。delayProcessing をサポートしていない場合、このコマンドのリクエストは失敗し、エラーコード disabledCommand が返されます。このコマンドは API レベル 2 で追加されました。

パラメータ

  • previewFileUrls: 未処理の画像の URL のリスト。カメラで未処理の画像をすべて処理する場合は、[all] を指定します。空にすることはできません。カメラで画像の処理に問題がある場合、カメラはエラーではなく応答します。代わりに、その URL を無視して処理を続ける必要があります。極端なケースとして、previewToFinalFileUrls が空の JSONObject として返される場合があります。

結果

  • previewToFinalFileUrls: <key, value=""> ペアの JSONObject。ここで、各キーはプレビュー画像の絶対 URL です。各キーは対応する最終処理画像であり、カメラから直接ダウンロードできます。このコマンドは camera.takePicture に類似しており、処理(カメラ内の合成を含む)が完了するまでに時間がかかる(数秒から数分)ため、previewToFinalFileUrls はすぐに返されません(この段落で後述する特殊なケースを除く)。コマンドの進行状況は、/osc/commands/status API を使用して定期的にカメラにポーリングすることで取得され、previewToFinalFileUrls はコマンドの終了時に返されます。コマンドが完了する前にカメラへの接続が切断された場合、クライアントは listFiles を使用して再度カメラに接続したときに最終画像の URL を取得できます。また、別のプロセス画像コマンドを発行すると、再接続前に画像がすでに処理されている場合は、直ちに previewToFinalFileUrls が返されます。</key,>

エラー

  • disabledCommand: 遅延処理をサポートしていない場合。
  • invalidParameterName: 入力パラメータ名を認識できない。
  • invalidParameterValue: 入力パラメータ名が認識されますが、値が無効です。たとえば、previewFileUrls の URL は無効です。

コマンド I/O

コマンド入力
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
コマンド出力
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
コマンド出力(エラー)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}