App- und Gerätemodule

App

{
  "app": {
    "language": "de",
    "keep_screen_on": true,
    "screensaver": {
      "enabled": true,
      "idle_seconds": 300,
      "provider_id": "family-photos",
      "show_clock": true,
      "show_badges": true,
      "badges_position": "bottom",
      "badges_orientation": "horizontal"
    }
  }
}

language akzeptiert de, en und fr; keep_screen_on besitzt den Alias always_on. Der Screensaver unterstützt enabled, idle_seconds/timeout_seconds, provider_id/connection_id, show_clock/clock_enabled, show_badges/show_sensors, badges, badges_position, badges_orientation, badges_text_color, badges_outline_color sowie gleichnamige sensor_*-Aliase.

Lokale Privacy-Sperren

Im Einstellungs-Tab kann das Gerät Kamera und Voice Assist getrennt hart deaktivieren. Diese beiden Schalter werden ausschließlich lokal im privaten App-Speicher abgelegt, sind standardmäßig aus und haben Vorrang vor Profil, Geräte-Override und HA-Entities. Beim Aktivieren beendet die App laufende Kamera- beziehungsweise Mikrofonsitzungen sofort, veröffentlicht keine Kamera-URLs mehr und lehnt neue Kamera- oder Assist-Befehle ab. Home Assistant zeigt den lokalen Sperrstatus als Diagnose-Binary-Sensor und kann die gesperrte Funktion nicht einschalten. Nur ein Benutzer direkt am Android-Gerät kann die Sperre wieder aufheben.

Voice Assistant

{
  "voice_assistant": {
    "enabled": true,
    "wake_word": true,
    "active_wake_words": ["okay_nabu"],
    "push_to_talk": true,
    "pipeline_id": "preferred",
    "audio_route": "speakerphone",
    "audio_source": "voice_recognition",
    "tts_output": "ha_stream",
    "follow_up_timeout": 15,
    "pipeline_timeout": 300,
    "processing_timeout": 120,
    "wake_word_timeout": 30,
    "noise_suppression_level": 0,
    "auto_gain_dbfs": 0,
    "status_sounds": true,
    "status_sound_volume": 70
  }
}

active_wake_words wird über die standardisierte HA-Satellitenkonfiguration gesetzt und enthält die vom gewählten serverseitigen Wakeword-Engine angebotenen IDs. audio_route ist system, speakerphone, earpiece oder bluetooth; tts_output ist ha_stream oder Android-TTS. bluetooth verwendet für Assist das bidirektionale HFP/SCO-Profil eines bereits in Android gekoppelten Geräts und damit auch dessen Mikrofon. Unter Android 12 oder neuer muss der Zugriff auf Geräte in der Nähe einmal lokal erlaubt werden. Für einen reinen A2DP-Wiedergabelautsprecher bleibt audio_route unverändert; diese Einstellung betrifft nur Assist und setzt bei bluetooth ein Mikrofonprofil voraus. push_to_talk_mode ist hold oder toggle. Lokale Wakeword-Inferenz ist nicht enthalten.

Kamera, MediaPlayer und Sensoren

camera beziehungsweise cameras konfiguriert enabled, id, facing, resolution, max_width (320–1920), stream_fps (1–30), jpeg_quality (30–95), transport (direct oder tunnel), port, base_path und optionalen lokalen HTTPS-Zugang. stream_fps ist pro Gerät über die HA-Number-Entity einstellbar; die App fordert die gewählte Bildrate beim Kameratreiber an und HA reicht den nativen MJPEG-Stream ohne Snapshot-Drosselung weiter. Die tatsächlich erreichbare Rate hängt von Kamera, Treiber, Auflösung und JPEG-Qualität ab. media_player.enabled ist standardmäßig false; weitere Laufzeiteinstellungen erfolgen über die HA-Entity. sensors kann pro Sensortyp enabled, interval_seconds und change_threshold setzen. GPS/Standort ist nicht verfügbar.