StreamApi
Lorsque vous passez le paramètre « &events=1 » au play (dans l’url ou dans une configuration de player), il vous est possible de piloter le player et de récupérer la valeur du timecode de lecture courant.
Le pilotage est alors rendu possible via l’iframe dans laquelle le player est embarqué.
En utilisant le code d’intégration fourni dans le backend, et en ajoutant un id à l’iframe (par ex « slplayer »), vous pouvez envoyer les commandes postMessage suivantes au player du type slplayer.contentWindow.postMessage(‘commande’, ‘*’), avec les commandes disponibles suivantes :
| Commande | Description |
|---|---|
| [« play »] | Lance la lecture du média |
| [« pause »] | Met en pause la lecture du média |
| [« mute »] | Coupe le volume |
| [« unmute »] | Active le volume |
| [« fullscreen »] | Bascule en mode fullscreen / taille du player |
| [« seek »,30.4] | Positionne le timecode à la valeur indiquée, en secondes |
| [« speed »,1.3] | Définit la vitesse de lecture (1 vitesse normale, valeur inférieure -> au ralenti, valeur supérieure -> en accéléré) |
| [« volume »,0.5] | Définit le volume (de 0 à 1.0) |
Par exemple lancer la commande slplayer.contentWindow.postMessage(‘[« speed »,1.9]’, « * ») définira une vitesse de lecture de 1.9x.
Afin de récupérer le timecode de lecture ou l’état du player, il est nécessaire d’ajouter un listener de nom getMediaValues sur votre page hôte.
<script type="text/javascript">
function getMediaValues(evt){
// Your code, as an example : console.log(evt.data);
};
window.addEventListener("message", getMediaValues);
</script>Les valeurs de timecode seront poussées toutes les 250 ms approximativement.
La valeur de timecode récupérée est un json du type suivant : [« sl-progress »,24.363924]
La valeur d’état du player récupérée est un json du type suivant : [« sl-state », »play »]
Les états possibles sont :
- play : le média est en cours de lecture.
- pause: le média est en pause.
- ended : le média est arrivé en fin de lecture.
Exemple d’application, avec le pilotage de deux lecteurs à partir de contrôles communs :
Raccourcis clavier
| Raccourci | Description |
|---|---|
| barre d’espace | lecture / pause |
| k | lecture / pause |
| m | muet / sonore |
| f | plein écran |
| flèche gauche / droite | déplacement +/- 5 secondes |
| flèche haut / bas | volume |
| > | vitesse de lecture |
| c | sous-titres |
| p | mosaïque |
| d | infos |
| n | chapitres |
| [0]-[9] | déplacement vers un dixième de la durée du media. « 3 » = 30% |
