鸟瞰图（Birdseye）

Birdseye 会把多台摄像头合成为一个动态总览画面。它特别适合电视墙、Home Assistant 仪表盘或只想查看“当前有活动”的摄像头。Birdseye 画质来自 detect 流，而不是 record 主码流。

显示模式

模式	行为
continuous	持续显示符合条件的摄像头。
motion	近期检测到运动的摄像头进入 Birdseye。
objects	近期存在被跟踪目标的摄像头进入 Birdseye。

示例

birdseye:
  enabled: true
  mode: objects
  layout:
    max_cameras: 4
    scaling_factor: 2.0

摄像头级覆盖

可以全局启用 Birdseye，再对某一摄像头单独禁用或改成不同模式。这样能排除室内隐私摄像头、测试视频或没有必要出现在总览中的流。

画质与性能

Birdseye 使用 detect role 的画面组成，因此如果 Birdseye 很模糊，应检查 detect 分辨率，而不是盲目提高录像码率。摄像头数量很多时可设置 max_cameras，仅显示最近活动的摄像头。

验证与排查

Live 页中把 Birdseye 添加到 Camera Group。
如果没有任何画面，先确认各摄像头 detect 流正常。
objects 模式下没有目标时画面减少属于正常行为。
频繁切换时可调整 inactivity/cooldown 相关设置（以当前版本配置参考为准）。

Birdseye

Birdseye composes several cameras into one dynamic overview. It is useful for wall displays, Home Assistant dashboards, or activity-focused monitoring. Tiles are built from each camera's detect stream, not the high-quality recording stream.

Modes

Mode	Behavior
continuous	Keep eligible cameras visible.
motion	Show cameras with recent motion.
objects	Show cameras with recently tracked objects.

Example

birdseye:
  enabled: true
  mode: objects
  layout:
    max_cameras: 4
    scaling_factor: 2.0

Per-camera overrides

Enable Birdseye globally and override individual cameras when a stream should be excluded or use a different mode.

Image quality and load

Because Birdseye uses the detect stream, improve detect resolution if Birdseye looks soft. For large systems, limit max_cameras so only the most relevant active cameras are composed.

Verification

Add Birdseye to a Camera Group on Live.
If it is blank, verify each detect stream first.
In objects mode, fewer tiles while nothing is tracked is expected.
Tune inactivity/cooldown options according to the configuration reference for your core version.

Birdseye

Birdseye combina varias cámaras en una vista dinámica. Es útil en pantallas, Home Assistant o supervisión centrada en actividad. Las teselas usan el stream detect, no el stream principal de grabación.

Modos

Modo	Comportamiento
continuous	Mantiene cámaras visibles.
motion	Muestra cámaras con movimiento reciente.
objects	Muestra cámaras con objetos seguidos recientemente.

Ejemplo

birdseye:
  enabled: true
  mode: objects
  layout:
    max_cameras: 4
    scaling_factor: 2.0

Ajustes por cámara

Active globalmente y desactive o cambie el modo por cámara cuando sea necesario.

Calidad y rendimiento

La calidad depende del stream detect. En sistemas grandes limite max_cameras.

Verificación

Añada Birdseye a un Camera Group.
Si aparece vacío, revise los streams detect.
En modo objects es normal que desaparezcan cámaras sin actividad.
Ajuste inactividad/cooldown según la referencia de su versión.