Introducción
Al ingerir vídeos, puede utilizar archivos de manifiesto CSV para especificar metadatos adicionales (incluidos el título del vídeo, la descripción, los tiempos de vuelo, las etiquetas y los metadatos personalizados), así como archivos de miniaturas y subtítulos opcionales. Puede utilizar archivos de manifiesto CSV al ingerir contenido con FTP o Aspera.
Limitaciones
El formato CSV del archivo de metadatos admite menos entidades que el formato XML. El formato CSV permite especificar miniaturas (imágenes de vista previa) y metadatos personalizados para asociarlos a un vídeo. El formato XML admite estas funciones, así como la asociación de los nombres de los conjuntos de anuncios definidos existentes.
Manejo de metadatos
Si incluye vídeos al ingerirlos, se asigna a los campos de vídeo de Video Cloud de una de estas dos maneras:metadata
- De forma predeterminada, cada par
metadata
clave/valor se agrega como una etiqueta en el formulario:meta::key::value
. Por ejemplo,<ooyala:metadata name="category">cooking</ooyala:metadata>
produciría la etiquetameta::category::cooking
- Si prefiere utilizar para almacenar metadatos, Brightcove Support puede cambiar una configuración de su cuenta para hacerlo.
custom_fields
Tenga en cuenta lo siguiente:- Tendrá que crear campos personalizados con nombres correspondientes a sus claves de metadatos.
- El número de campos personalizados está limitado a 10 de forma predeterminada, por lo que si necesita más que eso para acomodar sus metadatos, deberá solicitar campos personalizados adicionales de Soporte.
- Si no existe un campo personalizado correspondiente a cada elemento de metadatos en su cuenta, se producirá un error en toda la operación de metadatos.
Encabezados de columna de manifiesto CSV
Los siguientes campos son la primera línea (encabezados de columna) del archivo CSV, con campos de datos reales seguidos en las filas siguientes (una fila por vídeo).
Título de columna | Descripción | Necesario/Opcional |
---|---|---|
video | Nombre de archivo del vídeo o la URL donde se encuentra el vídeo. La URL puede incluir o.http://https:// | requerido |
title | Nombre o título del vídeo. | opcional |
thumbnail | Nombre de archivo de la miniatura o de la URL donde se encuentra la miniatura. | opcional |
content_type | Tipo de contenido (vídeo o activo remoto). Si el nombre de archivo especificado en la columna de vídeo es una dirección URL en la que se encuentra el vídeo y si desea definir un activo remoto, cambie el valor de la columna content_type (de video, predeterminado) a content_type=remoteasset. | requerido (sólo activos remotos) |
description | Descripción del vídeo. | opcional |
hosted_at | URL permanente donde se incrusta el vídeo. Asigna al valor de la hosted_at propiedad de un activo remoto.
Nota: Después de crear un activo remoto, su propagación a los distintos CDN podría retrasarse 60 segundos o más. Si solicita un activo remoto demasiado pronto después de su creación, los CDN almacenarán en caché los resultados, lo que podría tardar varios minutos en borrarse. Práctica recomendada: después de la creación, espere 30 o 60 segundos, consulte con el API de backlot [GET] /v2/assets/asset_id route, y después de recuperar el código de inserción del activo remoto (ID de contenido o ID de activo), proceda a insertar el activo. |
opcional |
flight_start_time | La hora de inicio cuando se puede reproducir el activo, en UTC. Ejemplo:2011-06-01T00:00:00Z | requerido (sólo si flight_end_timese especifica) |
flight_end_time | La hora de finalización en la que se puede reproducir el activo, en UTC. Ejemplo:2011-07-01T00:00:00Z | opcional |
durationInMs | (Sólo OS v2.5) Duración que representa la duración del vídeo (en milisegundos). Requerido cuando content_type=remoteasset. | necesario (sólo para activos remotos) |
labels | Una o más etiquetas, separadas por comas. Por ejemplo: /sports,/sports/jogging. | opcional |
metadata | Metadatos personalizados para el vídeo. Puede tener una columna para cada tipo de metadatos. Consulte la sección Gestión de metadatos anterior para ver cómo se asignan los metadatos a los campos de vídeo de Video Cloud. | opcional |
embed_code | (Reservado). ID de contenido en Backlot del activo de vídeo. | reservado |
id | Se asigna a la propiedad de ID externo del activo creado: un identificador personalizado que se define que puede utilizar en lugar del identificador de contenido. | opcional |
subTitle | Especifica un archivo de subtítulos opcionales (sólo compatible con archivos DFXP). Una de las siguientes:
|
opcional |
subTitle:lang | (opcional) - Idioma del archivo de subtítulos opcionales. Código de idioma de dos letras./td > | opcional |
subTitle:frameRate | (opcional) - Frecuencia de fotogramas del archivo de subtítulos opcionales. Las unidades están en fotogramas por segundo (FPS). El valor predeterminado es 30. Los archivos de subtítulos más antiguos podrían ser 24. | opcional |
profileguid | ID del perfil de procesamiento, que es un grupo de codificaciones que definen los formatos a los que se debe convertir un vídeo maestro durante la transcodificación. Si no desea utilizar el perfil predeterminado de ingesta de Video Cloud, debe incluir el identificador del que desea utilizar. Consulte Gestión de perfiles de ingesta. | opcional |
Ejemplo de archivo de manifiesto CSV (OIS v2.5)
video,title,description,labels,hosted_at,id,thumbnail,subTitle,flight_start_time,flight_end_time,profileguid
test.mp4,Test CSV,This is an example,"test,example,csv",http://www.ooyala.com,my_test_guid_csv,my_thumbnail.jpg,my_caption.dfxp,2016-01-01T15:15:00-07:00,2022-01-01T16:00:00-07:00,57d5a5a10f654fe79ef954dc8d29a108

Creación de un archivo de manifiesto CSV
Tenga en cuenta lo siguiente al generar un archivo de metadatos CSV:
- Si un valor de texto en un campo de datos tiene una coma (,), debe incluir el campo entre comillas dobles («).
- Si un valor de texto en un campo de datos tiene una comilla doble («) en él, debe encerrar el campo entre comillas dobles y escapar del carácter de comilla doble en el campo de texto con una segunda comilla (por ejemplo, «Ella dijo, «" "Que tenga un buen día.""»)
Si va a crear el archivo de metadatos CSV desde Excel, maneja automáticamente el escape.
Para crear un archivo de metadatos CSV:
- Sube uno o más vídeos.
- Abra un programa de hoja de cálculo, como Microsoft Excel.
- Agregue los encabezados de columna a la primera fila.
- Agregue una fila para cada vídeo.
- Guarde el archivo como CSV. Por ejemplo, puede seleccionar Guardar como en el menú Archivo . Cuando se le solicite, seleccione el tipo de archivo de valores separados por comas.
- Con el método de subida de su elección, sube el archivo CSV mientras subiste los vídeos. Vea FTP o Aspera.