音视频通话

准备工作

帐号申请

点此注册 一个账号,或者联系商务代为开通,或在网站咨询客服。

创建项目

可以在 管理平台 中创建新的项目(系统有一个默认项目,可以直接使用),如下图:
GetAPPID

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

防火墙开通

在使用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

  1. 在 Xcode 工程的 Info.plist 配置麦克风、摄像头权限说明,例如:
  • NSCameraUsageDescription — 需要访问您的摄像头进行视频通话,同意才能开启相机
  • NSMicrophoneUsageDescription — 需要访问您的麦克风进行视频通话,同意才能开启麦克风
  1. 在工程目录执行 pod install 后编译运行。

安卓

  1. 添加权限声明到 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" />
  1. 混淆:在 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

本地录制示例见 本地录制。