====== Skripte ======

[[ha:arcen:start|← zurück zur Übersicht]]

Stand: **25.09.2026**, 10 Skripte, davon 4 veraltet.

^ Skript ^ Modus ^ Aufruf durch ^ Zweck ^
| ''script.alarm_schalten_scharf_hulle_unscharf'' | restart | Dashboard-Buttons, Zone, Heizen, Nacht-Hüllenschutz | Alarmanlage schalten und Helfer synchronisieren |
| ''script.alarm_video_senden'' | parallel (max 20) | Alarm-Videoschleife | Alarm-Video per Telegram oder Push senden |
| ''script.telegram_universal_versand'' | queued (max 10) | fast alle Meldungen | zentraler Versand Telegram / Ersatz-Push |
| ''script.test_push_nachricht_an_alle_handys'' | single | Alarm-Fehler, manuell | (kritischer) Push an alle iPhones |
| ''script.kamera_ptz_schritt'' | single | Dashboard Kamera | Kamera schrittweise schwenken/neigen |
| ''script.kamera_clip_aufnehmen'' | single | Dashboard Kamera | 10-s-Clip + Vorschaubild |
| ''script.chalet_kamera_ptz_schritt'' | queued | – | alte PTZ-Variante nur für Chalet, ungenutzt |
| ALT: Alarmanlage Chalet: Scharfschalten mit Verzögerung | – | – | abgelöst |
| ALT: Alarmanlage Chalet: Hüllschutz mit Verzögerung | – | – | abgelöst |
| ALT: Alarmanlage Chalet: Unscharfschalten | – | – | abgelöst |

===== Alarm: Schalten (Scharf/Hülle/Unscharf) =====

**Feld:** ''ziel'' = Scharf | Hüllenschutz | Unscharf.

  - Ist der Zielzustand schon erreicht: Sperre aus, Fehler leeren, fertig.
  - Sperre ''alarm_vorgang_laeuft'' an, Fehler leeren.
  - ''alarm_control_panel.alarm_arm_away'' / ''alarm_arm_home'' / ''alarm_disarm'' an das Homematic-Panel.
  - bis zu **45 s** warten, bis das Panel nicht mehr pending/arming/disarming ist.
  - erreichten Zustand in ''input_select.alarmstatus'' schreiben, Sperre aus.
  - Weicht er vom Ziel ab: ''input_text.alarm_letzter_fehler'' = „<Ziel> nicht möglich (Status: …)“ und Benachrichtigung in HA („evtl. offene Tür/Fenster prüfen“).

===== Alarm: Video senden =====

**Felder:** ''datei'', ''laenge'' (s), ''nummer''.
  - wartet //Länge + 3 s//, bis die Aufnahme geschrieben ist.
  - ''telegram_aktiv'' an → ''telegram_bot.send_video'' an beide Chats mit Button „✅ Alarm bestätigen“ (''/alarm_ack'').
  - sonst Push an Norberts iPhone mit Video-Anhang (''/media/local/…''), Unterbrechungsstufe //time-sensitive//, Aktion ''ARCEN_ALARM_ACK''.

===== Telegram Universal-Versand =====

**Felder:** ''message'', ''photo'', ''video'' (alle optional).
  * ''input_boolean.telegram_aktiv'' an → Telegram an Norbert (851603710) und Ute (965268974), ''parse_mode: markdown''; Foto oder Video mit Text als Bildunterschrift.
  * sonst **Ersatz-Push** an Norberts iPhone, Titel „Arcen“; Markdown-Zeichen ''*'' und ''_'' werden entfernt, Medien als Anhang.

===== Test: Push-Nachricht an alle Handys =====

**Felder:** ''title'', ''message'', ''sound'', ''critical'' (1 = Stummmodus durchbrechen). Derzeit nur Norberts iPhone; Utes iPhone ergänzen, sobald die App mit Arcen verbunden ist.

===== Kamera PTZ Schritt =====

**Felder:** ''kamera'' = chalet | gartenhaus, ''richtung'' = links | rechts | hoch | runter.
Je Schritt: Reolink-PTZ-Button drücken, 40 ms warten, Stopp drücken, 150 ms Pause. Anzahl = ''input_number.kamera_ptz_schritte''.

===== Kamera Clip aufnehmen (10 s) =====

**Feld:** ''kamera'' = chalet | gartenhaus. Speichert ''/media/kameras/<kamera>_JJJJ-MM-TT_HH-MM-SS.jpg'' (Vorschau) und ''.mp4'' (10 s). Läuft 10 s, damit der Dashboard-Button „Nimmt auf …“ zeigt.