XML - campos de metadatos de TV por episodios

Descripción general

Usa esta referencia para preparar los metadatos XML de TV. Roku organiza el contenido de TV como series > season > episode; consulta las Definiciones de tipo de contenido. Descarga el esquema y la muestra anotada en la Descripción general de metadatos XML de Roku.

Los campos title, brief_synopsis, short_synopsis, long_synopsis, cast, crew y localizations aparecen tanto a nivel de episodio como de serie. Los encabezados indican el nivel, por ejemplo, "Título del episodio" y "Título de la serie".

Los campos se organizan en Información del paquete, Descriptores de contenido del episodio, Cortes publicitarios y puntos de referencia, Reparto y equipo de filmación del episodio, Localizaciones del episodio, Bloque de la serie, Bloque de la temporada, Opciones de reproducción/Disponibilidad y Activos.

Información del paquete

package

Identifica la versión del esquema que utiliza el paquete.

<package version="tv1.0">

provider

Nombre del propietario del contenido, estudio o cadena.

<provider>Roku Originals</provider>

language

Idioma principal de los metadatos del paquete. Como mínimo, debe ajustarse a un código de idioma admitido. Se recomienda incluir un código de región, por ejemplo, es-MX o es-ES.

<language>en</language>

type

Define el tipo de contenido del paquete.

<type>tv</type>

asset_id (episodio)

Identificador único de un episodio que debe permanecer sin cambios. La empresa socia genera y proporciona el ID. El ID de los metadatos de ingesta debe coincidir con el ID de título (Title ID) del documento de Avails para facilitar el seguimiento desde el envío de Avails hasta la publicación. Límite de 50 caracteres.

<asset_id>episodeAssetIdHere</asset_id>

eidr

ID de EIDR, si existe uno.

<eidr></eidr>

tmsId

ID de Gracenote, si existe uno.

<tmsId></tmsId>

Descriptores de contenido del episodio

Título del episodio

Título del episodio. Incluye solo el nombre tal como debe aparecer en la plataforma. No agregues datos entre paréntesis que no formen parte del título (por ejemplo, (Clásica), (1987), (Temporada 1), (HD)).

<title><![CDATA[Episode Title. Required.]]></title>

episodeNumber

Posición numérica del episodio dentro de su temporada. Determina el orden de reproducción en la plataforma. Los valores deben reflejar el orden original de emisión/exhibición; no deben usarse números de producción. Solo números enteros.

<episodeNumber>2</episodeNumber>

brief_synopsis (episodio)

Una sinopsis del episodio. Admite CDATA. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.

<brief_synopsis><![CDATA[Brief episode summary. 100 characters maximum. Required for Linear OTT distribution.]]></brief_synopsis>

short_synopsis (episodio)

Sinopsis breve del episodio. Admite CDATA. Límite de 250 caracteres.

<short_synopsis><![CDATA[Short summary of episode. 250 characters maximum. Required]]></short_synopsis>

long_synopsis (episodio)

Opcional. Sinopsis larga del episodio. Admite CDATA. Límite de 500 caracteres.

<long_synopsis><![CDATA[Long summary of episode. 500 characters maximum. Optional.]]></long_synopsis>

closedCaptions

Este campo Y/N es obligatorio para todo el contenido destinado a Roku Channel en EE. UU. Indica si se incluyen subtítulos descriptivos; consulta la entrega de subtítulos descriptivos para los requisitos del archivo.

<closedCaptions>Y</closedCaptions>

closedCaptionsExemption

Código de exención de la FCC para el requisito de subtítulos descriptivos. Obligatorio si closedCaptions = N.

<closedCaptionsExemption>1</closedCaptionsExemption>

release_date (episodio)

Fecha original en la que el episodio estuvo disponible por primera vez en cualquier presentación. Debe incluir, como mínimo, un año de estreno correcto.

<release_date>YYYY-MM-DD</release_date>

runtime

Duración total del episodio, en minutos enteros.

<runtime>45</runtime>

rating (episodio)

Clasificación de contenido/edades de una fuente de clasificación. Se debe proporcionar, para cada episodio, una clasificación válida de TV emitida por la autoridad de clasificación (ratingSystem) del territorio en el que estará disponible el contenido. Si no ha sido clasificado por la autoridad oficial de ese territorio, usa en su lugar una clasificación válida de USA_PR, según las pautas de tvguidelines.org (no existe un organismo oficial de clasificación para USA_PR).

<ratings>
<rating system="MPAA" reason="For drug content, some sensuality and war violence.">PG-13</rating>
<rating system="BBFC">12A</rating>
<rating system="CHVRS">14A</rating>
</ratings>

tag (episodio)

Las etiquetas permiten clasificar el contenido más allá de su género. El equipo editorial y el motor de recomendaciones de Roku las usan para ayudar a los usuarios a encontrar contenido. No hay límite en la cantidad de etiquetas ni una lista predefinida. Las etiquetas distinguen entre mayúsculas y minúsculas; úsalas de manera consistente.

<tags>
  <tag>energy</tag>
  <tag>dance</tag>
  <!-- Additional tags here-->
</tags>

Cortes publicitarios y puntos de referencia

adBreak start_time

Se utiliza para determinar los cortes publicitarios para contenido financiado con anuncios. Los valores deben tener precisión de milisegundos. Si hay negros comerciales presentes, proporciona el código de tiempo en el punto medio. No es obligatorio para SVOD, pero se pueden ingerir datos con precisión de fotogramas si están disponibles.

<adBreaks>
  <adBreak>
    <start_time>00:03:15.000</start_time>
  </adBreak>
  <adBreak>
    <start_time>00:07:45.425</start_time>
  </adBreak>
<!-- Additional adBreaks here-->
</adBreaks>

cuePoint start_time y end_time

Identifica los puntos de entrada/salida de los créditos iniciales, resúmenes, créditos finales y material detrás de cámaras. Las etiquetas cuePoint deben incluir el atributo type. Los valores deben tener precisión de milisegundos.

<cuePoints>
	<cuePoint type="ad overlay">
		<start_time>00:09:10.456</start_time>
		<end_time>00:09:12.678</end_time>
	</cuePoint>
	<cuePoint type="behind the scenes">
		<start_time>00:07:08.123</start_time>
		<end_time>00:07:59.123</end_time>
	</cuePoint>
	<cuePoint type="intro">
		<start_time>00:01:08.123</start_time>
		<end_time>00:01:59.123</end_time>
	</cuePoint>
	<cuePoint type="recap">
		<start_time>00:21:08.123</start_time>
		<end_time>00:21:59.123</end_time>
	</cuePoint>
	<cuePoint type="end">
		<start_time>00:41:08.123</start_time>
		<end_time>00:41:59.123</end_time>
	</cuePoint>
</cuePoints>

cuePoint atributo type

Define el tipo de un cuePoint dado. El nombre del atributo debe ser type. Todo cuePoint que se proporcione requiere start_time y end_time, sin importar el tipo.

<cuePoint type="intro">

Reparto y equipo de filmación del episodio

cast display_name (episodio)

Nombre de un miembro del reparto del episodio. Admite CDATA.

<cast>
  <cast_member>
    <display_name><![CDATA[Harrison Ford]]></display_name>
  </cast_member>
<!-- Additional cast members here-->
</cast>

crew display_name (episodio)

Nombre de un miembro del equipo de filmación del episodio. Admite CDATA.

Entregas en Excel: Director es la única función de crew_member admitida. XML admite la lista completa de funciones del equipo de filmación.

<display_name><![CDATA[George Lucas]]></display_name>

crew role (episodio)

Función del miembro del equipo de filmación indicado en display_name. Todo miembro del equipo de filmación debe incluir también su función. Consulta la lista enumerada de funciones del equipo de filmación. Las funciones distinguen entre mayúsculas y minúsculas.

<role>Director</role>

Localizaciones del episodio

localizations (episodio)

Contiene los metadatos localizados del episodio: idioma, título traducido, brief_synopsis, short_synopsis y long_synopsis.

<localizations>

localization atributo name (episodio)

Define el idioma de los campos localizados dentro de un bloque localization del episodio. El nombre del atributo debe ser name; el valor debe, como mínimo, ajustarse a un código de idioma admitido (se recomienda incluir código de región, por ejemplo, es-MX frente a es-ES).

<localization name="es">

Título localizado del episodio

Título localizado del episodio. También se aplican las restricciones sobre datos entre paréntesis indicadas en Título del episodio. Debe ir acompañado de una short_synopsis localizada. La long_synopsis localizada es opcional.

<title><![CDATA[Localized Episode Title. Required.]]></title>

brief_synopsis localizado (episodio)

Una sinopsis localizada del episodio. Admite CDATA. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT. El idioma se define en el atributo name del bloque localization que la contiene.

<brief_synopsis><![CDATA[Localized brief episode summary. 100 characters maximum. Required for Linear OTT distribution.]]></brief_synopsis>

short_synopsis localizado (episodio)

Admite CDATA. Límite de 250 caracteres. Debe ir acompañado de un title localizado. La long_synopsis localizada es opcional.

<short_synopsis><![CDATA[Localized Short summary of episode. 250 characters maximum. Required]]></short_synopsis>

long_synopsis localizado (episodio)

Opcional. Admite CDATA. Límite de 500 caracteres. Si se proporciona, debe acompañar a title y short_synopsis localizados.

<long_synopsis><![CDATA[Localized Long summary of episode. 500 characters maximum. Optional.]]></long_synopsis>

Bloque de la serie

series

Inicia el bloque que hace referencia a los metadatos del programa al que pertenece el episodio. Roku sigue la definición estadounidense de serie. Los episodios se anidan como series > season > episode.

<series>

series_id

Identificador único e inalterable de una serie. La empresa socia genera y proporciona el ID, que debe coincidir con el ID de serie del documento de Avails. Límite de 50 caracteres.

<series_id>seriesIdHere</series_id>

Título de la serie

Título de la serie. Incluye solo el nombre tal como debe aparecer en la plataforma. No agregues datos entre paréntesis que no formen parte del título.

<title><![CDATA[Series Title. Required.]]></title>

brief_synopsis (serie)

Una sinopsis de la serie. Admite CDATA. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.

<brief_synopsis><![CDATA[Brief series summary. 100 characters maximum. Required for Linear OTT distribution.]]></brief_synopsis>

short_synopsis (serie)

Admite CDATA. Límite de 250 caracteres.

<short_synopsis><![CDATA[Short summary of series. 250 characters maximum. Required]]></short_synopsis>

long_synopsis (serie)

Opcional. Admite CDATA. Límite de 500 caracteres.

<long_synopsis><![CDATA[Long summary of series. 500 characters maximum. Optional.]]></long_synopsis>

original_spoken_language

Idioma original de producción de la serie. Como mínimo, debe ajustarse a un código de idioma admitido (se recomienda incluir código de región).

<original_spoken_language>en</original_spoken_language>

country_of_origin

El país principal donde se produjo la serie, y donde están establecidos los principales creadores, el equipo de filmación y los productores. Debe ajustarse a un código admitido según ISO 3166-1 alfa-2.

<country_of_origin>US</country_of_origin>

release_date (serie)

Fecha original en la que la serie estuvo disponible por primera vez, normalmente la fecha de estreno del primer episodio. Debe incluir, como mínimo, un año de estreno correcto.

<release_date>YYYY-MM-DD</release_date>

genre

Clasificación por género. Cada episodio debe entregarse con al menos un género admitido a través de su registro de serie. Consulta la lista enumerada de géneros.

<genres>
  <genre>drama</genre>
  <!-- Additional genres here-->
</genres>

tag (serie)

Las etiquetas permiten clasificar la serie más allá de su género. Se aplican las mismas reglas que para tag (episodio): distinguen entre mayúsculas y minúsculas, no tienen límite de cantidad y no hay una lista predefinida.

<tags>
  <tag>energy</tag>
  <tag>dance</tag>
  <!-- Additional tags here-->
</tags>

cast display_name (serie)

Nombre de un miembro del reparto de la serie. Admite CDATA.

<cast>
  <cast_member>
    <display_name><![CDATA[Harrison Ford]]></display_name>
  </cast_member>
<!-- Additional cast members here-->
</cast>

crew display_name (serie)

Nombre de un miembro del equipo de filmación de la serie. Admite CDATA.

Entregas en Excel: Director es la única función de crew_member admitida.

<display_name><![CDATA[George Lucas]]></display_name>

crew role (serie)

Función del miembro del equipo de filmación indicado en display_name. Consulta la lista enumerada de funciones del equipo de filmación. Distingue entre mayúsculas y minúsculas.

<role>Director</role>

localizations (serie)

Contiene los metadatos localizados de la serie para paquetes multilingües.

<localizations>

localization atributo name (serie)

Define el idioma de los campos localizados dentro de un bloque localization de la serie. El nombre del atributo debe ser name; el valor debe, como mínimo, ajustarse a un código de idioma admitido (se recomienda incluir código de región).

<localization name="es">

Título localizado de la serie

Título localizado de la serie. También se aplican las restricciones sobre datos entre paréntesis indicadas en Título de la serie. Debe ir acompañado de una short_synopsis localizada. La long_synopsis localizada es opcional.

<title><![CDATA[Localized Series Title. Required.]]></title>

brief_synopsis localizado (serie)

Una sinopsis localizada de la serie. Admite CDATA. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT. El idioma se define en el atributo name del bloque localization que la contiene.

<brief_synopsis><![CDATA[Localized brief series summary. 100 characters maximum. Required for Linear OTT distribution.]]></brief_synopsis>

short_synopsis localizado (serie)

Admite CDATA. Límite de 250 caracteres. Debe ir acompañado de un title localizado. La long_synopsis localizada es opcional.

<short_synopsis><![CDATA[Localized Short summary of series. 250 characters maximum. Required]]></short_synopsis>

long_synopsis localizado (serie)

Opcional. Admite CDATA. Límite de 500 caracteres. Si se proporciona, debe acompañar a title y short_synopsis localizados.

<long_synopsis><![CDATA[Localized Long summary of series. 500 characters maximum. Optional.]]></long_synopsis>

Bloque de la temporada

season

Inicia el bloque que hace referencia a los metadatos de la temporada de la serie a la que pertenece el episodio. Los episodios se anidan como series > season > episode.

<season>

season_id

Identificador único e inalterable de una temporada. La empresa socia genera y proporciona el ID, que debe coincidir con el ID de temporada del documento de Avails. Límite de 50 caracteres.

<season_id>seasonIdHere</season_id>

seasonNumber

Posición numérica de la temporada dentro de la serie. Determina el orden de reproducción de sus episodios. Los valores deben reflejar el orden original de emisión/exhibición. Solo números enteros; no debe ser 0.

<seasonNumber>2</seasonNumber>

Opciones de reproducción/Disponibilidad

playOptions

Contiene la información de disponibilidad: países o territorios, tipo de monetización y fechas de inicio y fin de disponibilidad.

<playOptions>

country

Código de país del territorio en el que el contenido está disponible. Se permiten múltiples nodos country si vodType, licensePeriodStart y licensePeriodEnd son idénticos entre ellos.

<playOption>
  <country>US</country>
  <!-- Additional country nodes here -->
</playOption>

vodType

Tipo de monetización del episodio. Se permiten múltiples nodos vodType si country, licensePeriodStart y licensePeriodEnd son idénticos entre ellos.

<playOption>
  <vodType>AVOD</vodType>
  <!-- Additional vodType nodes here -->
</playOption>

licensePeriodStart

Fecha de inicio de la disponibilidad del contenido. Una por playOption. Debe ser cronológicamente anterior a licensePeriodEnd; ambas no deben ser idénticas.

<playOption>
  <licensePeriodStart>YYYY-MM-DDTHH:MM:SS</licensePeriodStart>
</playOption>

licensePeriodEnd

Fecha de finalización de la disponibilidad del contenido. Una por playOption. Debe ser cronológicamente posterior a licensePeriodStart; ambas no deben ser idénticas.

<playOption>
  <licensePeriodEnd>YYYY-MM-DDTHH:MM:SS</licensePeriodEnd>
</playOption>

Activos

El bloque assets hace referencia a todos los archivos entregados con el paquete (video, subtítulos descriptivos, audio, subtítulos, ilustraciones), descritos mediante pares asset/data_file con atributos que identifican el tipo y la función.

assets

Inicia el bloque de activos.

<assets media_type="video">

Full Source (Video)

Describe el archivo de video fuente. asset type="full"; data_file role="source". <locale> y <file_name> también son obligatorios.

<asset type="full">
  <data_file role="source">

Full Captions

Describe los subtítulos descriptivos del archivo de video fuente. asset type="full"; data_file role="captions". Si se entrega un archivo de subtítulos descriptivos separado del video (sidecar), <locale> y <file_name> son obligatorios.

Los subtítulos descriptivos son muy recomendables para todas las entregas. La empresa socia determina si son obligatorios para la entrega específica.

<asset type="full">
  <data_file role="captions">

Full Audio

Describe el audio que se entrega en un archivo separado del video fuente (audio sidecar): un doblaje completo a otro idioma o una pista de audio descriptivo para accesibilidad. asset type="full"; data_file role="audio" (doblaje de traducción) o role="audio description" (accesibilidad). <locale> y <file_name> también son obligatorios.

El audio sidecar puede requerirse cuando se necesitan activos localizados (el audio de origen no es nativo del territorio de distribución) o para cumplir con las regulaciones de la FCC.

<asset type="full">
  <data_file role="audio">

Full Subtitles

Describe los subtítulos sidecar del archivo de video fuente. asset type="full"; data_file role="subtitles". <locale> y <file_name> también son obligatorios.

Los subtítulos sidecar pueden requerirse cuando se necesitan activos localizados (el audio de origen no es nativo del territorio de distribución).

<asset type="full">
  <data_file role="subtitles">

Forced Subtitles

Describe los subtítulos narrativos forzados sidecar del archivo de video fuente. asset type="full"; data_file role="forced subtitles". <locale> y <file_name> también son obligatorios.

<asset type="full">
  <data_file role="forced subtitles">

Artwork

Describe los archivos de ilustración a nivel de episodio o de serie. asset type="artwork". <locale> y <file_name> también son obligatorios. Consulta Ilustraciones para las especificaciones completas de entrega de imágenes.

Usa el atributo role="episode" de data_file para las ilustraciones del episodio y role="series" para las de la serie.

<asset type="artwork">
  <data_file role="episode">

<asset type="artwork">
  <data_file role="series">

locale

Identifica el idioma del data_file. Como mínimo, debe ajustarse a un código de idioma admitido (se recomienda incluir código de región). Aplica a las funciones de data_file source, captions, audio, subtitles, y al tipo de activo artwork.

<locale name="en"/>

file_name

Nombre de archivo del activo indicado por el atributo role o type del data_file que lo contiene. Todos los valores distinguen entre mayúsculas y minúsculas y deben incluir la extensión de archivo adecuada.

Para archivos de ilustración específicamente, el atributo type de la etiqueta file_name puede omitirse (lo que indica arte clave), o establecerse en type="background_image", type="boxcover", o type="poster".

<file_name>VideoFilename.mxf</file_name>

audio

Descriptor de distribución de canales de audio para el archivo de video entregado.

<audio>stereoOnly</audio>