# CIVクラウドカメラ接続 ヘルプ ## 概要 CIVクラウドカメラ接続では、建物のCIVクラウド防犯カメラとUnlockOSを連携します。連携が完了すると、KEYVOXのWebhookで配達が確認されるたびに90秒間の録画クリップが自動的に生成され、居住者はアプリから配達の映像を確認できるようになります。 **仕組みの流れ：** 1. 施設管理者がCIVクラウドアカウントを接続し、カメラ一覧を取得する 2. 各カメラを特定のエントランスに紐付ける 3. 配達が確認されると、UnlockOSが紐付けられたカメラで90秒間の録画を開始する 4. 居住者が配達履歴を開き、再生ボタンをタップして映像を確認する --- ## 事前準備 | 必要なもの | 説明 | |-----------|------| | CIVクラウドアカウント | CIVクラウド監視システムのユーザー名とパスワード | | 稼働中のカメラ | CIVクラウド上でカメラがオンラインかつ映像を取得中であること | | KEYVOX置き配の設定完了 | カメラをマッピングする前に置き配管理（おきはい）の設定が必要 | --- ## セットアップ手順 カメラ接続は2つのステップで行います：(1) CIVクラウドアカウントを接続し、(2) 各カメラをエントランスに紐付けます。 ### Step 1: CIVクラウドアカウントの接続 1. 管理パネルで **接続設定** を開き、**CIVカメラ** タブに移動する 2. CIVクラウドの **ユーザー名** と **パスワード** を入力する 3. **接続** ボタンをクリックする 4. 認証情報が正しければ、接続状態が「接続済み」に変わり、カメラ一覧が自動的に読み込まれる 5. CIVクラウドアカウントに登録されているすべてのカメラが名前とオンライン状態とともに表示される 接続後は、**接続解除** ボタンでいつでも連携を解除できます。 > **注意**: CIVクラウドの認証情報は安全に保存され、保存後は表示されません。 ### Step 2: カメラとエントランスの紐付け 1. 管理パネルで **置き配管理** を開き、**カメラ** タブに移動する 2. 建物のエントランス一覧が表示される（各エントランスは、エントランス設定タブで「入口」に設定されたKEYVOXスマートロックに対応） 3. 各エントランスに対して、そのエントランスを映しているCIVクラウドカメラをドロップダウンから選択する 4. **保存** ボタンをクリックして紐付けを適用する 紐付けが完了したエントランスで配達が確認されると、対応するカメラで録画が自動的に開始されます。 > ドロップダウンにカメラが表示されない場合は、CIVクラウドアカウントが接続されているか（Step 1）、少なくとも1台のカメラがCIVクラウド上でオンラインになっているかを確認してください。 --- ## 居住者向け映像再生 居住者は `resident.unlockos.io/{facility-slug}/` の居住者アプリから配達履歴を確認できます。 ### 録画の視聴方法 1. 居住者アプリを開き、**配達履歴** に移動する 2. 録画が紐付いている配達には **再生ボタン** アイコンが表示される 3. 再生ボタンをタップして動画プレイヤーを開く 4. 90秒間のクリップがHLSストリーミングでアプリ内で再生される > 録画はカメラをエントランスに紐付けた後の配達からのみ利用できます。過去の配達に遡って録画が付与されることはありません。 ### 再生に関する注意事項 - 動画再生には安定したインターネット接続が必要です - 録画が取得できなかった場合（例：配達時にカメラがオフラインだった場合）、再生ボタンは表示されません - 居住者は自分の部屋の配達の録画のみ視聴できます --- ## トラブルシューティング ### 接続が失敗する・認証情報が無効と表示される - CIVクラウドの **ユーザー名**（メールのエイリアスや表示名ではなく正式なユーザー名）と現在のパスワードを使用しているか確認してください - CIVクラウドのWebポータルに直接ログインして認証情報が正しいことを確認してください - CIVクラウドのパスワードを最近変更した場合は、新しいパスワードを入力して再度「接続」をクリックしてください ### 接続後にカメラが表示されない - CIVクラウドアカウントに少なくとも1台のカメラが登録されており、停止・削除状態でないことを確認してください - CIVクラウドポータルでカメラのオンライン状態を確認してください（オンラインのカメラのみUnlockOSに表示されます） - CIVクラウドに最近カメラを追加した場合は、UnlockOSで一度接続を解除して再接続し、カメラ一覧を更新してください ### カメラタブのドロップダウンが空になっている - 接続設定の「CIVカメラ」タブで接続状態が「接続済み」になっているか確認してください - CIVクラウドポータルでカメラがオンラインになっているか確認してください - カメラタブのページを更新してください ### 配達の再生ボタンが表示されない - 録画はKEYVOXで配達が確認された時点でトリガーされます。カメラの紐付けを保存する前に処理された配達には録画がありません - 配達時にカメラがオフラインだった可能性があります。CIVクラウドポータルのカメラ活動ログで録画が行われたか確認してください - 配達確認後、録画が配達記録に紐付くまで数分かかる場合があります ### 動画が再生されない・プレイヤーにエラーが表示される - インターネット接続を確認してください。HLSビデオストリーミングには安定した接続が必要です - 配達履歴ページを閉じて開き直し、再度再生ボタンをタップしてください - 問題が解消しない場合、録画ファイルが正常に取得されていない可能性があります。施設管理者にご連絡ください ### トークン期限切れエラーが表示される - CIVクラウドの認証トークンは一定期間で有効期限が切れます。管理パネルでトークン関連のエラーが表示された場合は、接続設定の「CIVカメラ」タブで一度接続を解除し、認証情報を再入力して再接続してトークンを更新してください --- ## よくある質問 ### Q: 録画はどのくらいの期間保存されますか？ A: 録画の保存期間はCIVクラウドアカウントのストレージプランによって決まります。UnlockOSは動画ファイルを独自に保存せず、CIVクラウドAPIを通じて録画に直接アクセスします。保存期間の上限についてはCIVクラウドのご契約内容をご確認ください。 ### Q: 1つのエントランスに複数のカメラを紐付けられますか？ A: いいえ。各エントランスに紐付けられるカメラは1台のみです。複数のカメラでエントランスをカバーしている場合は、配達エリアを最もよく映しているカメラを選択してください。 ### Q: 1台のカメラを複数のエントランスに紐付けられますか？ A: いいえ。各カメラは同時に1つのエントランスにのみ割り当てられます。 ### Q: カメラは常時録画していますか？それとも配達時のみ録画しますか？ A: 常時録画の設定はCIVクラウドアカウントの設定によって決まります。UnlockOSは配達確認のタイミングで90秒間のクリップを取得する機能を使用しており、常時録画が有効になっている必要はありません。 ### Q: 配達確認時にカメラがオフラインだった場合はどうなりますか？ A: 配達確認自体は成功し、居住者にはエントリーキーが発行されます。ただし、録画は取得されず、その配達の再生ボタンは表示されません。 ### Q: 新しい録画が利用可能になったとき、居住者に通知されますか？ A: UnlockOSは録画のために個別の通知を送信しません。居住者は配達履歴を開いたときに再生ボタンで録画の有無を確認できます。 ### Q: カメラ接続は配達員の操作に影響しますか？ A: いいえ。エントランスでの配達員の操作は変わりません。カメラ録画はKEYVOX Webhookイベントによって配達確認後にバックグラウンドで実行されます。 --- ## 関連ページ - [置き配管理](okihai-manager.md) - 部屋・エントランス設定・配達履歴の設定 - [エントランス設定](okihai-unit-classification.md) - KEYVOXスマートロックを入口・部屋として分類する方法 - [居住者向け置き配サービス](okihai-resident.md) - 居住者向けの配達履歴・映像再生ガイド - [ロック接続](lock-connection.md) - KEYVOXスマートロックの接続