音视频终端SDK：基础功能

Web端播放器SDK的基础功能由属性或接口实现。

接口的调用规则如下：

• HTML5播放模式

  在创建播放器构造函数的回调函数里调用。示例如下：

  //H5播放模式
   var player = new Aliplayer({},function(player) {
   player.play();
   });

• Flash播放模式

  在ready事件发生之后或创建播放器ready回调里调用。示例如下：

  //Flash播放模式
   player.on('ready',function(e) {
   player.play();
   });

指跳转到某个时刻进行播放，由seek接口实现。示例如下：

//time为指定的时间，单位：秒。
player.seek(time)

指暂停播放视频，由pause接口实现。示例如下：

player.pause()

Web端播放器SDK仅H5模式支持旋转、镜像等显示设置。

指画面按指定角度旋转，由setRotate接口实现。设置后还可查询旋转角度。示例如下：

//设置旋转角度。<角度>正数为顺时针旋转，负数为逆时针旋转。如：player.setRotate(180)表示顺时针旋转180度。
player.setRotate(<角度>)
//获取旋转角度。
player.getRotate()

支持水平镜像和垂直镜像，由setImage接口实现。示例如下：

//水平镜像
player.setImage('horizon')
//垂直镜像
player.setImage('vertical')

此外，Web端播放器SDK还提供两个属性videoHeight和videoWidth用于设置视频的宽度和高度，高度和宽度一般比容器的小，这样旋转和镜像时不会溢出到父容器外面，示例如下：

 width: '100%', //容器的大小
 height: '100%', //容器的大小
 videoHeight:"200px", //视频的高度大小

指获取当前的播放时刻，由getCurrentTime接口实现。示例如下：

//接口返回的时间单位为秒。
player.getCurrentTime()

指获取视频总时长。需要在视频加载完成以后才可以获取到，可以在play事件后获取。由getDuration实现，示例如下：

player.getDuration()

指监听播放器的状态。由getStatus接口实现。返回值包括：

• init：初始化。

• ready：准备。

• loading：加载中。

• play：播放。

• pause：暂停。

• playing：正在播放。

• waiting：等待缓冲。

• error：错误。

• ended：结束。

示例如下：

player.getStatus()

设置音量包括音量调节和静音设置。

指调节音量大小，由setVolume接口实现。设置后还可获取音量信息。示例如下：

//volume的值为0～1之间的实数。
player.setVolume(0)
//获取音量信息。
player.getVolume()

指将播放中的视频设置为静音状态，由mute接口实现。示例如下：

player.mute()

仅H5模式支持倍速播放。Web端播放器SDK默认的UI自带倍速功能，用户观看时可通过界面选择倍速。如果自定义UI，可通过setSpeed接口实现倍速功能。

示例如下：

//设置倍速。以下示例表示设置为2倍速。
player.setSpeed(2)

指通过设置多路清晰度流的地址，达成多清晰度播放的效果。

• 如果使用VID+PlayAuth方式播放，无需额外设置。Web端播放器SDK会从点播服务获取清晰度列表。观众点击播放界面控制栏里的设置按钮可以看到清晰度列表。

  说明

  VID+PlayAuth方式下，H5播放模式可以通过设置format属性选择播放MP4或MP3播放格式，默认为MP4格式播放。

• 如果使用URL播放方式播放（即通过设置source属性播放），需要在source属性设置中通过JSON结构的键值对（Key-Value Pair）指定多路清晰度流的地址。设置生效后观众点击播放界面控制栏里的设置按钮可以看到清晰度列表。

URL播放方式下，source属性设置中可通过JSON结构的键值对（Key-Value Pair）包括：

 "OD": "<原画URL>"
 "FD": "<流畅URL>"
 "LD"："<标清URL>"
 "SD": "<高清URL>"
 "HD": "<超清URL>"
 "2K": "<2K URL>"
 "4K": "<4K URL>"

以下是URL播放方式设置清晰度的示例代码：

//示例设置清晰度为超清和高清的地址。
source:'{"HD":"http://******/player/hdexample.mp4","SD":"http://******/player/sdexample.mp4"}'

Web端播放器SDK还支持通过设置qualitySort属性，表示启用升序还是降序排列清晰度。

• desc表示按倒序排序（从大到小排序）。

• asc表示按正序排序（从小到大排序）。