Se utilizzi una telecamera PTZ compatibile ONVIF e vuoi controllarla direttamente dalla dashboard di Home Assistant, puoi creare una card con i pulsanti direzionali integrati sull’immagine live della telecamera.
Nel mio caso ho utilizzato una C21A configurata tramite integrazione ONVIF. Dopo varie prove ho scelto la modalità RelativeMove, che garantisce uno spostamento preciso ad ogni pressione del pulsante.
Risultato finale
La card mostra:
- Streaming live della telecamera
- Pulsante Su
- Pulsante Giù
- Pulsante Sinistra
- Pulsante Destra
Ogni clic genera uno spostamento relativo della telecamera.
Codice YAML completo
type: picture-glance
title: Telecamera C21A
camera_image: camera.c21a_mainstream
entities:
- entity: camera.c21a_mainstream
icon: mdi:arrow-up
name: Su
tap_action:
action: perform-action
perform_action: onvif.ptz
target:
device_id: ff8e451cca5103ba81271e631a2b89ba
data:
move_mode: RelativeMove
tilt: UP
distance: 0.3
speed: 1
- entity: camera.c21a_mainstream
icon: mdi:arrow-down
name: Giù
tap_action:
action: perform-action
perform_action: onvif.ptz
target:
device_id: ff8e451cca5103ba81271e631a2b89ba
data:
move_mode: RelativeMove
tilt: DOWN
distance: 0.3
speed: 1
- entity: camera.c21a_mainstream
icon: mdi:arrow-left
name: Sinistra
tap_action:
action: perform-action
perform_action: onvif.ptz
target:
device_id: ff8e451cca5103ba81271e631a2b89ba
data:
move_mode: RelativeMove
pan: RIGHT
distance: 0.3
speed: 1
- entity: camera.c21a_mainstream
icon: mdi:arrow-right
name: Destra
tap_action:
action: perform-action
perform_action: onvif.ptz
target:
device_id: ff8e451cca5103ba81271e631a2b89ba
data:
move_mode: RelativeMove
pan: LEFT
distance: 0.3
speed: 1
Regolazione della sensibilità
Il parametro più importante è:
YAML
distance:
Più il valore è alto, maggiore sarà lo spostamento della telecamera per ogni click.
Esempi pratici:
YAML
distance: 0.05
Movimento molto piccolo.
YAML
distance: 0.2
Movimento medio.
YAML
distance: 0.3
Buon compromesso per la maggior parte delle PTZ.
YAML
distance: 0.5
Movimento molto evidente.
Attenzione alle direzioni
Alcune telecamere interpretano i comandi ONVIF in modo invertito. Nel mio caso ho dovuto invertire i valori:
YAML
pan: RIGHT
per il pulsante Sinistra e
YAML
pan: LEFT
per il pulsante Destra.
Se la telecamera si muove nella direzione sbagliata, è sufficiente invertire questi due parametri.
Considerazioni finali
Dopo diversi test ho verificato che il problema non era Home Assistant ma la regolazione dello spostamento. Riducendo troppo il valore distance la telecamera sembrava “lentissima” perché ogni click produceva un movimento minimo.
Con:
YAML
distance: 0.3
speed: 1
il controllo risulta molto più fluido e pratico per l’uso quotidiano dalla dashboard di Home Assistant.
Configurazione testata con telecamera PTZ ONVIF integrata in Home Assistant usando una card Picture Glance per il controllo diretto dei movimenti Pan/Tilt.