Les options du modèle emb

Toutes les options sont détaillée en entête des squelettes des modèles audio et video qui eux mêmes sont appelés par le modèle standard emb de SPIP en fonction du type mime du fichier à afficher.

Définition de la taille et de l’emplacement du lecteur

largeur : définir la largeur du lecteur

• La largeur du lecteur est indiquée par le paramètre largeur.
• Elle peut être stipulée soit en px (si c’est juste un nombre), soit en pourcentage (si % est indiqué).
• si aucune valeur de hauteur n’est indiqué et que la largeur est en de 100%, le même comportement que moviesize=adapt (cf : moviesize) est appliqué.

hauteur : définir la hauteur du lecteur

• La hauteur quant à elle ne peut être exprimée qu’en pixels et doit être un nombre, par exemple hauteur=300.

align : définir l’alignement du lecteur

• Comme les modèles par défaut de SPIP, il est possible de définit l’alignement des modèles à gauche, au centre, à droite.
• Dans un appel depuis un contenu éditorial, on utilisera |left, |right ou |center.
• Dans un appel depuis un squelette, on utilisera align=left, align=right ou align=center.

moviesize : adaptation ou non à 100% de l’élément parent

• Le paramètre moviesize avec la valeur adapt permet de modifier automatiquement la taille du lecteur lors du chargement à 100% de l’élément parent tout en essayant de conserver le ratio de la vidéo (soit passé par le paramètre ratio au javascript, soit récupéré depuis les métadonnées de la vidéo).

Les paramètres de lectures audio et vidéo

À noter : certains de ces paramètres ne fonctionnent pas tous avec tous les navigateurs pour différentes raisons.

autoplay : lire automatiquement au chargement de la page

• Pour lire la video ou le son dès l’ouverture de la page, il suffit d’utiliser le paramètre autoplay avec une valeur différente que non ou false. Par défaut, si le paramètre n’est pas utilisé, la lecture ne se lance pas au démarrage.

Exemple dans le contenu d’un texte :

Exemple dans un squelette :

autobuffer : précharger automatiquement le média audio ou vidéo au chargement

Pour précharger automatiquement le fichier audio ou vidéo à lire au moment de l’initialisation du lecteur dans la prévision d’une lecture future, il suffit d’utiliser le paramètre autobuffer ou preload (l’usage de ces deux paramètres sont identiques et sont là pour préserver la compatibilité ascendante).

Ce paramètre peut avoir trois valeurs différentes :

• auto chargera l’ensemble de la vidéo ou du son ;
• metadata arrêtera le chargement lorsque les metadatas seront reçues ;
• non (valeur par défaut) ne chargera rien du tout ;

Exemple dans le contenu d’un texte s’arrêtant au chargement des metadatas :

Exemple dans un squelette avec préchargement complet :

Note : sur les plateformes mobiles (iOS et Android), ce paramètre n’a aucune incidence car pour des raison de limitation d’utilisation de bande passante, ces plateformes ne préchargent rien lors de l’affichage de la page.

loop : boucler automatiquement

Il est possible de mettre le document en boucle automatiquement au chargement de la page avec l’option loop=oui.

Exemple dans le contenu d’un texte :

Exemple dans un squelette :

Les paramètres de gestion du son

volume : définir le volume par défaut au chargement du lecteur

Ce paramètre définit le volume par défaut du lecteur lors de son initialisation. Il nécessite un nombre comme valeur comme volume=50 pour 50%.

volume_bloque : rendre impossible le changement de volume

Ce paramètre permet de bloquer le niveau de volume à la même valeur que lors de l’initialisation du lecteur.

Sa valeur doit être oui pour être prise en compte, donc : volume_bloque=oui.

muted : mettre le lecteur en sourdine au démarrage

Ce paramètre permet de mettre le lecteur en sourdine lors de son initialisation.

Sa valeur doit être oui pour être prise en compte, donc : muted=oui.

muted_bloque : rendre impossible de rendre le player audible ou de le mettre en sourdine

Ce paramètre permet de bloquer le fait que le lecteur soit en sourdine (mute) ou non.

Sa valeur doit être oui pour être prise en compte, donc : muted_bloque=oui.

Les paramètres d’affichage des contrôles

controls : ne pas afficher de contrôles

Si vous souhaitez ne pas afficher les contrôles du player (barre de boutons...), il suffit de passer le paramètre controls=non au modèle.

boutons_caches : ne pas afficher certains boutons

Ce paramètre permet de ne pas afficher certains boutons spécifiques des contrôles du lecteur.

Il suffit de spécifier les noms des boutons à ne pas créer en les séparant par des virgules. Les noms des boutons possibles sont :

• fullscreen ;
• volume ;
• loop ;

volume_slider_orientation : définir l’orientation du slider de volume

infos : ne pas afficher le titre du document

Si ce paramètre est non, le titre du document ne sera pas affiché.