App Cloud
- Overview and general topics
- Product Updates
- Glossary
- The App Cloud SDK
- Creating an app template
- Tutorials
- Content optimization
- Development tips and best practices
- Packaging a template
- Creating apps from a template
- Publishing an app
- Delivering ads
- Push Notifications
- Analytics
- Managing users and accounts
Player Debugger
Transferencia FTP por lotes: Referencia para el manifiesto XML
Este documento es una referencia del manifiesto de transferencia FTP por lotes que se debe crear para utilizar el sistema de transferencias FTP por lotes de Video Cloud. Este documento proporciona especificaciones detalladas y ejemplos de código de los elementos y atributos XML obligatorios que deben incluirse en el archivo de manifiesto XML. También se incluyen especificaciones para ejecutar diversas acciones con el archivo de manifiesto XML, como la carga de activos, la creación o actualización de vídeos, la recodificación de vídeos y otras muchas opciones.
Este tema incluye las secciones siguientes:
- ¿Por qué utilizar la transferencia FTP por lotes?
- Requisitos
- Validación del archivo de manifiesto XML
- Estructura del documento de manifiesto XML
- Identificación del documento XML
- La etiqueta de apertura del archivo de manifiesto XML
- La dirección de correo electrónico para notificaciones o el servicio de devolución de llamadas HTTP
- Acciones comunes ejecutadas con el archivo de manifiesto XML de la transferencia FTP por lotes
- La etiqueta de cierre del archivo de manifiesto XML
¿Por qué utilizar la transferencia FTP por lotes?
La transferencia por lotes permite cargar y transferir varios vídeos y listas de reproducción a la vez mediante un archivo de manifiesto XML y el servidor FTP de Video Cloud. A menudo, los editores utilizan la transferencia FTP por lotes para integrar su sistema de gestión de contenidos (CMS) con la publicación de vídeos en Video Cloud, o bien para realizar la ingestión inicial de vídeos en los servicios de publicación de Video Cloud.
Requisitos
Asegúrese de cumplir los siguientes requisitos antes de proceder:
- La transferencia FTP por lotes únicamente está disponible para los clientes de Video Cloud Pro y Enterprise. Si desea ampliar su cuenta de Video Cloud, póngase en contacto con Brightcove para obtener más información.
- Si usted todavía está aprendiendo XML, consulte los recursos básicos enumerados en Utilización de la transferencia FTP por lotes o vea la siguiente demo:
Tutorial en vídeo: Introducción al lenguaje XML - Conozca los fundamentos y procedimientos detallados en Utilización de la transferencia FTP por lotes. Consulte también la lista de vínculos relacionada en la esquina superior derecha de este documento.
- Archivo de ejemplo de un manifiesto XML para la transferencia FTP por lotes. Descargue este sencillo ejemplo para ver cómo cargar el vídeo usando el archivo de manifiesto XML. Abra este archivo y revíselo a medida que lee este artículo. Si opta por utilizar este archivo, deberá adaptarlo a los ajustes de su cuenta y de su entorno.
Validación del archivo de manifiesto XML
Puede validar su archivo de manifiesto XML comparándolo con su definición de tipo de documento (DTD) para la transferencia FTP por lotes. Descargue la Definición del tipo de documento (DTD) para la transferencia FTP por lotes.
Antes de validar el archivo de manifiesto XML, es muy importante asegurarse de que no contenga caracteres inválidos. Los caracteres no permitidos deberán marcarse con una secuencia de escape. Si no se corrigen, estos caracteres podrían causar fallos en su proceso de carga y causar la pérdida o inaccesibilidad de los activos correspondientes. Una utilidad que comprueba que el código XML está bien formado debería detectar estos errores, si es que existieran. A continuación se muestra cómo los caracteres no permitidos en XML deberían representarse correctamente en su manifiesto XML:
- & debería representarse como &
- < y > deben representarse como < y >
- ' y " deben representarse como ' y "
Estas restricciones son aplicables a los valores de los atributos XML del manifiesto; en el cuerpo de elementos XML que admiten CDATA, puede representar directamente estos caracteres. Por ejemplo, compare cómo la frase "Réné & moi" se representa en el atributo <title name > y en la sección CDATA del elemento<short-description>:
<title name="Réné & Moi" refid="myVideo" active="TRUE" video-full-refid="asset2"> <short-description> <![CDATA[ Réné et moi remarquons qu'il est tellement romantique, de manière énigmatique, de se tenir debout sur la terrasse à Chichen Itza et d'observer la montée de la lune gibbeuse! ]]> </short-description> </title>
Estructura del documento de manifiesto XML
En las secciones siguientes se describe la estructura del archivo de manifiesto XML, se explican la sintaxis obligatoria y las acciones opcionales que pueden ejecutarse con el archivo y con el sistema de transferencia FTP por lotes.
Identificación del documento XML
Obligatorio. Esta primera etiqueta identifica el tipo de documento XML y siempre tiene el aspecto siguiente:
<?xml version="1.0" encoding="utf-8"?>
La etiqueta de apertura del archivo de manifiesto XML
Obligatorio. Esta etiqueta específica de Video Cloud indica el inicio del manifiesto de carga.
Ejemplo
<publisher-upload-manifest publisher-id="101" preparer="3rd Street Video" report-success="true">
La etiqueta publisher-upload-manifest utiliza los atributos siguientes.
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| publisher-id | Obligatorio | Identifica para qué editor son los archivos descritos. Esto garantiza que sus vídeos terminen en la cuenta correcta. Encontrará su ID de editor en Video Cloud Studio haciendo clic en Información de la cuenta > Perfil. |
| preparer | Obligatorio | Este atributo debe contener información identificativa sobre quién envió el manifiesto. Esto resulta muy útil cuando un tercero está preparando activos para un editor y los envía directamente a Video Cloud. |
| report-success | Opcional | TRUE o FALSE. Este ajuste permite definir si Brightcove debe enviar una notificación por correo electrónico cuando la carga se completa de forma satisfactoria. El valor predeterminado es FALSE; si usted no incluye este atributo y lo define como TRUE, no recibirá ninguna notificación cuando la carga se complete de forma satisfactoria. |
La etiqueta publisher-upload-manifest puede incluir una o varias de las etiquetas siguientes, que se describen de forma detallada en este documento:
| Nombre | Descripción |
|---|---|
| notify | Dirección para el correo electrónico de notificación [Opcional] |
| callback | Dirección URL para enviar la llamada de devolución de estado mediante HTTP [Opcional] |
| asset | Identificar los activos para la carga [Opcional] |
| title | Crear o actualizar vídeos [Opcional] |
| manual-lineup | Crear o actualizar listas de reproducción manuales [Opcional] |
| automatic-lineup | Crear o actualizar listas de reproducción inteligentes [Opcional] |
La dirección de correo electrónico para notificaciones o el servicio de devolución de llamadas HTTP
Opcional. La etiqueta notify identifica a dónde enviará Brightcove la notificación por correo electrónico de éxito o error. Aunque esta etiqueta no es obligatoria, conviene asegurarse de que se notifique a alguien de su organización si se producen errores. Salvo que defina el atributo report-success="true" en la etiqueta publisher-upload-manifest, únicamente recibirá notificaciones en caso de error, no de éxito. Para enviar las notificaciones a varias direcciones, utilice una instancia independiente de esta etiqueta para cada dirección de correo electrónico. La notificación por correo electrónico vendrá de la dirección donotreply@brightcove.com. Asegúrese de que los correos electrónicos procedentes de esa dirección pueden atravesar su filtro de spam.
Ejemplo
<notify email="usted@ejemplo.com"/> <notify email="yo@ejemplo.com"/>
La etiqueta notify utiliza el atributo siguiente:
Atributo notify
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| Obligatorio | Identifica una dirección de correo electrónico a la que se enviarán las notificaciones de carga. |
Además de recibir notificaciones por correo electrónico, la etiqueta callback también se puede utilizar para enviar notificaciones de carga a páginas web. La notificación se envía en un POST a la dirección URL que se proporciona en el atributo entity-url de la etiqueta callback. El POST incluye:
referenceId=<el id. de referencia indicado en el manifiesto> id=<el id. del título, de la lista de reproducción o del activo en la base de datos> entity=<VIDEO, LINEUP o ASSET> action=<CREATE, DELETE o UPDATE> status=<FAILED,SUCCESS> error=<un mensaje de error>
El estado siempre se incluye en el mensaje de devolución de llamada. Si el estado es FAILED, el resto de la información puede o no estar incluida en el post de llamada de devolución, en función de si la información está disponible en el momento del error. Vea este ejemplo de uso de la función de devolución de llamada HTTP en el sistema de transferencia FTP por lotes, usando PHP para crear un archivo de registro de los datos generados por la transferencia FTP por lotes.
Ejemplo
<callback entity-url="http://example.com/batch-callback.php"/>
Atributo callback
| nombre | ¿obligatorio? | descripción |
|---|---|---|
| entity-url | Obligatorio | Identifica una dirección URL a la que se enviarán las notificaciones de estado de carga. |
Acciones comunes ejecutadas con el archivo de manifiesto XML de la transferencia FTP por lotes
Las siguientes secciones describen diversas acciones que se pueden ejecutar con el archivo de manifiesto XML para la transferencia FTP por lotes. Dentro de un archivo de manifiesto XML se pueden ejecutar varias de las acciones o simplemente una de ellas, dependiendo de sus necesidades de contenidos.
Identificar los activos para la carga
Opcional. La etiqueta asset describe un archivo que se carga a través del archivo de manifiesto XML. Incluya una etiqueta asset separada por cada archivo que se desee cargar.
Ejemplo
<asset filename="MyVideo.flv"
refid="asset1"
size="188812"
hash-code="a4ade1e2b09d517ff7360f91527639b3"
display-name="Mi vídeo (FLV)"
type="VIDEO_FULL"/>
La etiqueta asset utiliza los atributos siguientes:
Atributos de asset
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| filename | Obligatorio | El nombre del archivo como aparece en el disco. La longitud máxima es de 125 caracteres. Para información sobre nombres de archivo válidos, lea Preparación de los activos en Utilización de la transferencia FTP por lotes. |
| refid | Obligatorio | Un identificador único para que un elemento title pueda hacer referencia a este activo desde el archivo de manifiesto. Puede ser un Id. utilizado por el sistema de gestión de contenidos. Utilice únicamente caracteres alfanuméricos. La longitud máxima es de 150 caracteres. |
| size | Opcional | El tamaño numérico del archivo en bytes. Es posible que deba realizar una conversión, de kilobytes o megabytes a bytes, para obtener este número. Aunque la inclusión del atributo de tamaño de archivo es opcional (salvo para activos remotos), puede facilitar la detección y localización de problemas de transferencia. Para activos remotos se precisan los tamaños de los archivos. |
| encoding-rate | Opcional | Para las variantes de representación con múltiples tasas de bits que usted cargue, la tasa de codificación en bits por segundo. Por ejemplo, 150 kbps se especifica como 150000. |
| frame-width | Opcional | Para las variantes de representación de una secuencia con múltiples tasas de bits que se carguen, la anchura de fotogramas del vídeo. |
| frame-height | Opcional | Para las variantes de representación de una secuencia con múltiples tasas de bits que se carguen, la altura de los fotogramas del vídeo. |
| hash-code | Opcional | La suma de comprobación MD5 (código hash) del archivo. Recuerde que el uso de sumas de comprobación MD5 es opcional, aunque recomendado. Las sumas de verificación permiten a Video Cloud verificar la correcta transferencia del archivo. Por lo tanto, usar una suma de comprobación puede ayudar a detectar y solucionar problemas relacionados con la transferencia. Para obtener información sobre cómo crear una suma de comprobación para sus archivos, consulte Creación de sumas de comprobación para transferencias FTP por lotes. |
| display-name | Opcional | Un nombre para el archivo indicado para que se muestre al editor en el módulo multimedia de Video Cloud. Si no define este atributo, se utilizará el nombre del archivo como nombre de visualización. |
| encode-to | Opcional | FLV o MP4. Si existe, codifica este archivo de vídeo con la codificación especificada. FLV utilizará el codec VP6, mientras que MP4 utilizará el codec H.264. Brightcove recomienda usar MP4 (H.264). Si este atributo no existe, el archivo de vídeo no se transcodificará. Si utiliza el elemento de reencode-from-new-source para recodificar el vídeo, este atributo es necesario en el elemento asset que proporciona el nuevo archivo de origen. |
| encode-multiple | Opcional | TRUE o FALSE. Si está definido como TRUE, se codifican varias variantes de representación de este archivo de vídeo para las secuencias con múltiples tasas de bits. El valor predeterminado es FALSE, por lo tanto, salvo que se defina lo contrario, la transcodificación se realizará en un único activo de vídeo. Este atributo debe utilizarse junto con encode-to. Si utiliza el elemento de reencode-from-new-source para recodificar el vídeo, este atributo es necesario en el elemento asset que proporciona el nuevo archivo de origen. |
| h264-preserve-as-rendition | Opcional | TRUE o FALSE. Si está definido en TRUE, Video Cloud almacena una copia del archivo de vídeo H.264 original como activo de vídeo. El archivo H.264 se conservará como variante de representación adicional de una secuencia con múltiples tasas de bits. El valor predeterminado es FALSE. El archivo de origen debe ser un vídeo H.264 válido. Si es TRUE, Video Cloud creará múltiples variantes de representación del archivo original, conservará el original y lo utilizará como variante de representación adicional. Esta opción puede ser útil para proporcionar la mayor calidad de vídeo posible. Este atributo debe utilizarse junto con encode-to y encode-multiple="true". El archivo de origen debe ser un vídeo H.264 válido. |
| h264-no-processing | Opcional | TRUE o FALSE. Si está definido como TRUE, permite cargar un archivo H.264 sin transcodificarlo. El archivo H.264 se conservará como variante de representación adicional de una secuencia con múltiples tasas de bits. El valor predeterminado es FALSE. No se puede utilizar junto con encode-to ni con ninguna de las demás opciones de transcodificación. El archivo de origen debe ser un vídeo H.264 válido. |
| type | Obligatorio | Identifica el tipo de activo que se cargará. El valor debe ser una de las siguientes cadenas en mayúsculas: VIDEO_FULL: un vídeo completo codificado en VP6 Flash Vídeo (FLV) o H.264 (MP4). El valor FLV_FULL es obsoleto para el atributo type; en su lugar, utilice el atributo VIDEO_FULL. FLV_BUMPER: una cortinilla de vídeo codificada en VP6 Flash Video (FLV) o H.264 (MP4) (máximo un clip de 15 segundos). THUMBNAIL: un archivo de imagen que se utiliza como imagen en miniatura en las listas. VIDEO_STILL: una imagen de captura para el vídeo (o una imagen representativa de otra fuente). BACKGROUND: una imagen de fondo que se utilizará en los reproductores de vídeo. LOGO: una imagen de logotipo del editor. LOGO_OVERLAY: una imagen que se utiliza para las marcas en vídeo. OTHER_IMAGE: tipos de imagen diversos. Tenga en cuenta que los archivos de vídeo cargados con la transferencia FTP por lotes deben estar codificados en VP6 (FLV) o H.264 (MP4). |
Si utiliza activos remotos, use la etiqueta remote-asset en lugar de la etiqueta asset para identificar los activos. Consulte Creación de vídeos con archivos de vídeo remotos para obtener detalles sobre el uso de activos remotos y los atributos de la etiqueta remote-asset.
Crear o actualizar vídeos con el elemento title
Opcional. La etiqueta title describe los vídeos que desea crear o actualizar. Utilice una etiqueta title independiente para cada vídeo que desee incluir en la carga en su archivo de manifiesto XML.
Ejemplo
<title name="Mi título"
refid="title1"
active="TRUE"
start-date="01/01/2007 12:00 AM"
end-date="01/01/2007 12:00 AM"
video-full-refid="asset2"
thumbnail-refid="asset4"
video-still-refid="asset5"
flash-prebumper-refid="asset6"
shared="true"
economic-type="AD"
ad-keys=";key=value;key=value" >
<short-description>Mi descripción abreviada.</short-description>
<long-description>Mi descripción detallada.</long-description>
<related-link-url>http://su-empresa.com/</related-link-url>
<related-link-text>Más información.</related-link-text>
<tag>funny</tag>
<tag>entertaining</tag>
<logo-overlay
asset-refid="12345"
click-thru="http://www.example.com"
tooltip="Ir al ejemplo" alignment="bottom right" />
</title>
Las etiquetas de títulos incluyen atributos y etiquetas sucesoras, que se correlacionan fielmente con los campos del cuadro de diálogo Editar vídeo del módulo multimedia. Tenga en cuenta, no obstante, que editando un vídeo en Video Cloud Studio se puede definir que un vídeo genere siempre una solicitud de anuncio, pero que no se puede hacer lo mismo si se emplea la transferencia FTP por lotes.
Atributos de title
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| name | Obligatorio | El nombre del vídeo como aparecerá en un reproductor. Los espectadores verán este nombre de vídeo al realizar una exploración o búsqueda. El nombre no puede superar los 255 caracteres de longitud. |
| refid | Obligatorio | Un identificador único para que los elementos lineup puedan hacer referencia a este elemento title desde el archivo de manifiesto. La longitud máxima es de 150 caracteres. |
| active | Opcional | TRUE o FALSE. Especifica si este vídeo debe estar activo a partir del momento en que se crea. Si no define este atributo, su valor será el predeterminado: FALSE. |
| start-date | Opcional | La fecha y la hora de inicio de la programación principal para el vídeo. El formato necesario es MM/DD/AAAA HH:MM AM. Por ejemplo: start-date="01/01/2008 12:00 AM". Nota: La entrada en el manifiesto de carga para la fecha de inicio es en hora del Pacífico. Sin embargo, una vez completada la carga, la fecha de inicio que se muestra en el módulo multimedia es en hora del Este de EE.UU. |
| end-date | Opcional | La fecha y la hora de fin de la programación principal para el vídeo. El formato necesario es MM/DD/AAAA HH:MM AM. Por ejemplo: start-date="12/31/2008 12:00 AM". Nota: La entrada en el manifiesto de carga para la fecha de inicio es en hora del Pacífico. Sin embargo, una vez completada la carga, la fecha de fin que se muestra en el módulo multimedia es en hora del Este de EE.UU. |
| video-full-refid | Opcional | El atributo de Id. de referencia de un archivo de vídeo completo que se incluirá en este vídeo. Este Id. de referencia puede ser un Id. especificado anteriormente en el sistema o un Id. especificado en una etiqueta asset en el mismo archivo de manifiesto. |
| thumbnail-refid | Opcional | El parámetro de Id. de referencia de un activo de imagen en miniatura. Este Id. de referencia puede ser un Id. especificado anteriormente en el sistema o un Id. especificado en una etiqueta asset en el mismo archivo de manifiesto. No utilice este atributo si también utiliza el atributo encode-to para el activo de vídeo correspondiente. Cuando Video Cloud transcodifica un vídeo, se crea automáticamente una imagen en miniatura. |
| video-still-refid | Opcional | El parámetro de Id. de referencia de un activo de captura de vídeo. Este Id. de referencia puede ser un Id. especificado anteriormente en el sistema o un Id. especificado en una etiqueta asset en el mismo archivo de manifiesto. No utilice este atributo si también utiliza el atributo encode-to para el activo de vídeo correspondiente. Cuando Video Cloud transcodifica un vídeo, se crea automáticamente una imagen de captura de vídeo. |
| flash-prebumper-refid | Opcional | El parámetro de Id. de referencia de un activo de cortinilla de vídeo. Este Id. de referencia puede ser un Id. especificado anteriormente en el sistema o un Id. especificado en una etiqueta asset en el mismo archivo de manifiesto. |
| allow-viral-syndication | Opcional | TRUE o FALSE. Si es FALSE, este vídeo no se podrá distribuir viralmente y los botones "obtener código" y "compartir" aparecerán desactivados en el reproductor. El valor predeterminado es TRUE. |
| shared | Opcional | TRUE o FALSE. ¿Debe compartirse este vídeo con las cuentas de afiliados? Si está definido como TRUE, usted también deberá incluir al menos un elemento sucesor share-to-id en el elemento title para especificar los Id. de cuenta de los afiliados con los que comparte. Obtenga más información sobre la compartición de contenido multimedia. |
| auto-accept-shared | Opcional | TRUE o FALSE. Si este vídeo se va a compartir con cuentas de afiliados, ¿pueden los afiliados aceptarlo automáticamente en su Media Library de Video Cloud, en lugar de aceptarlo explícitamente en el módulo multimedia de Video Cloud Studio? Este atributo no tiene ningún efecto, salvo que haya definido shared="TRUE" para este vídeo y que el afiliado haya habilitado la aceptación automática para la cuenta de origen del vídeo compartido. Obtenga más información sobre la compartición de contenido multimedia. |
| economic-type | Opcional | Uno de los valores siguientes: FREE o AD. Si no se especifica ningún valor para el tipo económico, el valor predeterminado del vídeo será AD, si el valor es FREE, no se efectuarán solicitudes de anuncios para este vídeo. |
| ad-keys | Opcional | Una cadena de pares clave/valor separada por punto y coma que se inicia con un punto y coma. Por ejemplo: ad-keys=";key=value;key=value;key=value" |
| overlay-update | Opcional | TRUE o FALSE. Si está establecido en true, y este vídeo ya existe, únicamente se modificarán los atributos y los elementos sucesores de este título definidos explícitamente. Si está establecido en false (predeterminado), los atributos o los elementos sucesores de este título no definidos explícitamente se definirán en null. |
Etiquetas de subelementos de title
Una etiqueta title puede contener las siguientes etiquetas como elementos sucesores.
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| short-description | Obligatorio | Una descripción abreviada de este vídeo con limitación de 250 caracteres. En función de la plantilla de reproductores, los espectadores pueden ver esta descripción. Normalmente, la descripción abreviada también se muestra en las fuentes RSS que incluyen el vídeo. |
| long-description | Opcional | Una descripción detallada de este vídeo con limitación de 5.000 caracteres. Los espectadores pueden ver esta descripción al realizar una exploración o búsqueda en sitios web o motores de búsqueda públicos. |
| related-link-url | Opcional | Una dirección URL relacionada para el vídeo. La longitud máxima es de 255 caracteres. |
| related-link-text | Opcional | Texto para la dirección URL del vínculo relacionado opcional. La longitud máxima es de 255 caracteres. |
| custom-string-value | Opcional | Un campo de metadatos personalizados tipo cadena. Utilice el atributo name para el nombre del campo y el atributo value para el valor de cadena del campo. La longitud máxima es de 1.024 caracteres. |
| custom-enum-value | Opcional | Un campo de metadatos personalizados tipo enumeración. Utilice el atributo name para el nombre del campo y el atributo value para el valor de cadena del campo. La longitud máxima es de 100 caracteres. |
| tag | Opcional | Una o varias etiquetas tag que colaborarán en el filtrado y la búsqueda del vídeo, hasta un máximo de 128 caracteres cada una. El número máximo de etiquetas tag es de 1.200 por vídeo. Las etiquetas tag también ayudan a los editores a filtrar los vídeos de una lista de reproducción inteligente. Puede utilizar múltiples instancias de este elemento para asociar varias etiquetas tag a un único vídeo. Cada etiqueta debe estar contenida en su propio elemento <tag>. Por ejemplo:
<tag>viaje</tag> |
| rendition-refid | Opcional | Un Id. de referencia para una variante de representación de este vídeo para secuencias con múltiples tasas de bits. Esta etiqueta únicamente debe utilizarse al asignar activos que no requieran que Video Cloud los transcodifique. |
| share-to-id | Opcional | Si comparte este vídeo y ha definido <title shared="true" >, debe incluir uno o varios elementos sucesores share-to-id en el elemento title para especificar los Id. de cuenta de Video Cloud de las cuentas con las que comparte el vídeo. Obtenga más información sobre la compartición de contenido multimedia. |
| logo-overlay | Opcional | La colección de metadatos para definir una imagen que se colocará encima de la ventana de vídeo para mostrar la marca y para dirigir el tráfico a una ubicación específica. Esta etiqueta utiliza los atributos de logo-overlay. Obtenga más información sobre la sobreimpresión de logotipos. |
Atributos de logo-overlay
Opcional. Puede utilizar el archivo de manifiesto XML para especificar una imagen que se colocará encima de la ventana de vídeo para mostrar la marca y dirigir el tráfico a una ubicación específica, mediante la etiqueta logo-overlay. Más información sobre la sobreimpresión de logotipos. La etiqueta logo-overlay utiliza los atributos siguientes:
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| asset-refid | Obligatorio | El parámetro de Id. de referencia del activo de sobreimpresión de logotipos. Este Id. de referencia puede ser un Id. especificado anteriormente en el sistema o un Id. especificado en una etiqueta asset en el mismo archivo de manifiesto. |
click-thrulogo-overlay |
Opcional | La dirección URL de la ventana del navegador que se abrirá al hacer clic en la imagen de sobreimpresión de logotipos. La longitud máxima es de 128 caracteres. |
| tooltip | Opcional | La información sobre la herramienta o la etiqueta alt que aparecerá en la imagen de sobreimpresión de logotipos al pasar el ratón por encima. La longitud máxima es de 128 caracteres. |
| alignment | Opcional | La alineación de la imagen de sobreimpresión de logotipos en la ventana de vídeo. Los valores válidos son "top left", "top right", "bottom left" o "bottom right". Por ejemplo:
<alignment="top right"/> |
Recodificación de vídeos existentes
Opcional. Puede utilizar el archivo de manifiesto XML para ordenar a Video Cloud que recodifique los archivos de vídeo correspondientes a un vídeo, manteniendo todos los metadatos del vídeo. Utilice el elemento reencode-from-existing-source como sucesor del elemento de nivel superior publisher-upload-manifest si desea utilizar el archivo de origen existente en su biblioteca multimedia de Video Cloud como origen para la recodificación; utilice el elemento reencode-from-new-source si está suministrando un nuevo archivo de origen (incluso de mayor calidad) con el manifiesto XML. Leer la información completa sobre la recodificación de vídeos existentes.
| Nombre | Descripción |
|---|---|
| reencode-from-existing-source | Identifica un vídeo para su recodificación a partir de su actual activo de origen. |
| reencode-from-new-source | Identifica un vídeo a recodificar a partir de un nuevo origen recién proporcionado, o a partir de un origen ya existente en nuestro sistema pero no asociado actualmente a este vídeo. |
Atributos de reencode-from-existing-source
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| title-refid | Obligatorio | ID de referencia del vídeo a recodificar |
| encode-to | Opcional | FLV o MP4. Si existe, codifica este archivo de vídeo con la codificación especificada. FLV representa VP6, mientras que MP4 representa H.264. En ausencia de este atributo, se utilizará el codec predeterminado del editor. |
| encode-multiple | Opcional | TRUE o FALSE. Si es TRUE, se crearán múltiples variantes de representación del vídeo. Si es FALSE, sólo se creará una única variante. En ausencia de este atributo, asume el valor predeterminado TRUE. |
| overwrite-images | Opcional | TRUE o FALSE. Si es TRUE, las imágenes del vídeo recodificado (la miniatura y el fotograma) serán reemplazadas por la nueva imagen capturada durante la recodificación. Si es FALSE, se conservarán las imágenes existentes del vídeo. En ausencia de este atributo, asume el valor predeterminado FALSE. Si el vídeo no tiene asociada ninguna miniatura ni imagen capturada, serán creadas durante la recodificación, sea cual sea el valor de este atributo. |
| preserve-source-as-rendition | Opcional | TRUE o FALSE. Si es TRUE, Video Cloud creará múltiples variantes de representación del archivo original, conservará el original y lo utilizará como variante de representación adicional. En ausencia de este atributo, asume el valor predeterminado FALSE. |
Atributos de reencode-from-new-source
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| title-refid | Obligatorio | ID de referencia del vídeo a recodificar |
| new-source-refid | Obligatorio | Identificador de referencia del activo a utilizar como nuevo origen del vídeo a recodificar. Este activo puede aparecer en el mismo manifiesto que este elemento reencode-from-existing-source, o ser un activo ya existente en el sistema de Video Cloud. |
| overwrite-images | Opcional | TRUE o FALSE. Si es TRUE, las imágenes del vídeo recodificado (la miniatura y el fotograma) serán reemplazadas por la nueva imagen capturada durante la recodificación. Si es FALSE, se conservarán las imágenes existentes del vídeo. En ausencia de este atributo, asume el valor predeterminado FALSE. Si el vídeo no tiene asociada ninguna miniatura ni imagen capturada, serán creadas durante la recodificación, sea cual sea el valor de este atributo. |
Crear o actualizar listas de reproducción con el elemento lineup
Opcional. Existen dos tipos de listas de reproducción: manuales e inteligentes. Más información sobre el Uso de listas de reproducción.
- Listas de reproducción manuales. La posición de los vídeos en la lista de reproducción se determina creando una lista de todos los vídeos que se incluirán en ella. Utilice la etiqueta manual-lineup.
- Listas de reproducción inteligentes. Todos los vídeos de la cuenta del editor se incluyen automáticamente en la lista de reproducción. Puede especificar la forma en la que se ordenan los vídeos: alfabéticamente, por fechas de comienzo o por fecha de creación (del más antiguo al más reciente, del más reciente al más antiguo), el más reproducido o el más reproducido en la última semana. Utilice la etiqueta automatic-lineup.
No es necesario crear listas de reproducción utilizando el archivo de manifiesto XML; en lugar de ello, puede utilizar el archivo de manifiesto XML para cargar solo activos, o activos y vídeos, así como para crear listas de reproducción con el módulo multimedia.
Listas de reproducción manuales
Para las listas de reproducción manuales, utilice la etiqueta manual-lineup. En la etiqueta manual-lineup, utilice una serie de etiquetas title-refid para indicar todos los vídeos que se deben incluir en la lista de reproducción.
Ejemplo
<manual-lineup
name="Mi línea de reproducción manual"
refid="lineup1"
thumbnail-refid="asset4"> <title-refid>title1</title-refid>
<title-refid>title3</title-refid>
<title-refid>title137</title-refid>
</manual-lineup>
La etiqueta manual-lineup utiliza una combinación de atributos y elementos sucesores que se correlacionan perfectamente con los campos que se encuentran en el formulario de creación de listas de reproducción del módulo multimedia.
Atributos de manual-lineup
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| name | Obligatorio | El nombre de la lista de reproducción como aparecerá en los reproductores. Los espectadores verán este nombre de lista de reproducción al realizar una exploración o búsqueda. La longitud máxima es de 50 caracteres. |
| refid | Obligatorio | Un identificador único para que se pueda hacer referencia a la lista de reproducción más adelante. La longitud máxima es de 150 caracteres. |
| thumbnail-refid | Opcional | El atributo refid de un activo de imagen en miniatura que se incluirá en esta línea de reproducción manual. Este Id. de referencia puede ser un Id. especificado anteriormente en el sistema o un Id. especificado en una etiqueta asset en el mismo archivo de manifiesto. |
| overlay-update | Opcional | TRUE o FALSE. Si está establecido en TRUE, y esta lista de reproducción ya existe, únicamente se modificarán los atributos de esta lista de reproducción definidos explícitamente. Si está establecido en FALSE (predeterminado), los atributos de esta lista de reproducción no definidos explícitamente se definirán en null. Sin embargo, overlay-update no se puede utilizar para añadir nuevos vídeos a una lista de reproducción existente. Si desea añadir vídeos a una lista de reproducción existente, deberá incluir la lista completa de vídeos, cada uno en su propio elemento title-refid. |
Etiqueta de elemento sucesor para la etiqueta manual-lineup
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| title-refid | Obligatorio | El parámetro refid de un vídeo que se incluirá en esta lista de reproducción manual. Este Id. de referencia puede ser un Id. especificado anteriormente en el sistema o un Id. especificado en una etiqueta asset en el mismo archivo de manifiesto. |
| description | Opcional | Una descripción abreviada de esta lista de reproducción. No puede superar los 250 caracteres. |
Listas de reproducción inteligentes
Para las listas de reproducción inteligentes, utilice la etiqueta automatic-lineup. No se incluyen referencias a los vídeos de forma explícita, sino que se especifica cómo ordenarlos utilizando el atributo type. También puede filtrar vídeos utilizando el atributo tag-filter y el elemento sucesor title-tag.
Ejemplo
<automatic-lineup name="Mi línea de reproducción automática"
refid="lineup2"
type="NEWEST_TO_OLDEST"
tag-filter="AND"
title-limit="50"
thumbnail-refid="asset4">
<title-tag>sporty</title-tag>
</automatic-lineup>
El elemento automatic-lineup dispone de una combinación de atributos y subelementos que se correlacionan perfectamente con los campos que se encuentran en el formulario de creación de listas de reproducción del módulo multimedia.
Atributos de automatic-lineup
Etiqueta de elemento sucesor para la etiqueta automatic-lineup
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| title-tag | Opcional | Puede utilizar este elemento para filtrar los vídeos que se incluirán en esta línea de reproducción automática. Utilice un elemento title-tag independiente para cada etiqueta que desee utilizar para filtrar títulos. Consulte tag-filter para obtener información sobre cómo tratar el filtrado con más de una etiqueta. Por ejemplo:
<automatic-lineup name="Mi línea de reproducción automática" |
| description | Opcional | Una descripción abreviada de esta lista de reproducción. No puede superar los 250 caracteres. |
Creación de puntos de referencia
Opcional. Puede añadir puntos de referencia a un vídeo utilizando el elemento XML cuepoint en el archivo de manifiesto XML para la transferencia FTP por lotes. Un punto de referencia es un marcador en un instante concreto a lo largo de un vídeo. Puede utilizar puntos de referencia para desencadenar anuncios intermedios o para separar capítulos o escenas en un vídeo de largo formato. Más información sobre Añadir puntos de referencia a vídeos.
La etiqueta cuepoint es de nivel superior y se utiliza para definir un punto de referencia de un vídeo. Tiene una etiqueta sucesora opcional, metadata. La etiqueta sucesora metadata puede contener CDATA o una cadena, y proporciona información sobre el punto de referencia.
Ejemplos
<cuepoint name="My Cue" type="CODE" time="500000" video-refid="video001" />
<cuepoint name="Mi otro punto de referencia" type="AD" time="50000" video-refid="video001" />
<cuepoint name="Mi tercer punto de referencia" type="AD" time="120000" video-refid="video001">
<metadata>Algo interesante sobre este punto de referencia.</metadata>
</cuepoint>
<cuepoint name="Mi cuarto punto de referencia" type="AD" time="270000" video-refid="video055">
<metadata>
<![CDATA[
Éste es un conjunto multilínea de metadatos
]]>
</metadata>
</cuepoint>
Atributos de la etiqueta cuepoint
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| name | Obligatorio | Un nombre que permita hacer referencia al punto de referencia. La longitud máxima es de 128 caracteres. |
| video-refid | Obligatorio | El Id. de referencia del vídeo al que se aplica este punto de referencia. |
| time | Obligatorio | El momento del punto de referencia, calculado en milisegundos desde el comienzo del vídeo. |
| type | Obligatorio | Tipo de punto de referencia: AD o CODE. Un punto de referencia AD se utiliza para desencadenar solicitudes de anuncios intermedios. Un punto de referencia CODE genera un evento que se puede supervisar y al que es posible responder, y puede indicar una pausa de capítulo o de escena en el vídeo. |
| metadata | Opcional | Una cadena que se puede pasar junto con un punto de referencia CODE. La longitud máxima es de 512 caracteres. |
Etiqueta sucesora para la etiqueta cuepoint
De forma opcional, una etiqueta cuepoint puede incluir un único elemento sucesor metadata. El elemento metadata incluye una cadena que se puede entregar junto con el punto de referencia.
Eliminar activos, vídeos o listas de reproducción
Opcional. También puede utilizar el sistema de transferencia FTP por lotes para eliminar activos, vídeos, listas de reproducción o puntos de referencia de la cuenta. Advertencia: Si un vídeo hace referencia a un activo, el activo no se puede eliminar, y si una lista de reproducción hace referencia a un vídeo, el vídeo no se puede eliminar.
Ejemplo
<delete-asset refid="RandomAssetsRefID"/> <delete-title refid="RandomTitlesRefID"/> <delete-lineup refid="RandomLineupsRefID"/> <delete-cuepoint video-refid="video0001" id="0123456789"/>
Utilice las etiquetas siguientes y establezca el atributo refid en el Id. de referencia del activo, el vídeo, la lista de reproducción o el identificador del punto de referencia que desee eliminar.
| Nombre | ¿Obligatorio? | Descripción |
|---|---|---|
| delete-asset | Opcional | Elimina el activo con el Id. de referencia especificado en el atributo refid. |
| delete-title | Opcional | Elimina el vídeo con el Id. de referencia especificado en el atributo refid. |
| delete-lineup | Opcional | Elimina la lista de reproducción con el Id. de referencia especificado en el atributo refid. |
| delete-cuepoint | Opcional | Elimina el punto de referencia con el identificador especificado en el atributo id. |
La etiqueta de cierre del archivo de manifiesto XML
Obligatorio. La última etiqueta marca el final del archivo de manifiesto XML e indica que todo el manifiesto está presente.
</publisher-upload-manifest>
Temas relacionados
Además de este documento, Brightcove proporciona la documentación siguiente para ayudarle a entender y utilizar la función de transferencia FTP por lotes de Video Cloud:
