Contactar con Soporte
del sistema
En este tema se trata del uso Backlot API de para ingerir contenido en Video Cloud.
Introducción
Utilice el Backlot API para cargar contenido mediante programación en Video Cloud. Este enfoque le permite integrar su sistema de gestión de contenido (CMS) o flujos de trabajo directamente con la plataforma Video Cloud.
Puede utilizar el Backlot API para cargar y administrar vídeos, miniaturas y archivos de subtítulos opcionales mediante programación.
Si desea ingerir contenido usando la API de backlot, consulte:
- Activos de vídeo y audio (para vídeos y miniaturas)
- Trabajar con subtítulos opcionales
La llamada principal utilizada para cargar archivos (denominada «activos») es la /v2/assets ruta.
Nota: No agregue un video con un valor nulo external_id, es decir, un external_id sin valor ("") o un valor de "null". Dichos ID externos nulos no se pueden buscar más adelante.
Activos de vídeo y audio
Cuando subes un vídeo a Ooyala, Ooyala lo transcodifica automáticamente usando los ajustes especificados para tu cuenta y hace que los vídeos estén disponibles para su reproducción a través del reproductor.
Te recomendamos que subas vídeos a Ooyala en H.264, pero también apoyamos muchos códecs de uso común.
- Crear el activo con propiedades básicas
- Recuperar las «URL de carga» del sistema
- Para cada «URL de carga», coloque el fragmento de archivo apropiado en el sistema
Nota: Cuando cargue cada fragmento, no firme la solicitud, como lo haría con otras solicitudes. Simplemente PON el contenido del fragmento a las URL exactas. Estas direcciones URL ya se han firmado por usted.
Obtener la carga de direcciones URL para el activo recién creado
[GET] /v2/activos/ {asset_id} /uploading_urls
Establecer estado de carga
[PUT] /v2/activos/ {asset_id} /upload_status
{
«estado» :"cargado»
}
Ver transmisiones de un vídeo
El término streams en este contexto significa los procesos Internal-to-Ooyala iniciados por el sistema para transcodificar sus vídeos.
[GET] /v2/activos/ {asset_id} /streams
Ver los archivos de origen de un vídeo
[GET] /v2/activos/ {asset_id} /source_file_info
Obtener direcciones URL para imágenes de vista previa generadas automáticamente
[GET] /v2/activos/ {asset_id} /generated_preview_images
Cargar imagen de vista previa personalizada
[POST] /v2/activos/ {asset_id} /preview_image_files
<archivo_contenido >
Establecer configuración de imagen de vista previa principal
- generated: utilizar la imagen de vista previa generada automáticamente
- uploaded_file: utilice la imagen de vista previa personalizada cargada
- remote_url: URL de la imagen de vista previa
[PUT] /v2/activos/ {asset_id} /primary_preview_image
{
«tipo» :"generado» | «uploaded_file» | «remote_url»
}
Acerca de los metadatos
Un activo puede tener hasta 100 pares de nombre/valor de metadatos personalizados. Un nombre está limitado a 128 caracteres y su valor está limitado a 2.048 caracteres.
Ejemplos
En este ejemplo se crea un vídeo:
[POST] /v2/assets {
«nombre» :"Honey Badger»,
«nombre_archivo»:» honeybadger.avi «,
«asset_type» :"video»,
«file_size» :398422,
«chunk_size» :100000
}
Video Cloud devuelve una respuesta similar a la siguiente:
{
«nombre» :"Honey Badger»,
«preview_image_url» :null,
«asset_type» :"video»,
«duración» :0,
«embed_code»: {embed_code},
"created_at":"2011-10-26T19:40:32+00:00",
«time_restrictions» :null,
"updated_at":"2011-10-26T19:40:32+00:00",
«external_id» :nulo,
«hosted_at» :null,
«original_file_name»:» honeybadger.avi «,
«descripción» :null,
«status» :"subir»
}
En este ejemplo se devuelven las URL de carga:
[GET] /v2/activos/ {asset_id} /uploading_urls
Video Cloud devuelve una respuesta similar a la siguiente:
["https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000000000-0000000099999&filesize=100000&expires=1314391791&signature=Jliypj/Q0c5dVu4tDFUDIjIngyDu/LGng+rCG3KNSF4",
«https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000100000-0000000199999&filesize=100000&expires=1314391791&signature=qOjdkomEUO7mgWDjqu9z01QrI39sxa9W0zzRXDhOR9Y «,
"https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000200000-0000000299999&filesize=100000&expires=1314391791&signature=+bT8Jft9kvVdkYMND87BSs/VWu1r2imCNkl9v2++eTU",
«https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000300000-0000000398421&filesize=98422&expires=1314391791&signature=cObAITdnMHeT6/wuNCAjYABgxqdlfPaLeATOmsKxmdg"]
En este ejemplo se marca el vídeo como cargado, lo que indica a Video Cloud que comience a procesar el archivo:
[PUT] /v2/activos/ {asset_id} /upload_status
{
«estado» :"cargado»
}
Video Cloud devuelve una respuesta similar a la siguiente:
{
«status»: «subido»
}
[GET] /v2/activos/ {asset_id} /source_file_info
Video Cloud devuelve una respuesta similar a la siguiente:
{
«original_file_name»: lakeside.wmv,
«source_file_url»: {source_url}»
«file_size»: 25227886
}
Trabajar con subtítulos opcionales
Puede agregar subtítulos opcionales a vídeos o vídeos de activos remotos a través de la API de Backlot.
Formatos admitidos para subtítulos
| Extensión de archivo | Descripción |
|---|---|
| .vtt (WebVTT/) - this is the format required for HTML5 video players | WebVTT se puede utilizar tanto para subtítulos incrustados como sidecar en formatos de streaming HTTP como HLS y DASH. |
| .TTML ( anteriormente DXFP ) - se convertirá a WebVTT | TTML (archivo de lenguaje de marcado de texto temporizado. Generalmente, un archivo de subtítulos opcionales de este tipo tendrá una extensión.dfxp (perfil de intercambio de formato de distribución). |
Subir subtítulos opcionales
[PUT] /v2/activos/ {asset_id} /closed_captions/ {dfxp_file_content}
Obtener subtítulos opcionales
[GET] /v2/activos/ {asset_id} /closed_captions
Actualizar subtítulos opcionales
[PUT] /v2/activos/ {asset_id} /closed_captions
Eliminar subtítulos opcionales
[ELIMINAR] /v2/activos/ {asset_id} /closed_captions