DocumentaciónOperación

Parámetros del STB

Al editar un STB en Conexiones (pestaña STBs → clic en el equipo) o desde el menú STBs, el panel muestra las pestañas Servicio, Distribución, MPV, EXO, Otros y, si el equipo tiene app 2.5+, Control Parental. Esta guía explica los parámetros de reproducción y comportamiento; el PIN y los canales bloqueados están en Control parental.

Cómo abrir la ficha de un STB

  1. Menú → Conexiones → abrir el cliente → pestaña STBs → clic en el botón de editar del equipo.
  2. O menú → STBs → buscar el equipo → botón que abre la misma ficha en Conexiones.
  3. Revise los datos en cada pestaña y pulse Aplicar al final. Los cambios de plan y parámetros de reproducción suelen notarse al reconectar o reiniciar la app.

Los valores iniciales de un STB nuevo salen de Ajustes por defecto en el Tablero (pestañas Distribución, MPV, EXO, Otros). Lo que configure ahí es la base; en esta ficha puede afinar caso por caso.

Visión general: MPV vs EXO

En la pestaña Distribución elige el Reproductor:

  • MPV (recomendado) — motor principal en la mayoría de Android TV y STB actuales. La pestaña MPV aplica cuando este reproductor está seleccionado.
  • Exo — motor alternativo (ExoPlayer). La pestaña EXO aplica cuando Exo está seleccionado.

No mezcle ajustes: si el reproductor es MPV, ignore la pestaña EXO salvo que vaya a cambiar a Exo. Si un STB va mal con MPV, pruebe Exo (o viceversa) cambiando solo el reproductor y dejando el resto en valores conservadores.

Regla práctica: empiece siempre con los defaults del Tablero. Cambie un parámetro a la vez, pruebe en el TV del cliente y anote qué funcionó. Así evita combinar cambios que se contradicen.

Pestaña Servicio

Define qué ve el abonado y si puede usar el servicio. Es la pestaña que más usará el operador en el día a día.

CampoPara qué sirveValores y recomendación
ID Equipo Identificador interno del aparato en Flex TV (solo lectura). No se edita. Sirve para soporte y activaciones.
Referencia Nombre descriptivo del STB en la casa del cliente («Living», «Dormitorio», «Bar mostrador»). Use un nombre que el cliente reconozca. Facilita buscar en STBs y en reclamos.
Paquete fijo Plan principal de canales contratado. El número entre paréntesis indica cuántos canales activos incluye ese paquete en su cabecera. Obligatorio para que el STB tenga señal. Si el cliente pagó un plan concreto, asigne ese paquete. Sin paquete, no hay lista de canales aunque haya crédito.
Paquetes adicionales Packs extra temporales (deportes, adultos, etc.) con plazo de 3, 7, 15 días o 1 mes. Solo los que el cliente compró. Al vencer el plazo, el pack deja de aplicarse solo. Puede combinar varios adicionales si su operador lo permite.
Estado Activo / Inactivo a nivel de este STB. Activo = puede ver si tiene crédito y plan. Inactivo = bloqueo del equipo (moroso, equipo robado, prueba terminada). No confundir con «Inactiva la conexión» del cliente entero.
Conexión titular A qué cliente (cuenta) pertenece el STB. Cámbielo solo si el equipo pasa a otro titular (mudanza, venta). Verifique límite de STBs por conexión.

Pestaña Distribución

Define cómo llega el video al aparato y qué motor lo reproduce. Es el primer paso antes de tocar MPV o EXO.

Transmisión

OpciónQué haceCuándo usarla
MPEG-TS Flujo continuo tipo IPTV clásico. Menor retardo entre lo que pasa en vivo y lo que ve el abonado (zapping más «directo»). Red estable, clientes que priorizan zapping rápido o equipos antiguos acostumbrados a TS. Más sensible a microcortes de red: si el Wi‑Fi flojea, puede cortar más seguido.
HLS (M3U8) Video en segmentos (lista .m3u8). Algo más de delay, pero más tolerante a redes inestables. Wi‑Fi débil, 4G, zonas con pérdida de paquetes. Recomendado en muchos Android TV modernos con MPV. En apps muy viejas (< 2.4) puede no estar disponible.

Resumen: MPEG-TS = menos delay, más exigente con la red. HLS = más delay, más estable en malas redes.

Reproductor

OpciónQué haceCuándo usarla
MPV (recomendado) Reproductor flexible, muy configurable desde la pestaña MPV. Buen equilibrio en STB Android TV. Valor por defecto en la mayoría de operadores. Use esta pestaña para afinar decodificación, buffers y perfiles.
Exo ExoPlayer de Google. Parámetros en pestaña EXO (buffers en milisegundos, tunneling, etc.). Si MPV da pantalla negra, tirones o incompatibilidad en un modelo concreto. Pruebe Exo con valores conservadores antes de seguir tocando MPV.

Pestaña MPV

Solo aplica si el reproductor es MPV. Agrupa decodificación, memoria, red y presets internos del motor.

Decodificación de video

Controla si el video se decodifica por CPU o por hardware (MediaCodec del chip).

OpciónComportamientoRecomendado para
Desactivado — CPU Decodifica con procesador. Menos dependiente del MediaCodec del fabricante. TV Android baratos donde el HW va a 5–15 fps o falla. Es la opción más estable en muchos STB económicos.
AUTO-SAFE — HW seguro Intenta hardware sin forzar modos agresivos. Equipo intermedio: probar si CPU consume mucho pero el HW «casi» funciona.
MEDIACODEC-EMBED Salida HW directa al Surface (pantalla). STB/TV donde el fabricante documenta buen soporte. Puede ir bien en algunos modelos premium.
MEDIACODEC-COPY HW con copia de frames a memoria. Móviles potentes. En TV baratos suele ir muy lento (~5 fps). Evitar en STB justos de RAM.
MEDIACODEC HW sin copy. Hardware moderno y estable. Probar solo si AUTO-SAFE o EMBED funcionan bien.

Buffer del demuxer

Tope de RAM que MPV reserva para datos del stream antes de decodificar (no confundir con «Buffer de media»).

  • 80M–120M — TV con 1 GB RAM o muy justos.
  • 150M (recomendado TV barato) — buen equilibrio en la mayoría de STB económicos.
  • 200M — uso general / equipos con 2 GB RAM.
  • 250M — red inestable (más colchón de datos crudos).
  • 300M–500M — solo STB con buena RAM; en 1–2 GB puede provocar cierres de la app.

Buffer de media

Segundos de video que MPV intenta mantener por delante durante la reproducción.

  • 4–5 s — zapping rápido, HLS, redes buenas (menos delay al cambiar canal).
  • 6–8 s — equilibrio general (recomendado por defecto).
  • 10–15 s — red inestable o muchos microcortes; más delay al zapear.

Timeout de red

Segundos máximos para conectar y esperar datos del servidor.

  • 5–8 s — fallar rápido y reintentar (útil con placas que reconectan solas).
  • 10 s — equilibrado (recomendado).
  • 15–20 s — redes muy lentas o enlaces saturados.

Perfil

Preset interno de MPV que agrupa varias optimizaciones (latencia, calidad de imagen, uso de GPU).

OpciónEfectoCuándo
Equilibrado Balance entre fluidez, calidad y consumo. TV barato + HLS — primera opción en la mayoría de casos.
Menos latencia Prioriza respuesta rápida al zapping. Cliente que cambia mucho de canal y tolera algo menos de calidad.
Más calidad Prioriza imagen y procesamiento. STB potente, red buena, quejas por imagen «lavada» o poco definida.
GPU alta calidad Preset agresivo en GPU. Solo hardware que lo soporte bien; si hay tirones, volver a Equilibrado.

Códecs con hardware decode

Lista de formatos de video que MPV puede intentar decodificar por hardware. Si el chip no soporta un códec, puede fallar o usar CPU.

OpciónCódecsCuándo
Todos (recomendado) H264, HEVC, MPEG4, MPEG2, VP8, VP9, AV1 STB modernos con buen soporte. Máxima compatibilidad con fuentes actuales.
H264 + HEVC Solo esos dos Limitar códecs «raros» si el HW falla con VP9/AV1.
IPTV clásico H264, MPEG2, MPEG4 Fuentes TS tradicionales; STB que se cuelga con HEVC/AV1.
Solo H264 Únicamente H264 Último recurso: pantalla negra o reinicios con otros códecs.

Cache de media (cache)

Buffer extra además del «Buffer de media». No es lo mismo: duplica colchón en algunos escenarios.

  • Desactivado — HLS y zapping rápido (recomendado en la mayoría de casos con HLS).
  • Activado — MPEG-TS inestable; combinar con Buffer de media 8–10 s para reducir cortes.

Sincronización de video

Cómo MPV alinea video y audio cuando el equipo no llega al framerate del canal.

OpciónComportamientoCuándo
Seguir audio El video se ajusta al audio. Suele ser el más estable. Recomendado en casi todos los STB.
Movimiento más fluido Re-muestrea video para suavizar (display-resample). STB con potencia media y quejas de imagen entrecortada sin desincronización grave.
Baja latencia Descarta frames para no acumular delay (display-vdrop). STB lento que va a tirones; priorizar respuesta sobre fluidez perfecta.
Sin sincronización No corrige desfase audio/video. Solo prueba puntual de diagnóstico. No dejar en producción.

Salto de frames

Qué tan agresivo es MPV al descartar cuadros cuando el STB no alcanza el framerate (típico 5–15 fps en hardware justo).

OpciónComportamientoCuándo
Equilibrado Descarta en la salida de video (vo). Recomendado por defecto.
Máximo rendimiento Descarta también en el decodificador. STB muy justo que sigue lento con Equilibrado.
Rendimiento extremo vo + decoder. Último recurso antes de cambiar a CPU o Exo.
No descartar cuadros Intenta mostrar todos los frames. Solo STB potentes; en hardware débil empeora tirones y delay.

Salida de video

OpciónComportamientoCuándo
Compatibilidad máxima (gpu) Ruta de renderizado más compatible con Android TV. Recomendado en Android TV / STB genéricos.
Aceleración por hardware (mediacodec_embed) Salida directa por MediaCodec al display. Modelos que lo soporten bien; en otros puede dar pantalla negra. Probar en el equipo real.

Pestaña EXO

Solo aplica si el reproductor es Exo. Los buffers se miden en milisegundos (a diferencia de MPV, donde «Buffer de media» va en segundos).

Decodificador de video

OpciónComportamientoCuándo
Automático (recomendado) Exo elige HW cuando puede. Primera opción.
Forzar Hardware Prioriza MediaCodec. STB con buen chip de video.
Preferir Software Prioriza CPU. MediaCodec falla o va a tirones con HW.
Solo CPU Sin hardware útil. TV sin decodificador usable; máxima compatibilidad a costa de CPU.

Tunneling de audio/video

  • Apagado (recomendado) — máxima compatibilidad en Android TV baratos.
  • Encendido — pasa audio/video directo al hardware del TV (menos CPU). En muchos modelos baratos produce pantalla negra, sin audio o inestabilidad. Activar solo tras probar en ese modelo concreto.

Buffers (ms)

CampoQué controlaNotas
Buffer mínimo Cantidad mínima de media que Exo intenta mantener. Más alto = más colchón ante cortes; puede tardar un poco más en estabilizar el play.
Buffer máximo Tope de buffer acumulado. Limita memoria y datos precargados al zapping.
Buffer para iniciar reproducción Datos mínimos antes del primer play. Más bajo = arranque más rápido, más sensible a microcortes.
Buffer tras un rebuffer Cuánto rellena tras quedarse sin datos. Evita bucles play/stop en redes inestables.
Timeout de conexión Tiempo máximo para conectar al middleware. Si el origen tarda más, ese intento falla.
Timeout de lectura Si dejan de llegar datos X ms con la conexión abierta. Útil cuando el origen se «congela» sin cerrar la sesión.

Use los defaults del Tablero salvo que tenga un motivo claro (red mala → subir buffers mínimo/rebuffer; zapping lento → bajar buffer de inicio con cuidado).

Pestaña Otros

Comportamiento de la app fuera del motor de video.

CampoPara qué sirveRecomendación
Iniciar al encender el equipo La app Flex TV se abre sola al prender el TV/STB. Activo en STB dedicados a IPTV. Inactivo si el cliente usa el TV también para Netflix/YouTube y no quiere que Flex TV tome el control al encender.
Tiempo para «¿Seguís ahí?» Tras X horas sin uso, la app pregunta si el viewer sigue presente (ahorro de ancho de banda y licencias). 1–3 h en hogares; 4–6 h en bares o locales con pantalla muchas horas encendida.
Abrir barra de controles al hacer zapping Al cambiar de canal muestra u oculta la barra con info del canal. Activo si el cliente quiere ver número/nombre al zapear. Inactivo para experiencia más limpia tipo TV abierta.
Control remoto web Permite manejar el STB desde un navegador (móvil/PC) en la misma red. Activo para soporte remoto o clientes tech-savvy. Inactivo si no lo usan o por política de seguridad del operador.
Reiniciar APP Botón para reiniciar la aplicación a distancia en ese STB. Primer paso ante pantalla trabada, después de cambiar parámetros de reproducción, o cuando el cliente reporta que la app quedó colgada.

Control Parental (app 2.5+)

La pestaña Control Parental no forma parte de MPV/EXO: gestiona el PIN de 4 dígitos, los canales bloqueados del paquete fijo y el reinicio de PIN en el STB. Requiere permiso Actualizar plan y adicionales.

Documentación completa (PIN, canales bloqueados, reinicio y estado de sincronización): Control parental.

Escenarios recomendados

STB Android TV barato (1–2 GB RAM), red Wi‑Fi normal

  • Distribución: HLS + reproductor MPV.
  • MPV: decodificación Desactivado (CPU), demuxer 150M, buffer media 6–8 s, timeout red 10 s.
  • Perfil Equilibrado, códecs Todos, cache Desactivado, sync Seguir audio, framedrop Equilibrado, salida Compatibilidad máxima.

Cliente exige zapping muy rápido (red buena)

  • Transmisión MPEG-TS si la red lo aguanta; si no, HLS con perfil Menos latencia.
  • Buffer de media MPV 4–5 s, cache Desactivado.

Red inestable (microcortes frecuentes)

  • Transmisión HLS.
  • Buffer de media 10–15 s; si es MPEG-TS, cache Activado + buffer 8–10 s.
  • Demuxer 250M solo si el STB tiene RAM suficiente.

Pantalla negra o 5 fps con MPV

  1. MPV → decodificación Desactivado (CPU).
  2. Códecs → IPTV clásico o Solo H264.
  3. Salida de video → Compatibilidad máxima.
  4. Si sigue mal → cambiar reproductor a Exo, tunneling Apagado, decodificador Automático o Preferir Software.

STB potente (4 GB RAM, chip moderno)

  • MPV: puede probar AUTO-SAFE o HW embed, demuxer 200M, perfil Más calidad.
  • Framedrop No descartar cuadros solo si mantiene fluidez; si no, volver a Equilibrado.

Precauciones

  • Los técnicos sin permiso Parámetros distribución (MPV / EXO / otros) no ven o no pueden guardar estas pestañas. Revise permisos en Técnicos.
  • Cambiar muchos valores a la vez dificulta saber qué arregló el problema.
  • Tras guardar, pida al cliente reconectar o use Reiniciar APP en Otros.
  • Los defaults globales se editan en Tablero → Ajustes por defecto; afectan STB nuevos, no reescriben los ya configurados uno a uno.

Volver a Conexiones → STBs · Listado global de STBs · Ajustes por defecto del Tablero