soporte Contactar con Soporte | Estadoestado del sistema del sistema
Contenido de la página

    Adaptador de ingestión Ooyala-Video Cloud: Archivos de manifiesto CSV

    Puede seguir utilizando FTP o Aspera con un manifiesto CSV para ingerir sus vídeos en Video Cloud. Este tema explica la estructura del CSV.

    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

    Nota: Este tema se aplica a OIS v2.5.

    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

    1. 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 etiqueta meta::category::cooking
    2. 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).

    Nota: Puede especificar estas columnas en cualquier orden y omitir las columnas que no necesite, siempre que los datos de las filas de datos coincidan exactamente con los encabezados.
    Encabezados de columna de manifiesto CSV
    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:
    • Nombre del archivo de subtítulos opcionales que ha subido. Ejemplo:<media:subTitle href="caption-1.dfxp"/>
    • URL donde se encuentra el archivo de subtítulos opcionales. La URL puede incluir o.http://https://

    Consulte Ingesta de archivos de subtítulos opcionales.

    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:

    1. Sube uno o más vídeos.
    2. Abra un programa de hoja de cálculo, como Microsoft Excel.
    3. Agregue los encabezados de columna a la primera fila.
    4. Agregue una fila para cada vídeo.
    5. 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.
    6. Con el método de subida de su elección, sube el archivo CSV mientras subiste los vídeos. Vea FTP o Aspera.