音视频通话

影音播放

功能介绍

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

注意:

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

播放端

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

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

import { CrMediaView } from '@cr/react-native-rtc';

<CrMediaView scaleType={0} style={{ flex: 1 }} />

相关 API 请参考:

2. 播放配置

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

import { CrSDK } from '@cr/react-native-rtc';

const cfg = await CrSDK.instance.getMediaCfg();
// 视频尺寸
cfg.size = { width: 360, height: 640 };
// 帧率:视频帧率(5~30)
cfg.fps = 20;
await CrSDK.instance.setMediaCfg(cfg);

相关 API 请参考:

相关结构定义请参考:

3. 播放、暂停、停止

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

//开始播放,如果不需要远端需要观看配合bLocPlay为true
// 请使用业务可访问的绝对路径;本地录像目录可用 getMoviesStorageDirectory()
const dir = await CrSDK.instance.getMoviesStorageDirectory();
await CrSDK.instance.startPlayMedia(`${dir}demo.mp4`, false);

//暂停播放
await CrSDK.instance.pausePlayMedia(false);

//继续播放
await CrSDK.instance.pausePlayMedia(true);

//停止当前播放
await CrSDK.instance.stopPlayMedia();

相关 API 请参考:

4.设置播放进度

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

//以毫秒为单位
const pos = 60 * 1000;
await CrSDK.instance.setMediaPlayPos(pos);

相关 API 请参考:

观看端

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

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

import { CrMediaView, CrSDK } from '@cr/react-native-rtc';

<CrMediaView scaleType={0} style={{ flex: 1 }} />

// 获取当前房间影音状态
const mediaInfo = await CrSDK.instance.getMediaInfo();

相关 API 请参考:

相关结构定义请参考:

2. 观看共享通知

import { CrSDKNotifier, NOTIFIER_EVENT } from '@cr/react-native-rtc';

class MediaListener extends CrSDKNotifier {
  notifyMediaOpened(mediaFileInfo: { totalTime: number; width: number; height: number }) {
    // 影音文件已打开,可获取总时长、分辨率
  }

  // 通知影音开始播放
  notifyMediaStart(mediaNotify: { userID: string }) {
    // mediaNotify.userID 为发起播放的用户
  }

  // 通知影音是否暂停播放
  notifyMediaPause(mediaNotify: { userID: string; pause: boolean }) {}

  // 通知停止影音共享
  notifyMediaStop(mediaNotify: { userID: string; reason: number }) {}
}

const listener = new MediaListener();
listener.addCrNotifierListener([
  NOTIFIER_EVENT.notifyMediaOpened,
  NOTIFIER_EVENT.notifyMediaStart,
  NOTIFIER_EVENT.notifyMediaPause,
  NOTIFIER_EVENT.notifyMediaStop,
]);

相关 API 请参考: