StreamApi
oEmbed ?
oEmbed is a protocol that allows you to easily integrate dynamic content (videos, images, tweets…) from different websites into any other website or application, by simply providing a URL.
Streamlike supports oEmbed since version 5.53
To learn more about the oEmbed protocol: https://oembed.com
oEmbed in Drupal
Since version 8.8, Drupal Core offers a media module that allows users with the appropriate permissions to upload, manage and reuse media of all types.
Among the media types offered is the « Remote Video » type, which allows you to declare the URL of a video from a streaming service, and to generate the display automatically.
This functionality is based on oEmbed. By default, the « URL » field of this media type accepts YouTube and Vimeo URLs, but Streamlike can be added as an « oEmbed provider » using a simple community module.
Declaration of Streamlike as oEmbed provider in Drupal
Step 1/3: Installing the « oEmbed Providers » module
Go to the « oEmbed Providers » module page on drupal.org: https://www.drupal.org/project/oembed_providers
This page also provides a complete description of the features and settings of the module.
Install the module in the usual way (preferably using composer):
Step 2/3: Setting up the « oEmbed Providers » module
Go to the module settings form at : /admin/config/media/oembed-providers
> « General » tab
Leave the default settings.
> « Custom Providers » tab
Add an oEmbed provider(« + Add oEmbed provider » at the top right)
Fill in the fields with the following values:
- Provider name: Streamlike
- Provider URL: https://cdn.streamlike.com
- Endpoints / Endpoint #1
- Endpoint schemes = https://cdn.streamlike.com/play?med_id=*
- Endpoint URL = https://cdn.streamlike.com/oembed
- Discovery = enable
- Available formats = check JSON and XML
Save the settings.
> « Provider Buckets » Tab
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 (system name : video)
NB : this naming must be strictly respected because the media type » Remote Video » only uses this one. - Description (optional) = for example, Streamlike
- Allowed Providers = in the list of all the proposed providers, check « Streamlike » as well as all the other providers you wish to integrate.
NB: this list will replace the default services (Youtube and Vimeo). If you want to offer support for these services, you have to re-select them here.
Save the settings.
Step 3/3: Select available providers for « Remote Video »
Edit the « Remote Video » media type: /admin/structure/media/manage/remote_video
In the « Media source configuration » section, check the authorized providers in « Allowed Providers ».
The media type « Remote Video » is now ready to use Streamlike.
Entering a Streamlike « Remote Video » media type
Add a new media of type » Remote Video » : /media/add/remote_video
Below the field is a list of currently supported services, of which « Streamlike » must be included:
Paste the url of a Streamlike media and save the media.
Your Streamlike media is now available in Drupal media, and available to all related features.
How do I get the Streamlike media URL?
The Streamlike media url is of the form
https://cdn.streamlike.com/play?med_id=<id_du_media>
The media ID can be copied directly from the Streamlike console’s « Media » view by hovering over the media thumbnail and clicking on the icon at the bottom right:
