CRÉATION DE RÈGLES DE DIFFUSION DANS LE NUAGE VIDÉO BRIGHTCOVE

Photo de JESS R
JESS R

En 2017, Brightcove a lancé la diffusion dynamique et a commencé à générer nos manifestes et nos vidéos " juste à temps ", au moment où un lecteur les demande, ce qui nous permet de reconditionner le contenu dans plusieurs formats différents et de prendre en charge le plus grand nombre de périphériques possible.

Depuis, nos clients nous ont de plus en plus fait part de leur souhait de profiter eux-mêmes de cette flexibilité et de contrôler finement le CDN sur lequel leur contenu est diffusé, la qualité des rendus vidéo disponibles et même l'ordre dans lequel les différents rendus de qualité doivent être présentés dans le manifeste vidéo. C'est ce qui a conduit à la création de notre fonction "règles de diffusion", qui est désormais disponible dans le cadre de notre API.

Dans ce billet, nous allons voir comment utiliser cette API pour résoudre l'un des cas d'utilisation les plus courants que nous voyons - limiter la qualité maximale de la vidéo diffusée sur certains appareils.

SE METTRE EN PLACE

Pour commencer, nous avons besoin d'une vidéo à tester, que nous avons ingérée comme d'habitude via Video Cloud.

Si l'on examine le manifeste HLS transmis à ce lecteur, on constate qu'il contient un certain nombre de lignes représentant des manifestes de rendu de différentes résolutions - dans ce cas, 480×270, 640×360, 960×540 et 1280×720 (ci-dessous) :

#EXT-X-STREAM-INF:PROGRAM-ID=0,BANDWIDTH=2205500,CODECS="mp4a.40.2,avc1.4d001f",RESOLUTION=1280x720,AUDIO="audio-2",CLOSED-CAPTIONS=NONE
https://manifest.prod.boltdns.net/manifest/v1/hls/v4/aes128/5270290572001/aa7059e5-586b-4caa-ae6f-5533f223a569/a557b391-f20e-4727-9185-459411a63029/10s/rendition.m3u8

Si 960×540 est la résolution maximale que nous voulons fournir à notre appareil hypothétique, nous devrions voir disparaître le rendu 1280×720 une fois que notre règle a été appliquée.

CRÉER NOTRE RÈGLE

Les règles de livraison sont composées de conditions (quand une règle doit être invoquée) et d'actions (comment la règle doit affecter le contenu).

Puisque nous savons que nous voulons que la règle limite la qualité maximale du rendu vidéo, créons d'abord l'action à l'aide de la requête HTTP suivante :

POST /accounts/{accountID}/actions
  Content-Type: application/json
  Authorization: Bearer {access_token}

et le corps de la requête est fixé à :

{
  "properties": {
    "max_video_resolution": "960x540"
  }
}

Cela créera la nouvelle action et nous renverra quelque chose qui ressemble à :

{
  "id": "88b13752-3469-4e46-b4aa-49cd4f1685a6",
  "properties": {
    "max_video_resolution": "960x540"
  }
}

L'INVOCATION MANUELLE D'ACTIONS

Avant d'appliquer notre action de manière conditionnelle, nous pouvons l'invoquer manuellement et vérifier qu'elle fait ce que nous voulons en ajoutant son ID en tant que paramètre à notre requête API de lecture :

https://edge.api.brightcove.com/playback/v1/accounts/5270290572001/videos/6230434222001?config_id=88b13752-3469-4e46-b4aa-49cd4f1685a6

Cela nous renverra le même manifeste HLS que précédemment, mais avec le rendu 1280×720 supprimé !

En plus d'être utile pour les tests, l'invocation manuelle de règles de cette manière est une technique puissante pour les clients qui utilisent les SDK de Brightcove pour créer leurs propres applications, leur permettant d'invoquer des règles différentes par appareil, par application ou même par utilisateur, simplement en transmettant des ID d'action différents.

Nos clients appliquent souvent une action pour diffuser un type de contenu de base à des utilisateurs anonymes, tandis que toute personne qui s'inscrit se voit appliquer une action manuelle pour lui diffuser un contenu plus riche (vidéo et audio de meilleure qualité, codecs modernes tels que HEVC, fournisseur de CDN premium).

L'INVOCATION CONDITIONNELLE D'ACTIONS

Pour les clients qui ne veulent pas ou n'ont pas besoin de la granularité de l'invocation manuelle d'actions, nous fournissons un ensemble de conditions prédéfinies pour contrôler les circonstances dans lesquelles les services de génération de manifestes de Brightcove doivent appliquer des règles. Celles-ci s'appliqueront à toutes les demandes et constituent donc un excellent moyen de cibler certains groupes d'utilisateurs, quel que soit le type d'appareil sur lequel ils visionnent vos vidéos.

L'ensemble des conditions proposées peut être consulté dans la référence de l'API ici.

Pour ce tutoriel, imaginons que nous sachions que les utilisateurs du Royaume-Uni ont des difficultés à mettre en mémoire tampon les résolutions élevées en raison de problèmes de capacité du réseau national et que nous souhaitions donc supprimer le rendu de la résolution élevée jusqu'à ce que ces problèmes soient résolus.

PUT /accounts/{accountID}/conditions
  Content-Type: application/json
  Authorization: Bearer {access_token}

Cet appel à l'API prend un tableau de conditions, mais pour l'instant, nous allons simplement en créer un, en incluant le corps suivant dans notre demande :

[
  {
    "name": "Cut off high-quality renditions for the UK",
    "if": {
      "request_country": [
        "GB"
      ]
    },
    "then": [
      "88b13752-3469-4e46-b4aa-49cd4f1685a6"
    ]
  }
]

Maintenant, si nous effectuons notre requête API de lecture standard depuis le Royaume-Uni (remarquez qu'il n'y a pas de paramètre config_id cette fois-ci), nous verrons que le rendu de haute qualité est supprimé !

QUELLE EST LA PROCHAINE ÉTAPE ?

Nous espérons vous avoir donné un aperçu de la puissance et de la flexibilité des règles de livraison. La liste complète des conditions et actions prises en charge est disponible ici. Si vous souhaitez que nous en ajoutions d'autres à l'avenir, n'hésitez pas à contacter le service d'assistance à la clientèle ou votre représentant et à nous en faire part !

Si vous souhaitez en savoir plus sur la façon dont nos clients utilisent les règles de diffusion, jetez un coup d'œil sur la façon dont Seven West Media optimise la diffusion de son contenu vidéo grâce aux règles de diffusion de Brightcove.

Partager

Brightcove a aidé un fabricant d'équipements de diagnostic à réduire le temps et les dépenses consacrés à la salle de classe tout en améliorant la réussite ...
Brightcove a aidé la place de marché automobile la plus reconnue à gérer son énorme vidéothèque et à la rentabiliser...
Pour préserver l'intégrité de leur marque, les enseignes de distribution ont besoin de lecteurs vidéo personnalisables qui leur permettent d'ajuster les couleurs, la police...

PRÊT À COMMENCER ?

Contactez-nous pour savoir comment nous pouvons améliorer vos efforts de marketing vidéo et vous aider à générer les résultats et le retour sur investissement dont vous avez besoin.