1 Operator Cast Requirements
Forgejo Actions edited this page 2026-10-14 15:34:33 +00:00

Chromecast — deploymentkrav

Android-appen kan caste fotos og videoer til Chromecast / Android TV (spec 060). Casting stiller krav til netværk og TLS, som operatøren skal opfylde:

Krav

  1. LAN-adgang: Chromecast'en skal kunne nå Memories-API'ets URL fra sit eget netværk (samme VLAN/subnet som serveren, eller rute derimellem). Telefon og Chromecast skal begge være på det netværk, hvor API'et er tilgængeligt.
  2. Betroet TLS: Chromecast'en henter media-URL'en selv og kræver et TLS-certifikat den stoler på. Selvsignerede certifikater virker ikke — cast falder fejl med modtagerfejl på medieindlæsning. Brug f.eks. Let's Encrypt via Traefik eller et andet certifikat med gyldig kæde.
  3. Ingen internet-adgang nødvendig ud over Play services: discovery og cast-session går via Google Play services på telefonen; media-bytes går direkte mellem Chromecast'en og API'et.

Sådan virker auth for cast

Chromecast'en kan ikke sende telefonens session-cookie. Appen henter derfor et kortlivet signeret token (POST /api/media/token, HMAC-SHA256, default TTL 15 min) og sender det som ?st=-queryparameter på media-URL'en. Token er bundet til én media-item + rendition og udløber automatisk — cookie-auth for uændret for web og app.

Fejlfinding

  • Ingen devices i cast-pickeren: telefon og Chromecast skal være på samme netværk; genstart Chromecast ved mistanke om mDNS-problemer.
  • "Kunne ikke indlæse medie" på TV'et: tjek først TLS-cert-kæden og at API-URL'en er den samme, Chromecast'en kan nå (ikke localhost, ikke internt docker-navn).
  • Album-afspilning stopper når telefonens skærm slukker: kendt begrænsning (ISSUE-158) — afspilning er foreground-scoped i første version.

Relateret: spec 060 (specs/060-android-cast-to-chromecast/), design docs/superpowers/specs/2026-10-14-android-cast-chromecast-design.md.