HomeAssistant (HA) 2025.12.2 以降のバージョンで Hikvision カメラを接続する最良の方法は、実は名前に Hikvision と付く古い統合（主にアラーム状態しか見られず、映像は見られません）ではなく、ONVIF プロトコルを使うことです。
かみ砕いて説明します：ONVIF はカメラ界の「標準語」だと考えてください。Hikvision には独自の「方言」（独自プロトコル）があり、HomeAssistant が完全には理解できないことがあります。しかしカメラに「標準語」を話させれば（ONVIF を有効化）、HomeAssistant はすぐに理解します。映像を直接見られるだけでなく、カメラで設定した動作検知アラームも自動的に検出します。
以下は 2025.12.2 バージョンに基づく詳しい初心者チュートリアルです。最も重要な手順は実はカメラ側にあるので、必ずステップ1をよく読んでください。
ステップ1：Hikvision カメラの管理画面で「標準語の資格を取る」（ONVIF を有効にする）
多くの初心者がここでつまずきます。Hikvision は既定で ONVIF が無効になっており、しかも ONVIF のアカウントとパスワードはカメラのログイン用アカウントとパスワードとは別なのです。
- パソコンのブラウザでカメラにログイン： ブラウザのアドレスバーにカメラの IP アドレス（例：192.168.1.64）を入力し、管理者アカウントとパスワードでログインします。
- 設定の入口を探す： 上部メニューの 構成 (Configuration) -> 左側メニューの ネットワーク (Network) -> 詳細設定 (Advanced Settings) -> 統合プロトコル (Integration Protocol) をクリックします。
- ONVIF を有効にする：
- ONVIF を有効化 (Enable ONVIF) にチェックを入れます。
- ここがポイント：下の 追加 (Add) ボタンをクリックし、HA 専用の ONVIF ユーザーを作成します。
- ユーザー名：ha_admin を推奨します（カメラのログインアカウント admin と混同しないでください）。
- パスワード：自分だけが知っているパスワードを設定します（英数字のみを推奨、複雑すぎる記号は避けます）。
- 権限：ユーザータイプとも言い、管理者 (Media User/Operator/Admin) を選択します。権限不足を避けるため管理者を推奨します。
OK をクリックして保存します。
時刻を同期する（落とし穴対策）：システム (System) ->システム設定 (System Settings) ->時刻設定 (Time Settings) に進みます。カメラの時刻が HA の時刻と一致していることを確認します（できれば両方で NTP を有効にします）。時刻が合わないと認証に失敗します。
ステップ2：HomeAssistant でカメラを「受け取る」
ステップ1を終えると、カメラは「標準語」を話せるようになりました。HA に戻って追加しましょう。
統合ページを開く：HA の左側メニューで 設定 (Settings) ->デバイスとサービス (Devices & Services) をクリックします。
統合を追加：右下の + 統合を追加 (+ ADD INTEGRATION) ボタンをクリックします。
ONVIF を検索：検索ボックスに ONVIF と入力し、表示されたアイコンをクリックします。
情報を入力：ここでダイアログが表示されます。運が良ければ HA がカメラを自動検出しているので「送信」を押すだけで済みます。自動検出されない場合は手動で入力します：
ホスト (Host)：カメラの IP アドレス（例：192.168.1.64）を入力します。
ポート (Port)：既定は 80 です。うまくいかず、設定を変えていない場合、古い Hikvision 機種では 8000 や 8080 のこともありますが、ほとんどの場合は空欄または 80 で構いません。
名前 (Name)：カメラに名前を付けます。例えば「玄関」など。
ユーザー名：
注意！
ここにはステップ1で専用に作成した ONVIF ユーザー名（例：ha_admin）を入力します。カメラにログインする admin ではありません。
パスワード：ステップ1で設定した ONVIF パスワードです。
完了：送信をクリックします。エラーがなければ、HA は検出したデバイス（メインストリーム、サブストリーム、各種センサー）を部屋に割り当てるよう求めます。そのまま完了をクリックします。
ステップ3：映像をダッシュボードに出す
- HA の 概要 (Overview) ページに戻ります。
- 右上の 鉛筆アイコン (ダッシュボードを編集) をクリックします。
- 右下の + カードを追加 (Add Card) をクリックします。
- 画像概要 (Picture Glance) または 画像エンティティ (Picture Entity) を検索します。
- 「エンティティ (Entity)」欄で、先ほど追加したカメラエンティティ（通常 camera.damenkou_main_stream のような名前）を選択します。
- これで映像が見えるはずです（通常は数秒ごとに更新される静止画で、クリックするとライブ配信になります）。
- 注：低遅延のリアルタイム映像が欲しい場合は、カード設定で「表示方法」を次に設定することをおすすめします：
よくある失敗事例と応急処置 (Troubleshooting)
- 問題A：「認証に失敗しました」または「接続できません」と表示され続ける。
- 原因1：カメラのログインパスワードを使っており、ONVIF ユーザーのパスワードを使っていない。ステップ1をもう一度確認してください。
- 原因2：Hikvision のセキュリティ設定で「不正ログインのロック」が有効になっている。カメラの管理画面 ->システム ->セキュリティ ->セキュリティサービス に進み、「不正ログインのロックを有効にする」を一時的にオフにするか、カメラを再起動してロックを解除します。
- 原因3：認証タイプの問題。カメラ管理画面の 統合プロトコル ページで、ONVIF 認証 (ONVIF Authentication) や Web 認証 (Web Authentication) の項目があれば、Digest/Basic または Digest（できるだけ Basic と互換）を選んでいることを確認してください。
問題B：映像は見えるが非常にカクつき、十数秒の遅延がある。
- これは正常です。HA 標準のストリーミングには遅延があります。
- 最適化方法：HA の統合でこのデバイスを開き、既定のプレビューとして Substream（サブストリーム）を使用する にチェックを入れます。メインストリームの 4K は画質が大きすぎて WIFI が耐えられないからです。
- または、カードの「ストリームをプリロード (Preload stream)」にチェックを入れます。
問題C：ONVIF がどうしても追加できない。
- 代替案：Generic Camera (汎用カメラ) 統合を使います。
- 統合を追加するときに Generic Camera を検索します。
- 静止画像 URL: http://admin:パスワード@IPアドレス:80/ISAPI/Streaming/channels/101/picture
- ストリーミングソース URL (RTSP): rtsp://admin:パスワード@IPアドレス:554/Streaming/Channels/101
- （注意：ここで使うのはカメラにログインする admin とパスワードであり、ONVIF のものではありません。）
このチュートリアル通りに進めれば、99% の Hikvision カメラが 5 分以内に Home Assistant 2025.12 に接続できます。成功を祈ります！
