1. Home
3. Guides
5. Products
7. Mobile
9. iOS Screen Sharing

Share a screen using Daily's iOS SDK

Screen sharing enables the local participant to display the contents of their screen to other users in the meeting.

Before you begin, ensure that you understand how to start a video call. For details, see our Introduction to the Daily Client SDKs for Android and iOS.

Screen share for iOS is composed by two parts: broadcast upload extension, screen share support inside daily-ios.

This guide will describe how to implement screen sharing using the iOS SDK, show you some examples, and point you to where you can learn more.

How to create a broadcast upload extension

In order to use the screen sharing functionality for iOS, you will need to create a Broadcast Upload Extension for your app.

The DailySystemBroadcast framework provides all the files needed for capturing the contents of the user's screen and sending it to Daily.

Follow the steps below to learn how to create a new broadcast upload extension using Daily's framework.

1. Ensure that DailySystemBroadcast framework is integrated into the project. You can find the details about how to install broadcast extension framework in our installation guide.

2. Create a new Broadcast Upload Extension target in Xcode.

• Do not select "include UI extension".
• Recommended naming: ScreenCaptureExtension, since it’s an independent process responsible for ingesting and processing the captured video & audio frames that the OS captures and passing it to your app, which then actually sends the media via WebRTC.

3. Add the DailySystemBroadcast framework as dependency of your app target and of your new ScreenCaptureExtension target.

4. Add the same App Group capability in your main app target as well as in this new Broadcast Upload Extension target.

5. Replace your SampleHandler.swift default code that has been created by this code below:

   1
   import DailySystemBroadcast
   2
   
   3
   public class SampleHandler: DailyBroadcastSampleHandler {
   4
   
   5
       override init() {
   6
           super.init(appGroupIdentifier: "group.replace.yours.app.group.identifier")
   7
       }
   8
   
   9
   }
   10
   
   

• Remember to change the appGroupIdentifier to use yours.

6. Edit your app target’s Info.plist

   • Add an RTCAppGroupIdentifier key with your app group identifier.
   • Add a DailyScreenCaptureExtensionBundleIdentifier key with your screen share extension’s bundle identifier.

   If you view the raw file contents of Info.plist, it should look like this:

   1
       <dict>
   2
           ...
   3
           <key>DailyScreenCaptureExtensionBundleIdentifier</key>
   4
           <string>yours.broadcast.upload.extension.identifier</string>
   5
           <key>RTCAppGroupIdentifier</key>
   6
           <string>group.replace.yours.app.group.identifier</string>
   7
           <key>CFBundleDevelopmentRegion</key>
   8
           ...
   9
       </dict>
   10
   
   

How to start the broadcast upload extension

In order to start the broadcast upload extension, you should use the native component RPSystemBroadcastPickerView.

The following code snippet shows how you should setup the RPSystemBroadcastPickerView to open the right extension.

1
import UIKit
2
import Daily
3

4
class CallViewController: UIViewController {
5
    @IBOutlet private weak var systemBroadcastPickerView: UIView!
6

7
    override func viewDidLoad() {
8
        super.viewDidLoad()
9
        // Defining to open the broadcast upload extension that you have created
10
        let systemBroadcastPickerView = self.systemBroadcastPickerView as! RPSystemBroadcastPickerView
11
        systemBroadcastPickerView.preferredExtension = "yours.broadcast.upload.extension.identifier"
12
        systemBroadcastPickerView.showsMicrophoneButton = false
13
    }
14
}
15

How to start a screen share

The following code snippet shows how you might start a screen share:

1
import UIKit
2
import Daily
3

4
class CallViewController: UIViewController {
5
    // Create call client
6
    let call: CallClient = .init()
7

8
    override func viewDidLoad() {
9
        super.viewDidLoad()
10
        // Set the delegate, so we can receive the listeners when the screen capture has started or stopped
11
        self.call.delegate = self
12
    }
13
}
14

15
// to listen to events, use the CallClientDelegate Swift protocol:
16
extension CallViewController: CallClientDelegate {
17
    // Once the screen capture has started we can invoke the Daily SDK to start screen share
18
    func callClientDidDetectStartOfSystemBroadcast(
19
        _ callClient: CallClient
20
    ) {
21
        logger.debug("System broadcast started")
22

23
        callClient.updateInputs(
24
            .set(screenVideo: .set(isEnabled: .set(true))),
25
            completion: nil
26
        )
27
    }
28
    // ... others not shown
29
}
30

How to stop screen share

The following code snippet shows how you might stop a screen share:

1
import UIKit
2
import Daily
3

4
class CallViewController: UIViewController {
5
    // Create call client
6
    let call: CallClient = .init()
7

8
    override func viewDidLoad() {
9
        super.viewDidLoad()
10
        // Set the delegate, so we can receive the listeners when the screen capture has started or stopped
11
        self.call.delegate = self
12
    }
13
}
14

15
// to listen to events, use the CallClientDelegate Swift protocol:
16
extension CallViewController: CallClientDelegate {
17
    // Once the screen capture has stopped we can invoke the Daily SDK to stop screen share
18
    public func callClientDidDetectEndOfSystemBroadcast(
19
        _ callClient: CallClient
20
    ) {
21
        logger.debug("System broadcast ended")
22

23
        callClient.updateInputs(
24
            .set(screenVideo: .set(isEnabled: .set(false))),
25
            completion: nil
26
        )
27
    }
28
    // ... others not shown
29
}
30

How to check if the local screen sharing is enabled

The following code snippet shows how you might check if the local screen sharing is enabled:

1

2
class CallViewController: UIViewController {
3
    // Create call client
4
    let call: CallClient = .init()
5

6
    private var screenIsEnabled: Bool {
7
        // checking if the local screen share is enabled
8
        self.call.inputs.screenVideo.isEnabled
9
    }
10
}
11

12

Demo app

To see a working example of how to interact with the Daily Client SDK for screen sharing, see our iOS demo app.