eminuxandCursor
a448ad59ee
Documenta overlay in app, YoutubeRelay copy+AAC in Sidekiq e HLS sul path camera; aggiorna checklist e troubleshooting. Co-authored-by: Cursor <cursoragent@cursor.com>
33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
# YouTube Live — checklist operativa
|
||
|
||
**Aggiornato:** 2026-07-29
|
||
Pipeline attuale: telefono → MediaMTX → `Streams::YoutubeRelay` (ffmpeg copy+AAC in Sidekiq) → YouTube. Overlay tabellone in **app**, non più `OverlayRelay` server.
|
||
|
||
## Verifica rapida su server
|
||
|
||
```bash
|
||
ssh eminux@192.168.1.146
|
||
docker exec infra-rails-1 bin/rails youtube:e2e # se il task è ancora presente
|
||
docker exec infra-sidekiq-1 pgrep -a ffmpeg # deve contenere rtmps://...youtube.com/live2
|
||
docker logs infra-sidekiq-1 2>&1 | grep -E 'YoutubeRelay|YoutubeBroadcastActivate|LivePipeline' | tail -40
|
||
```
|
||
|
||
## Avvio diretta dall’app
|
||
|
||
1. Partita → **YouTube Live** → wizard → **Camera**
|
||
2. Attendi sul passo rete che compaia il link YouTube (poll automatico)
|
||
3. Avvia: entro ~90s su YouTube compare video (slate MediaMTX se il telefono non pubblica ancora; tabellone quando l’app pubblica RTMP con overlay)
|
||
|
||
## Se qualcosa non va
|
||
|
||
| Sintomo | Cosa fare |
|
||
|---------|-----------|
|
||
| «YouTube temporaneamente occupato» | Attendi 15–20 min (rate limit Google). **Non** creare molte sessioni di fila. |
|
||
| Pagina YouTube vuota | `docker logs infra-sidekiq-1 \| grep YoutubeRelay` — manca `stream_key` o relay non partito |
|
||
| App 0 Mbps / 0 fps ma LIVE | RTMP non pubblica: permessi camera / messaggio «Connessione RTMP»; relay YouTube non parte finché MediaMTX non vede il publisher |
|
||
| YouTube resta in waiting | Log relay in sidekiq; `StreamPublisherSyncJob` + activate retry |
|
||
|
||
## Note storiche
|
||
|
||
Checklist precedente (giu 2026) citava `OverlayRelay` / tee RTMPS dall’overlay server: **deprecato**. Non cercare più log `OverlayRelay` o `overlay_relay_*.log`.
|