camera.startCapture
次の値に応じて、動画キャプチャまたはインターバル画像キャプチャを開始します。
captureMode
(オプション)
このコマンドは API レベル 2 で追加されました。
パラメータ
- このコマンドのリクエスト本文にパラメータはありません。インターバル画像かどうか
キャプチャまたは動画キャプチャは、
captureMode
オプションによって決まります。
インターバル キャプチャの場合、オープンエンドのキャプチャであるかどうかは、
captureNumber
が 0 以上かどうかを示す値。
captureMode
、captureInterval
、
インターバル キャプチャの前に captureNumber
を設定する必要があります。
「動画」に設定する必要があるのは captureMode
のみです動画の前
このキャプチャは camera.stopCapture コマンドでのみ停止できます。
結果
- オープンエンドのキャプチャ(CaptureMode == "video" または captureNumber == 0 の場合)
<ph type="x-smartling-placeholder">
- 無制限のインターバル キャプチャ:
<ph type="x-smartling-placeholder">
</ph>
- fileUrls: 画像を指す絶対 URL のリスト
間隔キャプチャ用のファイルです。このコマンドは何も返されないことに注意してください。
キャプチャが完了するまで、直ちに
fileUrls
完了するまで captureNumber
。コマンドの進行状況は、
カメラを定期的にポーリングして取得します。たとえば、アンケートが
推定所要時間(time = captureInterval * (captureNumber - 1)
)
/osc/commands/status API を使用する
fileUrls
はコマンド終了時に返される結果です。
コマンドが正常に完了しなかった場合(たとえば、
(カメラのバッテリーが切れる前に撮影)や、カメラを接続解除する前に撮影された画像などが該当します。
コマンドが成功した場合
クライアントが
camera.listFiles
後でクライアントとカメラの間に新しい接続が確立されたとき。
エラー
- disabledCommand: コマンドは現在無効になっています。たとえばカメラ
動画キャプチャまたはインターバル キャプチャの途中です。
- invalidParameterName: パラメータ名を認識できません。たとえば
sessionId
を認識できません。
コマンド I/O |
コマンド入力 |
none |
コマンド出力 |
{ "results": { "fileUrls":[ "url1", "url2", "url3", ... "urln" ] } } |
コマンド出力(エラー) |
{ "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-08-21 UTC。
[null,null,["最終更新日 2024-08-21 UTC。"],[[["Initiates either video or interval image capture based on pre-set capture mode."],["For interval capture, `captureMode`, `captureInterval`, and `captureNumber` options must be configured beforehand."],["For video capture, only `captureMode` needs to be set to \"video\" and can be stopped using the `camera.stopCapture` command."],["The command results for non-open-ended interval capture include a list of image URLs accessible after capture completion, retrievable via polling or `camera.listFiles`."],["Errors like \"disabledCommand\" occur if the camera is already capturing or \"invalidParameterName\" if an unrecognized parameter is used."]]],["This command initiates video or interval image capture based on the `captureMode` setting. For interval capture, `captureNumber` determines if it's open-ended; `captureInterval` and `captureNumber` must be preset. Video capture, set by `captureMode`, is ended via `camera.stopCapture`. Open-ended capture has no immediate results. Non-open-ended interval capture eventually provides a `fileUrls` list, accessible after the completion time or if interrupted. Errors include `disabledCommand` and `invalidParameterName`. The command's input is null, and output results with file URLs.\n"]]