assistance Contacter le support | Étatétat du système du système
Contenu de la page

    ressources à distance

    Dans cette rubrique, vous apprendrez comment ajouter des ressources distantes, notamment des vidéos, des formats associés, des manifestes, des images et des pistes de texte WebVTT, à Video Cloud à l'aide de l'API CMS. Cette rubrique explique comment configurer la vidéo, puis ajouter, mettre à jour et supprimer des ressources distantes.

    Présentation

    Les actifs distants sont principalement ajoutés par le biais des Opérations des actifs, avec quelques exceptions indiquées ci-dessous. Notez que les opérations GET pour les ressources peuvent être utilisées pour les actifs ingérés et distants.

    Autorisation

    Flux de travail

    Voici les étapes à suivre pour configurer une ressource distante :

    <img class="bcls-image—no-border » alt="Flux de travail des ressources distantes » src= » /assets/images/cms/managing-videos/remote-assets-workflow.svg « »/>
    Flux de travail des actifs

    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 qui 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 d'informations sur l'opération de création vidéo, reportez-vous à la référence de l'API.

    Ajouter des formats associés

    Ajoutez ensuite 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 format associé :

          {
            "video_duration": 31487,
            "name": "RA - Great Blue Heron",
            "remote_url": "//learning-services-media.brightcove.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

    1. 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 tels que HLS ou DASH, utilisez les points de terminaison manifestes décrits dans la section suivante.
    2. Video Cloud n'inspecte pas les fichiers vidéo distants. Par conséquent, la fourniture de 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 d'informations sur l'opération d'ajout de format associé, reportez-vous à la référence de l'API.

    3. Les rendus pour les actifs distants doivent avoir le video_codec et video_container champs pour fonctionner correctement.
    4. Les formats associés MP4 doivent avoir le "progressive_download": true champ défini pour fonctionner correctement dans le lecteur Brightcove
    5. Les ressources mixtes ne sont pas autorisées - vous ne pouvez pas ajouter un format associé distant à une vidéo ingérée
    6. Si votre CDN ou un autre référentiel distant prend en charge la livraison HTTP et HTTPS, spécifiez l'URL des ressources distantes avec une URL neutre au protocole , comme indiqué dans l'exemple ci-dessus (c'est-à-dire utilisez « //mon.domain/path/... » au lieu de "http://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 n'avez pas besoin d' « ajouter des rendus » comme expliqué dans la section précédente.

    Outre l'ajout de formats associés pleine longueur, vous pouvez également ajouter des manifestes pour des formats associés segmentés tels que HLS, HDS et ISM, en effectuant une requête POST au point de terminaison pour le type 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": "http://learning-services-media.brightcove.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 correspondante de la référence API :

    Ajouter une affiche/miniature

    Vous pouvez ajouter une affiche distante et une miniature à votre vidéo en effectuant des requêtes POST aux terminaux suivants :

          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": "http://learning-services-media.brightcove.com/images/great-blue-heron-poster.png"
          }
          
          

    Pour plus de détails sur les opérations, reportez-vous à la référence de l'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 formats associés 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 de ressource distante par une vidéo ingérée en faisant une requête à l'API Dynamic Inquest :

          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": "http://host/master.mp4"
            }
          }
          
          

    Reportez-vous à la référence de l'API Dynamic Ingest pour obtenir des options et des informations supplémentaires.

    L'une des utilisations courantes des vidéos de ressources distantes est de créer une vidéo d'espace réservé pour une utilisation dans un événement de streaming en direct. Une fois l'événement terminé, vous pouvez remplacer la vidéo « live » par un enregistrement vidéo à la demande de l'événement qui apparaît dans le même lecteur que vous avez utilisé pour la diffusion en direct. Vous pouvez le faire en utilisant la méthode décrite ci-dessus, mais elle peut également être utilisée pour transformer n'importe quelle vidéo d'actifs distants en une vidéo qui est ingérée dans Video Cloud.

    Modifier les ressources

    Outre l'ajout de ressources distantes pour une vidéo, il existe également des opérations de récupération, de mise à jour et de suppression des informations sur les ressources. Ces opérations utilisent les points de terminaison décrits ci-dessus, mais avec les requêtes GET, PATCH ou DELETE. Pour les demandes de mise à jour et de suppression, vous devez ajouter l'ID d'asset (qui est inclus dans la réponse aux requêtes POST et GET) à l'URL de requête :

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
          
          

    Reportez-vous à la référence de l'API pour plus de détails sur les opérations de get, de mise à jour et de suppression.

    Contraintes

  • SSAI n'est pas pris en charge pour les ressources distantes.
  • DRM n'est pris en charge que si vous pouvez personnaliser le lecteur pour communiquer avec le serveur de licences DRM. Ceci est possible avec le Brightcove Player via un plugin. Pour les autres joueurs, vous devrez consulter la documentation du joueur.
  • Analytics : le système Brightcove Analytics dépend des métadonnées vidéo générées par le système, telles que la durée de la vidéo. Les données d'analyse des ressources distantes seront moins riches, à moins que vous ne puissiez fournir ces métadonnées pour la ressource distante.
  • Garantie de lecture : toutes les vidéos ingérées dans Video Cloud peuvent être lues dans le Brightcove Player. Cela est vrai pour presque tous les actifs distants, mais il existe des cas de périphérie où les vidéos peuvent ne pas être lues. Il y a quelques fonctionnalités avancées de DASH et HLS que nous ne prenons pas encore en charge par exemple. Pour les lecteurs non BrightCove, vous devrez vérifier que le format vidéo est entièrement pris en charge par ce lecteur.