Mese: Ottobre 2026

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.