Native configuration (iOS & Android)

Never copy CallPipModule, VideosdkRPK or RealtimexVoip into your app, and never register a second CallPipPackage in MainApplication — they would be duplicate classes.

Replace MyChatApp with your Xcode target / Android package. In Fieldr the names are ios/Fieldr/…, ios/FieldrBroadcast/… and com.softwareco.fieldr.

1apply plugin: "com.android.application"2apply plugin: "org.jetbrains.kotlin.android"3apply plugin: "com.facebook.react"4apply plugin: "com.google.gms.google-services"   // ← add

Put google-services.json in android/app/.

Activity attributes are not merged from libraries, so add these two on your launcher activity:

1<activity2  android:name=".MainActivity"3  android:supportsPictureInPicture="true"4  android:resizeableActivity="true"5  ...>

Every permission, service and receiver listed in What the package does for you is merged automatically. Paste host-setup/android/AndroidManifest.snippet.xml only if you disabled Android autolinking for this package.

Optional:

• Full-screen incoming calls: install @notifee/react-native and set androidFullScreenCalls: true (App entry). Android 14+ grants USE_FULL_SCREEN_INTENT automatically only to calling / alarm apps (Play Console declaration); without it the call shows as a heads-up notification.
• Notification icon: a white-on-transparent drawable, e.g. android/app/src/main/res/drawable/ic_notification.png, passed as configurePushNotifications({androidSmallIcon: 'ic_notification'}).

MainActivity.kt and MainApplication.kt need no chat code.

From host-setup/ios/snippets/Info.plist.snippet.xml, plus the photo-library string for attachments:

1<key>NSCameraUsageDescription</key>2<string>Camera access is required for video calls.</string>3<key>NSMicrophoneUsageDescription</key>4<string>Microphone access is required for audio and video calls.</string>5<key>NSPhotoLibraryUsageDescription</key>6<string>Choose photos and videos to send in chat.</string>7 8<!-- Screen share: must match the App Group and the Broadcast extension bundle id -->9<key>RTCAppGroupIdentifier</key>10<string>group.com.example.mychatapp</string>11<key>RTCScreenSharingExtension</key>12<string>com.example.mychatapp.Broadcast</string>13 14<key>UIBackgroundModes</key>15<array>16  <string>audio</string>               <!-- call audio in the background -->17  <string>voip</string>                <!-- PushKit calls; camera in PiP on iOS 18+ -->18  <string>picture-in-picture</string>  <!-- call PiP -->19  <string>remote-notification</string> <!-- background delivery + clear pushes -->20</array>

Optional VoIP keys:

From host-setup/ios/snippets/Entitlements.snippet.plist. In Xcode: Signing & Capabilities → Push Notifications, Background Modes, App Groups.

1<key>com.apple.security.application-groups</key>2<array>3  <string>group.com.example.mychatapp</string>4</array>5<key>aps-environment</key>6<string>development</string>   <!-- Xcode switches to production for release / TestFlight -->

com.apple.developer.avfoundation.multitasking-camera-access (camera in PiP / Split View on iOS 16–17) is a managed entitlement — request it from Apple first; adding it unapproved breaks signing. iOS 18+ only needs the voip background mode.

React Native Firebase requires FirebaseApp.configure() at the start of launch:

1import Firebase2 3// inside application(_:didFinishLaunchingWithOptions:), first line:4FirebaseApp.configure()

No PushKit, CallKit or bridging-header code is needed — the pod's RealtimexVoip handles it. An app delegate that already implements pushRegistry(_:didReceiveIncomingPushWith:for:completion:) keeps working: the pod sees it and stays off (that app must then report every push to CallKit itself — host-setup/ios/snippets/AppDelegate.pushkit.snippet.swift).

1require_relative '../node_modules/react-native-permissions/scripts/setup'2 3setup_permissions([4  'Camera',5  'Microphone',6  'PhotoLibrary',7])8 9target 'MyChatApp' do10  config = use_native_modules!11  use_react_native!(:path => config[:reactNativePath])12  # …React Native Firebase pod settings for your setup (Fieldr: $RNFirebaseAsStaticFramework = true)13end14 15# Screen share — TOP-LEVEL target, outside the app target.16target 'MyChatAppBroadcast' do17  inherit! :search_paths    # not :none — CocoaPods would then link nothing18  pod 'RealtimexLiveChatBroadcast',19      :path => '../node_modules/@realtimexsco/live-chat-react-native'20end

Then cd ios && pod install.

1. Xcode → File → New → Target → Broadcast Upload Extension (MyChatAppBroadcast, no UI extension).
2. Replace its files with the 3 templates in host-setup/ios/screen-share/Broadcast/:
   • SampleHandler.swift — the whole file is one line of code:

1import RealtimexLiveChatBroadcast2 3class SampleHandler: RealtimexBroadcastSampleHandler {}

• Info.plist — NSExtensionPointIdentifier com.apple.broadcast-services-upload, RPBroadcastProcessMode RPBroadcastProcessModeSampleBuffer, RTCAppGroupIdentifier.
  • Broadcast.entitlements — the same App Group.

3. Set the extension PRODUCT_BUNDLE_IDENTIFIER (com.example.mychatapp.Broadcast) and put the same value in the main Info.plist RTCScreenSharingExtension.
4. Replace group.YOUR_TEAM.YOUR_APP in both Info.plists and both entitlements with your App Group.
5. Embed the .appex under Embed Foundation Extensions, add the Podfile target above, pod install.

More detail: ios/SCREEN_SHARE_HOST_SETUP.md.

The package draws foreground RealtimeX notifications itself. If your app has no UNUserNotificationCenterDelegate, React Native Firebase also presents FCM pushes in the foreground; turn that off to avoid a second banner:

{"react-native": {"messaging_ios_foreground_presentation_options": []}}

An app with its own UNUserNotificationCenter delegate should complete remote pushes with [] in willPresent.

Earlier versions asked hosts to paste PushKit / CallKit code into the AppDelegate. To move to the pod:

1. Delete the PKPushRegistryDelegate extension, RNCallKeep.setup(...), RNVoipPushNotificationManager.voipRegistration() and import PushKit from AppDelegate.swift.
2. Delete the bridging-header imports for RNCallKeep / RNVoipPushNotificationManager (and the header with its SWIFT_OBJC_BRIDGING_HEADER setting if it is now empty).
3. Delete patches/react-native-callkeep+4.3.16.patch.
4. pod install, rebuild.