H5-SDK

# 影音播放

功能简介：
把本地的一个视频文件播放给房间内其他用户观看，播放进度完全由播放端控制。
影音播放功能介绍分为播放端和观看端两部分。

注意：一个房间中同一时间只支持进行一个影音播放。支持的影音格式因浏览器不同而不同。

播放端：

  1. 创建影音播放组件
  2. 开始播放并观看影音
  3. 设置播放进度
  4. 暂停、停止播放

观看端：

  1. 创建影音播放组件
  2. 观看影音
  3. 影音停止播放通知

两端通用的功能：

  1. 播放信息

播放端

1.创建影音播放组件

//首先要创建影音播放组件
var mediaObj = CRVideo_CreatMediaObj({
    controls: true, //视频控件是否需要浏览器自带的控制条,
    loop: true, //视频是否循环播放 
});

相关API请参考：

2.开始播放并观看影音

每次只能播放一个视频，停止正在播放的视频才能播放下一个视频。通过设置播放配置，还可以控制房间内其他人看到的效果。

  • 接口调用：
// 开始播放影音：
CRVideo_StartPlayMedia(mediaObj, file, locPlay, bPauseWhenFinished)
  • 观看影音需要监听以下的回调通知：
//观看端和播放端都会收到开始播放影音的通知。此时显示影音播放组件，即可观看影音
CRVideo_NotifyMediaStart.callback = function(userid){
    document.body.appendChlid(mediaObj.handler());  //把创建的组件放入DOM树中
}

相关API请参考：

3.设置播放进度

可以通过拖动播放组件上的工具条来调整播放进度，也可以用代码来设置播放进度。

  • 调用接口：
// 设置播放进度，单位：毫秒.例如：设置到2秒处.  
CRVideo_SetMediaplaypos(2000)

相关API请参考：

4.暂停、停止播放

  • 调用接口：
// 暂停或恢复播放影音
CRVideo_PausePlayMedia(true);  // ture为暂停，false为恢复

//停止播放影音
CRVideo_StopPlayMedia()
  • 回调通知：

注意：主动调用CRVideo_StopPlayMedia停止播放，或者影音文件播放到结尾，都会触发事件CRVideo_NotifyMediaStop，房间内所有人都会收到。

//影音共享暂停播放通知
CRVideo_NotifyMediaPause.callback = function(userid,pause){

}

//影音共享播放停止通知
CRVideo_NotifyMediaStop.callback = function(){
    
}

相关API请参考:

观看端：

1.创建影音播放组件

//首先要创建影音播放显示组件
var mediaObj = CRVideo_CreatMediaObj({
    controls: true, //视频控件是否需要浏览器自带的控制条,
    loop: true, //视频是否循环播放 
});

相关API请参考：

2.观看影音

//观看端和播放端都会收到开始播放影音的通知。此时显示影音播放组件，即可观看影音
CRVideo_NotifyMediaStart.callback = function(userid){
    mediaObj.setVideo(userid);  //将别人开启的共享，需要setVideo。如果是自己开启的共享，无需设置
    document.body.appendChlid(mediaObj.handler());  //把创建的组件放入DOM树中
}

相关API请参考：

3.影音停止播放通知

//影音停止播放通知，观看端和播放端都会收到此通知。
CRVideo_NotifyMediaStop.callback = function(){
    document.body.removeChlid(mediaObj.handler());
    mediaObj = null;
}

两端通用的功能：

播放信息

  • 调用接口：
// 取得影音文件信息
var mediaInfo =  CRVideo_Getmediainfo(UID)

相关API请参考:

相关结构定义请参考:

← 呼叫 →