Groups
Qué es un Destination group
Un Destination group es un ramillete con nombre de Destinations al que un Live stream emite en paralelo. Enlazar un Destination group a un Live stream cablea cada miembro a la vez y permite al Operator activar o desactivar miembros individuales en runtime sin desenlazar el ramillete.
Un Destination group es independiente de los Live streams que respalda. El mismo grupo puede respaldar muchos Live streams, y el mismo Destination puede pertenecer a varios grupos.
Modelo pool y slots
Un grupo es un pool: admite hasta 20 Destinations, sin importar para cuántos publishing points esté licenciado el Encoder (Multi Publishing Points). La licencia determina cuántos miembros pueden estar activos a la vez, no cuántos puede contener el grupo. Los miembros activos siempre ocupan un slot hasta el número licenciado; los miembros detenidos comparten los slots restantes, así que activar uno puede tomar el slot de uno detenido. Ningún Destination activo se descarta nunca para hacer hueco.
Cómo funciona
Define
Pulsa Add publishing group y elige los miembros. El grupo expone solo los campos canónicos:
| Campo | Notas |
|---|---|
| Name | Nombre visible. |
| Destinations assigned to this group (etiqueta del editor) | Checkbox grid de todos los Destinations disponibles. Los Destinations marcados son los miembros activos del grupo. En demo.yml y en la API este campo se llama members. |
Enlaza
Enlaza el grupo a un Live stream desde el editor de Live streams — elígelo en el campo Destination. El editor coloca los grupos bajo "Destination groups" y los Destinations individuales bajo "Destinations"; cualquiera es un binding válido.
Buscar y filtrar
La barra de búsqueda de la pestaña Groups acepta texto pero no filtra la lista en la versión actual de la UI. Para reducir la vista, navega directamente al grupo objetivo desde el editor de Live streams o cambia a la pestaña Destinations que sí permite búsqueda por subcadena.
Control en runtime
Una vez que el Live stream enlazado está al aire, el Operator trabaja el grupo desde el panel Destinations del cluster de runtime, que se refresca cada pocos segundos, de modo que las ediciones de pertenencia y estado aparecen sin recargar manualmente:
- Alternar miembros. Activa o desactiva el estado primary y backup de cada miembro de forma independiente. La operación API es
runtimeTogglePublishings: envía una lista de toggles{entry_point_id, primary, backup}y el broadcast en marcha los aplica sin detenerse. Solo estado — las renditions y las pistas de audio son inmutables en runtime; para cambiar qué renditions del Encoding group enlazado transporta un Destination, el Live stream debe detenerse. - Editar la pertenencia en uso. Añade o quita Destinations de un grupo mientras respalda Live streams en marcha — ver Editar un grupo en uso.
Editar un grupo en uso
Un grupo puede editarse mientras uno o más Live streams están emitiendo sobre él, y el cambio se aplica sin parar y arrancar.
- Añadir un Destination. Siempre permitido, hasta el límite del pool de 20 miembros. En un Live stream en marcha el nuevo miembro entra apagado; actívalo desde el panel Destinations de On Air para engancharlo en directo. Si todos los slots licenciados ya están activos, el enganche se rechaza con un conflicto
409("no free publishing slot") — detén un miembro antes para liberar un slot. - Quitar un Destination. Permitido solo cuando ese Destination está inactivo en todos los Live streams en marcha; si sigue al aire en alguno, la eliminación se rechaza con un conflicto
409. Cuando la eliminación tiene éxito su slot se libera de inmediato, así el panel de On Air refleja la edición al instante.
409 con el motivo. Añádelos antes de salir al aire para que se enganchen de inmediato.Cross-links
- Destinations para el catálogo por-Destination y los tipos soportados.
- Live streams para el binding desde un Live stream a su Destination group.
FAQ
runtimeTogglePublishings para sacar del aire al miembro que falla mientras el Live stream sigue corriendo en el resto del grupo; el Live stream en sí no se detiene.