# Home Assistant 統合（HACS）

公式カスタム統合で Yunkan のカメラ・検知・録画を Home Assistant に取り込みます。HACS からワンクリックでインストールでき、MQTT ブローカーは不要です。

Yunkan は公式の Home Assistant カスタム統合を提供開始しました。これは薄いクライアントで、Yunkan サーバーの通常 API と通信し、サーバーの機能を Home Assistant のネイティブエンティティ・メディアブラウザ・サービスにマッピングします。録画・検知・アカウントのロジックはすべてサーバー側に残ります。

[![Open in HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=mrtian2016&repository=yunkan-hass-integration&category=integration)

お使いの Home Assistant の HACS でこのリポジトリをカスタムリポジトリとして開きます。

## できること

- **カメラ**：ネイティブ WebRTC（低遅延、HLS フォールバック）+ JPEG スナップショット——ピクチャーグランスカード、エリアダッシュボード、HomeKit エクスポート、`camera.snapshot`。
- **検知センサー**（カメラごと）：人・車両・動物・荷物・顔・転倒・赤ちゃんの泣き声・動き——認識した名前 / ナンバーも付与。
- **オブジェクト数**センサー + **認識した顔 / ナンバー**センサー。
- **スイッチ**：AI 検知、録画、機能別検知トグル、PTZ 自動追尾——さらにハブ上のサーバー全体検知スイッチ。
- **デバイスページの操作**：スナップショット更新と PTZ 方向ボタン、PTZ プリセットのドロップダウン、音声ブロードキャスト入力欄。
- **デバイストリガーとアクション**（自動化用）、およびすぐ使える通知ブループリント。
- **メディアブラウザ**で録画・イベント・スナップショットを閲覧（Home Assistant 自身の認証を経由）。

## 必要条件

- Home Assistant **2024.11** 以降（ネイティブ WebRTC カメラのため）。
- 到達可能な Yunkan サーバー——メイン入口アドレス（nginx 入口、通常ポート `23406`）を使用。
- Yunkan アカウント。PTZ・検知スイッチ・音声ブロードキャストには **管理者** アカウントが必要。閲覧は任意のアカウントで可能。

## HACS でインストール

1. **HACS で開く**

   上の **HACS で開く** ボタンをクリック（または HACS で右上のメニュー → カスタムリポジトリからリポジトリ URL をカテゴリ *Integration* で追加）。

2. **インストールして再起動**

   HACS で **Yunkan** を検索してインストールし、Home Assistant を再起動します。

3. **統合を追加**

   **設定 → デバイスとサービス → 統合を追加 → Yunkan** を開き、サーバー URL・ユーザー名・パスワードを入力します。

> **ℹ️ カスタムリポジトリとしてインストール**
>
> Yunkan はまだ HACS の既定ストアに載っていません（収録申請を審査中）。そのため**カスタムリポジトリ**としてインストールします——上のボタンがその設定を行います。既定ストアに載れば直接検索できるようになります。

## 無料版 vs Pro

カメラ・スナップショット・イベント・センサー・メディアブラウザ・PTZ はどの Yunkan サーバーでも利用できます。**AI 検知** と **音声ブロードキャスト** は Pro 機能で、無料版ではこれらの操作はアップグレード案内を表示し、無言で失敗しません。

> **💡 MQTT ディスカバリと併用可能**
>
> Yunkan の MQTT ディスカバリも併用している場合、両方の経路は別々のエンティティ ID で共存します。本統合はより充実した Pro 向けの選択肢で、MQTT ブローカーは不要です。

---

来源:https://yun-kan.com/ja/docs/home-assistant