Contrôlez par programmation des intégrations Omny.fm sur votre site web
Le lecteur iframe intégrable d’Omny Studio peut être contrôlé par programmation sur votre propre site Web à l’aide de la bibliothèque Javascript player.js.
Player.js vous permet de communiquer avec l’iframe à l’aide d’un ensemble de méthodes et d’événements standardisés sur un large éventail de lecteurs multimédias riches compatibles.
Lisez la documentation player.js pour savoir comment mettre en œuvre player.js sur votre site Web.
Affichez le code de démonstration et l’exemple pour le voir fonctionner en direct.
Événements pris en charge
Le lecteur intégré d’Omny Studio délivre les événements player.js suivants :
lecture - lorsque le lecteur est activé
pause - lorsque le lecteur est en pause
fin - lorsque le lecteur a fini de lire le clip
timeupdate - pendant que le lecteur joue, l’heure actuelle se met à jour en secondes et la durée en secondes
Méthodes prises en charge
Le lecteur intégré Omny Studio prend en charge les méthodes player.js suivantes
play() - active le lecteur
pause() - met le lecteur en pause
getPaused() - recommence si le lecteur est en pause
setCurrentTime() - recherche le temps en secondes
getCurrentTime() - renvoie la position actuelle en secondes
getDuration() - renvoie la durée en secondes
mute() - coupe le son du lecteur
unmute() - réactive le son du lecteur
getMuted() - recommence si le son du lecteur est coupé
getVolume() - renvoie le volume du lecteur en %
setVolume() - définit le volume du lecteur en %
Politique de lecture automatique iFrame
En raison des récentes modifications apportées aux règles de lecture automatique de Google Chrome, la lecture par programmation de l’intégration à l’aide de player.js peut être restreinte par défaut.
Vous pouvez contourner ce problème en ajoutant allow="autoplay" à l’élément iFrame qui délèguera l’autorisation de lecture à l’iFrame inter-domaines (en supposant que votre site dispose d’autorisations de lecture automatique).
Par exemple, votre code iframe ressemblera à :
<iframe src="https://omny.fm/..." allow="autoplay"></iframe>Politique de parrainage
Si votre site Web inclut une « politique de parrainage », en particulier une valeur de Referrer-Policy: same-origin, alors player.js pourrait ne pas fonctionner immédiatement.
Par défaut, pour des raisons de sécurité, la bibliothèque player.js est conçue pour n’envoyer des événements qu’à la fenêtre/document parent en spécifiant le paramètre Window.postMessage() targetOrigin . Le paramètre targetOrigin est supposé être le document.referrer.
Si la politique de parrainage same-origin est spécifiée, le lecteur intégré Omny.fm et player.js ne peuvent pas déterminer automatiquement l’origine à laquelle les messages doivent être envoyés.
Vous pouvez résoudre ce problème en spécifiant un paramètre URL referrer avec le domaine de votre site Web (y compris le protocole) sur l’URL iframe du lecteur omny.fm intégré.
Par exemple
<iframe src="https://omny.fm/shows/breakfast-with-john/baltic-bumpers/embed?style=cover&referrer=https://example.com" allow="autoplay; clipboard-write" frameborder="0" width="100%" height="180"></iframe>