React Native
This document describes how to quickly integrate the TRTC SDK for React Native into your project.
Environment Requirements
React Native 0.63 or above
Node (above v12) & Watchman
Developing for Android:
Android Studio 3.5 or above
Devices with Android 4.1 or above
Java Development Kit
Developing for iOS and macOS:
Xcode 11.0 or above
OS X 10.11 or above
A valid developer signature for your project
For how to set up the environment, see the React Native official document.
Integrating SDK
We have released the TRTC SDK for React Native to npm. You can configure
package.json
to install the SDK.1. Add the following dependencies to
package.json
of your project:"dependencies": {"trtc-react-native": "^2.0.0"},
2. Grant camera and mic permissions to enable the audio and video call features.
1. Configure application permissions in
AndroidManifest.xml
. The TRTC SDK requires the following permissions:<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /><uses-permission android:name="android.permission.RECORD_AUDIO" /><uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /><uses-permission android:name="android.permission.BLUETOOTH" /><uses-permission android:name="android.permission.CAMERA" /><uses-permission android:name="android.permission.READ_PHONE_STATE" /><uses-feature android:name="android.hardware.camera" /><uses-feature android:name="android.hardware.camera.autofocus" />
Note:
Do not set
android:hardwareAccelerated="false"
. Disabling hardware acceleration will result in failure to render remote users’ videos.2. Manually configure audio and video permission requests.
if (Platform.OS === 'android') {await PermissionsAndroid.requestMultiple([PermissionsAndroid.PERMISSIONS.RECORD_AUDIO, //For audio callsPermissionsAndroid.PERMISSIONS.CAMERA, // For video calls]);}
1. Add requests for camera and mic permissions in
Info.plist
:<key>NSCameraUsageDescription</key><string>Video calls are possible only with camera permission.</string><key>NSMicrophoneUsageDescription</key><string>Audio calls are possible only with mic access.</string>
2. Link native libraries. For detailed directions, see Linking Libraries.