准备工作
帐号申请
点此注册 一个账号,或者联系商务代为开通,或在网站咨询客服。
创建项目
可以在 管理平台 中创建新的项目(系统有一个默认项目,可以直接使用),如下图:

为了保障接口安全,后台不再显示 App Secret,所以请在创建项目成功显示 App Secret 时妥善保存好。 如果遗忘只能如下图更换 App Secret:

防火墙开通
在使用SDK 提供的相关服务之前,您需要打开下面这些特定的端口:
| 协议类型 | 端口 | 端口用途 | 适用SDK平台 | ||||
|---|---|---|---|---|---|---|---|
| Windows, macOS, Linux, Android, iOS | Web | 小程序 | 直播观看 | Web管理页面 | |||
| TCP | 2725 | Web管理后台端口 | √ | ||||
| 2726 | 信令端口1 | √ | √ | √ | √ | ||
| 2728 | 信令端口2 | √ | |||||
| 1935 | RTMP端口 | √ | √ | ||||
| UDP | 2698 | 音视频流媒体端口 | √ | ||||
| 2699 | 音视频流媒体端口(Web) | √ | |||||
SDK 集成准备
安装
npm install @cr/react-native-rtc
要求:React Native 0.60.0 及以上、iOS 12.0 及以上、Android 4.4 及以上。
可参考仓库内 api-demo/ 示例工程。
说明:
npm install @cr/react-native-rtc
iOS
- 在 Xcode 工程的
Info.plist配置麦克风、摄像头权限说明,例如:
- NSCameraUsageDescription — 需要访问您的摄像头进行视频通话,同意才能开启相机
- NSMicrophoneUsageDescription — 需要访问您的麦克风进行视频通话,同意才能开启麦克风
- 在工程目录执行
pod install后编译运行。
安卓
- 添加权限声明到
AndroidManifest.xml:
<uses-feature android:glEsVersion="0x00020000" android:required="true" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
屏幕共享还需声明:
<activity
android:name="com.rtc.screencapture.PermissionActivity"
android:launchMode="singleTop"
android:exported="false" />
<service
android:name="com.rtc.screencapture.ScreenCaptureService"
android:exported="false"
android:foregroundServiceType="mediaProjection" />
- 混淆:在
android/app/proguard-rules.pro中添加:
-keep class com.cloudroom.** { *; }
-keep class com.rtc.** { *; }
-keep class org.crmedia.** { *; }
存储路径说明
RN SDK 提供以下路径接口(详见 API):
| 接口 | 用途 |
|---|---|
| getStoreDirectory | SDK 缓存 / init 的 sdkDatSavePath(Android 常用;iOS 可传空串用默认路径) |
| getMoviesStorageDirectory | 本地录制 mp4 推荐目录,勿硬编码 /sdcard/ |
| getSdkLogFilePath | SDK 日志文件完整路径,便于排查 |
| getApplicationId | Android applicationId / iOS Bundle ID |
本地录制示例见 本地录制。