StreamApi
oEmbed ?
oEmbed est un protocole permettant d’intégrer facilement du contenu dynamique (vidéos, images, tweets…) provenant de différents sites web dans tout autre site ou application, en fournissant simplement une URL.
Streamlike supporte oEmbed depuis la version 5.53
Pour en savoir plus sur le protocole oEmbed: https://oembed.com
oEmbed dans Drupal
Drupal Core propose, depuis la version 8.8, un module « média » permettant aux utilisateurs dotés des permissions adéquates d’uploader, gérer et réutiliser des médias de tous types.
Parmi les types de media proposés figure le type « Vidéo distante » (« Remote Video »), qui permet de déclarer l’URL d’une vidéo d’un service de streaming, et d’en générer l’affichage automatiquement.
Cette fonctionnalité s’appuie sur oEmbed. Par défaut, le champ « URL » de ce type de média accepte les URLs YouTube et Vimeo mais on peut y ajouter Streamlike en tant que « oEmbed provider », au moyen d’un simple module communautaire.
Déclaration de Streamlike comme provider oEmbed dans Drupal
Etape 1/3 : Installation du module « oEmbed Providers »
Rendez-vous sur la page du module « oEmbed Providers» sur drupal.org : https://www.drupal.org/project/oembed_providers
Cette page (en anglais) fournit également un descriptif complet des fonctionnalités et paramétrages du module.
Installez le module de la manière habituelle (de préférence au moyen de composer) : https://www.drupal.org/docs/extending-drupal/installing-modules
Etape 2/3 : Paramétrage du module « oEmbed Providers »
Rendez-vous sur le formulaire de paramètres du module à : /admin/config/media/oembed-providers
> Onglet « Général »
Laissez les paramètres par défaut.
> Onglet « Custom Providers »
Ajoutez un fournisseur oEmbed (« + Add oEmbed provider » en haut à droite)
Renseignez les champs avec les valeurs suivantes :
- Nom du fournisseur: Streamlike
- URL du fournisseur: https://cdn.streamlike.com
- Extrémités / Endpoint #1
- Endpoint schemes = https://cdn.streamlike.com/play?med_id=*
- Endpoint URL = https://cdn.streamlike.com/oembed
- Discovery = activer
- Available formats = cocher JSON et XML
Enregistrez les paramètres.
> Onglet « Provider Buckets »
Les « providers buckets » sont des groupes de providers utilisés pour l’intégration.
Ajoutez un « provider bucket » (« + Add provider bucket » en haut à droite)
Renseignez les champs avec les valeurs suivantes :
- Bucket name = video (nom système : video)
NB : ce nommage doit être strictement respecté car le type de media « Remote Video » n’utilise que celui-ci. - Description (optionnel) = par exemple, Streamlike
- Allowed Providers = dans la liste de tous les providers proposés, cochez « Streamlike » ainsi que tous les autres providers que vous souhaitez intégrer.
NB : cette liste se substituera aux services par défaut (Youtube et Vimeo). Si vous voulez proposer le support de ces services, il faut les re-sélectionner ici.
Enregistrez les paramètres.
Etape 3/3 : Sélectionner les providers disponibles pour « Vidéo distante »
Editez le type de media « Video distante » (« Remote Video ») : /admin/structure/media/manage/remote_video
Dans la section « Media source configuration », cochez les providers autorisés dans « Allowed Providers ».
Le type de média « Video distante » est à présent prêt pour utiliser Streamlike.
Saisie d’un média de type « Remote Video » Streamlike
Ajoutez un nouveau média de type « Remote Video » : /media/add/remote_video
Sous le champ figure la liste des services a présent supportés, au sein desquels doit figurer « Streamlike » :
Collez l’url d’un média Streamlike et enregistrez le média.
Votre média Streamlike est à présent disponible au sein des médias de Drupal, et disponible à toutes les fonctionnalités associées.
Comment obtenir l’URL du media Streamlike ?
L’url du media Streamlike est de la forme
https://cdn.streamlike.com/play?med_id=<id_du_media>
L’ ID du média peut se copier directement depuis la vue « Médias » de la console Streamlike en survolant la vignette du média et en cliquant sur l’icone en bas à droite :
