撮影（静止画・録画・巡回撮影・外部送信）

撮影プリセットで決めた向きを静止画か短い録画で撮り、メディアビューワーに保存するか、指定の URL へエッジPC から送る。向きを複数登録すると順に回って撮る（巡回撮影）

カメラの静止画か短い録画を決まった時刻や外部からの合図で撮り、メディアビューワーに保存するか、指定した URL へエッジPC から直接送る機能です（両方も可）。PTZ カメラでは**決めた向きを順に回して撮る（巡回撮影）**こともできます。広い現場を 1 台のカメラでまかない、「あの場所は今どうなっているか」「先月と比べてどう変わったか」を後から見返せます。

• 撮る向き・画質は「撮影プリセット」に、いつ撮るか・どこへ出すかは「撮影ジョブ」に分けて登録します。 1 つのプリセットを複数のジョブで使えます。
• 撮影プリセットに向きを 2 つ以上登録すると、1 回の撮影で順に回って撮ります（巡回撮影）。 向きには現場の呼称（「1 工区」「調整池」「南法面」など）をそのまま付けます。AI エージェントからも同じ言葉で聞けます。
• 出力はジョブごとに選びます。 保存した写真はメディアビューワーで見比べ、ZIP でまとめて保存できます。外部へはエッジPC から送るので、エッジPC から届く URL なら社内 LAN にも送れます。
• 撮るものはジョブごとに静止画か録画かを選びます。 録画は向きごとに決めた秒数だけ撮る短い動画で、常時録画とは別に保存します。
• 起動のしかたは 5 通りです。スケジュール・画面の「今すぐ撮影」・独自コンポーネント（エッジ内）・外部 API・AI アプリのイベント（トリガー）。

すぐ撮影

その場で撮って残すだけなら、設定は要りません。 サイドバーの 「撮影」 を開くと最初に出る 「すぐ撮影」 タブで撮れます。

• カメラが 1 秒ごとの静止画のタイルで並びます（1 ページ 12 台。デバイス一覧と同じ絞り込みができます）。
• 上の 「静止画」 / 「録画」 で撮るものを選びます。録画は長さ（5 / 10 / 30 / 60 秒）も選びます。
• タイルの 「撮影」（録画を選んだときは 「録画」）で、そのカメラを今の向きのまま撮ります。静止画の幅はカメラの保存サイズに従います（既定は原寸）。録画は録り終えるまで通知に「録画しています」と出ます。
• タイルをクリックして選び、「選んだ n 台を撮影」（録画なら 「選んだ n 台を録画」）で複数台をまとめて撮れます。

撮ったものはメディアビューワーに保存され、撮影元が その場で撮影、場所が 今の向き で並びます。静止画は押した瞬間の絵が保存され、その場で通知にも表示されます（一覧に出るまでは数秒かかります）。外部送信先へ送りたいときや、決めた向きで撮りたいときは、撮影ジョブを作って実行してください。 1 台の映像を見ながら撮るなら、ライブ映像の個別画面の「撮影」パネルも使えます。

設定の組み立て

決めた時刻に撮る・決めた向きで撮る・外部へ送るときは、「すぐ撮影」以外の 4 つのタブで設定します。

撮影プリセット

カメラごとに、撮る向きと撮影条件を名前を付けて登録します。ジョブで選ぶと、撮影の直前にこの条件へ切り替えます。

向きの数で撮り方が変わります。

プリセットの一覧の行をクリックすると、向きの一覧が開きます。行の説明には「今の向きのまま撮る」「向き ◯ か所を順に撮る」のように撮り方が出ます。「設定」 で名前・画質・幅・待ちを変え、ゴミ箱のボタンでプリセットを削除します。

• プリセットは撮影ジョブから使われている間は削除できません（「このプリセットを使っているジョブがあるため削除できません」）。
• 向きや画質を指定したのに ONVIF の接続情報が無いカメラでは、撮影を失敗として記録します（違う向きで撮った画像を残さないため）。

向きを登録する

登録するとその向きで 1 枚撮って一覧のサムネイルにします。ジョブで撮る前に画角を確かめられ、撮った写真はそのまま時系列の 1 枚目になります。

呼称は現場で呼んでいる名前にしてください。 AI エージェントは呼称で場所を選ぶので、「調整池はどうなっている？」のような聞き方にそのまま答えられます。

範囲から作る

広い現場を面で覆うときは、1 件ずつ向けずに範囲の端を 2 か所決めて、横 × 縦に等分した区画を向きとして一括で登録できます。向きの一覧の 「範囲から作る」 から開きます。作った区画は、そのプリセットの向きに加わります。

両端の区画はちょうど端 1・端 2 の向きで撮り、その間を等分します。 隣り合う区画がどれだけ重なるかは区画の数で決まるので、サムネイルを見て隙間が空いていれば数を増やして作り直してください。ズームはすべての区画で端 1 を決めたときの値にそろえます。

呼称は後から付け替えて構いません。 付け替えても、それまでの写真は同じ向きの時系列につながります。付け替えなくても撮影は回りますが、番号のままだと AI エージェントに場所の言葉で聞けません。

作った範囲は 「作った範囲」 から選び直して、「この条件で作り直す」 で割り直せます。作り直すとその範囲の向きは置き換わり、呼称が変わった場所の写真は元の呼称の時系列に残ります。範囲の × で、範囲とそこから作った向きを消します（撮った写真は残ります）。「+ 新しい範囲」 で同じプリセットに別の範囲を足せます。「撮影プリセットへ戻る」 で一覧に戻ります。

プリセットの向きは合わせて 200 件までです。手で登録した向きやほかの範囲と足して超える場合は登録できません。

登録した向きを直す

向きの一覧の各行から変えられます。

一覧の 「写真を見る」 で、そのプリセットの写真に絞ってメディアビューワーを開きます。

撮影ジョブ

向きが 2 つ以上あるプリセットを選ぶと、「◯ か所の向きを順に回って撮ります（1 回およそ ◯ 分）」と 1 回の所要時間の目安が出ます。

1 台のカメラに撮影ジョブを複数作れます。日中は 1 時間おきに全体を、夜間は 30 分おきに出入口だけを、のように撮る向き・間隔を分けたいときは、プリセットとジョブを分けて作ります。同じカメラのジョブが重なった場合は、1 件ずつ順に撮ります。 後の撮影は前の撮影が終わるまで待つので、撮れる時刻がずれます。ジョブの編集画面では、同じカメラのほかのジョブと向こう 1 週間で撮影の時間が重なると、相手のジョブ名と重なる回数が出ます。どちらもカメラの向きと画質を変えないジョブ同士（今の向きのまま撮るだけ）は、重なっても写真が変わらないので出しません。

出力

外部送信先がまだ無いときは、先に「外部送信先」タブで登録してください。

録画のジョブ

「撮るもの」で 「録画」 を選ぶと、向きへ振って落ち着くのを待ってから、選んだ秒数だけ録画します。巡回撮影では向きごとに 1 本ずつ撮ります。

• MP4（H.264）で保存し、音声は入りません。 カメラの映像が H.265 のときは、ブラウザで再生できるよう H.264 に変換して保存します（録っている間だけエッジPC の CPU を使います）。
• 録っている間はカメラを占有します。 同じカメラのほかの撮影は、録り終えるまで待ちます。長い録画を向きの多いプリセットで撮ると 1 回の時間が長くなるので、所要時間の目安と重なりの注意を確かめてください。
• 常時録画とは別に保存します。 常時録画の保持日数では消えず、写真と同じく保存先の空きが足りなくなったときだけ古いものから消えます。
• 画像の幅（撮影プリセット）は録画には効きません。 H.265 を変換するときだけ幅 1920px までに縮めます。

スケジュール

cron 式は、毎月 1 日・第 2 火曜のように一定間隔・決まった時刻では表せない予定に使います。

• 曜日と時間帯は式の中で指定します（cron 式では曜日のチェックと開始・終了時刻は使いません）。
• 秒・年のフィールド、@hourly などの別名、H は使えません（「cron 式は「分 時 日 月 曜日」の 5 つを空白で区切って指定してください」と出ます）。
• 入力すると 次の撮影 の時刻が 5 回分出るので、意図どおりか確かめてから保存してください。

どの種類でも次のとおりです。

• 時刻はエッジPC の現地時刻で指定します。 画面には 時刻は現地時刻（America/New_York）で指定します。 のようにタイムゾーンが出ます。タイムゾーンはエッジPC の詳細画面で変えられます（→ タイムゾーン）。画面に出る次の撮影の時刻は目安です。
• 夏時間のある地域では、切り替わる日も現地の時刻どおりに撮ります。春に飛ぶ時刻（例: 02:30）はその直後に撮り、秋に 2 回来る時刻は 1 回だけ撮ります。
• 撮影は区切り（定刻）から 5 分以内に始めます。エッジPC が止まっていて区切りを 5 分以上過ぎた分は、後から撮り直しません。
• 前回の撮影がまだ終わっていない場合、その回は撮らずに見送ります。
• スケジュールはエッジPC が単独で動かします。回線が切れても撮影は続き、送れなかった画像は後で再送します（下記「送信と再送」）。

今すぐ撮影（手動）

ジョブ一覧の 「今すぐ撮影」 で 1 回撮り、出力へ出します。結果は撮影ログとメディアビューワーで確かめます。無効のジョブでは押せません。ライブ映像の個別画面の「撮影」パネルでも、そのカメラの有効なジョブを選んで 「今すぐ撮る」 で同じように撮れます。

エッジ内（独自コンポーネント）から起動する

ジョブで 「エッジ内（カスタム処理のコンテナ）からの起動を許可する」 にチェックを入れると、同じエッジPC で動く独自コンポーネントから撮影を起動できます。独自の検知処理の結果に合わせて画像を撮って送る、といった使い方ができます。

curl -X POST http://host.docker.internal:3001/local/capture-jobs/<キー>/run \
  -H "Authorization: Bearer <トークン>" \
  -H "Content-Type: application/json" \
  -d '{"source":"my-component","payload":{"reason":"検知"}}'

起動を許可したジョブの一覧は GET http://host.docker.internal:3001/local/capture-jobs（同じトークン）で取れます。

AI アプリのイベントで起動する

物体検出・ナンバープレート検知の詳細画面の「連携」で、このジョブを動かすトリガーを作れます。在/不在のルールが切り替わったときや、ナンバーを新しく読んだときに撮影します（→ AI アプリを使う）。ジョブ側で許可を入れる必要はありません。外部送信先へは、イベントの内容が payload として届きます。

{
  "trigger": { "id": "…", "name": "入口に人が来たら撮る" },
  "event": {
    "id": "…",
    "deviceId": "…",
    "ts": "2026-09-28T03:00:00.000Z",
    "eventType": "presenceStart",
    "ruleId": "r1a2b3c",
    "detail": { "ruleName": "入口", "matchedCount": 1, "detections": [{ "label": "person", "confidence": 0.87, "bbox": { "x": 0.42, "y": 0.31, "width": 0.1, "height": 0.35 } }] }
  }
}

ナンバーを読んだときは eventType が plateRead になり、detail に plate（番号）・confidence（確信度）・bbox（プレートの枠）が入ります。payload が 4KB を超えるときは detections を省きます。

外部 API から起動する

ジョブで 「外部 API（API トークン）からの起動を許可する」 にチェックを入れると、外部のシステムから撮影を起動できます。

curl -X POST https://api.thingsconnect.app/api/v1/capture/jobs/<ジョブ ID>/run \
  -H "Authorization: Bearer <API トークン>" \
  -H "Content-Type: application/json" \
  -d '{"payload":{"orderId":"A-123"}}'

• 応答は 202 {"runId": "..."} です。エッジPC が依頼を受け付けて保存した時点で返るので、撮影と送信の結果は GET /api/v1/capture/runs/<runId> で確かめます（同じトークンで呼べます）。応答の run にその回の状態と撮れた枚数・失敗した枚数が、deliveries に写真 1 枚ごとの撮影と送信の結果が入ります。
• 受け付けた依頼はエッジPC に保存されるので、撮影の前にエッジPC が再起動しても、起動後に撮影します（依頼から 10 分を過ぎても撮り始められなかったものは撮らずに 失敗 にします）。
• 許可していないジョブは 403、無効なジョブは 409、エッジPC に届かなかった場合は 502 を返します。
• 「撮影」スコープのトークンでは、ほかに GET /api/v1/capture/jobs（ジョブ一覧）・GET /api/v1/capture/deliveries（撮影ログ）を呼べます。項目の詳細は REST API を参照してください。

撮影はどう進むか

1 回の撮影では、プリセットの向きを登録した順に 1 つずつ、その向きへ振る → 止まるのを待つ → ブレと AF が収まるのを待つ（既定 2 秒）→ 撮るを繰り返します。撮った写真は 1 枚ずつ出力へ出します（外部送信先へは 1 枚ごとに送ります）。

• 人や AI がカメラを操作すると、撮影は今の向きで止まります。 操作が 60 秒止んでから、その回でまだ撮っていない向きだけを続けます。操作が入った向きの写真は保存しません（別の場所を向いた写真がその向きの時系列に混ざるのを防ぐため）。
• 手動（今すぐ撮影）・外部 API・AI エージェントの撮影は、スケジュールの撮影に割り込みます。 割り込んだ撮影が終わると、スケジュールの撮影の続きを撮ります。
• 止まったまま 1 時間経った回と、次のスケジュールの枠が来た回は打ち切ります（頼まれた時点の写真にならないため）。
• 撮影プリセットの 「撮る」 と AI エージェントの capture は、向きを 1 つその場で撮ってメディアビューワーに保存します（外部へは送りません）。撮影中のジョブには割り込み、ジョブは後で残りを撮ります。

外部送信先

ヘッダの値と HMAC の鍵は暗号化して保存し、登録後は画面に表示しません。 編集するときは値を変える行だけ入力します（空欄の行は登録済みの値のまま）。署名をやめるときは 「署名をやめる」 にチェックを入れます。Content-Type・Content-Length・Host・X-Signature・X-ThingsConnect- で始まるヘッダは送信時に付けるものなので指定できません。

外部送信先は撮影ジョブから使われている間は削除できません（「この外部送信先を使っているジョブがあるため削除できません」）。

受け取る側の形式

写真 1 枚（録画は 1 本）ごとに 1 回送ります。 巡回撮影では、1 回の撮影で向きの数だけ届きます。どの形式でも、送信の ID を X-ThingsConnect-Delivery-Id ヘッダで付けます。再送しても同じ値なので、受け取る側はこれで重複を捨てられます。送信先が 2xx を返したら成功とみなします。

一緒に送る情報（メタデータ）は次のとおりです。

録画のジョブでは、画像の代わりに録画（MP4）を送ります。 multipart/form-data はフィールド名が video（video/mp4 のファイル）、JPEG そのまま は本文が MP4 で Content-Type: video/mp4、JSON は "video": { "contentType": "video/mp4", "base64": "..." } になります。JSON の形式は録画を base64 にするので 1.3 倍ほど大きくなります。受け取る側の本文の上限に注意してください。

JPEG そのまま の形式で付けるヘッダです（値の無い項目のヘッダは付けません）。

日本語を含む名前（ジョブ名・カメラ名・プリセット名・向きの名前）は URL エンコードして送ります。

HMAC 署名を設定した場合は、送った本文のバイト列そのもの（multipart は境界を含めた全体）に対する HMAC-SHA256 を X-Signature: sha256=<16 進> で付けます。受け取る側で同じ鍵で計算して一致を確かめてください。

送信と再送

• 撮った画像はいったんエッジPC に保存し、外部送信先ごとに撮った順で 1 件ずつ送ります。
• 送れなかった場合は 30 秒後から間隔を倍々に空けて（最大 30 分）再送し、10 回、または撮影から 24 時間で諦めます（放棄）。
• 再送は送る時点の外部送信先の設定を使います。URL やヘッダを直せば、溜まっている分にも効きます。
• エッジPC に溜められるのは 500 件・1GB までで、超えた分は古いものから諦めます。

撮影ログ

「撮影ログ」 タブに、直近 30 日の写真 1 枚ごとの撮影と外部送信の結果が出ます。ジョブ・状態・トリガーで絞り込めます。「ジョブ / 向き」 欄に、ジョブ名と撮影プリセット・向きの名前が出ます。外部送信先へ送った画像はクラウドに残しません（残すには出力で「メディアビューワーに保存する」を選びます）。

撮影・再送の結果は、撮影ログに出るまで少し遅れます。

手動・外部 API で依頼してから 15 分経っても撮影の報告が届かない場合は 失敗（「エッジPC から撮影の報告が届きませんでした」）にします。 エッジPC が止まったときなどに、結果が分からないまま残り続けるのを防ぐためです。後からエッジPC の報告が届いた場合は、その結果で上書きします。

カメラの詳細画面

カメラの詳細画面（「デバイス」 から開く）の 「撮影」 タブに、そのカメラの撮影の様子が出ます。

「写真を見る」 でそのカメラに絞ったメディアビューワーを開きます。「ジョブを見る」（ジョブが無いときは 「ジョブを設定する」）では撮影の画面、「撮影ログを見る」 では撮影ログを開きます。

エッジPC からメディアビューワーへ登録できなかった写真がある場合は、その枚数が出ます。 登録を繰り返し断られた場合に起きます（回線が切れている間は数えず、つながってから登録します）。その時刻の写真はメディアビューワーに出ません。

写真を見る・保存先

保存した写真は メディアビューワー で、撮影プリセットと向き（現場の呼称）ごとの時系列で見ます。2 時点の比較・1 枚ずつの保存・ZIP でのまとめて保存・タイムラプス動画づくりができます。

「メディアビューワーに保存する」を選んだ写真は撮ったエッジPC に置かれます。お客様側での準備は要りません。 画面で開くときにエッジPC から読み出すので、エッジPC がオフラインの間は開けません。写真は録画と同じ保存先に置かれ、空き容量が少なくなると古いものから削除されます（→ メディアビューワーの保存先と保持）。

カメラ・撮影ジョブ・撮影プリセット・向きを削除しても写真は残ります。 カメラを削除すると、そのカメラの撮影ジョブと撮影プリセットも削除されます。

AI エージェントから聞く

MCP で接続すると、現場の呼称のまま問い合わせられます（→ 利用可能な MCP ツール一覧）。

• list_presets — 撮影プリセットと向き（見られる場所）の一覧
• get_snapshot — 指定した時点に最も近い 1 枚
• compare — 2 時点を並べて取得
• capture — 向きを 1 つその場で撮る（ジョブの撮影に割り込み、あとで残りを撮ります）
• list_capture_jobs / list_capture_deliveries / run_capture_job — 撮影ジョブの一覧・撮影ログ・実行

呼称は表記ゆれを吸収するので、「調整池」でも「調整」でも引けます。

運用上の注意

• 巡回撮影をするカメラで常時録画をするときは、定位置を決めてください。 巡回している間は録画の画角も変わります。定位置を決めておけば撮り終えたときにそこへ戻り、決めていなければ最後の向きのまま録画を続けます。ジョブの編集画面にもその旨が出ます。
• 巡回撮影をするカメラを AI 推論の入力に使わないでください。 移動中のフレームで推論すると誤った結果が出ます。
• 夜間の巡回撮影は想定していません。 赤外線照明が届くのは 80〜100m 程度で、遠方は写りません。
• カメラの左右・上下の反転は、向きを登録する前に決めてください。 後から切り替えると、登録済みの向きが反対側を向きます（→ ONVIF カメラを操作する）。
• 工事の進行で画角が合わなくなったら、向きの一覧の「変更」で向きを直してください。 呼称を変えなければ、それまでの写真と同じ時系列につながります。