MovieLabs

MovieLabs en Roku: orden de entrega, etiquetas, marcadores y validación de esquema.

Descripción general

Esta página explica los requisitos de Roku para las entregas de MovieLabs: versiones de esquema, correspondencia de campos, orden de entrega, marcadores de cortes publicitarios y validación. El glosario define los términos de MovieLabs que se usan aquí.

Orden de entrega

El orden de entrega determina si Roku puede procesar un título. Sigue tanto el orden de archivos como el de serie, temporada y episodio que se indica a continuación.

1. Los archivos multimedia deben preceder a su XML

Para cada MMC, todos los archivos a los que hace referencia deben entregarse antes que el propio XML de MMC.
Para cada MEC, todos los archivos a los que hace referencia deben entregarse antes que el propio XML de MEC.

2. Orden de ingesta jerárquico (serie > temporada > episodio)

Las películas y los episodios requieren la entrega exitosa tanto del MMC como del MEC para su ingesta.
Las series y las temporadas requieren la entrega exitosa de al menos el MEC para su ingesta. (Se admiten los MMC de serie y de temporada si las referencias de ilustraciones se entregan a través del MMC.)
Un episodio no puede ingerirse hasta que el MEC de su temporada se haya entregado e ingerido correctamente.
Una temporada no puede ingerirse hasta que el MEC de su serie se haya entregado e ingerido correctamente.

Si el contenido llega fuera de orden:

Un episodio procesado antes que su serie o temporada se mantiene en estado sin ingerir hasta que la serie o temporada se haya entregado correctamente.
Una temporada procesada antes que su serie o un episodio perteneciente a ella se mantiene en estado sin ingerir hasta que la serie o el episodio se hayan entregado correctamente.
Una serie procesada antes que una temporada y un episodio pertenecientes a ella se mantiene en estado sin ingerir hasta que una temporada y un episodio se hayan entregado correctamente.

Para las entregas de reemplazo, consulta Actualizaciones de metadatos (MDU) y reemplazos de archivos: Reemplazos de archivos de MovieLabs.

Metadatos y archivos multimedia específicos de Roku

Roku Channel admite la entrega de metadatos a través de la especificación de MovieLabs, utilizando los siguientes esquemas:

MMC y MEC: el servicio MovieLabs de Roku Channel se desarrolló con la versión MEC v2.9 y MMC v1.10, tal y como se define en el sitio web de MovieLabs.
EMA Avails: Roku Channel admite la última versión de la especificación de EMA, entregada mediante .xlsx.

Todos los archivos de video, audio, subtítulos descriptivos, subtítulos e imagen, junto con los requisitos mínimos de metadatos, los géneros y las clasificaciones/fuentes de clasificación, deben cumplir con los formatos y requisitos definidos en el resto de esta especificación.

Etiquetas

Las etiquetas para fines de merchandising/curaduría pueden entregarse a través del nodo Keyword, compatible con el XML de MEC de MovieLabs. Consulta el esquema MEC de MovieLabs para conocer la ubicación correcta.

<md:LocalizedInfo language="en">
	<md:TitleDisplayUnlimited>Gran título de mi programa</md:TitleDisplayUnlimited>
	<md:Summary190>Resumen breve de mi programa.</md:Summary190>
	<md:Summary400>Resumen más extenso de mi programa.</md:Summary400>
	<md:Genre id="genre"/>
	<md:Keyword>palabra clave</md:Keyword>
</md:LocalizedInfo>

TMS ID

Los TMS ID de Gracenote pueden entregarse a través del XML de MEC de MovieLabs, como un Identifier con Namespace TMSID dentro del nodo AltIdentifier. Consulta el esquema MEC de MovieLabs para conocer la estructura correcta.

<md:AltIdentifier>
	<md:Namespace>TMSID</md:Namespace>
	<md:Identifier>EP012345678910</md:Identifier>
</md:AltIdentifier>

Cortes publicitarios y puntos de referencia en el XML de MMC

Los puntos de referencia de corte publicitario, créditos iniciales y créditos finales se proporcionan en el XML de MMC de MovieLabs a través del nodo Markers. Consulta el esquema MMC de MovieLabs para conocer la estructura correcta.

Nota: Roku solo necesita un único punto de inicio para los marcadores de corte publicitario. El reproductor de Roku pausa la reproducción en ese punto, reproduce el bloque de anuncios y reanuda desde el mismo punto.

    <manifest:Markers>

    <!--Punto de referencia de créditos iniciales: inicio y fin-->
      <manifest:Marker>
        <manifest:Timecode format="seconds">155.071</manifest:Timecode>
        <manifest:DisplayLabel>FIRST_FRAME_EPISODE_INTRO</manifest:DisplayLabel>
        <manifest:Label>FFEI</manifest:Label>
      </manifest:Marker>
      <manifest:Marker>
        <manifest:Timecode format="seconds">200.867</manifest:Timecode>
        <manifest:DisplayLabel>LAST_FRAME_EPISODE_INTRO</manifest:DisplayLabel>
        <manifest:Label>LFEI</manifest:Label>
      </manifest:Marker>

      <!--Punto de referencia de créditos finales: inicio y fin-->

      <manifest:Marker>
        <manifest:Timecode format="seconds">3669.207</manifest:Timecode>
        <manifest:DisplayLabel>FIRST_FRAME_UP_NEXT</manifest:DisplayLabel>
        <manifest:Label>FFUN</manifest:Label>
      </manifest:Marker>
      <manifest:Marker>
        <manifest:Timecode format="seconds">3812.517</manifest:Timecode>
        <manifest:DisplayLabel>LAST_FRAME_UP_NEXT</manifest:DisplayLabel>
        <manifest:Label>LFUN</manifest:Label>
      </manifest:Marker>

      <!--Puntos de referencia de corte publicitario (Roku solo necesita un punto de inicio. Nuestro reproductor pausará la reproducción del video en este punto, reproducirá el bloque de anuncios y reanudará desde este mismo punto)-->

      <manifest:Marker>
        <manifest:Timecode format="seconds">737.111</manifest:Timecode>
        <manifest:DisplayLabel>FIXED_POINT_CANDIDATE_INSERTION</manifest:DisplayLabel>
        <manifest:Label>FPCI</manifest:Label>
      </manifest:Marker>
      <manifest:Marker>
        <manifest:Timecode format="seconds">1361.276</manifest:Timecode>
        <manifest:DisplayLabel>FIXED_POINT_CANDIDATE_INSERTION</manifest:DisplayLabel>
        <manifest:Label>FPCI</manifest:Label>
      </manifest:Marker>
      <manifest:Marker>
        <manifest:Timecode format="seconds">1948.821</manifest:Timecode>
        <manifest:DisplayLabel>FIXED_POINT_CANDIDATE_INSERTION</manifest:DisplayLabel>
        <manifest:Label>FPCI</manifest:Label>
      </manifest:Marker>
      <manifest:Marker>
        <manifest:Timecode format="seconds">2841.421</manifest:Timecode>
        <manifest:DisplayLabel>FIXED_POINT_CANDIDATE_INSERTION</manifest:DisplayLabel>
        <manifest:Label>FPCI</manifest:Label>
      </manifest:Marker>
      <manifest:Marker>
        <manifest:Timecode format="seconds">3270.100</manifest:Timecode>
        <manifest:DisplayLabel>FIXED_POINT_CANDIDATE_INSERTION</manifest:DisplayLabel>
        <manifest:Label>FPCI</manifest:Label>
      </manifest:Marker>
    </manifest:Markers>

ArtReference de MEC para Roku Channel

Los archivos de imagen específicos de Roku se identifican mediante el atributo purpose de ArtReference del MEC de MovieLabs:

Valor del atributo `purpose`	Tipo de ilustración de Roku
`keyart`	Arte clave en 16:9 con texto y tratamiento del título para películas/formato corto/series, O imagen en 16:9 sin texto para episodios
`boxcover`	Carátula en 4:3 o 3:4 con texto y tratamiento del título
`poster`	Portada en 2:3 con texto y tratamiento del título
`background`	Imagen de fondo en 16:9 sin texto

<md:LocalizedInfo language="en" default="true">
	<md:TitleDisplayUnlimited>Ahed's Knee</md:TitleDisplayUnlimited>

	<!--Referencias de imagen de MEC-->
	<!--Arte clave en 16:9 con texto y tratamiento del título para películas/formato corto/series, para entregarse con purpose="keyart"-->
	<md:ArtReference resolution="1920x1080" purpose="keyart">16x9_texted_image_with_title_treatment.jpg</md:ArtReference>

	<!--Imagen en 16:9 sin texto para episodios, para entregarse con purpose="keyart"-->
	<md:ArtReference resolution="1920x1080" purpose="keyart">16x9_textless_episode_image.jpg</md:ArtReference>

	<!--Imagen de carátula en 4:3 o 3:4 con texto y tratamiento del título, para entregarse con purpose="boxcover". La relación de aspecto depende del tipo de contenido-->
	<md:ArtReference resolution="2560x1920" purpose="boxcover">4x3_texted_image_with_title_treatment.jpg</md:ArtReference> <!--para el tipo de contenido de serie-->
	<md:ArtReference resolution="1920x2560" purpose="boxcover">3x4_texted_image_with_title_treatment.jpg</md:ArtReference> <!--para el tipo de contenido de película-->

	<!--Imagen de portada en 2:3 con texto y tratamiento del título, para entregarse con purpose="poster"-->
	<md:ArtReference resolution="2000x3000" purpose="poster">2x3_texted_image_with_title_treatment.jpg</md:ArtReference>

	<!--Imagen de fondo en 16:9 sin texto, para entregarse con purpose="background"-->
	<md:ArtReference resolution="1920x1080" purpose="background">16x9_textless_background_image.jpg</md:ArtReference>

	<md:Summary190>Resumen breve del programa en el idioma especificado</md:Summary190>
	<md:Summary400>Resumen largo del programa en el idioma especificado</md:Summary400>
	<md:Genre>Drama</md:Genre>
</md:LocalizedInfo>

Validación del esquema de MovieLabs

Roku utiliza Apache xmlbeans para analizar y validar los archivos XML de MEC/MMC. Su herramienta de validación por línea de comandos puede usarse para verificar los archivos antes de la entrega.

Descarga y extrae xmlbeans en tu equipo.
Desde la línea de comandos, ve (cd) al directorio bin de xmlbeans.
Dentro de bin, ubica la herramienta validate.
Descarga los archivos XSD del esquema oficial de MovieLabs en tu equipo:
- manifest-v1.10.xsd (para MMC)
- mdmec-v2.9.xsd (para MEC)
Ejecuta: validate schema.xsd instance.xml. Sustituye schema.xsd por mdmec-v2.9.xsd para archivos MEC, o por manifest-v1.10.xsd para archivos MMC.
El resultado en la línea de comandos indicará si el XML dado es válido.

Ejemplo de uso:

./validate ~/dev/movielabsSpec/schema/mdmec-v2.9.xsd /path/to/file/directory/MEC_SAMPLE_123456789.xml

Ejemplo de respuesta:

XMLBEANS_LIB=./../lib
ERROR StatusLogger Log4j2 could not find a logging implementation. Please add log4j-core to the classpath. Using SimpleLogger to log to the console...
/path/to/file/directory/MEC_SAMPLE_123456789.xml valid

Validación de géneros: el esquema oficial de MovieLabs puede rechazar valores de género admitidos por Roku. Roku acepta estos valores en su proceso de ingesta, aunque el validador independiente xmlbeans los marque como errores.

Glosario

Término	Definición
MEC	Media Entertainment Core: el esquema de metadatos de MovieLabs que describe el contenido en sí.
MMC	Media Manifest Core: el esquema de MovieLabs que describe el manifiesto de activos entregables (video, audio, imágenes) vinculados a un título.
EMA Avails	La especificación de MovieLabs/EMA que expresa los términos de licenciamiento y disponibilidad de un contenido.
Nodo Markers	El elemento del XML de MMC que contiene los códigos de tiempo de los puntos de referencia para cortes publicitarios, créditos iniciales y créditos finales.
ArtReference	El elemento del XML de MEC que hace referencia a un archivo de ilustración, etiquetado con un atributo `purpose` que identifica qué tipo de imagen de Roku representa.
TMS ID	Un identificador asignado por Gracenote para un título, entregable a través del nodo `AltIdentifier` del MEC.
xmlbeans	Una biblioteca/herramienta de Apache que Roku utiliza para validar los archivos XML de MEC/MMC contra el esquema oficial de MovieLabs.

Updated about 5 hours ago

Did this page help you?