カスタムカメラ

HomeBe·at は Home Assistant で管理されていないカメラもストリーミングできます。RTSP、RTMP、または HLS ストリームをアプリに直接追加するか、go2rtc から自動的に検出させることができます。

go2rtc 自動検出

Home Assistant インスタンスが go2rtc を実行している場合(HA 2024.11 以降内蔵)、HomeBe·at は接続時に利用可能なすべてのストリームを自動的に検出します。検出されたストリームは RTSP とスナップショット URL が事前入力されたカスタムカメラとして追加されます。

仕組み

  1. HomeBe·at が Home Assistant に接続すると、ポート 11984(HA 管理)または 1984(スタンドアロン)で go2rtc API を探索します。
  2. 既存の Home Assistant カメラエンティティと一致するストリームは RTSP URL オーバーライドを取得し、HA のプロキシを経由せずに直接 RTSP でストリーミングできるようになります。
  3. HA エンティティと一致しないストリームはカスタムカメラとして追加されます。
  4. 検出されたカメラはデフォルトで無効として追加されます。設定で必要なものを有効にしてください。
  5. RTSP ストリームはローカルネットワークでのみアクセス可能なため、すべての URL にはローカルの HA ホストが使用されます。

スナップショット

検出されたカメラは go2rtc の API(/api/frame.jpeg)経由でスナップショット URL を取得するため、アクティブにストリーミングしていないときでもカメラのサムネイルが表示されます。

検出されたカメラの編集

自動検出されたカメラは通常のカスタムカメラです。名前の変更、ストリーム URL の変更、スナップショット URL の更新、削除が可能です。検出されたカメラを削除して再接続すると、次の検出時に再追加されます。

カスタムカメラを使用するタイミング

カスタムカメラは、Home Assistant に追加せずにストリーム URL を直接監視したい場合に便利です。一般的な使用例:

  • ローカルネットワーク上の RTSP ストリーム付き IP カメラ
  • Blue Iris や Frigate などの NVR からの RTMP ストリーム
  • サードパーティサービスからの HLS ストリーム
  • HA の連携機能でサポートされていないカメラ
  • HA カメラエンティティとして登録されていない go2rtc のストリーム(例:3D プリンターカメラ、ベビーモニター)

対応プロトコル

プロトコルURL 形式備考
RTSPrtsp://user:pass{'@'}ip:554/streamIP カメラで最も一般的
RTMPrtmp://ip:1935/live/streamNVR の再ストリームで一般的
HLShttp://ip:8080/stream.m3u8HTTP ベース、遅延が大きい

カスタムカメラの追加

手動で追加

1
設定を開く

HomeBe·at のメニューバーから設定パネルを開きます。

2
カスタムカメラに移動

カスタムカメラのセクションに移動します。

3
ストリーム URL を追加

カメラの名前を入力し、ストリーム URL を貼り付けます。HomeBe·at がプロトコルを自動検出します。

go2rtc 検出経由

go2rtc から検出されたカスタムカメラは、接続時に自動的に追加されます。上記の go2rtc 自動検出をご覧ください。

PTZ 操作

カスタムカメラが ONVIF または Home Assistant 経由で公開される他のプロトコルで PTZ(パン/チルト/ズーム)をサポートしている場合、HomeBe·at は PTZ コントロールを自動的に検出して有効にします。方向リングとズームボタンは HA 管理カメラと同様に動作します。

注意: カスタムカメラは Home Assistant のカメラと一緒にカメラグリッドに表示され、ビューポートに追加できます。カスタムカメラでは Home Assistant のバイナリセンサーが必要なため、検知アラートは利用できません。