XML - campos de metadatos de películas

Descripción general

Usa esta referencia para preparar los metadatos XML de películas. Descarga el esquema y la muestra anotada en la Descripción general de metadatos XML de Roku. La Descripción general de metadatos explica los tipos de contenido, las reglas para los ID y los períodos de disponibilidad que se aplican a todo el contenido.

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

Información del paquete

package

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

<package version="film5.0">

provider

Nombre del propietario del contenido, estudio o cadena.

<provider>Roku Originals</provider>

language

Idioma principal de los metadatos del paquete. El valor debe usar un código de idioma admitido. Se recomienda incluir un código de región para distinguir variantes como el español de México (es-MX) y el de España (es-ES).

<language>en</language>

type

Define el tipo de contenido del paquete.

<type>film</type>

asset_id

Identificador único de una película 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>movieAssetIdHere</asset_id>

eidr

ID de EIDR, si existe uno.

<eidr></eidr>

tmsId

ID de Gracenote, si existe uno.

<tmsId></tmsId>

Descriptores de contenido

title

Título de la película tal como debe aparecer en la plataforma. No agregues datos entre paréntesis que no formen parte del título, como un indicador de versión original o nueva, el año de estreno, la temporada o el formato de video (por ejemplo, (Clásica), (1987), (Temporada 1), (HD)).

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

brief_synopsis

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

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

short_synopsis

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

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

long_synopsis

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

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

original_spoken_language

El idioma original de producción del título. Como mínimo, el valor debe ajustarse a un código de idioma admitido. Como práctica recomendada, incluye también un código de región (consulta language arriba para el ejemplo es-MX / es-ES).

<original_spoken_language>en</original_spoken_language>

country_of_origin

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

<country_of_origin>US</country_of_origin>

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

Fecha original en la que el contenido 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 contenido, en minutos enteros.

<runtime>120</runtime>

genre

Clasificación por género del contenido. Cada película debe entregarse con al menos un género admitido. Consulta la lista enumerada de géneros.

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

rating

Clasificación de contenido/edades de una fuente de clasificación. Se debe proporcionar, para cada película, una clasificación válida de cine o TV emitida por la autoridad de clasificación (ratingSystem) del territorio en el que estará disponible el contenido. Si el título no ha sido clasificado por la autoridad oficial de ese territorio, incluye en su lugar una clasificación válida del sistema USA_PR. No existe un organismo oficial de clasificación para USA_PR; usa las pautas de tvguidelines.org para asignar la clasificación adecuada.

<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

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. Agregar etiquetas puede ofrecer más opciones para agrupar y recomendar un título. No hay límite en la cantidad de etiquetas ni una lista predefinida.

• Las etiquetas distinguen entre mayúsculas y minúsculas: "Rom-Com" y "rom-com" son etiquetas distintas. Usa las mismas mayúsculas y minúsculas en todas las entregas.

<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 del contenido financiado con anuncios. Los valores deben tener una precisión de milisegundos. Si el video incluye negros comerciales, proporciona el código de tiempo en el punto medio del negro comercial. No es obligatorio para contenido SVOD, pero se pueden ingerir datos de adBreak 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

Se utiliza para identificar los puntos de entrada/salida de los créditos iniciales, resúmenes de contenido, créditos finales y material detrás de cámaras. Las etiquetas cuePoint deben incluir el atributo type. Los valores deben tener una 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, con uno de los siguientes valores. Todo cuePoint que se proporcione requiere start_time y end_time, sin importar el tipo.

<cuePoint type="intro">

Reparto y equipo de filmación

cast display_name

Nombre de un miembro del reparto. Admite CDATA.

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

crew display_name

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

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

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.

role

Función del miembro del equipo de filmación indicado en display_name. Todo miembro del equipo de filmación incluido 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

localizations

Contiene los metadatos localizados de paquetes multilingües: idioma, título traducido, brief_synopsis, short_synopsis y long_synopsis.

<localizations>

localization atributo name

Identifica el idioma de los campos del bloque localization. El nombre del atributo debe ser name y su valor debe usar un código de idioma admitido. Se recomienda incluir un código de región; consulta language.

<localization name="es">

localized title

Título localizado de la película, en el idioma especificado por el atributo name del bloque localization que lo contiene. También se aplican las restricciones sobre datos entre paréntesis indicadas en title. Debe ir acompañado de una short_synopsis localizada. La long_synopsis localizada es opcional.

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

localized brief_synopsis

Una sinopsis localizada de la película. 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 movie summary. 100 characters maximum. Required for Linear OTT distribution.]]></brief_synopsis>

localized short_synopsis

Sinopsis breve localizada, en el idioma especificado por el bloque localization que la contiene. Admite CDATA. Límite de 250 caracteres. Debe ir acompañada de un title localizado. La long_synopsis localizada es opcional.

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

localized long_synopsis

Opcional. Sinopsis larga localizada, en el idioma especificado por el bloque localization que la contiene. 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 movie. 500 characters maximum. Optional.]]></long_synopsis>

Opciones de reproducción/Disponibilidad

playOptions

Contiene la información de disponibilidad del paquete: 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, siempre que vodType, licensePeriodStart y licensePeriodEnd sean idénticos entre ellos.

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

vodType

Tipo de monetización de la película. Se permiten múltiples nodos vodType, siempre que country, licensePeriodStart y licensePeriodEnd sean idénticos entre ellos.

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

licensePeriodStart

Fecha de inicio de la disponibilidad del contenido para las personas usuarias de Roku Channel. Una licensePeriodStart 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 para las personas usuarias de Roku Channel. Una licensePeriodEnd 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 como parte del paquete (video, subtítulos descriptivos, audio, subtítulos, ilustraciones). Cada archivo individual se describe mediante un par asset/data_file, con atributos que identifican el tipo y la función del activo.

assets

Inicia el bloque de activos.

<assets media_type="video">

Full Source (Video)

Describe el archivo de video fuente. El atributo de la etiqueta asset debe ser type="full", y el atributo de la etiqueta data_file debe ser 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 (es decir, el audio original de la fuente 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 (es decir, el audio original de la fuente 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. asset type="artwork". <locale> y <file_name> también son obligatorios. Consulta Ilustraciones para las especificaciones completas de entrega de imágenes.

<asset type="artwork">
  <file_name>

<asset type="artwork">
  <file_name type="background_image">

<asset type="artwork">
  <file_name type="boxcover">

<asset type="artwork">
  <file_name type="poster">

Un file_name sin atributo type representa el arte clave. Los valores explícitos de type solo son necesarios para background_image, boxcover y poster.

locale

Identifica el idioma del data_file. Como mínimo, el valor debe ajustarse a un código de idioma admitido; incluye un código de región como práctica recomendada. 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 en el atributo role o type del data_file que lo contiene. Todos los valores de file_name distinguen entre mayúsculas y minúsculas y deben incluir la extensión de archivo adecuada.

<file_name>VideoFilename.mxf</file_name>

audio

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

<audio>stereoOnly</audio>