Actualizaciones MDU y reemplazos de archivos

Descripción general

Roku procesa las actualizaciones de forma automática. Puedes enviar una actualización cuando necesites cambiar los metadatos o archivos de un programa ya entregado a Roku Channel.

Toda actualización de metadatos o reemplazo de archivos debe incluir estos valores exactamente como se entregaron originalmente:

• Provider
• Asset ID
• Content Type

Roku gestiona las versiones de los metadatos de forma automática. No necesitas incluir información de versión en los metadatos.

Identificación del archivo de reemplazo: Roku gestiona automáticamente las versiones de los registros de metadatos. Los archivos de reemplazo deben usar un nombre único o, si están referenciados en un MMC de MovieLabs, un checksum MD5 exacto. Estos requisitos permiten identificar los archivos de reemplazo y son independientes de las versiones de los registros de metadatos.

Plantillas de actualización de Excel

Descarga las plantillas de actualización de Excel (ZIP) para actualizar metadatos y reemplazar o agregar archivos multimedia de películas, TV y clips.

Campos admitidos para la actualización automatizada de metadatos (MDU)

Roku actualmente admite la actualización de los siguientes campos a través de la MDU automatizada:

• ID de TMS
• ID de EIDR
• Títulos (principales y localizados)
• Sinopsis de hasta 100 caracteres (brief_synopsis, principales y localizadas, incluidas las de series)
• Descripciones breves (principales y localizadas)
• Descripciones extensas (principales y localizadas)
• Fecha de lanzamiento
• Títulos de series
• Número de temporada
• Número de episodio
• Idioma (e idiomas localizados)
• Períodos de disponibilidad
• Tipos de licencias
• Países
• Géneros
• Etiquetas de proveedores
• Clasificación de contenido (sistema y clasificación)
• Créditos
• Cortes publicitarios
• Puntos de referencia

---

Actualización de metadatos (MDU)

Las actualizaciones de metadatos se procesan de la misma manera que el contenido nuevo de ingesta. Para actualizar únicamente los metadatos (sin cambios de archivo), sigue los requisitos a continuación.

Requisitos

• Las actualizaciones de metadatos deben entregarse en el mismo formato que los metadatos de la ingesta original.
• Las actualizaciones de metadatos deben incluir exactamente el mismo Asset ID utilizado en la ingesta original. Para obtener una lista de los Asset ID existentes, contacta a [email protected].
• Deben eliminarse todas las referencias a nombres de archivo de una actualización de solo metadatos. Esto incluye:
  • Nombre de archivo de video fuente
  • Nombre de archivo de subtítulos descriptivos
  • Nombre de archivo de subtítulos
  • Nombre de archivo de doblaje de audio
  • Nombres de archivo de arte clave, fondo y/o portada

Grupos de campos

Algunos campos deben actualizarse en conjunto, en grupos completos. Deben proporcionarse todos los campos obligatorios de un grupo, o la actualización no se procesará.

Grupo de metadatos:

brief_synopsis tiene un límite de 100 caracteres, incluidos los valores localizados y de series. Obligatorio para la distribución en Linear OTT. Los campos obligatorios del grupo de metadatos siguen siendo necesarios.

Grupo de disponibilidad:

Procedimiento

1. Carga la actualización de metadatos mediante el método de entrega aprobado durante la incorporación: la carpeta /prod de Aspera o la ubicación de producción aprobada en S3.

Si la actualización no se refleja en Roku Channel dentro de un plazo de 24 horas, contacta a [email protected].

---

Reemplazos y adiciones de archivos

Los reemplazos y las adiciones de archivos se procesan de la misma manera que el contenido nuevo de ingesta.

• Un reemplazo de archivo reemplaza un archivo que actualmente existe en la biblioteca de Roku Channel.
• Una adición de archivo agrega un nuevo archivo a un registro existente, por ejemplo, agregar subtítulos o doblajes localizados a un título que antes no los tenía.

Requisitos

• Los reemplazos/adiciones de archivos deben entregarse en el mismo formato que los metadatos de la ingesta original.
• Los reemplazos/adiciones de archivos deben incluir exactamente el mismo Asset ID utilizado en la ingesta original. Para obtener una lista de los Asset ID existentes, contacta a [email protected].
• Los archivos de reemplazo deben entregarse con un nombre único, tanto en los metadatos como en el propio archivo. Agregar un sufijo de versión (_v2, _v3, etc.) es suficiente, por ejemplo, movie_title_v2.mov. Los archivos referenciados en un MMC de MovieLabs pueden usar un checksum MD5 exacto en lugar de un nombre único, como se explica en Reemplazos de archivos de MovieLabs.
• Los archivos de reemplazo deben entregarse en la misma carpeta exacta que la entrega original.
• Solo deben aparecer en el archivo de metadatos las referencias a los nombres de los archivos que realmente se estén reemplazando o agregando. Los archivos que no se reemplacen o agreguen no deben entregarse ni referenciarse.
• Si se reemplaza el archivo de video fuente y su duración cambia, los archivos relacionados (subtítulos descriptivos, subtítulos, doblajes de audio) deberían reemplazarse también, para mantenerse sincronizados.
• Los reemplazos de archivos requieren que se proporcionen valores de idioma para actualizarse correctamente.

Reemplazos de archivos de MovieLabs

Los siguientes requisitos aplican a los archivos de reemplazo referenciados en un MMC de MovieLabs. También aplican todos los requisitos generales de reemplazo de archivos indicados arriba.

Identificación de un reemplazo

Cada archivo de reemplazo debe incluir al menos uno de los siguientes elementos para que Roku pueda distinguir un reemplazo intencional de una entrega duplicada:

• Un nombre de archivo único, distinto de los nombres entregados anteriormente para ese activo.
• Un checksum MD5 exacto, incluido en el elemento <manifest:ContainerReference> correspondiente mediante <manifest:Hash method="MD5">.

Si se reutiliza el nombre de archivo anterior, debe incluirse un checksum MD5 exacto. El checksum debe calcularse a partir del archivo de reemplazo que se va a entregar; no copies el checksum de una versión anterior.

Se recomienda usar tanto un nombre de archivo único como un checksum MD5, pero cualquiera de los dos métodos es suficiente. Puedes usar sufijos de versión o marcas de tiempo para distinguir las versiones, siempre que el nombre completo cumpla con los requisitos de nombres de archivo.

Entrega del reemplazo

• Entrega el archivo multimedia de reemplazo antes del MMC actualizado. La transferencia del archivo debe completarse antes de entregar el MMC.
• El MMC actualizado debe hacer referencia al archivo de reemplazo. El valor de <manifest:ContainerLocation> debe coincidir exactamente con el nombre o la ubicación del archivo entregado, incluidas las mayúsculas y minúsculas.
• Cuando se proporcione un checksum MD5, debe aparecer en el mismo <manifest:ContainerReference> que el archivo al que corresponde.
• Para las ilustraciones referenciadas mediante <md:ArtReference> en un MEC, debe actualizarse la referencia correspondiente en el MEC. Las instrucciones anteriores sobre el hash de MMC aplican a los archivos referenciados en un MMC.

Un archivo entregado con un nombre utilizado anteriormente y sin un checksum MD5 actualizado puede tratarse como una entrega duplicada y no reemplazar el activo existente.

Archivos admitidos para reemplazo/adición automatizados

• Archivo de video
• Archivo de arte clave de la serie
• Archivo de portada de la serie
• Archivo de imagen de fondo de la serie
• Archivo de imagen del episodio
• Archivo de arte clave de la película
• Archivo de portada de la película
• Archivo de imagen de fondo de la película
• Archivo de arte clave de formato corto
• Archivo de subtítulos descriptivos
• Archivo de subtítulos completos
• Archivo de subtítulos narrativos forzados
• Archivo de audio sidecar (doblajes de audio y audio descriptivo)

Procedimiento

1. Carga los metadatos de reemplazo o adición de archivos mediante el método de entrega aprobado durante la incorporación: la carpeta /prod de Aspera o la ubicación de producción aprobada en S3.

---

Eliminación de contenido

Si cambian los derechos y es necesario retirar contenido de Roku Channel de inmediato o en una fecha futura, actualiza la fecha de finalización de la disponibilidad mediante el proceso de Actualización de metadatos (MDU) descrito arriba.

• Deben proporcionarse actualizaciones explícitas para cada territorio del que deba retirarse el contenido. Un retiro en un territorio no aplica automáticamente en otros.
• Ten en cuenta: las fechas de finalización proporcionadas sin un valor de hora explícito caducarán a las 11:59:59 p. m. de esa fecha (hora local), según el comportamiento predeterminado descrito en la sección de Períodos de disponibilidad de la Descripción general de metadatos.

---

Glosario