Cómo funciona
PlayerOFF conecta dos piezas: un receptor (la app de PlayerOFF abierta en un TV o navegador) y tu app (en el teléfono o donde sea). No hay cuentas: todo es temporal.
- El receptor muestra un código. Al abrirse, la app del TV pide un receptor temporal y muestra un código de 6 caracteres y un QR con
playeroff://connect?code=<CÓDIGO>. - Tu app canjea el código. Con
POST /v1/sessionsrecibes unsessionToken. El código sirve una sola vez y el TV pasa a "Teléfono conectado". - Tu app envía un video. Con
POST /v1/castsy el token, el TV lo reproduce al instante. Si ya estaba reproduciendo otro, lo reemplaza. - Tu app controla la reproducción. Pausar, saltar, volumen, subtítulos, audio o detener, con
POST /v1/sessions/commands, y ve en vivo qué pasa en el TV conGET /v1/sessions/events(ver Control remoto). El control del TV sigue funcionando igual.
Qué caduca y cuándo
| Qué | Dura |
|---|---|
| Código de conexión | 5 minutos (el TV lo renueva solo) |
| Envío no entregado | 5 minutos; luego su estado pasa a expired |
| Sesión | 2 horas desde la última petición (o mientras el flujo de eventos esté abierto), o hasta que el TV se cierre. Al caducar, el TV vuelve a mostrar el código. |
| Receptor | Mientras la app del TV esté abierta |
Una sesión a la vez
Cada TV acepta un solo teléfono conectado. Si otra persona canjea el código que aparece abajo en la pantalla "Teléfono conectado", tu sesión termina y tus llamadas responden 410 session_ended. Para volver a enviar, canjea el código nuevo.
