Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/software-mansion/argent --skill argent-tv-interactAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
Argent TV (Apple TV + Android TV + Fire TV)
Critical
- A TV is focus-driven, not touch-driven. Drive every interaction with
describe+tv-remote+keyboard; never usegesture-*/ coordinate taps; they don't apply on any TV platform. - Always `describe` before navigating to find the live cursor and your target; never guess focus from a screenshot. The cursor is the focused element; on Vega the toolkit often leaves
focusedfalse and marks the highlighted item[selected], so treat[selected]as the cursor when nothing reports[focused]. - Pass the
udidfromlist-devices: an Apple TV simulator UDID or an Android TV / Vegaserial. Dispatch is automatic from the id; the same tools drive all three. - E2E tests: Vega only. Apple TV and Android TV have no e2e support (a
tap:can pass without doing anything): report that limitation. - Fire TV (Vega) (
platform: "vega"inlist-devices): readreferences/vega.mdbefore driving it. It covers booting and stopping the VVD, Fast Refresh, and debugging the JS runtime.
The navigation loop
describe: find the cursor and your target.tv-remote: move focus toward the target. Prefer one call with a path ending inselect, e.g.{button:["down","right","select"]}; count rows/columns from the list order.describeagain to confirm, or on Apple TVawait-ui-element {condition:"exists", selector:{text:"X", role:"focused"}}. On a miss, repeat.
Tools
describe, tv-remote and keyboard descriptions cover the TV behaviour (focus view, remote keys and paths, text-only typing). Beyond them:
launch-app/restart-app/reinstall-apptake thebundleIdfrom the app manifest.
Per-platform
Apple TV (tvOS simulator)
- Boot like any iOS sim (
boot-device); the firstdescribe/tv-remotestarts the AX + HID daemons (a few seconds). - Dev build:
open-url {udid, url:"<scheme>://expo-development-client/?url=http%3A%2F%2F<HOST_IP>%3A8081"}(<HOST_IP>= your Mac's LAN IP, shown on the launcher).
Android TV (leanback emulator)
- Boot the leanback AVD like any emulator; see
argent-android-emulator-setup. - Dev build:
open-url<scheme>://expo-development-client/?url=http%3A%2F%2F10.0.2.2%3A8081(<scheme>: the app's URL scheme, or its package name if it sets none), then dismiss the first dev menu withtv-remoteselect(notback: it exits the app).
Fast Refresh (dev builds)
Needs a Debug build + Metro running. argent only connects to Metro: start Metro yourself, and forward the port where the app needs it (Android: argent-metro-debugger §1; Vega: references/vega.md).
- Apple TV / Android TV: use the dev-build deep-links above;
npm startfor Metro. - Vega: see
references/vega.md.