音视频通话

影音播放

功能介绍

把一个本地视频文件、或网络流媒体播放给房间内其他用户观看,支持暂停、设置放位置等;

支持的影音文件格式有: mov、rmvb、rm、flv、mp4、3gp、mp3、wav等市面上常见格式;支持http、rtmp、rtsp网络流媒体;

一个房间中同一时间只支持进行一个影音播放;

实现介绍

1.准备影音图像播放容器

<div id="mediaContainer"></div>

2.开始播放并观看影音

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

  • 接口调用:
// 配置影音共享参数1920*1080,帧率24(如果视频文件清晰度比配置低,则以文件为准)
const mediaCfg = JSON.parse(rtcsdk.getMediaCfg());
mediaCfg.size = "1920*1080";
mediaCfg.fps = 24;
rtcsdk.setMediaCfg(JSON.stringify(mediaCfg));

//开始播放影音
rtcsdk.startPlayMedia("D:/1.mp4");
  • 观看影音需要监听以下的回调通知:
//观看端和播放端都会收到开始播放影音的通知,此时显示影音播放UI,即可观看影音
rtcsdk.on("notifyMediaStart", (userID) => {
  const div = document.getElementById('mediaContainer');
    
  //为div元素创建视图容器
  const videoUI = rtcsdk.createVideoUI(div, {
    notifyFrameReceived(frame){
      // _timestamp,当前影音播放时间,可用于计算当前播放进度
      const {_timestamp} = frame;
    }
  });

  const videoObj = {
      type: 2
  }
  videoUI.setVideo(videoObj); //设置videoUI观看影音共享画面
})

相关API请参考:

3.设置播放进度

  • 调用接口:
// 设置播放进度,单位:毫秒.例如:设置到2秒处.
rtcsdk.setMediaPlayPos(2000);

相关API请参考:

4.暂停、停止播放

  • 调用接口:
// 暂停或恢复播放影音:ture为暂停,false为恢复
rtcsdk.pausePlayMedia(true);

//停止播放影音
rtcsdk.stopPlayMedia();
//共享端停止影音共享后,UI组件一同销毁
videoUI.destroy();
  • 回调通知:

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

//媒体暂停播放通知
rtcsdk.on("notifyMediaPause", (userID, bPause) => {

})

//影音停止播放通知,观看端和播放端都会收到此通知。reason 为停止原因
rtcsdk.on("notifyMediaStop", (userID, reason) => {
    //此时观看端销毁UI组件
    videoUI.destroy();
})

相关API请参考: