Diffusion de VOD sur une chaîne

Présentation

Pour diffuser en continu un ensemble de VOD en direct sur une chaîne dans Brightcove Beacon, vous devez suivre une série d'étapes pour créer le flux vidéo et l'envoyer à votre partenaire de diffusion Cloud tiers.

Une vue de haut niveau du processus est :

1. Marquez les vidéos que vous souhaitez utiliser dans votre flux.
2. Créez le flux vidéo XML de vos vidéos souhaitées avec l'API Social Syndication.
3. Envoyez l'URL de votre flux vidéo XML à votre partenaire Cloud Streaming tiers.
4. Créez une vidéo à distance dans le module Media avec l'URL fournie par votre partenaire Cloud Streaming.
5. Connectez la vidéo à distance avec Brightcove Beacon via l'ID vidéo.
6. Téléchargez le fichier XML fourni par votre fournisseur Cloud Streaming dans votre compartiment Amazon S3 pour générer le Guide de programmation électronique (EPG)

Le reste du présent document fournira des détails pour chacune des étapes ci-dessus.

Création du flux vidéo XML avec l'API Social Syndication

Pour diffuser votre ensemble marqué de VOD sous forme de flux en direct, vous devez créer un fichier XML de flux vidéo. Ce fichier contiendra toutes les informations des vidéos que vous souhaitez diffuser. Ce fichier est obligatoire pour tout partenaire tiers Cloud Streaming tel que Frequency, Veset ou Amagi. Voici des détails sur ce processus :

• Vous aurez besoin d'un outil de développement API comme Facteur ou Insomnie. Dans cet exemple Facteur sera utilisé.
• Pour créer le fichier XML de flux vidéo, vous devez utiliser l'API Brightcove Social Syndication. Pour plus d'informations sur l'utilisation de l'API pour obtenir l'URL XML, veuillez consulter la documentation de l'API Social Syndication.
• L'authentification pour la plupart des API de plate-forme se fait via un jeton d'accès OAuth2 temporaire. Quelques API utilisent une clé d'API permanente ou une clé de stratégie à la place. Pour plus de détails, reportez-vous à la documentation sur les API individuelles.

1. Ouvrez votre outil client API, dans cet exemple Postman est utilisé.
2. Sélectionnez POST dans le menu déroulant du type d'appel d'API.

   

3. Copiez l'appel de l'API Social Syndication :

   https://social.api.brightcove.com/v1/accounts/your-account-id/mrss/syndications

4. Collez l'appel de l'API Social Syndication dans le champ URL et modifiez les données d'URL avec vos propres informations d'ID de compte.
5. Sélectionnez l'onglet Corps dans votre client API.

   

6. Copiez le modèle de ressource de syndication sociale suivant :

   
   {
     "name": "Your Channel Syndication Videos",
     "type": "universal",
     "include_all_content": false,
     "include_filter": "tags:yourtag",
     "title": "80s Music Videos",
     "description": "Amateur Tokyo drift!",
     "destination_url": "http://mywebsite.com",
     "keywords": "80s, rock",
     "author": "Rick Astley",
     "category": "Music",
     "album_art_url": "http://my_album_art.jpg",
     "explicit": "no",
     "owner_name": "http://my_album_art.jpg",
     "owner_email": "rick@astley.com",
     "language": "en-us",
     "fetch_sources": true,
     "fetch_digital_master": false,
     "fetch_dynamic_renditions": true,
     "sort": "-created_at"
    } 

7. Collez le modèle Resource de syndication sociale dans le champ de texte Corps .
8. Modifiez les données du modèle de ressource Social Syndication Resource avec vos propres informations.
9. N'oubliez pas d'ajouter la balise que vous avez créée précédemment dans Video Cloud, dans les tags « include_filter » : « : Champ YourTag » .
10. Cliquez sur le bouton Envoyer dans votre client API pour effectuer l'appel POST .

    

11. Notez que la réponse de l'API Social Syndication ajoute quelques champs en lecture seule :

    
     {
        "id": "7f594cd3-4853-4174-aff3-203c3e99e9c2",
        "name": "Your Channel Syndication Videos",
        "type": "universal",
        "include_all_content": false,
        "include_filter": "tags:yourtag",
        "title": "80s Music Videos",
        "description": "Amateur Tokyo drift!",
        "syndication_url": "https://social.feeds.brightcove.com/v1/accounts/9999999999999/mrss/accounts/{account_id}/mrss/syndications/7f594cd3-4853-4174-aff3-203c3e99e9c2/feed",
        "destination_url": "http://mywebsite.com",
        "keywords": "80s, rock",
        "author": "Rick Astley",
        "category": "Music",
        "album_art_url": "http://my_album_art.jpg",
        "explicit": "no",
        "owner_name": "http://my_album_art.jpg",
        "owner_email": "rick@astley.com",
        "language": "en-us",
        "fetch_sources": true,
        "fetch_digital_master": false,
        "fetch_dynamic_renditions": true,
        "sort": "-created_at"
     }

12. Après la création du flux vidéo, notez que la réponse de l'API inclut l' id et le syndication_url. Le syndication_url est celui que vous devez fournir à votre partenaire Cloud Streaming, mais il reste quelques étapes à faire avant que le flux vidéo soit prêt.

    

13. Copiez l' ID de réponse de l'API.
14. L'étape suivante consiste à ajouter un modèle pour les données. Dans le menu déroulant, sélectionnez PUT.

    

15. Ajoutez la réponse id du dernier appel d'API dans la pétition URL.
16. Cliquez sur l'onglet Corps .

    

17. Sélectionnez l'option brute .
18. Copiez et collez l'un des modèles XML fournis pour Universal Syndication dans la section Texte.
19. Cliquez sur Envoyer pour effectuer l'appel de l'API PUT .
20. Après avoir effectué l'appel PUT , la réponse API contiendra le modèle avec les informations de vos vidéos et le syndication_url sera mis à jour et prêt à être livré à votre partenaire Cloud Streaming.

Fournir le flux XML à votre partenaire Cloud Streaming

Une fois que vous avez mis à jour le syndication_url avec votre flux vidéo, vous devez le remettre à votre partenaire Cloud Streaming (Frequency, Veset, Amagi), car l'URL contient le fichier XML.

Après l'avoir reçu, votre partenaire Cloud Streaming doit vous fournir une URL de diffusion en continu et un nouveau fichier XML contenant le Guide de programmation électronique pour Brightcove Beacon.

Ajout d'une vidéo à distance dans Studio

Une fois que vous avez reçu l'URL de diffusion de votre chaîne, vous devez envoyer le flux en direct en tant que vidéo à distance dans Video Cloud à Brightcove Beacon.

1. Ouvrez le module Media dans votre compte Video Cloud.

   

2. Dans le panneau de gauche, cliquez sur le bouton+ Ajouter une vidéo à distance .

   

3. Dans le champ Nom de la vidéo , nommez votre vidéo de flux.

   

4. Dans le menu Type de vidéo , sélectionnez l'option Live .
5. Dans le champ Format , sélectionnez l'option HLS .
6. Dans le champ URL , collez l'URL du flux fournie par votre partenaire Cloud Streaming.
7. Cliquez sur le bouton Enregistrer .
8. Une fois la vidéo distante créée, cliquez dessus dans le module Media .
9. Ouvrez la section INFORMATIONS VIDÉO et copiez l' ID.

   

Connexion de la vidéo à distance à Brightcove Beacon

La dernière étape consiste à connecter le flux vidéo distant que vous venez de créer dans Video Cloud à un canal Brightcove Beacon.

1. Ouvrez Brightcove Beacon.
2. Dans le menu supérieur, cliquez sur l'onglet Canaux .

   

3. Cliquez sur la chaîne souhaitée. Pour plus d'informations sur la création d'une chaîne, veuillez consulter la documentation des chaînes.
4. Dans les paramètres du canal, cliquez sur l'onglet Streams .

   

5. Dans le champ Stream Video ID , collez l' ID vidéo de votre Video Cloud Remote Video.
6. Cliquez sur Mettre à jour le canal.

   

7. Ouvrez l'application Web Brightcove Beacon pour tester et vous devriez voir votre flux VOD sur la chaîne souhaitée.
8. La dernière étape consiste à télécharger le fichier XML fourni par votre partenaire Cloud Streaming tiers dans votre compartiment Amazon S3. Cela crée l'EPG pour le canal. Pour plus d'informations sur la façon de télécharger et d'extraire le fichier XML, veuillez consulter la documentation EPG.