iOS screen sharing

Last updated Oct 19, 2026 Configure a Broadcast Upload Extension to add screen sharing to your RealtimeKit iOS application.

Native iOS

Add a Broadcast Upload Extension

In Xcode, add a Broadcast Upload Extension through File → New → Target. Choose iOS → Broadcast Upload Extension and fill out the required information.

Configure app groups

Add your extension to an app group:

  1. Go to your extension's target in the project.
  2. In the Signing & Capabilities tab, select +.
  3. Add App Groups.
  4. Add App Groups to your main app, using the same identifier for both targets.

Configure SampleHandler

Edit your SampleHandler class:

import RealtimeKit

class SampleHandler: RtkSampleHandler {}

You can find the source to RtkSampleHandler and a full implementation of the ScreenShareExtension on GitHub ↗︎.

Update Info.plist

Ensure both the app and extension Info.plist files contain these keys:

<key>RTKRTCAppGroupIdentifier</key>
<string>(name of the group you have created)</string>

Add this key to the main app Info.plist:

<key>RTKRTCScreenSharingExtension</key>
<string>(Bundle Identifier of the Broadcast Upload Extension)</string>

Enable screen sharing

Launch the Broadcast Upload Extension and enable screen sharing:

meeting.localUser.enableScreenShare()

To stop screen sharing:

meeting.localUser.disableScreenShare()

React Native

Add a Broadcast Upload Extension

In Xcode, add a Broadcast Upload Extension through File → New → Target. Choose iOS → Broadcast Upload Extension and fill out the required information.

Configure app groups

Add your extension to an app group:

  1. Go to your extension's target in the project.
  2. In the Signing & Capabilities tab, select + and add App Groups.
  3. Add the same App Group to your main app target, using the same identifier for both.

Add screen-sharing sources through the Podfile

The SDK includes a Ruby helper script that adds the required screen-sharing Swift source files to your Broadcast Upload Extension target. Add the following to your Podfile:

# Add this line at the top
require Pod::Executable.execute_command('node', ['-p',
  'require.resolve(
    "@cloudflare/realtimekit-react-native/ios/scripts/screenshare_sources.rb",
    {paths: [process.argv[1]]},
  )', __dir__]).strip

target 'YourApp' do
  ...
  post_install do |installer|
    ...
    # Add this line here
    add_screenshare_sources(
      installer,
      project_name: 'YourApp',              # your Xcode project name (without .xcodeproj)
      extension_target_name: 'YourAppScreenshare' # your Broadcast Upload Extension target name
    )
    ...
  end
end

target 'YourAppScreenshare' do
# Remove the old steps added if any
end

Then run:

pod install

Configure SampleHandler

In your Broadcast Upload Extension, edit SampleHandler.swift:

class SampleHandler: RTKScreenshareHandler {
  override init() {
    super.init(
      appGroupIdentifier: "<YOUR_APP_GROUP_IDENTIFIER>",
      bundleIdentifier: "<YOUR_APP_BUNDLE_IDENTIFIER>"
    )
  }
}

Replace <YOUR_APP_GROUP_IDENTIFIER> with the App Group you created. Replace <YOUR_APP_BUNDLE_IDENTIFIER> with your main app's bundle identifier.

Update Info.plist

Add the following key to both your main app and extension Info.plist files:

<key>RTCAppGroupIdentifier</key>
<string>(YOUR_APP_GROUP_IDENTIFIER)</string>

Add this key to the main app Info.plist only:

<key>RTCAppScreenSharingExtension</key>
<string>(Bundle Identifier of the Broadcast Upload Extension)</string>

Enable screen sharing

meeting.self.enableScreenShare();

To stop screen sharing:

meeting.self.disableScreenShare();

Was this helpful?

YesNo

On this page

iOS screen sharing - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/realtime/realtimekit/humans/core/ios-screen-sharing/#page","headline":"iOS screen sharing","description":"Configure iOS screen sharing for native iOS and React Native RealtimeKit applications.","url":"https://developers.cloudflare.com/realtime/realtimekit/humans/core/ios-screen-sharing/","inLanguage":"en","image":"https://developers.cloudflare.com/realtime/realtimekit/humans/core/ios-screen-sharing/og.png?v=79d3523f720bba0f","dateModified":"2026-10-19","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Manage local user media devices, audio, video, and screenshare in RealtimeKit meetings. title: Local Participant image: https://developers.cloudflare.com/realtime/realtimekit/humans/core/local-participant/og.png?v=56c759aeac12b2a9

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/realtime/llms.txt
Use this file to discover all available pages before exploring further.