From a48d8442b1fc2b82e974bfe698ac64ba312298bb Mon Sep 17 00:00:00 2001 From: duffyduck Date: Tue, 29 Sep 2026 19:18:19 +0200 Subject: [PATCH] docs(android-agent): Fire TV (Overlay/Sprache/D-Pad) + ADB-Rollout per Satellit --- host-agent/android/README.md | 46 ++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/host-agent/android/README.md b/host-agent/android/README.md index 38a7f10..ebaa934 100644 --- a/host-agent/android/README.md +++ b/host-agent/android/README.md @@ -46,6 +46,52 @@ ARIA-Flow „E-Mail einrichten": `app_launch` (Mail-App) → `screenshot`/`ui_du (sehen, was da ist) → `ui_tap`/`ui_text` (durchklicken) → wieder `ui_dump` prüfen, bis fertig. Genau das agentische Muster wie beim Endian-Fix, nur mit Handy-UI. +### Fire TV / Android TV + +**Dieselbe APK** läuft auf Handy und Stick — die TV-Fähigkeiten schalten sich +automatisch frei (`caps` enthalten dann `tv`). Zusätzlich auf dem TV: + +| Action | Was | +|---|---| +| `notify` | **Einblendung über dem laufenden Bild** (Text/Bild) — ohne Netflix & Co. zu stoppen; oder als Sprache, je nach Einstellung (`mode` überschreibt) | +| `speak` | Sprachausgabe über die TV-Lautsprecher (ARIAs echte Stimme, sonst Geräte-TTS) | +| `volume` | Lautstärke setzen (`percent`) | +| `listen` / `listen_stop` | Mikrofon öffnen/schließen — ARIA-Sprachdialog auf dem Gerät | +| `ui_key` | zusätzlich D-Pad: `up/down/left/right/ok`, `play_pause/next/prev`, `lauter/leiser/stumm` | + +**Sprachdialog:** Die App spricht das gleiche Protokoll wie die ARIA-App +(`stt_stream_*` rein, `chat` + `audio_pcm` raus) — **serverseitig ist nichts +anzupassen**. In den App-Einstellungen wählst Du, wie ARIA hier antwortet: +**Einblendung** (Standard) oder **Sprache**; sie kann es pro Anfrage überschreiben. + +> **Turn-Ownership:** Der RVS verteilt jede Antwort an *alle* Clients im Raum. +> Damit nicht Handy **und** Stick gleichzeitig losreden, gibt dieses Gerät nur +> aus, was aus **seiner eigenen** Frage entstanden ist. + +> **Mikrofon der Fire-TV-Fernbedienung:** Die Mikro-Taste ist systemseitig mit +> Alexa belegt; ob Fremd-Apps an das Remote-Mikro kommen, ist je nach Stick- +> Generation unterschiedlich und **muss am Gerät ausprobiert werden**. Sicher +> funktioniert der **Sprech-Knopf in der App** (OK-Taste) — und falls das Remote- +> Mikro nicht hergibt, tut es ein USB-Mikro am Stick. + +Berechtigungen einmalig in der App: **„Einblendung erlauben"** (Über anderen Apps +anzeigen) und beim ersten Sprechen das **Mikrofon**. + +### Ausrollen per Satellit (ohne Datei-Kopieren) + +Statt die APK von Hand aufs Gerät zu schaufeln, kann ein **Satellit** sie per ADB +über das Netz installieren: + +1. Am Fire TV: **Einstellungen › Mein Fire TV › Entwickleroptionen › ADB-Debugging** an. +2. Diagnostic → Satelliten → scannen. ADB-fähige Geräte zeigen ein **ADB**-Tag + und einen **📦**-Button. +3. 📦 → APK-URL (aus dem Gitea-Release) → **Jetzt ausrollen**. Beim ersten Mal + erscheint auf dem TV „USB-Debugging zulassen?" → bestätigen (Haken „Immer erlauben"). + +ARIA kann dasselbe: `satellite_command` mit `action='adb.install'`, +`params={'ip':'…','url':'…'}`. Der Satellit lädt die APK **einmal** und kann sie +auf beliebig viele Sticks installieren. + > **⚠️ Gerät muss ENTSPERRT sein, damit ARIA es steuern kann.** Gesten und > Systemtasten (`ui_tap`/`ui_text`/`ui_swipe`/`ui_key`/`app_launch`) greifen bei > gesperrtem Bildschirm nicht — Android-Sicherheit. Der Agent erkennt das und