[Feature]Screenshare audio (#1020)

Author: ipavlidakis

CHANGELOG.md

@@ -4,7 +4,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 # Upcoming
 
-### 🔄 Changed
+### ✅ Added
+- Support for capture inApp audio during ScreenSharing sessions. [#1020](https://github.com/GetStream/stream-video-swift/pull/1020)
 
 # [1.38.2](https://github.com/GetStream/stream-video-swift/releases/tag/1.38.2)
 _December 22, 2025_

DemoApp/Resources/audio-tracks/track_1.mp3

@@ -0,0 +1,83 @@
+//
+// Copyright © 2025 Stream.io Inc. All rights reserved.
+//
+
+import AVFoundation
+import Foundation
+import StreamVideo
+
+final class AudioTrackPlayer: NSObject, AVAudioPlayerDelegate {
+    enum Track: String, Equatable, CaseIterable {
+        case track1 = "track_1"
+        case track2 = "track_2"
+
+        var fileExtension: String {
+            switch self {
+            case .track1:
+                return ".mp3"
+            case .track2:
+                return ".mp3"
+            }
+        }
+    }
+
+    @Published private(set) var isPlaying: Bool = false
+    @Published private(set) var track: Track?
+
+    private var audioPlayer: AVAudioPlayer?
+    private let processingQueue = OperationQueue(maxConcurrentOperationCount: 1)
+
+    func play(_ track: Track) {
+        processingQueue.addTaskOperation { @MainActor [weak self] in
+            guard
+                let self,
+                self.track != track,
+                let url = Bundle.main.url(forResource: track.rawValue, withExtension: track.fileExtension),
+                let audioPlayer = try? AVAudioPlayer(contentsOf: url)
+            else {
+                return
+            }
+
+            self.audioPlayer = audioPlayer
+            audioPlayer.play()
+            audioPlayer.numberOfLoops = 1000
+            self.track = track
+            self.isPlaying = true
+        }
+    }
+
+    func stop() {
+        processingQueue.addTaskOperation { @MainActor [weak self] in
+            guard
+                let self
+            else {
+                return
+            }
+
+            audioPlayer?.stop()
+            audioPlayer = nil
+            isPlaying = false
+            track = nil
+        }
+    }
+
+    // MARK: - AVAudioPlayerDelegate
+
+    func audioPlayerDidFinishPlaying(
+        _ player: AVAudioPlayer,
+        successfully flag: Bool
+    ) {
+        stop()
+    }
+}
+
+extension AudioTrackPlayer: InjectionKey {
+    static var currentValue: AudioTrackPlayer = .init()
+}
+
+extension InjectedValues {
+    var audioPlayer: AudioTrackPlayer {
+        get { Self[AudioTrackPlayer.self] }
+        set { _ = newValue }
+    }
+}

DemoApp/Resources/audio-tracks/track_2.mp3

@@ -40,15 +40,29 @@ struct DemoBroadcastMoreControlsListButtonView: View {
 
     @ViewBuilder
     private var inAppScreenshareButtonView: some View {
-        DemoMoreControlListButtonView(
-            action: {
-                viewModel.startScreensharing(type: .inApp)
+        Menu {
+            Button {
+                viewModel.startScreensharing(type: .inApp, includeAudio: false)
                 selection = .inApp
-            },
-            label: "Screenshare"
-        ) {
-            Image(systemName: "record.circle")
-                .foregroundColor(appearance.colors.text)
+            } label: {
+                Text("Without audio")
+            }
+
+            Button {
+                viewModel.startScreensharing(type: .inApp, includeAudio: true)
+                selection = .inApp
+            } label: {
+                Text("With audio")
+            }
+
+        } label: {
+            DemoMoreControlListButtonView(
+                action: {},
+                label: "Screenshare"
+            ) {
+                Image(systemName: "record.circle")
+                    .foregroundColor(appearance.colors.text)
+            }
         }
     }
 

DemoApp/Sources/Components/AudioTrackPlayer/AudioTrackPlayer.swift

@@ -0,0 +1,61 @@
+//
+// Copyright © 2025 Stream.io Inc. All rights reserved.
+//
+
+import Foundation
+import StreamVideo
+import SwiftUI
+
+struct DemoAudioTrackButtonView: View {
+    @Injected(\.audioPlayer) var audioPlayer: AudioTrackPlayer
+
+    @State private var isPlaying: Bool = AudioTrackPlayer.currentValue.isPlaying
+    @State private var track: AudioTrackPlayer.Track? = AudioTrackPlayer.currentValue.track
+
+    var body: some View {
+        Menu {
+            Button {
+                audioPlayer.stop()
+            } label: {
+                Label {
+                    Text("None")
+                } icon: {
+                    if track == nil {
+                        Image(systemName: "checkmark")
+                    }
+                }
+            }
+
+            Divider()
+
+            ForEach(AudioTrackPlayer.Track.allCases, id: \.self) { track in
+                Button {
+                    if self.track == track {
+                        audioPlayer.stop()
+                    } else {
+                        audioPlayer.play(track)
+                    }
+                } label: {
+                    Label {
+                        Text(track.rawValue)
+                    } icon: {
+                        if self.track == track {
+                            Image(systemName: "checkmark")
+                        }
+                    }
+                }
+            }
+        } label: {
+            DemoMoreControlListButtonView(
+                action: {},
+                label: "In-App audio"
+            ) {
+                Image(
+                    systemName: isPlaying ? "pause.circle" : "play.circle"
+                )
+            }
+        }
+        .onReceive(audioPlayer.$isPlaying.receive(on: DispatchQueue.main)) { isPlaying = $0 }
+        .onReceive(audioPlayer.$track.receive(on: DispatchQueue.main)) { track = $0 }
+    }
+}

DemoApp/Sources/Controls/DemoMoreControls/DemoBroadcastMoreControlsListButtonView.swift

@@ -77,6 +77,8 @@ struct DemoMoreControlsViewModifier: ViewModifier {
                             VStack {
                                 Divider()
 
+                                DemoAudioTrackButtonView()
+
                                 DemoMoreLogsAndGleapButtonView()
 
                                 DemoBroadcastMoreControlsListButtonView(

DemoApp/Sources/ViewModifiers/MoreControls/DemoAudioTrackButtonView.swift

@@ -17,6 +17,14 @@ private func content() {
         }
     }
 
+    asyncContainer {
+        Task {
+            let call = streamVideo.call(callType: "default", callId: "123")
+            try await call.join()
+            try await call.startScreensharing(type: .inApp, includeAudio: true)
+        }
+    }
+
     asyncContainer {
         Task {
             try await call.stopScreensharing()

DemoApp/Sources/ViewModifiers/MoreControls/DemoMoreControlsViewModifier.swift

@@ -546,9 +546,18 @@ public class Call: @unchecked Sendable, WSEventsSubscriber {
     }
 
     /// Starts screensharing from the device.
-    /// - Parameter type: The screensharing type (in-app or broadcasting).
-    public func startScreensharing(type: ScreensharingType) async throws {
-        try await callController.startScreensharing(type: type)
+    /// - Parameters:
+    ///   - type: The screensharing type (in-app or broadcasting).
+    ///   - includeAudio: Whether to capture app audio during screensharing.
+    ///     Only valid for `.inApp`; ignored otherwise.
+    public func startScreensharing(
+        type: ScreensharingType,
+        includeAudio: Bool = true
+    ) async throws {
+        try await callController.startScreensharing(
+            type: type,
+            includeAudio: includeAudio
+        )
     }
 
     /// Stops screensharing from the current device.

DocumentationTests/DocumentationTests/DocumentationTests/06-advanced/04-screensharing.swift

@@ -211,8 +211,19 @@ class CallController: @unchecked Sendable {
         }
     }
 
-    func startScreensharing(type: ScreensharingType) async throws {
-        try await webRTCCoordinator.startScreensharing(type: type)
+    /// Starts screensharing for the current call.
+    /// - Parameters:
+    ///   - type: The screensharing type (in-app or broadcasting).
+    ///   - includeAudio: Whether to capture app audio during screensharing.
+    ///     Only valid for `.inApp`; ignored otherwise.
+    func startScreensharing(
+        type: ScreensharingType,
+        includeAudio: Bool
+    ) async throws {
+        try await webRTCCoordinator.startScreensharing(
+            type: type,
+            includeAudio: includeAudio
+        )
     }
 
     func stopScreensharing() async throws {