Metadatos

Descripción general

El motor de transformación de Roku convierte los metadatos de las empresas socias al formato que utiliza su sistema de ingesta. Usa los nombres de elementos y campos acordados durante la incorporación y mantenlos en todas las entregas. Independientemente de los nombres, los datos de cada campo deben cumplir con la Especificación de ingesta de Roku Channel.

• Si ya utilizas un formato XML para entregar contenido a otras plataformas, es posible que puedas reutilizarlo para la entrega a Roku.
• Puedes proporcionar una muestra de tu formato de metadatos existente durante la incorporación para que Roku evalúe su validez para la ingesta.
• Independientemente del formato que se entregue, se deben proporcionar todos los elementos/campos obligatorios en el entregable de metadatos.

Documentación relacionada

Estos requisitos aplican a todos los formatos de entrega de metadatos. Para consultar los campos y las instrucciones de entrega de cada formato, revisa:

• MovieLabs: entrega de MEC y MMC
• XML de Roku: referencias de campos para Película, TV y Clip
• Excel de Roku: referencias de campos para Película, TV y Clip

---

Definiciones de tipos de contenido

Roku Channel admite tres tipos de contenido: tv, film y clip. Todo el contenido debe entregarse bajo uno de estos tres tipos, y los títulos deben entregarse bajo el mismo tipo de contenido en el que el programa se publicó originalmente.

TV

El contenido estructurado en una jerarquía de serie > temporada > episodio debe entregarse bajo la especificación de TV.

• Serie: una colección de programas/episodios publicados bajo un título común, con una narrativa, personajes o temática consistentes. En Norteamérica, cada año de una serie se denomina temporada; una serie puede abarcar varias temporadas.
• Temporada: un grupo de programas/episodios publicados en un año, atribuidos a una sola serie.
• Episodio: un segmento narrativo o informativo autónomo de una serie. Un episodio pertenece exactamente a una temporada de una sola serie.

Película

Los programas independientes que no forman parte de una jerarquía de serie/temporada/episodio deben entregarse bajo la especificación de Película. Esto incluye largometrajes, especiales de TV independientes y cortometrajes.

Clip

Los títulos de formato corto, independientes o auxiliares, pensados como complemento de un programa más largo (por ejemplo, eventos deportivos, películas, series de TV), deben entregarse bajo la especificación de Clip.

La presentación de los Clips y su comportamiento en la plataforma difieren de los de Película:

• La duración y el título aparecen directamente en la miniatura, sin necesidad de abrir el clip.
• Los Clips no cuentan con una página de detalles del contenido. A diferencia de Película, la persona usuaria no puede entrar a un Clip para ver una sinopsis o una pantalla con información adicional.
• En su lugar, se puede acceder a la sinopsis de un Clip presionando el botón * (asterisco/opciones) del control remoto de Roku.

---

Metadatos mínimos requeridos por tipo de contenido

brief_synopsis se aplica a nivel de título, episodio y serie, incluidas las versiones localizadas. Obligatorio para la distribución en Linear OTT. Tiene un límite de 100 caracteres.

Las sinopsis extensas siempre son opcionales, incluidas las versiones localizadas. Es muy recomendable entregar subtítulos descriptivos para todo el contenido; la empresa socia determina si son obligatorios para una entrega específica. Cuando se entregue un archivo sidecar de subtítulos descriptivos, incluye la referencia captions file_name. Consulta los requisitos de archivo en Subtítulos descriptivos y subtítulos.

Película / Clip: campos obligatorios

• provider
• content_type
• asset_id
• title
• release_date
• runtime
• genres
• rating
• rating_system
• short_synopsis
• video file_name
• key_art file_name

TV: Campos obligatorios

A nivel de episodio:

• provider
• content_type
• asset_id
• episode title
• episodeNumber
• episode release_date
• runtime
• rating
• rating_system
• episode short_synopsis
• video file_name
• episode thumbnail file_name

A nivel de serie:

• series_id
• series title
• series release_date
• series genres
• series short_synopsis
• series key_art file_name

A nivel de temporada:

• season_id
• seasonNumber

TV requiere metadatos en tres niveles: serie, temporada y episodio. Película y Clip requieren metadatos del título individual.

---

Requisitos y expectativas de ID

• La empresa socia genera y proporciona todos los ID. Roku no los asigna.
• Todo clip y película debe entregarse con un asset_id.
• Todo episodio debe entregarse con tres ID: asset_id, series_id y season_id.
• Se recomienda usar ID significativos para tu equipo, ya que son la forma en que Roku identifica de manera inequívoca un título en su sistema.
• El asset_id en los metadatos de ingesta debe coincidir con el Title ID proporcionado en el documento de Avails. Esto vincula el contenido a lo largo del proceso de Roku, desde el envío de Avails hasta la publicación.
• Cualquier actualización a un título ya ingerido en el sistema de Roku debe ir acompañada de su asset_id.

Todos los tipos de ID comparten estas reglas:

• Máximo 50 caracteres
• Solo caracteres alfanuméricos, guiones y guiones bajos
• Los espacios o caracteres especiales en cualquier ID provocarán un error en la ingesta

---

Hojas y planificadores de disponibilidad

• Durante la incorporación, Roku solicita una lista de lanzamiento inicial de títulos/episodios/clips actualmente disponibles para licenciamiento, además de un calendario de cuándo se actualizará el contenido.
• Para la entrega continua, Roku solicita:
  • Avails al menos 60 días antes del inicio de la ventana de licenciamiento
  • Entrega de contenido al menos 30 días antes de la curaduría en el canal

Este tiempo de anticipación permite el procesamiento y el control de calidad antes de que el contenido salga al aire. La capacidad de entrega se coordina después de la firma.

---

Períodos de disponibilidad

De forma predeterminada, el contenido pasa a estar disponible a las 12:00 a. m. (medianoche) y caduca a las 11:59:59 p. m. en la zona horaria local de cada persona usuaria. Si un título debe salir al aire o caducar a una hora específica, esa hora debe incluirse en los valores de inicio/fin de la ventana de licencia en los metadatos de ingesta.

Roku admite dos tipos de designación horaria:

Formato del valor de hora

• Las horas absolutas deben expresarse en UTC. En el ejemplo anterior, las 9:00 p. m., hora del este, del 1 de noviembre equivalen a la 1:00 a. m. UTC del 2 de noviembre.
• Si no se proporciona ninguna hora, Roku asume un inicio relativo de 12:00:00 a. m. y un fin relativo de 11:59:59 p. m..

---

Caracteres especiales

Roku utiliza secciones CDATA para permitir caracteres especiales (por ejemplo, ! @ # $ % ^ & * ( ) { } | [ ] ; : ' " ? / < >, así como conjuntos de caracteres extranjeros) dentro de determinados valores de nodo en el XML de ingesta. Roku recomienda encarecidamente incluir estos datos en secciones CDATA para garantizar una ingesta correcta.

CDATA aplica a los valores de los campos de metadatos, como títulos y sinopsis. Los nombres de archivo siguen las reglas de la Especificación de entrega de archivos.

Solo los siguientes nodos admiten secciones CDATA:

• title
• brief_synopsis
• long_synopsis
• short_synopsis
• display_name

En los nodos que no figuran en esta lista, los siguientes caracteres deben escribirse con su forma de escape para que Roku pueda leer el XML:

Nunca deben utilizarse caracteres especiales en los nombres de archivo ni en las referencias a nombres de archivo dentro de los metadatos en XML o Excel. Consulta las Pautas de nomenclatura de archivos para ver la lista completa de caracteres prohibidos específicamente para nombres de archivo.

---

Formatos de metadatos admitidos

• XML es el formato preferido.
• Se debe entregar un archivo XML completo por cada archivo de video de película, clip o episodio de TV entregado.
• Los metadatos deben entregarse mediante el método aprobado durante la incorporación, Aspera o S3, en la misma ubicación de carpeta que sus archivos asociados de video, subtítulos e ilustraciones.

---

Hojas de referencia musical

Puedes enviar las hojas de referencia musical del contenido distribuido en Roku Channel mediante el formulario de envío de hojas de referencia musical.

No envíes hojas de referencia musical junto con los archivos del paquete de video mediante Aspera. Las hojas entregadas con un paquete de video están sujetas a eliminación.

---

Glosario