Integrating React Native SDK for iOS

Add one line for the VideoSDKRTC pod to your Podfile. The React Native SDK's own pod is linked automatically.

important

If you are upgrading from v1.0.1, follow the Migration Guide. Remove the react-native-webrtc pod from your Podfile before you add VideoSDKRTC.

Step 1: Install the SDK.

The simplest way to get started is by installing the SDK in your application using the provided command:

Npm

npm install "@videosdk.live/react-native-sdk@2.0.0"

Yarn

yarn add "@videosdk.live/react-native-sdk@2.0.0"

This is the only VideoSDK package you need.

Step 2: Install all the dependencies via CocoaPods.

IMPORTANT: Make sure to use CocoaPods version 1.10 or higher.

$[sudo] gem install cocoapods

Step 3: Add the VideoSDKRTC pod to the Podfile of your react-native ios directory:

ios/Podfile

target 'YourApp' do
  # ...
  pod 'VideoSDKRTC', :podspec => '../node_modules/@videosdk.live/react-native-sdk/ios/VideoSDKRTC.podspec'
end

Add the line inside your app's target block. Without it, CocoaPods picks an older VideoSDKRTC from the public CocoaPods repository, which does not work with v2.0.0.

Step 4: Change the platform field of the Podfile to 18.0.

v2.0.0 needs iOS 18.0 or later. Update the line to platform :ios, '18.0', and set the iOS Deployment Target of your app target to 18.0 in Xcode as well.

ios/Podfile

platform :ios, '18.0'

Step 5: Install pods

cd ios && pod install

Step 6: Declare permissions in your Info.plist file.

ios/projectname/info.plist

<key>NSCameraUsageDescription</key>
<string>Camera permission description</string>
<key>NSMicrophoneUsageDescription</key>
<string>Microphone permission description</string>

To share the screen on iOS, your app also needs a Broadcast Upload Extension. Follow the iOS screen share guide.