Aperçu
Les actifs distants sont principalement ajoutés via le Opérations sur les actifs , à quelques exceptions près indiquées ci-dessous. Notez que les opérations GET pour les actifs peuvent être utilisées à la fois pour les actifs ingérés et distants.
Autorisation
Flux de travail
Voici les étapes à suivre pour configurer un élément distant :
Dans les sections suivantes, nous examinerons chacune de ces étapes.
Créer la vidéo
Avant de pouvoir ajouter des ressources distantes, vous devez créer un objet vidéo dans votre médiathèque Video Cloud, à l'aide de la requête POST pour :
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
Dans le corps de la requête, incluez un objet JSON qui contient au minimum le nom de la vidéo, mais peut contenir des métadonnées supplémentaires :
{
"name": "My Remote Video",
"description": "A short description of the video",
"tags": ["remote", "fall_campaign"],
"reference_id": "myUniqueReferenceID"
}
Pour plus de détails sur l'opération de création de vidéo, reportez-vous au Référence API.
Ajouter des rendus
Ensuite, ajoutez un ou plusieurs rendus vidéo distants complets en effectuant une requête POST à :
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/renditions
Le JSON dans le corps de la requête doit contenir au minimum l'URL distante, mais peut contenir d'autres métadonnées pour le rendu :
{
"video_duration": 31487,
"name": "RA - Great Blue Heron",
"remote_url": "//some.site.com/videos/mp4/greatblueheron.mp4",
"encoding_rate": 983000,
"frame_height": 360,
"size": 3887659,
"frame_width": 640,
"video_codec": "h264",
"video_container": "MP4",
"progressive_download": true
}
Remarques
- Utilisez ce point de terminaison uniquement pour ajouter des rendus vidéo complets (généralement un fichier .mp4 ou .mov) - pour ajouter des flux segmentés comme HLS ou DASH, utilisez les points de terminaison manifeste décrits dans la section suivante.
-
Video Cloud n'inspecte pas les fichiers vidéo distants, donc fournir des métadonnées supplémentaires permettra à Video Cloud d'afficher ces informations dans Studio (ou dans le lecteur Brightcove, si vous configurez le lecteur pour afficher les métadonnées).
Pour plus de détails sur l'opération d'ajout de rendu, consultez le Référence API.
- Les rendus pour les actifs distants doivent avoir le
video_codecetvideo_containerchamps pour fonctionner correctement. - Rendus MP4 doit avoir le
"progressive_download": truechamp configuré pour fonctionner correctement dans le lecteur Brightcove - Les éléments mixtes ne sont pas autorisés : vous ne pouvez pas ajouter de rendu distant à une vidéo ingérée
- Si votre CDN ou autre référentiel distant prend en charge la livraison HTTP et HTTPS, spécifiez l'URL des ressources distantes avec une URL neutre du point de vue du protocole , comme indiqué dans l'exemple ci-dessus (c'est-à-dire utilisez "//mon.domaine/chemin/..." au lieu de "https://my.domain/path/...")
Ajouter des manifestes
Notez que pour ajouter des types segmentés distants tels que les rendus DASH et HLS, il vous suffit de créer la vidéo, puis d'ajouter les manifestes - vous le faites ne pas besoin d'"ajouter des rendus" comme expliqué dans la section précédente.
En plus d'ajouter des rendus complets, vous pouvez également ajouter des manifestes pour des rendus segmentés tels que HLS, HDS et ISM, en effectuant une requête POST au point de terminaison pour le type de manifeste :
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hls_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hds_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ism_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ismc_manifest
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/dash_manifests
Dans le corps de la requête JSON, fournissez l'URL distante et un nom (facultatif) :
{
"remote_url": "https://some.site.com/avideo/hls/chickadee/chickadee.m3u8",
"name": "chickadee_hls"
}
Pour plus de détails sur l'utilisation des opérations d'ajout de manifeste, consultez la section appropriée de la référence API :
Ajouter une affiche/une vignette
Vous pouvez ajouter une affiche distante et une vignette à votre vidéo en effectuant des requêtes POST à ces points de terminaison :
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/poster
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/thumbnail
Dans le corps de la requête JSON, vous devez inclure l'URL distante de l'image, et vous pouvez ajouter un nom si vous le souhaitez :
{
"remote_url": "https://some.site.com/images/great-blue-heron-poster.png"
}
Pour plus de détails sur les opérations, consultez la référence API :
Ajouter des pistes de texte
Les pistes de texte peuvent être utilisées pour ajouter des légendes, des chapitres et d'autres métadonnées temporelles à votre vidéo.
Contrairement aux rendus et aux images, les pistes de texte sont traitées de la même manière pour les vidéos de ressources distantes que pour les vidéos ingérées dans le système Video Cloud. Pour ajouter réellement les pistes de texte à une vidéo, vous devez utiliser le module Média dans Studio ou le CMS API Mettre à jour l'opération vidéo.
Remplacer la télécommande par ingéré
Vous pouvez remplacer une vidéo d'élément distant par une vidéo ingérée en faisant une demande à l'API Dynamic Ingest :
https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
Le corps de requête le plus simple ressemblerait à ceci :
{
"master": {
"url": "https://host/master.mp4"
}
}
Voir le Référence de l'API d'ingestion dynamique pour des options et des informations supplémentaires.
L'une des utilisations courantes des vidéos de ressources distantes consiste à créer une vidéo d'espace réservé à utiliser dans un événement de diffusion en direct. Une fois l'événement terminé, vous souhaiterez peut-être remplacer la vidéo « en direct » par un enregistrement vidéo à la demande de l'événement qui apparaît dans le même lecteur que celui que vous avez utilisé pour la diffusion en direct. Vous pouvez le faire en utilisant la méthode décrite ci-dessus, bien qu'elle puisse également être utilisée pour transformer n'importe quelle vidéo de ressource distante en une vidéo ingérée dans Video Cloud.
Modifier les actifs
En plus d'ajouter des actifs distants pour une vidéo, il existe également des opérations pour récupérer, mettre à jour et supprimer les informations sur les actifs. Ces opérations utilisent les points de terminaison décrits ci-dessus, mais avec des requêtes GET, PATCH ou DELETE. Pour les demandes de mise à jour et de suppression, vous devez ajouter l'ID d'actif (qui est inclus dans la réponse aux demandes POST et GET) à l'URL de la demande :
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
Voir le Référence API pour plus de détails sur les opérations d'obtention, de mise à jour et de suppression.