Skip to content

Plantillas de streams

Cuando hay decenas de streams, nadie quiere reescribir los mismos ajustes de transcodificador y de archivo en cada uno. Una plantilla es un conjunto de valores por defecto para las secciones de configuración del stream. Un stream apunta a una plantilla, y las secciones de la plantilla se aplican allí donde el stream no tiene las suyas.

Una plantilla no es una programación ni un grupo: no arranca nada y no es dueña de ningún stream. Lo único que hace es aportar valores a los streams que la referencian.

Qué secciones define una plantilla

Una plantilla puede definir seis secciones de configuración, y solo esas:

  • Transcodificador — escalera, presets, reglas de audio, GOP; véase Transcodificación y MBR.
  • DVR — grabación del archivo: profundidad, discos, retención; véase Archivo DVR.
  • Miniaturas — véase Miniaturas.
  • Tiempos de espera de fuentes — comportamiento cuando una entrada desaparece; véase Reserva de fuentes.
  • Ventana en vivo — la longitud de la ventana en vivo en segmentos.
  • Voz a texto — la sección existe en el contrato de la plantilla, pero la consola todavía no tiene un formulario para ella: no se puede establecer desde la interfaz.

Todo lo demás — fuentes, el nombre, la referencia a un backend de autorización — la plantilla no lo define: son propiedades de un stream concreto.

La regla de resolución: la sección propia gana entera

No hay fusión campo a campo. La sección se toma entera: si el stream tiene su propia sección de transcodificador, no se aplica ni un solo campo de la de la plantilla. Si no la tiene, rige la de la plantilla.

De ahí se siguen dos consecuencias prácticas:

  • Para cambiar un solo campo respecto a la plantilla, el stream tendrá que llevar la sección completa, con el resto de sus campos incluidos.
  • Una sección vacía y una sección ausente son lo mismo. Una lista de miniaturas vacía y null cuentan como no definidas, y la plantilla toma el relevo en su lugar.

Una referencia a una plantilla que no existe equivale a no tener referencia: el stream funciona con sus propias secciones. La página del stream lo indica — La plantilla {name} no existe.

La lista de plantillas

La pantalla Plantillas contiene todas las plantillas de la instalación. Escriba un nombre en Nombre de la nueva plantilla y pulse Crear. La columna Secciones muestra qué secciones define realmente la plantilla — una plantilla vacía no afecta a nada.

La lista de plantillas: la columna Secciones muestra qué define una plantilla

Eliminar una plantilla que algo aún referencia se rechaza: No se puede eliminar: hay streams que referencian esta plantilla. Quite la referencia primero. Es una protección contra perder en silencio los ajustes de decenas de streams a la vez.

La página de la plantilla

Las pestañas reflejan las secciones: Transcodificador, DVR, Miniaturas, Tiempos de espera de fuentes (que también lleva el campo Ventana en vivo) y Streams que usan esta plantilla.

Los formularios son los mismos que en la página del stream, con una salvedad: una plantilla no tiene entrada por definición. La escalera del transcodificador se edita sin pistas de las pistas de la fuente, y no hay vista previa de entrada ni sustitución desde un flujo real — no hay de dónde tomarla.

La página de la plantilla: las pestañas reflejan las secciones de configuración

Un punto en una pestaña significa que hay ediciones sin guardar en esa sección. Guardar y Cancelar se comportan como en la página del stream: Guardar solo está activo mientras haya ediciones sin guardar, Cancelar revierte a la base aceptada.

La pestaña Streams que usan esta plantilla lista los streams que la referencian; en una lista larga indica que se muestran los primeros N. Mírela antes de editar: editar una plantilla cambia el comportamiento de todos esos streams a la vez.

La plantilla vista desde un stream

La plantilla se elige en la pestaña de ajustes básicos del stream con el campo Plantilla (Sin plantilla quita la referencia). La lista de streams tiene una columna Plantilla.

Cada sección de la página del stream está en uno de cuatro estados:

  • Propia — la sección está definida en el stream y la plantilla no la define.
  • De la plantilla {name} — no hay sección propia, así que rige la de la plantilla. Se muestra en solo lectura.
  • Sobrescribe la plantilla {name} — la sección está definida en ambos sitios y gana la del stream. Este estado se señala a propósito: de otro modo, una desviación consciente de la plantilla sería indistinguible de un stream que no sabe nada de plantillas.
  • Vacía — ni el stream ni la plantilla definen la sección.

Dos botones cambian el estado:

  • Sobrescribir — copia la sección de la plantilla en el stream y la hace editable. La sección pasa a sobrescribir.
  • Volver a la plantilla — elimina la sección propia del stream, y vuelve a regir la de la plantilla.

La lista de streams y las columnas que leen secciones — transcodificador, DVR, reserva de fuentes — muestran los valores efectivos, es decir con la plantilla ya sustituida, y no el documento en bruto del stream.