カメラの追加

ONVIF 自動検出（推奨）

カメラと SkyView が同じ LAN 上にあり、カメラで ONVIF が有効になっている場合（出荷時デフォルトで有効）：

1. 1

   スキャン

   Web 管理画面 → カメラ管理 → 追加 → 「ONVIF 自動検出」を選択すると、数秒で LAN 内のすべての ONVIF 機器が一覧表示されます

2. 2

   対象を選択

   IP / MAC / メーカーが自分のカメラと一致するものを確認し、選択します

3. 3

   認証情報を入力

   ONVIF のユーザー名とパスワード（RTSP のパスワードと同じとは限りません！Hikvision / Dahua は出荷時 admin/12345 のような設定が多いです）

4. 4

   保存

   SkyView が自動的にメイン / サブストリームのアドレスをネゴシエートし、PTZ / 双方向通話のポートも検出してまとめて保存します

手動 RTSP

ONVIF に対応していない、または誤ったアドレスが返される場合は手動方式を使います。メーカーのマニュアルや IPC アプリから RTSP の URL を確認する必要があります。よくある形式：

Tapo / Xiaomi / Wyze などの独自プロトコル → go2rtc ブリッジ

TP-Link Tapo C100/C200/C220、Xiaomi Mi Home、Wyze などのコンシューマー向けカメラは標準の RTSP を有効化していませんが、コミュニティプロジェクト go2rtc を使えばそれらを RTSP にブリッジして SkyView に接続できます。

1. 1

   go2rtc コンテナを起動する

   SkyView と同じマシンで構いません。ポート 1984 は go2rtc の Web UI、8554 は go2rtc が公開する RTSP です。

   bashコピー

   docker run -d --name go2rtc \
     --restart=always \
     --network host \
     -v $(pwd)/go2rtc.yaml:/config/go2rtc.yaml \
     alexxit/go2rtc

2. 2

   go2rtc.yaml でカメラを設定する

   Tapo の例：Tapo アプリのゲストアカウントを使うだけで構いません。

   yamlコピー

   streams:
     livingroom: tapo://guest_password@cameraIP:554/stream1
     kitchen: tapo://guest_password@anotherIP:554/stream1

3. 3

   SkyView にカメラを追加する

   手動 RTSP 方式を使い、URL に rtsp://<go2rtc ホスト IP>:8554/livingroom を入力し、認証情報は空欄のままにします。

サブストリームの意味

ONVIF / 主流の IPC はいずれも 2 本のストリームを提供します：メインストリーム（高画質、Live 視聴用）とサブストリーム（低画質、AI 検出用）です。SkyView は ONVIF で自動的にサブストリームのアドレスを取得します。手動 RTSP の場合は、2 つ目のフィールドにサブストリームの URL を入力することをお勧めします。これにより検出の帯域幅と CPU 使用量を 70% 以上節約できます。

映像コーデック：できるだけ H.264 を選び、H.265 は避ける

H.265 (HEVC) は同じ画質でも H.264 よりビットレートが 40〜50% 低く、一見お得に見えますが、ブラウザでの再生対応が非常に弱いです——ほとんどのユーザーは Web 管理画面で Live や再生を見ようとすると黒画面 / くるくる回るローディング表示になります。カメラを有効化する前にコーデックを H.264 に変更してください。

PTZ 制御（雲台）

ONVIF で接続したカメラが PTZ に対応していれば、Live ページの右下に方向 / ズームボタンが自動的に表示されます。手動 RTSP で接続した場合は自動的には有効化されず、カメラ詳細画面で ONVIF ポート（通常 80 / 8000）と PTZ の認証情報を手動で入力する必要があります。

双方向通話（Talkback）

ONVIF の双方向通話チャンネル（backchannel）に対応したカメラでは双方向通話が行えます（アプリのマイクボタンを押しながら話すと、相手に聞こえます）。Web 管理画面は現時点で双方向通話の開始に対応しておらず、押しながら話すボタンがあるのはモバイル版（iOS / Android）のみです。

カメラの編集 / 削除に関する注意事項

• RTSP URL を変更した後、検出が自動的に再開しないことがあります：そのカメラに対して「検出失敗」のステータス記録が残っているためで、カメラ詳細画面で「検出エラーをクリア」をクリックしないと再度実行されません
• カメラを削除すると、データベースの記録とストリーミングパスも同時に削除されますが、録画ファイルは削除されません——誤って証拠を失わないためです。手動で data/recordings/<id>/ から削除してください
• 名前の変更 / グループの変更は録画やイベント履歴に影響しません

Hikvision / Dahua / TP-Link Vigi（業務用 IPC）

この 3 社は国内で主流の業務用 IPC で、いずれも標準の ONVIF + RTSP に対応しており、SkyView との互換性が最も高いです。出荷時のデフォルト認証情報：

GB28181（中国国家標準 — Hikvision / Dahua / Uniview の NVR·IPC·DVR）

GB/T 28181 対応機器は SkyView に自動登録されます——カメラごとに RTSP アドレスを入力する必要はなく、1 台の NVR 配下の複数チャンネルも一括取り込みできます。Hikvision / Dahua / Uniview の国標 IPC・NVR・DVR の多くは「上位プラットフォーム接続（GB28181）」を内蔵しています。SkyView 0.9.13 以降が必要です。

ステップ 1 — SkyView で GB28181 を有効化

1. 1

   スイッチをオン

   Web Admin → 設定 → GB28181 →「有効化」をオン。

2. 2

   登録パスワードを設定

   機器に入力するプラットフォームパラメータが表示され、登録パスワード（全機器共通）を設定します。既定のパラメータはそのまま使えることがほとんどです。

3. 3

   リモート接続は extern_host を設定

   機器と SkyView が別ネットワークの場合、機器から折り返し到達できる自分側のアドレス（グローバル IP やルーターでマッピングしたアドレス）を「extern_host」に入力します。同一サブネットの直結なら空欄で構いません。

4. 4

   保存

   保存すると GB28181 サービスが 25060 で待ち受けを開始し、機器の登録を待ちます。

ステップ 2 — 機器 / NVR 側で「上位プラットフォーム」を設定

機器の Web 管理画面で「プラットフォーム接続 / GB28181 / 上位プラットフォーム」（呼称はベンダーで異なる）を開き、下表のとおり入力します。保存すると機器が自動登録され、NVR は配下の全チャンネルをまとめて報告します：

ステップ 3 — チャンネルを取り込み、通常のカメラとして使う

Web Admin → GB28181 ページ →「取り込み待ちの機器 / チャンネル」に、登録に成功した機器・NVR チャンネルが表示されます。使うチャンネルにチェックを入れて「取り込み」（複数選択可。NVR の全チャンネルを一度に取り込み）。取り込み後は通常のカメラと同じく、ライブ・録画・AI 検知・スナップショット・オンライン状態・PTZ + プリセット・双方向通話・機器側の録画再生がすべて使え、RTSP / ONVIF カメラと UI 上の違いはありません。