Merge pull request #417 from DolbyIO/release/3.10.0

Release/3.10.0

Author: graduad

.github/workflows/ci.yml

@@ -111,6 +111,8 @@ jobs:
     - name: Fetch dependencies
       run: |
         flutter pub get
+    - name: Update Cocoapods repo
+      run: pod repo update
     - name: Run unmocked integration tests
       env: 
         APP_KEY: ${{ secrets.DOLBYIO_APP_KEY }}

CHANGELOG.md

@@ -1,3 +1,23 @@
+## 3.10.0
+
+### Features
+
+- Introduced the ability to change the [capture mode](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/LocalAudio/setCaptureMode.html) in non-Dolby Voice conferences and use either the [Standard](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureMode.html#standard) or [Unprocessed](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureMode.html#unprocessed) mode.
+
+- Introduced a new [voiceFont](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureOptions/voiceFont.html) property to [AudioCaptureOptions](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureOptions-class.html) that is supported in the [Standard](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureMode.html#standard) audio capture mode. [Voice fonts](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureOptions/voiceFont.html) allow participants to modify their voices in real time to improve social interaction in entertainment scenarios. For more information about this feature, see the [Using Voice Fonts](https://docs.dolby.io/interactivity/docs/guides-using-voice-fonts) guide.
+
+- Introduced a new [preview](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/LocalAudio/preview.html) service that allows the local participant to test different capture modes and voice fonts before a conference. The service sets a preview recorder that records the participant's audio and plays it back. Before playing the recorded audio, set the [captureMode](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/LocalAudio/setCaptureMode.html) to a preferred setting that you wish to try.
+
+- Introduced a new [updateParticipantInfo](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/SessionService/updateParticipantInfo.html) method that lets participants modify their names and avatars while they are in a conference.
+
+- The SDK now supports receiving two shared screens in one conference.
+
+### Changes
+
+- Changed the default value of the audio capture mode in non-Dolby Voice conferences to [Standard](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureMode.html#standard) with [high](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/NoiseReduction.html#high) noise reduction. This setting optimizes captured audio for speech by aggressively removing non-speech content. If you want to transmit non-stationary background sounds to a conference and create a more natural audio experience, you can set noise reduction to [low](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/NoiseReduction.html#low), which offers a similar experience as the default setting in previous releases. If you wish to transmit non-voice audio to a conference as well and use input device setting without any processing, use the [Unprocessed](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/AudioCaptureMode.html#unprocessed) mode.
+
+- The [current](https://api-references.dolby.io/comms-sdk-flutter/dolbyio_comms_sdk_flutter/ConferenceService/current.html) method now returns null when the user is not in a conference.
+
 ## 3.10.0-beta.1
 
 ### Features

android/build.gradle

@@ -3,7 +3,7 @@ version '1.0-SNAPSHOT'
 
 buildscript {
     ext.kotlin_version = '1.7.10'
-    ext.voxeet_sdk_version = "3.10.0"
+    ext.voxeet_sdk_version = "[3.10.1,3.11)"
     ext.dagger_version = "2.40.5"
     repositories {
         google()

android/gradle.properties

@@ -1,2 +1,2 @@
-COMMS_SDK_VERSION="3.10.0-beta.1"
+COMMS_SDK_VERSION="3.10.0"
 COMPONENT_NAME="flutter-sdk"

android/src/main/kotlin/io/dolby/comms/sdk/flutter/events/AudioPreviewEventEmitter.kt

@@ -1,24 +1,23 @@
 package io.dolby.comms.sdk.flutter.events
 
 import com.voxeet.VoxeetSDK
-import com.voxeet.android.media.capture.audio.preview.RecorderStatus
+import com.voxeet.android.media.capture.audio.preview.AudioPreviewStatus
 
 class AudioPreviewEventEmitter(eventChannelHandler: EventChannelHandler) : NativeEventEmitter(eventChannelHandler) {
 
     /**
      * Emitted when the application user received an audio preview status changed.
      */
-    private val previewCallback: (RecorderStatus) -> Unit = { status ->
-        android.util.Log.d("[KB]", "status changed: $status")
+    private val previewCallback: (AudioPreviewStatus) -> Unit = { status ->
         emit(OnStatusChanged, status.name)
     }
 
     override fun registerEventEmitter() {
-        VoxeetSDK.audio().local.preview().callback = previewCallback
+        VoxeetSDK.audio().local.preview().onStatusChanged = previewCallback
     }
 
     override fun unregisterEventEmitter() {
-        VoxeetSDK.audio().local.preview().callback = null
+        VoxeetSDK.audio().local.preview().onStatusChanged = null
     }
 
     companion object {

android/src/main/kotlin/io/dolby/comms/sdk/flutter/events/EventChannelHandler.kt

@@ -22,7 +22,6 @@ class EventChannelHandler(private val channelName: String) : EventChannel.Stream
     }
 
     override fun onListen(arguments: Any?, callback: EventChannel.EventSink?) {
-        android.util.Log.d("[KB]", "arguments: ${arguments}")
         eventCallback = callback
     }
 

android/src/main/kotlin/io/dolby/comms/sdk/flutter/module/ConferenceServiceNativeModule.kt

@@ -2,6 +2,7 @@ package io.dolby.comms.sdk.flutter.module
 
 import com.voxeet.VoxeetSDK
 import com.voxeet.sdk.json.internal.ParamsHolder
+import com.voxeet.sdk.models.Conference
 import com.voxeet.sdk.models.VideoForwardingStrategy
 import com.voxeet.sdk.services.builders.ConferenceCreateOptions
 import com.voxeet.sdk.services.builders.VideoForwardingOptions
@@ -98,12 +99,14 @@ class ConferenceServiceNativeModule(private val scope: CoroutineScope) : NativeM
     private fun current(result: Result) = scope.launch(
         onError = result::onError,
         onSuccess = {
-            VoxeetSDK
-                .conference()
-                .conference
-                ?.let { conf -> ConferenceMapper(conf).convertToMap() }
-                ?.let { result.success(it) }
-                ?: throw IllegalStateException("Could not get current conference")
+            val conference = VoxeetSDK
+                    .conference()
+                    .conference
+            if (conference != null && VoxeetSDK.conference().isInConference) {
+                result.success(ConferenceMapper(conference).convertToMap())
+            } else {
+                result.success(null)
+            }
         }
     )
 

android/src/main/kotlin/io/dolby/comms/sdk/flutter/module/audio/AudioPreviewNativeModule.kt

@@ -32,7 +32,7 @@ class AudioPreviewNativeModule(private val scope: CoroutineScope) : NativeModule
             ::setCaptureMode.name -> setCaptureMode(call, result)
             ::record.name -> record(call, result)
             ::play.name -> play(call, result)
-            ::cancel.name -> cancel(result)
+            ::stop.name -> stop(result)
             ::release.name -> release(result)
         }
     }
@@ -83,10 +83,10 @@ class AudioPreviewNativeModule(private val scope: CoroutineScope) : NativeModule
         }
     )
 
-    private fun cancel(result: MethodChannel.Result) = scope.launch(
+    private fun stop(result: MethodChannel.Result) = scope.launch(
         onError = result::onError,
         onSuccess = {
-            result.success(VoxeetSDK.audio().local.preview().cancel())
+            result.success(VoxeetSDK.audio().local.preview().stop())
         }
     )
 

ios/Classes/Bindings/AudioPreviewServiceBinding.swift

@@ -9,7 +9,7 @@ class AudioPreviewServiceBinding: Binding {
             do {
                 try self?.nativeEventEmitter.sendEvent(
                     event: EventKeys.statusChanged,
-                    body: DTO.RecorderStatus(recorderStatus: status)
+                    body: DTO.AudioPreviewStatus(audioPreviewStatus: status)
                 )
             } catch {
                 fatalError(error.localizedDescription)
@@ -26,7 +26,7 @@ class AudioPreviewServiceBinding: Binding {
         completionHandler: FlutterMethodCallCompletionHandler
     ) {
         let status = audioPreview().status
-        completionHandler.success(encodable: DTO.RecorderStatus(recorderStatus: status))
+        completionHandler.success(encodable: DTO.AudioPreviewStatus(audioPreviewStatus: status))
     }
 
     /// Retrieves the comfort noise level setting for output devices in Dolby Voice conferences.
@@ -101,16 +101,15 @@ class AudioPreviewServiceBinding: Binding {
         }
     }
 
-    /// If playing or recording is underway calling this method will cancel the ongoing activity.
+    /// If playing or recording is underway calling this method will stop the ongoing activity.
     /// - Parameters:
     ///   - flutterArguments: Method arguments passed from Flutter.
     ///   - completionHandler: Call methods on this instance when execution has finished.
-    public func cancel(
+    public func stop(
         flutterArguments: FlutterMethodCallArguments,
         completionHandler: FlutterMethodCallCompletionHandler
     ) {
-        audioPreview().cancel()
-        completionHandler.success(flutterConvertible: true)
+       completionHandler.success(flutterConvertible: audioPreview().stop())
     }
 
     /// Release the internal memory and restart the audio session configuration.
@@ -144,8 +143,8 @@ extension AudioPreviewServiceBinding: FlutterBinding {
             play(flutterArguments: flutterArguments, completionHandler: completionHandler)
         case "record":
             record(flutterArguments: flutterArguments, completionHandler: completionHandler)
-        case "cancel":
-            cancel(flutterArguments: flutterArguments, completionHandler: completionHandler)
+        case "stop":
+            stop(flutterArguments: flutterArguments, completionHandler: completionHandler)
         case "release":
             release(flutterArguments: flutterArguments, completionHandler: completionHandler)
         default:

ios/Classes/Bindings/ConferenceServiceBinding.swift

@@ -34,14 +34,11 @@ class ConferenceServiceBinding: Binding {
     }
 
     func currentConference(completionHandler: FlutterMethodCallCompletionHandler) {
-        do {
-            guard let conference = VoxeetSDK.shared.conference.current else {
-                throw BindingError.noCurrentConference
-            }
-            completionHandler.success(encodable: DTO.Confrence(conference: conference))
-        } catch {
-            completionHandler.failure(error)
+        guard let conference = VoxeetSDK.shared.conference.current else {
+            completionHandler.success()
+            return
         }
+        completionHandler.success(encodable: DTO.Confrence(conference: conference))
     }
 
     // MARK: - Methods