Skip to content

Diagnóstico del playout

Empiece por el síntoma observable y compruebe la cadena en orden: parrilla guardada → fotograma de vídeo real → EPG → acceso del espectador. Una respuesta de la API o una guía de programación correcta no demuestran por sí solas qué está en emisión.

Necesita acceso de operador al playout y a su stream, además de una cuenta de abonado para la comprobación final. Consulte Compruebe el stream para obtener el enlace HLS.

Puede consultar el estado del playout mediante la management API. Defina la dirección de la instalación, la cuenta del operador y el nombre del stream; envíe la contraseña solo mediante HTTPS:

BASE='https://catena.example.com'
API_USER='operator'
read -rsp 'Operator password: ' API_PASSWORD; echo
STREAM='playout_<id>'
curl -fsS -u "$API_USER:$API_PASSWORD" \
  "$BASE/central/api-v4/streams/stats/$STREAM" |
  jq '.input.playout'

Compruebe health y problems en la respuesta y abra la sección correspondiente.

Emisión y parrilla

El relleno está en emisión

  • Síntoma: se reproduce el relleno del bloque, el relleno general o barras de color en lugar de una película o una fuente en vivo.
  • Causas posibles: ningún bloque cubre la hora actual, el VOD terminó antes que el bloque o el contenido no está disponible.
  • Comprobación: abra Playout y compare Ahora y a continuación con la retícula. Si no hay un bloque actual, revise los límites de los bloques vecinos. Si existe, compruebe su duración y la disponibilidad del asset. La solicitud de estado anterior ayuda a distinguir un error del asset de un hueco en la parrilla.
  • Acción: para un hueco, añada o mueva un bloque y pulse el botón general Guardar como se describe en Cree una parrilla de VOD. Si el VOD terminó naturalmente, deje el relleno hasta el bloque siguiente o cambie la duración y el contenido del bloque. Para un error del asset, vaya a Contenido y fuentes.
  • Comprobación del resultado: si añadió o corrigió un bloque, Ahora lo muestra, HLS o WebTV muestra su fotograma y el EPG muestra su programa. Si deja el relleno intencionadamente tras el final natural del VOD, compruebe que se reproduce hasta el límite del bloque siguiente y que después empieza el contenido del bloque siguiente. Para una fuente reparada, health debe volver a on_air y problems debe quedar vacío.

El bloque es incorrecto o una edición guardada no aparece en emisión

  • Síntoma: el reproductor muestra el programa anterior o un bloque distinto del que acaba de editar.
  • Causas posibles: editó un bloque futuro, la edición sigue siendo un borrador, la hora del bloque es incorrecta o una WebTV abierta conserva el EPG anterior.
  • Comprobación: compare Ahora y a continuación con la retícula y revise el inicio y la duración del bloque. Después de guardar la ventana del bloque, compruebe que el botón general Guardar situado sobre la retícula terminó sin errores. Compare el EPG actualizado de la tarjeta del canal con el fotograma HLS real.
  • Acción: pulse el botón general Guardar. Para un bloque futuro, espere hasta su inicio; para una hora incorrecta, corrija los límites y guarde otra vez. Recargue la WebTV abierta después de editar el EPG. No necesita reiniciar el stream para aplicar la parrilla.
  • Comprobación del resultado: Ahora, el EPG actualizado y el fotograma de vídeo corresponden al mismo bloque. La edición de un bloque futuro aparece en su programa, pero no cambia la emisión actual antes de la hora prevista.

El relleno general no se guarda

  • Síntoma: después de seleccionar Relleno del canal, el botón general Guardar devuelve HTTP 422 con «missing field fps».
  • Causa posible: en la versión comprobada, el editor envía una configuración de salida incompleta al cambiar el relleno general. El guardado de la parrilla y del relleno del bloque es una vía independiente que funciona.
  • Comprobación: vuelva a abrir el playout y compruebe que el relleno general anterior no cambió. No repita la misma solicitud del editor.
  • Acción: guarde el config existente completo con solo filler modificado mediante la management API siguiendo Defina el relleno general mediante la API. El procedimiento conserva fps, el tamaño, el audio y los demás parámetros y usa If-Match para no sobrescribir la edición de otro operador.
  • Comprobación del resultado: la respuesta de la API contiene el nuevo filler y los parámetros de salida anteriores. Compruebe el relleno seleccionado por HLS en el siguiente hueco de la parrilla; no elimine el bloque actual solo para probarlo.

Contenido y fuentes

Un archivo VOD no está disponible

  • Síntoma: un bloque VOD aparece en Ahora, pero el relleno está en emisión; el estado del stream puede ser degraded con un error del asset.
  • Causas posibles: el archivo o el almacenamiento no está disponible, el placement del asset no está listo o Catena aún no leyó la información del vídeo.
  • Comprobación: abra el asset en VOD → Catálogo. Compruebe el estado disponible, las pistas de vídeo y audio en Media info, una copia lista y un almacenamiento disponible en Copias. Ejecute la solicitud de estado del stream del inicio de esta página.
  • Acción: restaure el archivo o el almacenamiento y espere a que el placement esté listo. Elimine el bloque fallido y pulse el botón general Guardar; después vuelva a crearlo con el contenido, el inicio, la duración y los metadatos anteriores y guarde otra vez para que el playout reabra el asset. Consulte Edite la emisión actual para la secuencia de eliminación y creación. Si el almacenamiento no está disponible, use Diagnóstico del streamer y la información sobre placement de VOD; no vuelva a crear el playout. Si no puede restaurar el asset ahora, sustituya el contenido del bloque por otro VOD disponible y pulse el botón general Guardar.
  • Comprobación del resultado: el asset está disponible, health vuelve a on_air, el error del asset desaparece de problems y una HLS o WebTV nueva muestra el contenido del bloque en lugar del relleno.

Una fuente en vivo no se reproduce

  • Síntoma: un bloque en vivo está guardado y aparece en Ahora, pero el relleno está en emisión. El EPG puede mostrar el programa en vivo correcto al mismo tiempo.
  • Causas posibles: la propia fuente en vivo no está disponible o se aplica la limitación de la versión comprobada: una fuente que funciona puede no llegar a la emisión del playout incluso sin un error del asset.
  • Comprobación: reproduzca el stream en vivo de origen independientemente del playout e inspeccione sus entradas con Diagnóstico de la fuente. Después compare el fotograma HLS real del playout y problems. No use el EPG como prueba de la emisión en vivo.
  • Acción: si la fuente no está disponible, restaure su entrada y espere hasta que el stream en vivo se reproduzca independientemente. Elimine el bloque en vivo fallido y pulse el botón general Guardar; después vuelva a crearlo con los parámetros anteriores y guarde la parrilla otra vez. Si la fuente se reproduce independientemente pero el playout sigue mostrando el relleno, sustituya el bloque en vivo por un asset VOD disponible y pulse el botón general Guardar como se describe en Añada una fuente en vivo. No hay otra recuperación de la emisión en vivo comprobada en esta versión.
  • Comprobación del resultado: el reproductor muestra el fotograma real, no solo un evento EPG. Después de cambiar a VOD, compruebe el contenido del nuevo bloque y el programa actualizado.

Guía de programación

El EPG está vacía

  • Síntoma: la tarjeta del canal, WebTV o XMLTV no muestra los programas actual y siguiente.
  • Causas posibles: el intervalo seleccionado no tiene un bloque, el evento se eliminó con su bloque, el canal apunta a otro stream o el abonado no tiene acceso al canal.
  • Comprobación: compare el intervalo con la parrilla guardada. Compruebe el programa y el campo Stream en la tarjeta del canal y después Canales disponibles en la tarjeta del abonado. Los huecos entre bloques no crean eventos, y el siguiente guardado elimina los eventos que terminaron hace más de un día.
  • Acción: añada o restaure el bloque y pulse el botón general Guardar. Si el canal apunta al stream incorrecto, corrija el enlace siguiendo Cree el canal. Si solo la guía del abonado está vacía, restaure la cadena canal → paquete → suscripción en El canal no está visible para el espectador. Recargue WebTV.
  • Comprobación del resultado: la tarjeta del canal muestra un programa con el título y la hora previstos; después de recargar WebTV o hacer una nueva solicitud XMLTV, aparecen los mismos datos.

El EPG está desactualizada o contiene datos incorrectos

  • Síntoma: un título, una descripción, una hora o el orden de los programas no coincide con la última edición.
  • Causas posibles: la edición sigue siendo un borrador, el bloque contiene campos guardados incorrectos o una WebTV abierta muestra una guía cargada anteriormente.
  • Comprobación: abra el bloque y compare sus campos guardados. Compruebe el EPG actualizado en la tarjeta del canal o con una nueva solicitud XMLTV: si los datos ya son correctos allí, solo la WebTV abierta está desactualizada.
  • Acción: si la tarjeta actualizada del canal o XMLTV ya muestra los datos correctos, solo recargue WebTV; no hace falta otra edición ni guardar la parrilla de nuevo. Si los campos guardados son incorrectos o la edición sigue en el borrador, corrija los campos del bloque, guarde la ventana y pulse el botón general Guardar siguiendo Actualice la guía después de una edición. Actualice la página de la consola para la tarjeta del canal.
  • Comprobación del resultado: la tarjeta del canal actualizada, WebTV y XMLTV muestran el título, los límites y la descripción corregidos. Temporada, Episodio y el póster no se transfieren al EPG; incluya el número del episodio en el título si el espectador lo necesita.

El EPG es correcta, pero el relleno está en emisión

  • Síntoma: el programa actual de WebTV coincide con la parrilla mientras el fotograma muestra el relleno.
  • Causa posible: el EPG refleja la intención guardada del operador, no el fotograma real. Un VOD o una fuente en vivo no disponible y la limitación de la emisión en vivo no tienen por qué cambiar el evento.
  • Comprobación: abra el enlace HLS directo e inspeccione health y problems del stream. Después compruebe el asset del bloque actual y la reproducción independiente de la fuente en vivo.
  • Acción: siga Un archivo VOD no está disponible o Una fuente en vivo no se reproduce. Si la fuente en vivo funciona independientemente pero el playout sigue mostrando el relleno, use el cambio a VOD comprobado.
  • Comprobación del resultado: un reproductor nuevo muestra el contenido del bloque actual. Si seleccionó VOD en lugar de la fuente en vivo, el EPG también corresponde al nuevo bloque después de guardar y recargar WebTV.

Acceso del espectador

La HLS directa funciona, pero el canal no está visible para el espectador

  • Síntoma: el operador puede ver el enlace directo del stream, mientras WebTV informa No channels available u omite el canal necesario.
  • Causa posible: la HLS directa comprueba el stream, no la publicación. El canal no está vinculado a este stream, no pertenece a un paquete o su paquete no está en las suscripciones del abonado.
  • Comprobación: en Canales, verifique el nombre exacto del stream playout_<id>; en Paquetes, compruebe el contenido del paquete; en la tarjeta del abonado, revise Suscripciones y el bloque resultante Canales disponibles.
  • Acción: restaure los tres enlaces siguiendo Publique el canal: canal → stream, canal → paquete, abonado → suscripción al paquete. Recargue WebTV después de cambiarlos.
  • Comprobación del resultado: el canal aparece en Canales disponibles y en WebTV, y el espectador ve su fotograma y programa actual. La suscripción determina los canales disponibles; una HLS directa operativa no la sustituye.

El canal está visible, pero no se reproduce

  • Síntoma: el canal aparece en la lista, pero el reproductor informa de un error o no inicia la reproducción.
  • Causas posibles: no hay un stream asignado al canal, hay otro stream asignado o la reproducción falla en la sesión de WebTV aunque el stream asignado funcione.
  • Comprobación: lea el mensaje del reproductor y compruebe el campo Stream del canal. This channel has no broadcast configured significa que no hay un stream asignado. Compare el nombre exacto del stream asignado con el playout_<id> del playout necesario. Si el stream correcto ya está asignado, no lo guarde ni lo asigne de nuevo. Compare primero la HLS directa de ese stream.
  • Acción: si falta el stream o es incorrecto, asigne el correcto siguiendo Cree el canal y guarde el canal. Si la HLS directa falla con el stream correcto ya asignado, vaya a La HLS directa tampoco se reproduce. Si la HLS directa se reproduce, recargue WebTV o abra una nueva sesión de WebTV en una ventana privada del navegador e inicie sesión otra vez. Si el reproductor sigue en silencio sin mostrar un error, continúe con La HLS directa se reproduce, pero WebTV permanece en silencio sin un error. Para un mensaje explícito sobre límites de pantallas o acceso del dispositivo, use El espectador informa de que nada se reproduce.
  • Comprobación del resultado: una sesión nueva de WebTV muestra el fotograma del canal con sonido y el programa actual. Si WebTV permanece en silencio, conserve para la escalada el resultado de la HLS directa que ya funciona; este resultado no identifica la causa del fallo del reproductor.

La HLS directa se reproduce, pero WebTV permanece en silencio sin un error

  • Síntoma: el stream correcto está asignado y la HLS directa se reproduce, pero una sesión nueva de WebTV no muestra vídeo ni un error del reproductor.
  • Causa posible: las pruebas limitan el fallo a la reproducción en esta sesión de WebTV, pero no identifican su causa. No deduzca un defecto del playout, el transcodificador, la red o el navegador solo por este síntoma.
  • Comprobación: anote si recargar WebTV y abrir una sesión nueva cambió el resultado. En un navegador de escritorio, abra las herramientas de desarrollo antes de recargar. Guarde los errores y avisos de Console, las solicitudes fallidas de Network y los estados HTTP de la página, los manifiestos HLS y los segmentos multimedia. No cambie código, flags del navegador ni el stream. Si el dispositivo no ofrece estas herramientas, registre esa limitación en lugar de conectar un depurador.
  • Acción: deje de cambiar el playout, el transcodificador y la asignación del canal solo por este síntoma. Escale al administrador del servicio o al soporte con el paquete siguiente; elimine contraseñas, cookies, tokens de acceso y parámetros secretos de las solicitudes.
  • Paquete para la escalada:

  • La página exacta de WebTV y la URL, sin credenciales ni tokens.

  • El nombre y la versión del navegador, además del dispositivo y el sistema operativo.
  • El resultado de la sesión nueva, incluido si se cargaron la lista de canales y la guía de programación.
  • Las pruebas de Console y Network, o una nota de que el dispositivo no permite recopilarlas.
  • El hecho de que la HLS directa ya funciona, con el nombre del stream y el programa que se reprodujo.

  • Comprobación del resultado: si WebTV empieza a reproducir, compruebe imagen, sonido y programa actual. Si permanece en silencio, el paquete registra el resultado de la sesión nueva y la comparación con la HLS directa que ya funciona sin inventar un diagnóstico.

La HLS directa tampoco se reproduce

  • Síntoma: el stream del playout no se reproduce ni en WebTV ni mediante su enlace directo; el manifiesto maestro puede contener solo una cabecera sin variantes de calidad.
  • Causa posible: el playout entrega vídeo YUV sin comprimir y audio PCM, y no hay un transcodificador configurado para un reproductor HLS normal.
  • Comprobación: abra el manifiesto maestro y compruebe si hay variantes de calidad. En la página del stream, abra Transcodificador e inspeccione Vista previa: entrada → salida. Si una advertencia informa de un error del transcodificador, use el diagnóstico específico.
  • Acción: configure el preset Escalera estándar 1080/720/360 + AAC como se describe en Elija la salida para los espectadores y guarde el transcodificador.
  • Comprobación del resultado: el manifiesto maestro contiene variantes de calidad, el manifiesto de una variante contiene segmentos multimedia y el reproductor muestra el bloque actual con sonido. Después compruebe por separado el acceso del abonado al canal.

Qué hacer a continuación