下载文档

uexQcloudAV
更新时间:2016-08-04

1、简介

视频直播插件

1.1、说明

该插件对腾讯云的视频直播播放器SDK进行相关封装,另外直播视频会存在延迟,从端到端角度考虑会涉及输入或输出设备,以及中间采用的协议。下行HLS协议的方式延迟会显著高于RTMP协议。在不同网络状况下,会有差异。通常HLS协议的延迟在15~35s左右;RTMP/FLV协议的延迟在2~5s左右。目前移动端不支持rtmp.具体使用点击查看:附录——-> 简明使用步骤

1.2、UI展示

1.3、开源源码及自定义插件下下载

插件测试用例与源码下载:点击 插件中心至插件详情页 (插件测试用例与插件源码已经提供)
(自定义beta版插件下载上传到我的插件勾选使用)

2、API概览

2.1、方法

open 打开视频播放器

uexQcloudAV.open(params)

说明:

通过此方法打开视频播放器,进入播放界面

参数:

  1. var params ={
  2. x: ,
  3. y: ,
  4. width: ,
  5. height:,
  6. data : [
  7. {
  8. "desc" :,
  9. "videoType" : ,
  10. "url" :
  11. },
  12. .....
  13. ]
  14. }

各字段含义如下:

参数名称 参数类型 是否必选 说明
x Number x坐标
y Number y坐标
width Number 宽度
height Number 高度
data Array 视频资源数组,至少一个
desc String 对视频的描述,如”高清”,”标清”等,用于切换视频清晰度的显示按钮
videoType Number 视频类型,请参考VideoType
url String 播放路径,对应实时转码的链接地址,如需加密,则需填写加密后的播放地址, 具体请参考

平台支持:

Android2.2+
iOS6.0+

版本支持:

Android3.0.0+
iOS3.0.0+

示例:

  1. var params = {
  2. x: 20,
  3. y: window.screen.height - 240,
  4. width:window.screen.width - 40,
  5. height:240,
  6. data: [{
  7. "videoType": 1,
  8. "desc": "1080p",
  9. "url": "http://2527.vod.myqcloud.com/2527_3f7c6ea2e57611e48c830517c16aa0bc.f20.mp4"
  10. }, {
  11. "videoType": 1,
  12. "desc": "蓝光",
  13. "url": "http://2527.vod.myqcloud.com/2527_3f7c6ea2e57611e48c830517c16aa0bc.f30.mp4"
  14. }]
  15. };
  16. var data = JSON.stringify(params);
  17. uexQcloudAV.open(data);

play 播放

uexQcloudAV.play()

说明:

通过此方法进行视频播放操作,但不能启动播放功能,与start方法有区别。

参数:

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. uexQcloudAV.play();

pause 暂停

uexQcloudAV.pause()

说明:

通过此方法进行视频暂停操作。

参数:

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. uexQcloudAV.pause();

stop 停止

uexQcloudAV.stop()

说明:

通过此方法进行视频停止操作,视频从头开始。

参数:

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. uexQcloudAV.stop();

close 关闭

uexQcloudAV.close()

说明:

通过此方法关闭视频播放器。

参数:

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. uexQcloudAV.close();

clear 清空缓存

uexQcloudAV.clear()

说明:

关闭播放器后,如需要清空缓存,则可通过此方法来清空缓存。

参数:

平台支持:

iOS6.0+

版本支持:

iOS3.0.0+

示例:

  1. uexQcloudAV.clear();

getCurrentTime 获取当前播放的时间

uexQcloudAV.getCurrentTime()

说明:

  1. 3.3之后的引擎该方法支持同步返回值,3.3以下通过cbGetCurrentTime回调

参数:

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. var time=uexQcloudAV.getCurrentTime();
  2. alert(time);

seekTo 跳转到时间播放

uexQcloudAV.seekTo(time)

说明:

参数:

参数名称 参数类型 是否必选 说明
time String 跳转播放的时间点,以秒为单位

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. uexQcloudAV.seekTo("400");

2.2、回调方法

cbGetCurrentTime 播放时间的监听方法

uexQcloudAV.cbGetCurrentTime(data)

参数:

参数名称 参数类型 是否必选 说明
currentTime Number 播放的当前时间,以秒为单位

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. window.uexOnload = function(){
  2. uexQcloudAV.cbGetCurrentTime = function(data){
  3. alert(data);
  4. }
  5. }

2.3、监听方法

onStateChanged 播放器状态的监听方法

uexQcloudAV.onStateChanged(data)

参数:

各字段含义如下:

参数名称 参数类型 是否必选 说明
data Number 播放器状态,请参考PlayerState

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. window.uexOnload = function(){
  2. uexQcloudAV.onStateChanged = function( data){
  3. alert(data);
  4. }
  5. }

onNetworkStateChanged 切换网络的监听方法

uexQcloudAV.onNetworkStateChanged(data)

参数:

  1. var data ={
  2. networkState:
  3. }

各字段含义如下:

参数名称 参数类型 是否必选 说明
networkState Number 网络状态,请参考NetworkState

平台支持:

iOS6.0+

版本支持:

iOS3.0.0+

示例:

  1. window.uexOnload = function(){
  2. uexQcloudAV.onNetworkStateChanged = function( data){
  3. alert(data);
  4. }
  5. }

3、更新历史

iOS

API版本:uexQcloudAV-3.0.1

最近更新时间:2016-7-5

历史发布版本 更新内容
3.0.1 增加播放错误状态返回值
3.0.0 视频直播插件

Android

API版本:uexQcloudAV-3.3.1

最近更新时间:2016-7-5

历史发布版本 更新内容
3.3.1 添加错误码
3.3.0 腾讯云视频直播插件

4、附录

VideoType

value 说明
0 HLS
1 MP4
2 MP3
3 AAC
4 FMP4
5 WEBM
6 MKV
7 TS

PlayerState

value 说明
0 初始化
1 准备中
2 缓冲
3 播放
4 暂停
5 播放完毕
-1 错误

NetworkState

value 说明
0 无网络
1 移动网络
2 WIFI