影音播放
功能介绍
把本地的一个视频文件播放给房间内其他用户观看,播放进度完全由播放端控制。
影音播放功能介绍分为播放端和观看端两部分。
注意:
一个房间中同一时间只支持进行一个影音播放。支持的影音文件格式有: 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 请参考: