音视频通话

影音播放

功能介绍

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

注意:

一个房间中同一时间只支持进行一个影音播放。支持的影音文件格式有: mov、rmvb、rm、flv、mp4、3gp 等。

播放端

1. 创建影音播放UI显示组件

使用可视化 UI 组件进行影音播放

Widget _mediaViewWidget = RtcSDK.mediaManager.createView((viewID) {
    _mediaViewID = viewID;
});

相关 API 请参考:

2. 播放配置

此配置主要是为了定义共享播放时房间内其他人看到的效果

VideoCfg cfg = VideoCfg(
    size: VSize(width: 360, height: 640), // 视频尺寸(如:"640*360")
    fps: 20, // 帧率:视频帧率(5~30)
)
RtcSDK.mediaManager.setMediaCfg(cfg);

相关 API 请参考:

相关结构定义请参考:

3. 播放、暂停、停止

每次只能播放一个视频,当前播放需要先停止然后才能进行下一个视频播放;
开始播放参数可控制此播放是只有自己可见还是房间内所有人可见。

//开始播放,如果不需要远端需要观看配合bLocPlay为true
RtcSDK.mediaManager.startPlayMedia("/sdcard/RecordDemo/CloudroomVideoSDK/4.mp4", false);

//暂停播放
RtcSDK.mediaManager.pausePlayMedia(false);

//继续播放
RtcSDK.mediaManager.pausePlayMedia(true);

//停止当前播放
RtcSDK.mediaManager.stopPlayMedia();

相关 API 请参考:

4.设置播放进度

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

//以毫秒为单位
int pos = 60 * 1000;
RtcSDK.mediaManager.setMediaPlayPos(pos);

相关 API 请参考:

观看端

1. 创建影音观看UI显示组件

使用影音观看 UI 组件进行屏幕共享显示

Widget _mediaViewWidget = RtcSDK.mediaManager.createView((viewID) {
    _mediaViewID = viewID;
});

// 获取当前房间影音状态
RtcSDK.mediaManager.getMediaInfo().then((MediaInfo mediaInfo) {});

相关 API 请参考:

相关结构定义请参考:

2. 观看共享通知


  • 接口调用:
  @override
  void initState() {
    RtcSDK.mediaManager.setListener(MediaListener(
      onNotifyMediaOpened: notifyMediaOpened,
      onNotifyMediaStart: notifyMediaStart,
      onNotifyMediaPause: notifyMediaPause,
      onNotifyMediaStop: notifyMediaStop,
    ));
    super.initState();
  }

  @override
  void dispose() {
    super.dispose();
  }

  void notifyMediaOpened(MediaFileInfo mediaFileInfo) {}

  // 通知影音开始播放
  void notifyMediaStart(String userID) {}

  // 通知影音是否暂停播放
  void notifyMediaPause(String userID, bool pause) {}

  // 通知停止影音共享
  void notifyMediaStop(String userID, MEDIA_STOP_REASON reason) {}

相关 API 请参考: