Skip to content

Premiers pas

Intégration minimale du player audio avec les contrôles par défaut.

audio

Aperçu

Props & interactive options

Prop Type Défaut Description Essayer
auto_play url param off Démarrer la lecture automatiquement.
muted url param off Démarrer muet.
loop url param off Lecture en boucle.
Les navigateurs bloquent la lecture automatique avec le son. Activer auto_play active automatiquement muted pour permettre le démarrage ; le visiteur peut ensuite réactiver le son manuellement.

Documentation

La configuration la plus simple du player audio : play/pause, affichage du temps, contrôle du volume et barre de progression. Configurez l'autoplay, le démarrage muet et la stratégie de préchargement.

Code

HTML

Questions fréquentes

Le player audio envoie un message videas:embed:resize à la fenêtre parente chaque fois que son contenu s'agrandit ou se réduit (déploiement de playlist, sous-titres, panneau de chapitres…). Le snippet ci-dessus inclut le petit écouteur qui redimensionne l'iframe — placez-le une fois sur votre page et l'embed reste au pixel près.

Mêmes règles que pour la vidéo : muted=1 combiné à auto_play=1 est la seule combinaison garantie de démarrer sans interaction utilisateur sur iOS Safari et Chrome Android. L'autoplay avec son nécessite un tap préalable quelque part sur la page.

Non. L'audio est diffusé progressivement : le navigateur ne récupère que la portion nécessaire pour maintenir la mise en mémoire tampon de la lecture, et poursuit au fur et à mesure de l'écoute. Les fichiers volumineux ne bloquent pas le chargement de la page.