[Fix]Initial CallSetttings and external audio output (#819)

Author: ipavlidakis

CHANGELOG.md

@@ -8,6 +8,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - `CallViewController` was updated to accept the `video` flag when starting a call. [#811](https://github.com/GetStream/stream-video-swift/pull/811)
 - `team` property when creating calls through `CallViewModel` and/or `CallViewController` [#817](https://github.com/GetStream/stream-video-swift/pull/817)
 
+### 🔄 Changed
+- When joining a Call, if the user has an external audio device connected, we will ignore the remote `CallSettings.speakerOn = true`. [#819](https://github.com/GetStream/stream-video-swift/pull/819)
+
 ### 🐞 Fixed
 - Fix a retain cycle that was causing StreamVideo to leak in projects using NoiseCancellation. [#814](https://github.com/GetStream/stream-video-swift/pull/814)
 - Fix occasional crash caused inside `MicrophoneChecker`. [#813](https://github.com/GetStream/stream-video-swift/pull/813)

Sources/StreamVideo/WebRTC/v2/WebRTCAuthenticator.swift

@@ -74,16 +74,30 @@ struct WebRTCAuthenticator: WebRTCAuthenticating {
             )
         )
 
-        /// Always apply either the provided callSettings or the ones from the dashboard.
-        if let callSettings = await coordinator.stateAdapter.initialCallSettings {
-            await coordinator.stateAdapter.set(
-                callSettings: callSettings
-            )
-        } else {
-            await coordinator.stateAdapter.set(
-                callSettings: .init(response.call.settings)
-            )
+        /// Sets the initial call settings for the coordinator's state adapter.
+        ///
+        /// - First, retrieves the initial call settings, if any, that may have been
+        ///   stored previously on the coordinator.
+        /// - Then, constructs new call settings based on the remote values received
+        ///   from the backend.
+        /// - If there are no locally stored settings, defaults to the remote settings.
+        /// - If the current audio route is external (e.g., Bluetooth, AirPlay),
+        ///   and the settings indicate that the speaker should be on, updates
+        ///   the settings to turn the speaker off. This prevents external
+        ///   devices from mistakenly having the speaker route enabled.
+        /// - Finally, applies the determined call settings to the state adapter.
+        let initialCallSettings = await coordinator.stateAdapter.initialCallSettings
+        let remoteCallSettings = CallSettings(response.call.settings)
+        var callSettings = initialCallSettings ?? remoteCallSettings
+        if
+            coordinator.stateAdapter.audioSession.currentRoute.isExternal,
+            callSettings.speakerOn
+        {
+            callSettings = callSettings.withUpdatedSpeakerState(false)
         }
+        await coordinator.stateAdapter.set(
+            callSettings: callSettings
+        )
 
         await coordinator.stateAdapter.set(
             videoOptions: .init(preferredCameraPosition: {