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

Introducción

Al ingerir vídeos, puede utilizar archivos de manifiesto XML 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 XML al ingerir contenido con FTP, Aspera o MRSS.

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

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 etiqueta meta::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.

Elementos de manifiesto XML

Puede utilizar los siguientes elementos en el archivo de manifiesto XML.

Elementos de manifiesto XML
Etiqueta XML	Descripción	Necesario/Opcional
`<channel>`	Contiene uno o más `<item>` elementos.	requerido
`<item>`	Representa un único vídeo para ingerir. Puede especificar varios vídeos (`<item>` etiquetas) en un archivo de manifiesto XML. Contiene las etiquetas restantes de esta tabla.	requerido
`<media:content>`	Especifica un vídeo que se va a ingerir. Una de las siguientes: Nombre de archivo de un vídeo que has subido. Para la ingestión a través de MRSS (consulte Ingestión de una fuente MRSS alojada de forma remota), la URL donde se encuentra el vídeo. La URL puede incluir o.`http://https://` Para un activo remoto, utilice `<ooyala:remoteasset>` en su lugar.	requerido (excepto para activos remotos)
`<media:title>`	Nombre o título del vídeo.	opcional
`<media:thumbnail>`	Especifica una miniatura (imagen de vista previa). Una de las siguientes: Nombre de archivo de una miniatura que ha subido. URL donde se encuentra la miniatura. La URL puede incluir o.`http://https://`	opcional
`<media:subTitle>`	Especifica un archivo de subtítulos opcionales (compatible con archivos DFXP, WebVTT y SRT). Consulte Ingesta de archivos de subtítulos opcionales. Atributos: `href` ( requerido) - Una de las siguientes: Nombre del archivo de subtítulos opcionales que ha subido. Ejemplo:`caption-1.dfxp` URL donde se encuentra el archivo de subtítulos opcionales. La URL puede incluir o.`http://https://` `lang` ( opcional): idioma del archivo de subtítulos opcionales. Código de dos letras. Consulte Subtítulos opcionales admitidos. `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. Nota: Si se especifica, es su responsabilidad proporcionar valores válidos para `lang` y `frameRate`. Se agregan valores válidos al archivo DFXP. Los valores no conformes se ignoran. De cualquier manera, el archivo de subtítulos se agrega a Backlot y se vincula al activo.	opcional
`<media:description>`	Descripción del vídeo.	opcional
`<link>`	URL permanente donde se incrusta el vídeo. Se asigna a la `hosted_at` propiedad del activo creado.	opcional
`<dcterms:valid>`	Horarios de vuelo que representan las horas de inicio y finalización cuando se puede jugar el activo. Ejemplo: < >dcterms:inicio válido=2011-06-28T 15:15:00 - 07:00; end=2022-12-01T 16:00:00 - 07:00; esquema=W3C-DTF </dcterms:válido >	opcional
`<ooyala:labels>`	Una o más etiquetas, separadas por comas. Ejemplo: `/sports,/sports/jogging`. Para obtener información sobre el fondo, consulte Etiquetas.	opcional
`<media:keywords>`	Otra forma de definir etiquetas (sin barra diagonal). Los contenidos, separados por comas, se añadirán como etiquetas al vídeo. Se creará una nueva etiqueta sólo si no existe una etiqueta con el mismo nombre. Por ejemplo, para la `<media:keywords>` etiqueta siguiente, las etiquetas `label1` y se `label2` crearían y agregarían al vídeo como etiquetas. También se `parentlabel` crearía una etiqueta llamada, con la etiqueta `childlabel` anidada dentro de ella. <medio:palabras clave > etiqueta1, etiqueta2, parentlabel/childlabel < /media:palabras clave > Nota: El contenido de `<media:keywords>` se omite cuando la `<ooyala:labels>` etiqueta se incluye en el archivo de manifiesto XML o MRSS.	opcional
`<ooyala:embedcode>`	ID de vídeo de Video Cloud.	opcional (obligatorio si actualiza un vídeo en lugar de agregar uno nuevo)
`<ooyala: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. Comuníquese con su representante de soporte de Ooyala para obtener más detalles.	opcional
`<ooyala:metadata>`	Metadatos personalizados para el vídeo. Puede tener un elemento para cada tipo de metadatos. Consulte la sección Gestión de metadatos para obtener más información sobre cómo `metadata` se agrega a los vídeos como etiquetas especiales. Ejemplo:`<ooyala:metadata name="category">cooking</ooyala:metadata>`	opcional
`<ooyala:remoteasset>`	Especifica un activo remoto que se va a ingerir. Un activo remoto es un vídeo que se aloja en otro lugar que no sea Backlot. Especifique los siguientes atributos: `durationInMs`: duración del medio (en milisegundos) `url`: URL del activo remoto. La URL puede incluir o.`http://https://` Esta configuración se asigna al valor de la `hosted_at` propiedad de un activo remoto. Ejemplo:`<ooyala:remoteasset durationInMs='5000' url="http://your_website/your_remote_assets.mp4" />` 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.	requerido (sólo activos remotos)
`<ooyala:profileguid>`	Especifica un perfil de ingesta de Video Cloud que se utilizará para procesar el vídeo. Si no desea utilizar el perfil predeterminado de la cuenta, debe especificar el que desea utilizar en su lugar. Consulte Gestión de perfiles de ingesta.	opcional

Ejemplo

Ejemplo de archivo de manifiesto XML (OIS v2.5)

  <?xml version="1.0" encoding="utf-8"?>
  <rss version="2.0" xmlns:media=» http://search.yahoo.com/mrss/»
    xmlns:dcterms=» http://purl.org/dc/terms/»
    xmlns:fh=» http://purl.org/syndication/history/1.0»
    xmlns:ooyala=» http://www.ooyala.com/mrss/ «>
    <canal >
      <artículo >
        <medios: contenido url=» test.mp4 "> < /media:content >
        <Medios:Subtítulo href="my_caption.dfxp» > < /Media:Subtítulo >
        <media:miniatura url=» my_thumbnail.jpg "filesize="35712" > < /media:miniatura >
        <media:título > Prueba XML < /media:título >
        <media:description > Este es un ejemplo < /media:description >
        <ooyala: etiquetas > /test, /ejemplo, /xml < /ooyala: etiquetas >
        < >dcterms:inicio válido=2016-01-01T 15:15:00 - 07:00;
          end=2022-01-01T 16:00:00 - 07:00 < /dcterms:válido >
        <ooyala: profileguid > 57d5a5a10f654fe79ef954dc8d29a108 < /ooyala: profileguid >
      </artículo >
    </canal >
  </rss >

Paso a paso

Creación de un archivo de manifiesto XML

Para crear un archivo de metadatos XML:

Sube tus vídeos y otro contenido (miniaturas, archivos de subtítulos, etc.).
Abra un editor de texto, preferiblemente uno que valida XML.

Agregue los encabezados XML necesarios. Por ejemplo:

  <?xml version="1.0" encoding="utf-8"?>
  <rss version="2.0" xmlns:media=» http://search.yahoo.com/mrss/»
       xmlns:dcterms=» http://purl.org/dc/terms/»
       xmlns:fh=» http://purl.org/syndication/history/1.0»
       xmlns:ooyala=» http://www.ooyala.com/mrss/ «>

Cree un channel contenedor.

Cree una item entrada para cada video, que contenga los elementos deseados de la tabla anterior.

En el ejemplo siguiente, el XML especifica metadatos para dos vídeos. Para el primer vídeo, el archivo y las miniaturas se encuentran en un servidor de carga y se extraen de ese servidor. Para el segundo vídeo, el archivo y la miniatura ya se subieron a un servidor Ooyala. El segundo video también tiene tiempos de vuelo.

  <?xml version="1.0" encoding="utf-8"?>
  <rss version="2.0" xmlns:media=» http://search.yahoo.com/mrss/»
       xmlns:dcterms=» http://purl.org/dc/terms/»
       xmlns:fh=» http://purl.org/syndication/history/1.0»
       xmlns:ooyala=» http://www.ooyala.com/mrss/ «>
  
       <canal >
             <artículo >
              <media:contenido url=» http://mysite.com/upload/lacrosse_70.mov "/>
              <media:miniatura url=» http://mysite.com/upload/lacrosse_70_previewimage.jpg "/>
              <media:título > Deportes que realmente existen: Lacrosse</media:title>
              <media:descripción > Mi descripción de mi < vídeo/media:descripción >
              <ooyala: etiquetas > /deportes/lacrosse, /hobbies/lacrosse < /ooyala:etiquetas >
              <enlace > http://mysite.com/videos/sports/real_sports.html < /link >
              <ooyala:metadatos name="video_ID» > 70 < /ooyala:metadatos >
              <ooyala:nombre de metadatos ="número_temporada» > 1 < /ooyala:metadatos >
             </artículo >
  
             <artículo >
              <medios: contenido url=» curling_71.mov "/>
              <medios: miniatura url=» curling_71_previewimage.jpg "/>
              <media:título > Deportes que realmente existen: Curling</media:title>
              <media:descripción > Mi descripción de mi < vídeo/media:descripción >
              <ooyala: etiquetas > /deportes/rizado, /aficiones/rizado < /ooyala: etiquetas >
              <enlace > http://mysite.com/videos/sports/real_sports.html < /link >
              <ooyala:nombre de metadatos ="video_ID» > 71 < /ooyala:metadatos >
              <ooyala:nombre de metadatos ="número_temporada» > 1 < /ooyala:metadatos >
              <!— establecer tiempos de vuelo — >
              < >dcterms:inicio válido=2011-06-28T 15:15:00 - 07:00;
                  end=2022-12-01T 16:00:00 - 07:00; esquema=W3C-DTF
                  </dcterms:válido >
  
             </artículo >
       </canal >
  </rss >

Guarde el archivo como XML. Asegúrese de especificar un nombre único. Si especifica dos archivos con el mismo nombre y carga uno mientras el otro está procesando, el segundo podría ignorarse.
Con el método de subida de su elección, sube el archivo de manifiesto XML mientras subiste los vídeos. Vea FTP o Aspera.