Lecteur vidéo
Piloter la lecture d'une vidéo sur l'appareil : lecture, pause, reprise, arrêt, déplacement et sourdine.
Le lecteur se pilote par un endpoint générique, /player, qui porte l'action à
effectuer. Trois raccourcis existent pour les actions les plus courantes.
Endpoint générique
| Méthode | POST |
| Chemin | /player |
Requête
{
"id": 51,
"action": "play",
"currentTime": 0
}| Champ | Obligatoire | Rôle |
|---|---|---|
id | oui | Identifiant de la vidéo présente sur l'appareil. |
action | oui | L'action à effectuer, parmi la liste ci-dessous. |
currentTime | non | Position en secondes. Requis uniquement pour seek. |
Réponse
{
"videoId": 51,
"title": "Mont-Blanc",
"message": "Lecture de la vidéo",
"currentTime": 0
}Actions disponibles
| Action | Effet |
|---|---|
play | Démarre la lecture depuis le début, ou depuis currentTime s'il est fourni. |
pause | Met la lecture en pause en conservant la position. |
resume | Reprend une lecture mise en pause. |
stop | Arrête la lecture et ferme le lecteur. |
seek | Déplace la lecture à currentTime. |
mute | Coupe le son de la lecture. |
volume | Ajuste le volume du lecteur. |
Lorsque la vidéo porte une date limite d'utilisation atteinte ou dépassée, seules play
et resume sont refusées. pause, seek, stop et mute restent disponibles, afin de
garder la main sur une lecture déjà en cours. Voir
la date limite d'utilisation.
Pour connaître les vidéos disponibles et leurs identifiants, interrogez
/contents.
Arrêter la lecture
Raccourci équivalent à action: "stop" sur l'endpoint générique.
| Méthode | POST |
| Chemin | /player/stop |
Requête
{
"id": 51
}Réponse
{
"videoId": 51,
"title": "Mont-Blanc",
"message": "Arrêt de la vidéo"
}Déplacer la lecture
| Méthode | POST |
| Chemin | /player/seek |
Requête
{
"id": 51,
"currentTime": 16
}Réponse
{
"videoId": 51,
"title": "Mont-Blanc",
"message": "Seek de la vidéo",
"currentTime": 16
}currentTime est exprimé en secondes depuis le début de la vidéo.
Mettre en sourdine
| Méthode | GET |
| Chemin | /player/mute |
Réponse
{
"videoId": 51,
"title": "Mont-Blanc",
"message": "Sourdine de la vidéo",
"currentTime": 16
}La commande s'applique à la lecture en cours : contrairement aux autres endpoints du lecteur, elle ne prend pas d'identifiant de vidéo.
La sourdine ne concerne que le lecteur vidéo. Pour le volume général de l'appareil,
utilisez /volume.
Cette page vous a-t-elle aidé ?
Dernière mise à jour le