ApsaraVideo VOD:Fonctionnalités de base

Les fonctionnalités de base du SDK ApsaraVideo Player pour le Web sont activées à l'aide d'attributs ou de méthodes.

L'exemple de code suivant illustre l'appel de méthodes :

var player = new Aliplayer({},function(player) {
    player.setSpeed(2);
 });

Appelez la méthode seek pour lire une vidéo à partir d'un point temporel spécifique. Exemple de code :

// time specifies the specified point in time. Unit: seconds. 
player.seek(time)

Appelez la méthode pause pour mettre la lecture en pause. Exemple de code :

player.pause()

Appelez l'opération setRotate pour faire pivoter une image selon l'angle spécifié. Vous pouvez également interroger l'angle de rotation. Exemple de code :

// Specify the rotation angle. A positive value of Angle specifies a clockwise rotation. A negative value of Angle specifies an anticlockwise rotation. For example, player.setRotate(180) specifies a clockwise rotation of 180 degrees. 
player.setRotate(<Angle>)
// Obtain the rotation angle. 
player.getRotate()

Appelez setImage pour configurer le mode de mise en miroir. Modes pris en charge : mise en miroir horizontale et verticale. Exemple de code :

// Horizontal mirroring.
player.setImage('horizon')
// Vertical mirroring.
player.setImage('vertical')

Le SDK ApsaraVideo Player pour le Web fournit les attributs videoHeight et videoWidth qui vous permettent de spécifier la hauteur et la largeur d'une vidéo. Dans la plupart des cas, la hauteur et la largeur d'une vidéo sont inférieures à celles du conteneur. Cela évite que la vidéo ne déborde du conteneur parent lors de la rotation et de la mise en miroir. Exemple de code :

 width: '100', // The width of the container.
 height: '100%', // The height of the container.
 videoHeight:"200px", // The height of the video.

Appelez getCurrentTime pour obtenir la progression actuelle de la lecture. Exemple de code :

// The returned time is measured in seconds. 
player.getCurrentTime()

Vous pouvez interroger la durée totale d'une vidéo. Vous ne pouvez interroger la durée de la vidéo qu'après son chargement. Par exemple, vous pouvez interroger la durée de la vidéo après le déclenchement de l'événement de lecture. Appelez getDuration pour obtenir la durée totale de la vidéo. Vous ne pouvez obtenir la durée qu'après le chargement de la vidéo ou après le déclenchement de l'événement de lecture. Exemple de code :

player.getDuration()

Appelez getStatus pour obtenir l'état de lecture. Valeurs de retour :

• init : Initialisation.

• ready : Prêt.

• loading : Chargement.

• play : Lecture en cours.

• pause : En pause.

• playing : Lecture en cours.

• waiting : Mise en mémoire tampon.

• error : Erreur.

• ended : Terminé.

Exemple de code :

player.getStatus()

Vous pouvez ajuster le volume ou couper le son de la vidéo.

Appelez l'opération setVolume pour ajuster le volume. Vous pouvez également obtenir le volume actuel. Exemple de code :

// Set the volume to a real number from 0 to 1. 
player.setVolume(0)
// Obtain the current volume. 
player.getVolume()

Appelez la méthode mute pour couper le son de la vidéo pendant la lecture. Exemple de code :

// Mute the video.
player.mute();
// Unmute the video.
player.unMute();

Si vous utilisez l'interface utilisateur (UI) par défaut du SDK ApsaraVideo Player pour le Web, vous pouvez utiliser la fonctionnalité de vitesse de lecture intégrée pour ajuster la vitesse de lecture lorsque vous regardez la vidéo. Si vous utilisez une interface utilisateur personnalisée, appelez l'opération setSpeed pour ajuster la vitesse de lecture.

Exemple de code :

// Specify the playback speed. The following sample code provides an example on how to set the playback speed to twice the current speed. 
player.setSpeed(2)

Vous pouvez configurer les URL des flux avec plusieurs définitions pour la lecture multi-définition.

• Si vous utilisez VID et PlayAuth pour la lecture, aucun paramètre supplémentaire n'est requis. Le SDK ApsaraVideo Player pour le Web obtient la liste des définitions depuis ApsaraVideo VOD. Cliquez sur Settings sur la page de lecture pour afficher la liste des définitions.

  Remarque

  Si vous utilisez VID et PlayAuth pour la lecture, vous pouvez spécifier l'attribut format pour déterminer si les fichiers multimédias doivent être lus au format MP4 ou MP3 pour le lecteur HTML5. Par défaut, les fichiers multimédias au format MP4 sont lus.

• Si vous utilisez la lecture basée sur l'URL, vous devez configurer les paires clé-valeur dans l'attribut source pour spécifier les URL des flux avec plusieurs définitions. Les paires clé-valeur sont au format JSON. Une fois les paramètres appliqués, cliquez sur Settings sur la page de lecture pour afficher la liste des définitions.

En mode de lecture basé sur l'URL, les paires clé-valeur suivantes dans l'attribut source sont prises en charge :

   "OD": "<Original quality URL>"
   "FD": "<Low definition URL>"
   "LD":"<Standard definition URL>"
   "SD": "<High definition URL>"
   "HD": "<Ultra-high definition URL>"
   "2K": "<2K URL>"
   "4K": "<4K URL>"

L'exemple de code suivant illustre la configuration des définitions en mode de lecture basé sur l'URL :

// The following example shows how to configure the high definition and ultra-high definition URLs. 
source:'{"HD":"http://******/player/hdexample.mp4","SD":"http://******/player/sdexample.mp4"}'

Le SDK ApsaraVideo Player pour le Web vous permet également de spécifier l'attribut qualitySort pour lister les définitions par ordre croissant ou décroissant.

• La valeur desc spécifie l'ordre décroissant, de la définition la plus élevée à la plus basse.

• La valeur asc spécifie l'ordre croissant, de la définition la plus basse à la plus élevée.

rePlay:true

player.on('ended',function(){
   player.replay()
})