跳到主要内容

发布自定义资源

提示

在 Android 平台至少需要调用 publish(RCRTCMediaType.AudioVideo) 或 publish(RCRTCMediaType.Audio) 方法发布成功音频资源后，再发布自定义视频流才有效。tag 不能包含 _ 和 RongCloudRTC 字符。

创建自定义视频资源​

从本地目录下的资源文件创建自定义视频资源，path 需要是平台绝对路径，tag 为自定义视频标识。

方法​

JavaScript
rtcEngine.createCustomStreamFromFile(path, tag);

参数说明​

参数类型必填说明
pathString是本地资源文件的绝对路径
tagString是自定义视频标识，不能包含 _ 和 RongCloudRTC 字符

示例代码​

JavaScript
rtcEngine.createCustomStreamFromFile(path, tag);
console.log('自定义视频资源创建完成');

设置自定义视频属性​

方法​

JavaScript
rtcEngine.setCustomStreamVideoConfig(tag, config);

参数说明​

参数类型必填说明
tagString是自定义视频标识
configRCRTCVideoConfig是视频配置参数

示例代码​

JavaScript
let config = {
  minBitrate: 500,
  maxBitrate: 2200,
  fps: RCRTCVideoFps.Fps25,
  resolution: RCRTCVideoResolution.Resolution_720x1280,
};
rtcEngine.setCustomStreamVideoConfig(tag, config);
console.log('自定义视频属性设置完成');

设置自定义视频资源预览窗口​

导入预览窗口组件​

方法​

JavaScript
import RCReactNativeRtcView from '@rongcloud/react-native-rtc';

示例代码​

JavaScript
// 导入 RCReactNativeRtcView
import RCReactNativeRtcView from '@rongcloud/react-native-rtc';
console.log('预览窗口组件导入成功');

添加预览窗口并获取viewTag​

方法​

JavaScript
<RCReactNativeRtcView
  ref={(ref) => {
    let viewTag = findNodeHandle(ref);
  }}
  fitType={RCRTCViewFitType.Center}
  mirror={true}>
</RCReactNativeRtcView>

参数说明​

参数类型必填说明
fitTypeRCRTCViewFitType否视频填充模式
mirrorBoolean否视频是否镜像显示

示例代码​

JavaScript
// 增加 RCReactNativeRtcView 组件, fitType: 视频填充模式, mirror: 视频是否镜像显示。并在ref中获取viewTag
<RCReactNativeRtcView
  ref={(ref) => {
    let viewTag = findNodeHandle(ref);
    console.log('获取到预览窗口 viewTag:', viewTag);
  }}
  fitType={RCRTCViewFitType.Center}
  mirror={true}>
</RCReactNativeRtcView>

设置预览窗口​

方法​

JavaScript
rtcEngine.setLocalCustomStreamView(tag, viewTag);

参数说明​

参数类型必填说明
tagString是自定义视频标识
viewTagNumber是预览窗口的 viewTag

示例代码​

JavaScript
// 设置预览窗口，viewTag为上一步获取的 viewTag
rtcEngine.setLocalCustomStreamView(tag, viewTag).then(code => {
  if (code === 0) {
    // 设置成功
    console.log('自定义视频预览窗口设置成功');
  } else {
    // 设置失败
    console.log('自定义视频预览窗口设置失败');
  }
});

发布自定义视频资源​

方法​

JavaScript
rtcEngine.publishCustomStream(tag);

参数说明​

参数类型必填说明
tagString是自定义视频标识

示例代码​

JavaScript
rtcEngine.publishCustomStream(tag);
console.log('自定义视频资源发布请求已发送');

设置远端自定义视频资源发布监听​

方法​

JavaScript
rtcEngine.setOnRemoteCustomStreamPublishedListener(callback);

回调参数​

参数类型说明
roomIdString房间 ID
userIdString远端用户 ID
tagString远端自定义视频资源 tag
typeRCRTCMediaType资源类型

示例代码​

JavaScript
rtcEngine.setOnRemoteCustomStreamPublishedListener((roomId, userId, tag, type) => {
  console.log('远端自定义视频资源发布:', userId, tag, type);
});

订阅远端自定义视频资源​

方法​

JavaScript
rtcEngine.subscribeCustomStream(userId, tag);

参数说明​

参数类型必填说明
userIdString是远端用户 ID
tagString是自定义视频标识

示例代码​

JavaScript
rtcEngine.subscribeCustomStream(userId, tag);
console.log('订阅远端自定义视频资源');

设置远端自定义视频资源预览窗口​

方法​

JavaScript
rtcEngine.setRemoteCustomStreamView(userId, tag, viewTag);

参数说明​

参数类型必填说明
userIdString是远端用户 ID
tagString是自定义视频标识
viewTagNumber是预览窗口的 viewTag

示例代码​

JavaScript
// 设置预览窗口,viewTag参考setLocalCustomStreamView说明
rtcEngine.setRemoteCustomStreamView(userId, tag, viewTag).then(code => {
  if (code === 0) {
    // 设置成功
    console.log('远端自定义视频预览窗口设置成功');
  } else {
    // 设置失败
    console.log('远端自定义视频预览窗口设置失败');
  }
});
最后于 更新