AMÉLIORATIONS POUR LE LECTEUR BRIGHTCOVE V6.22

Photo de JESS R
JESS R
blog-placeholder image

La semaine dernière, nous avons prépublié le lecteur Brightcove 6.22. Cette version apporte quelques modifications utiles à l'API qui pourraient intéresser les clients et les intégrateurs.

CONFIGURATIONS ÉTENDUES DE L'AUTOPLAY

Dans le cadre de Video.js 7.1.0, nous avons fait de la autoplay plus puissante.

Actuellement, cette configuration peut être soit true ou falsece qui revient à définir l'option autoplay (ou non) sur l'attribut <video> élément. Lorsqu'il est truele lecteur tentera d'effectuer une lecture automatique et, si le navigateur l'empêche, affichera le bouton "Big Play".

Cependant, dans certains cas, les clients peuvent souhaiter augmenter les chances de succès de l'autoplay. L'extension de l'option autoplay peut désormais accepter plusieurs nouvelles valeurs de chaîne (en plus des valeurs booléennes existantes).

ANY

Ajout de la configuration, {"autoplay": "any"}Le joueur appelle alors l'option play() sur le loadstart événement. Si la lecture échoue, le lecteur se met en sourdine et appelle l'événement play() à nouveau. Si la lecture échoue toujours, l'état précédent de muted sera rétabli.

Cette valeur offre la solution la plus complète - lorsque la lecture automatique sans sourdine est préférée, mais que la lecture automatique avec sourdine est acceptable.

MUTED

Ajout de la configuration, {"autoplay": "muted"}Le lecteur se met en sourdine et appelle ensuite la fonction play() sur le loadstart événement. Si la lecture échoue, l'état précédent de muted sera rétabli.

Cette valeur est celle qui a le plus de chances de réussir dès la première tentative - lorsque l'autoplay en sourdine est préféré.

JOUER

Enfin, ajouter la configuration, {"autoplay": "play"}Le joueur appelle alors l'option play() sur le loadstart événement.

Les chances de réussite sont les mêmes que celles de la mise en place d'un système d'alerte. autoplay: true.

AMÉLIORATION DU PLUGIN CATALOGUE

NOTE: Pour l'instant, ces fonctionnalités ne seront disponibles que via les méthodes du plugin de catalogue - et non via la configuration ou le système d'information. data- attributs.

NORMALISATION DE L'API

La plus grande modification que nous ayons apportée au plugin catalogue fait partie d'un effort de standardisation de l'API de la bibliothèque qui s'est développée au fil des ans et qui présente des incohérences mineures entre ses méthodes.

L'essentiel de cet effort a consisté à ajouter un système commun de gestion de l'information. get() qui fonctionne pour tous les types de demandes et prend un seul argument : une demande conventionnelle de objet des paramètres du catalogue (décrit ci-dessous). Les get() renverra un Promise objet.

Par exemple, la recherche d'une vidéo à l'aide de l'attribut commun get() pourrait ressembler à ceci :

// Request a video from the Playback API.
player.catalog.get({
  type: 'video',
  id: '123456789',
  adConfigId: 'abc123'
})

  // The request succeeded, load the video data into the player.
  .then(function(data) {
    player.catalog.load(data);
  })

  // The request failed.
  .catch(function(err) {
    videojs.log.error(err);
  });

En outre, cet effort comprend des modifications rétrocompatibles des méthodes préexistantes - getVideogetPlaylistgetSearchgetSequenceet getLazySequence. Ces changements sont les suivants :

  • getVideogetPlaylistet getSearch peuvent désormais prendre un objet de paramètres de catalogue comme premier argument, à la place de leurs implémentations actuelles.
  • Le troisième argument de toutes les méthodes, adConfigIdest désormais obsolète. Utilisez un objet de paramètres de catalogue avec un adConfigId à la place.
  • Chaque méthode attend toujours un deuxième callback et renvoie un XMLHttpRequest objet. Si un Promise est préférée, utiliser la méthode commune get() méthode.

Il est important de noter que ces changements sont tous compatibles avec le passé. Aucun code existant ne doit être modifié !

Par exemple, la demande de vidéo ci-dessus pourrait encore être faite dans l'ancien style :

// Request a video from the Playback API.
player.catalog.getVideo('123456789', function(err, data) {

  // The request failed.
  if (err) {
    return;
  }

  // The request succeeded, load the video data into the player.
  player.catalog.load(data);
}, 'abc123');

PARAMÈTRES DU CATALOGUE OBJETS

Il s'agit d'une convention que nous espérons utiliser comme base pour décrire les requêtes adressées à l'API de lecture à partir du lecteur Brightcove.

Il est pris en charge en tant que premier argument de tous les get* des méthodes.

Toutes les valeurs doivent être des chaînes de caractères.

Nom Description
type Le type de demande à effectuer. Doit être l'un des suivants 'video''playlist'ou 'search'.
accountId L'identifiant du compte à partir duquel les données doivent être obtenues. Par défaut, il s'agit de l'identifiant du compte du joueur.
policyKey La clé de stratégie de ce compte. Par défaut, il s'agit de la clé de stratégie du lecteur.
id Un identifiant de vidéo ou de sélection ou un identifiant de référence préfixé par 'ref:'Exigée pour les demandes de vidéos et de listes de lecture !
q Une requête de recherche. Exigée pour les demandes de recherche (sauf dans les cas où id est utilisé dans sa forme dépréciée), ignorés pour les autres.
adConfigId A Video Could SSAI ad configuration ID.
tveToken Un jeton TVE facultatif à envoyer en tant que paramètre de la chaîne de requête.
limit Pris en charge uniquement pour les types de listes de lecture et de recherche. Limiter le nombre de vidéos renvoyées.
offset Pris en charge uniquement pour les types de listes de lecture et de recherche. Nombre de vidéos à sauter.
sort Pris en charge uniquement pour le type de recherche. Comment les vidéos doivent être triées pour les recherches.

NOTE: Pour des raisons de compatibilité ascendante, il existe deux utilisations supplémentaires et obsolètes de l'attribut id paramètre. Pour les recherche les types de id est pris en charge en tant que requête de recherche au lieu de q. Pour recherche les types et les séquences, les id peut contenir un sous-objet, qui est également un objet de paramètres de catalogue.

LIMITE ET DÉCALAGE DE LA LISTE DE LECTURE

En conséquence de cette normalisation, nous avons ajouté la prise en charge des éléments suivants limit et offset pour les listes de lecture. Cela permet aux clients de mettre en œuvre des listes de lecture plus longues ainsi que la pagination dans leurs listes de lecture. Ces fonctions peuvent être mises en œuvre dans la section getPlaylist() comme suit :

// Request a playlist from the Playback API.
player.catalog.getPlaylist({
  id: '123456789',
  limit: '25',
  offset: '0'
}, function(err, data) {

  // If there is an error object, the request failed.
  if (err) {
    return;
  }

  // The request succeeded, load the playlist data into the player.
  player.catalog.load(data);
});

CONCLUSION

Nous sommes très enthousiastes à propos de ces nouvelles fonctionnalités du lecteur Brightcove 6.22. Cette version est actuellement en préversion, mais nous la livrerons très bientôt à tous les lecteurs à mise à jour automatique.

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.