Reproductores web
Usa Reproductores web para publicar contenido en directo o grabado en el navegador con control de acceso, entrega adaptativa, embeds y URLs para espectadores.
Elige este módulo cuandoUna fuente en directo o grabada necesita una URL o embed HLS/DASH con acceso o pay-per-view.
Usa otro módulo cuandoUsa Multiview para operadores; usa Grupos de reproductores web cuando la audiencia necesita varios reproductores.
/api/vod/createAntes de empezar
Todos los métodos de gestión requieren un x-access-token válido. Prepara primero el recurso de entrada y decide si la reproducción será abierta, estará protegida por contraseña, formará parte de un grupo o estará vinculada a pay-per-view.
Qué puedes hacer
createyupdateconfiguran la entrada, el tipo de reproducción, el empaquetado, el bitrate adaptativo, el acceso, la agrupación y los ajustes de pay-per-view.getAll,getCountygetByIdconsultan los reproductores.startystopcontrolan la disponibilidad de la reproducción.getStatdevuelve el bitrate de entrada y la cadencia disponibles para el proceso del reproductor.removeelimina un reproductor.
Flujo de ejemplo
- Crea un reproductor desde un servidor SRT, servidor RTMP u otra entrada multimedia compatible.
- Elige reproducción HLS o DASH y ajusta la duración de los segmentos y el bitrate adaptativo según la latencia y resiliencia necesarias.
- Aplica acceso abierto, mediante contraseña, por grupo o pay-per-view.
- Inicia el reproductor y comprueba
getStatantes de probar la URL del espectador. - Valida la reproducción y el embed en navegadores y redes representativos.
Casos de uso habituales
- Publicar una señal de contribución SRT o RTMP como reproducción en directo embebida.
- Proteger un stream de revisión para partners mediante credenciales de espectador.
- Entregar un evento de pago mediante el acceso pay-per-view configurado.
- Crear variantes por idioma dentro de un grupo de reproductores web.
Límites y resolución de problemas
Que la página cargue correctamente no demuestra que el proceso multimedia upstream esté estable; comprueba getStat. Los fragmentos más pequeños pueden reducir la latencia, pero aumentan el número de solicitudes y la sensibilidad a las variaciones de red. Prueba la autorización, el pago, la política de embed, los códecs y las variantes adaptativas antes de publicar.
Siguientes pasos
Abre el reproductor en un navegador, comprueba el acceso y la reproducción y usa después Grupos de reproductores web cuando los espectadores necesiten varias señales seleccionables.
Publicar un archivo gestionado para reproducción web
Prepara el archivo, crea un reproductor con el preset de archivo adecuado y valida la reproducción HLS o DASH generada.
- Subir la fuenteCrea el archivo gestionado y conserva su id para la entrada del reproductor.
POST /api/files/uploadFile - Crear la reproducción VODElige el preset de archivo, el formato, la política de acceso y la presentación.
POST /api/vod/create - Iniciar y probar el reproductorInicia el recurso y prueba su URL en navegadores representativos.
POST /api/vod/start
El reproductor es un recurso de entrega; gestiona el archivo por separado y comprueba autorización, códecs y reproducción antes de publicar la URL.
Crea un reproductor web mediante POST /api/vod/create. Envía el JWT generado en el panel mediante la cabecera x-access-token.
La solicitud combina una entrada en directo con entrega HLS o DASH, bitrate adaptativo opcional, transcodificación, overlays, autorización de espectadores, pay-per-view, grupo y presentación.
Ejemplos de solicitud
Elige la plantilla correspondiente a la reproducción y política de acceso y añade solo los campos que necesite la experiencia del espectador.
Casos de uso habituales
- Publicar un evento como HLS listo para el navegador.
- Insertar un reproductor protegido por contraseña o autorización.
- Preparar idiomas, ángulos o comentarios para una experiencia agrupada.
Después de iniciar un reproductor en directo, usa su URL y supervisa espectadores, bitrate y FPS.
Utiliza este preajuste cuando una fuente SRT gestionada deba convertirse en un endpoint público de reproducción en el navegador sin restricciones de acceso.
Es la configuración más directa para ofrecer un reproductor en directo abierto en el navegador. La capa del reproductor se encarga del empaquetado y la reproducción, mientras la fuente continúa gestionada en el origen.
Así, el contrato de reproducción permanece estable aunque el transporte de entrada de la fuente siga siendo RTMP.
Utiliza este preajuste cuando el reproductor deba existir sin exponerse como página pública. El endpoint del navegador se genera, pero el acceso queda protegido mediante credenciales del reproductor.
Es adecuado para revisiones con socios, pases internos, avances premium o cualquier caso en el que el control de acceso deba residir en la propia capa de reproducción.
Utiliza este preajuste cuando un reproductor deba incorporarse a un grupo de endpoints relacionados, por ejemplo, para distintos idiomas, programas o vistas alternativas de un evento.
Los reproductores agrupados resultan útiles cuando la experiencia del navegador abarca más que una URL aislada y el espectador debe alternar entre variantes relacionadas.
Utiliza este preajuste cuando el navegador deba reproducir bitrate adaptativo en lugar de una única variante sin escalado.
El producto vincula el bitrate adaptativo con los ajustes de reproducción y la transcodificación. Es útil cuando la estabilidad del inicio y la adaptación de calidad para el espectador importan más que una única variante fija.
Etiqueta del panel: Nombre del reproductor.
Nombre descriptivo del endpoint de reproducción. El formulario de creación requiere este campo.
Tipo de reproductor. El flujo predeterminado para emisiones en directo utiliza VOD_TYPE_LIVE_STREAM; el producto también admite modalidades bajo demanda.
Descriptor de tipo multimedia opcional almacenado en el objeto reproductor.
Etiqueta del panel: Tipo de entrada.
Definición de entrada creada a partir del formulario común de fuentes. Las entradas del producto incluyen servidores SRT, servidores RTMP, rutas SRT y fuentes en directo mediante URL.
Ajustes de bitrate adaptativo del reproductor. El producto utiliza input_resolution como criterio principal de entrega y vincula ABR con la capa de transcodificación.
Etiqueta del panel: Tamaño del fragmento HLS.
La interfaz recomienda 3 segundos para obtener una buena experiencia HLS.
Etiqueta del panel: Duración del fragmento HLS.
La interfaz recomienda 60 segundos.
Controles de tamaño y duración de los fragmentos DASH guardados con el objeto del reproductor.
Etiqueta del panel: Cantidad mínima de fragmentos HLS.
Define cuántos fragmentos se precargan antes de comenzar la reproducción.
Etiqueta del panel: Margen respecto al directo.
Define a cuántos fragmentos del más reciente debe comenzar la reproducción en directo.
Ajustes de autorización del reproductor. La interfaz los utiliza para exigir que el espectador se autentique antes de abrir el reproductor web.
Bloque opcional de asignación a un grupo con group_id, el name visible dentro del grupo y el estado predeterminado selected.
Bloque opcional de monetización. Para la mayoría de los reproductores, el estado deshabilitado continúa siendo el valor predeterminado.
Ajustes opcionales de presentación e identidad visual del reproductor mostrado en el navegador.
Metadatos opcionales de evento y soporte almacenados con el objeto reproductor.
Bloques opcionales de procesamiento multimedia para los casos en que el reproductor necesite más que un simple empaquetado sin cambios.
Etiqueta del panel: Habilitar después de crear.
Define si el reproductor debe quedar activo inmediatamente después de crearlo.
Id de recurso que se devuelve al crear o listar el reproductor web.
Alias de acceso directo para _id.
Nombre almacenado para el objeto reproductor.
Tipo de reproductor y campos de tipo de medios guardados en el objeto.
Puerto interno generado que utiliza el proceso de entrega del reproductor.
Objeto u objetos de entrada vinculados que utiliza el flujo de reproducción.
Ajustes de reproducción y entrega guardados en el objeto del reproductor.
Estado de acceso, monetización, grupo y autorización de espectadores guardado en el reproductor.
Ajustes de presentación y visibilidad devueltos con el objeto reproductor.
Indicador del estado de ejecución actual del reproductor.
Marcas de tiempo gestionadas por el backend.
El modelo expone success: true como un campo virtual en respuestas exitosas.