[AND-143] Integrate the Telecom Framework

gradle/libs.versions.toml

@@ -22,6 +22,8 @@ androidxLifecycle = "2.8.6"
 androidxStartup = "1.2.0"
 androidxActivity = "1.9.2"
 androidxDataStore = "1.1.1"
+androidxCoreTelecom = "1.0.0-beta01"
+
 googleService = "4.4.2"
 
 androidxComposeBom = "2024.11.00"
@@ -86,6 +88,7 @@ androidx-camera-camera2 = { module = "androidx.camera:camera-camera2", version.r
 androidx-material = { group = "com.google.android.material", name = "material", version.ref = "androidxMaterial" }
 androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "androidxAppCompat" }
 androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "androidxCore" }
+androidx-core-telecom = { group = "androidx.core", name = "core-telecom", version.ref = "androidxCoreTelecom" }
 androidx-activity = { group = "androidx.activity", name = "activity-ktx", version.ref = "androidxActivity" }
 androidx-annotation = { group = "androidx.annotation", name = "annotation", version.ref = "androidxAnnotation" }
 androidx-constraintlayout = { group = "androidx.constraintlayout", name = "constraintlayout", version.ref = "androidxContraintLayout" }

stream-video-android-core/api/stream-video-android-core.api

@@ -296,7 +296,7 @@ public final class io/getstream/video/android/core/ClientState {
 	public final fun handleEvent (Lorg/openapitools/client/models/VideoEvent;)V
 	public final fun hasActiveOrRingingCall ()Z
 	public final fun removeActiveCall ()V
-	public final fun removeRingingCall ()V
+	public final fun removeRingingCall (Z)V
 	public final fun setActiveCall (Lio/getstream/video/android/core/Call;)V
 }
 
@@ -894,14 +894,15 @@ public abstract interface class io/getstream/video/android/core/api/SignalServer
 }
 
 public abstract interface class io/getstream/video/android/core/audio/AudioHandler {
+	public abstract fun selectDevice (Lio/getstream/video/android/core/audio/StreamAudioDevice;)V
 	public abstract fun start ()V
 	public abstract fun stop ()V
 }
 
 public final class io/getstream/video/android/core/audio/AudioSwitchHandler : io/getstream/video/android/core/audio/AudioHandler {
 	public static final field Companion Lio/getstream/video/android/core/audio/AudioSwitchHandler$Companion;
 	public fun <init> (Landroid/content/Context;Lkotlin/jvm/functions/Function2;)V
-	public final fun selectDevice (Lcom/twilio/audioswitch/AudioDevice;)V
+	public fun selectDevice (Lio/getstream/video/android/core/audio/StreamAudioDevice;)V
 	public fun start ()V
 	public fun stop ()V
 }
@@ -912,21 +913,25 @@ public final class io/getstream/video/android/core/audio/AudioSwitchHandler$Comp
 public abstract class io/getstream/video/android/core/audio/StreamAudioDevice {
 	public static final field Companion Lio/getstream/video/android/core/audio/StreamAudioDevice$Companion;
 	public static final fun fromAudio (Lcom/twilio/audioswitch/AudioDevice;)Lio/getstream/video/android/core/audio/StreamAudioDevice;
-	public abstract fun getAudio ()Lcom/twilio/audioswitch/AudioDevice;
+	public abstract fun getAudioSwitchDevice ()Lcom/twilio/audioswitch/AudioDevice;
 	public abstract fun getName ()Ljava/lang/String;
+	public abstract fun getTelecomDevice ()Landroidx/core/telecom/CallEndpointCompat;
 	public static final fun toAudioDevice (Lio/getstream/video/android/core/audio/StreamAudioDevice;)Lcom/twilio/audioswitch/AudioDevice;
 }
 
 public final class io/getstream/video/android/core/audio/StreamAudioDevice$BluetoothHeadset : io/getstream/video/android/core/audio/StreamAudioDevice {
-	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)V
-	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> ()V
+	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)V
+	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun component2 ()Lcom/twilio/audioswitch/AudioDevice;
-	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)Lio/getstream/video/android/core/audio/StreamAudioDevice$BluetoothHeadset;
-	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$BluetoothHeadset;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$BluetoothHeadset;
+	public final fun component3 ()Landroidx/core/telecom/CallEndpointCompat;
+	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)Lio/getstream/video/android/core/audio/StreamAudioDevice$BluetoothHeadset;
+	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$BluetoothHeadset;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$BluetoothHeadset;
 	public fun equals (Ljava/lang/Object;)Z
-	public fun getAudio ()Lcom/twilio/audioswitch/AudioDevice;
+	public fun getAudioSwitchDevice ()Lcom/twilio/audioswitch/AudioDevice;
 	public fun getName ()Ljava/lang/String;
+	public fun getTelecomDevice ()Landroidx/core/telecom/CallEndpointCompat;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
@@ -937,43 +942,52 @@ public final class io/getstream/video/android/core/audio/StreamAudioDevice$Compa
 }
 
 public final class io/getstream/video/android/core/audio/StreamAudioDevice$Earpiece : io/getstream/video/android/core/audio/StreamAudioDevice {
-	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)V
-	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> ()V
+	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)V
+	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun component2 ()Lcom/twilio/audioswitch/AudioDevice;
-	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Earpiece;
-	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$Earpiece;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Earpiece;
+	public final fun component3 ()Landroidx/core/telecom/CallEndpointCompat;
+	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Earpiece;
+	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$Earpiece;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Earpiece;
 	public fun equals (Ljava/lang/Object;)Z
-	public fun getAudio ()Lcom/twilio/audioswitch/AudioDevice;
+	public fun getAudioSwitchDevice ()Lcom/twilio/audioswitch/AudioDevice;
 	public fun getName ()Ljava/lang/String;
+	public fun getTelecomDevice ()Landroidx/core/telecom/CallEndpointCompat;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
 
 public final class io/getstream/video/android/core/audio/StreamAudioDevice$Speakerphone : io/getstream/video/android/core/audio/StreamAudioDevice {
-	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)V
-	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> ()V
+	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)V
+	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun component2 ()Lcom/twilio/audioswitch/AudioDevice;
-	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Speakerphone;
-	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$Speakerphone;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Speakerphone;
+	public final fun component3 ()Landroidx/core/telecom/CallEndpointCompat;
+	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Speakerphone;
+	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$Speakerphone;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$Speakerphone;
 	public fun equals (Ljava/lang/Object;)Z
-	public fun getAudio ()Lcom/twilio/audioswitch/AudioDevice;
+	public fun getAudioSwitchDevice ()Lcom/twilio/audioswitch/AudioDevice;
 	public fun getName ()Ljava/lang/String;
+	public fun getTelecomDevice ()Landroidx/core/telecom/CallEndpointCompat;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
 
 public final class io/getstream/video/android/core/audio/StreamAudioDevice$WiredHeadset : io/getstream/video/android/core/audio/StreamAudioDevice {
-	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)V
-	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> ()V
+	public fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)V
+	public synthetic fun <init> (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ljava/lang/String;
 	public final fun component2 ()Lcom/twilio/audioswitch/AudioDevice;
-	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;)Lio/getstream/video/android/core/audio/StreamAudioDevice$WiredHeadset;
-	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$WiredHeadset;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$WiredHeadset;
+	public final fun component3 ()Landroidx/core/telecom/CallEndpointCompat;
+	public final fun copy (Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;)Lio/getstream/video/android/core/audio/StreamAudioDevice$WiredHeadset;
+	public static synthetic fun copy$default (Lio/getstream/video/android/core/audio/StreamAudioDevice$WiredHeadset;Ljava/lang/String;Lcom/twilio/audioswitch/AudioDevice;Landroidx/core/telecom/CallEndpointCompat;ILjava/lang/Object;)Lio/getstream/video/android/core/audio/StreamAudioDevice$WiredHeadset;
 	public fun equals (Ljava/lang/Object;)Z
-	public fun getAudio ()Lcom/twilio/audioswitch/AudioDevice;
+	public fun getAudioSwitchDevice ()Lcom/twilio/audioswitch/AudioDevice;
 	public fun getName ()Ljava/lang/String;
+	public fun getTelecomDevice ()Landroidx/core/telecom/CallEndpointCompat;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
@@ -4417,14 +4431,14 @@ public class io/getstream/video/android/core/notifications/DefaultNotificationHa
 	public fun isInForeground ()Z
 	public fun maybeCreateChannel (Ljava/lang/String;Landroid/content/Context;Lkotlin/jvm/functions/Function1;)V
 	public static synthetic fun maybeCreateChannel$default (Lio/getstream/video/android/core/notifications/DefaultNotificationHandler;Ljava/lang/String;Landroid/content/Context;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
+	public fun onIncomingCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public fun onLiveCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public fun onMissedCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public fun onNotification (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public fun onPermissionDenied ()V
 	public fun onPermissionGranted ()V
 	public fun onPermissionRationale ()V
 	public fun onPermissionRequested ()V
-	public fun onRingingCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public fun showLiveCallNotification (Landroid/app/PendingIntent;Ljava/lang/String;I)V
 	public fun showMissedCallNotification (Landroid/app/PendingIntent;Ljava/lang/String;I)V
 	public fun showNotificationCallNotification (Landroid/app/PendingIntent;Ljava/lang/String;I)V
@@ -4496,10 +4510,10 @@ public abstract interface class io/getstream/video/android/core/notifications/No
 	public abstract fun getRingingCallNotification (Lio/getstream/video/android/core/RingingState;Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;Z)Landroid/app/Notification;
 	public static synthetic fun getRingingCallNotification$default (Lio/getstream/video/android/core/notifications/NotificationHandler;Lio/getstream/video/android/core/RingingState;Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;ZILjava/lang/Object;)Landroid/app/Notification;
 	public abstract fun getSettingUpCallNotification ()Landroid/app/Notification;
+	public abstract fun onIncomingCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public abstract fun onLiveCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public abstract fun onMissedCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 	public abstract fun onNotification (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
-	public abstract fun onRingingCall (Lio/getstream/video/android/model/StreamCallId;Ljava/lang/String;)V
 }
 
 public final class io/getstream/video/android/core/notifications/NotificationHandler$Companion {
@@ -5324,6 +5338,13 @@ public final class io/getstream/video/android/core/socket/sfu/state/SfuSocketSta
 	public fun toString ()Ljava/lang/String;
 }
 
+public final class io/getstream/video/android/core/sounds/CallSoundPlayer {
+	public fun <init> (Landroid/content/Context;)V
+	public final fun cleanUpAudioResources ()V
+	public final fun playCallSound (Landroid/net/Uri;)V
+	public final fun stopCallSound ()V
+}
+
 public abstract interface class io/getstream/video/android/core/sounds/RingingConfig {
 	public abstract fun getIncomingCallSoundUri ()Landroid/net/Uri;
 	public abstract fun getOutgoingCallSoundUri ()Landroid/net/Uri;
@@ -5349,6 +5370,16 @@ public final class io/getstream/video/android/core/sounds/Sounds {
 	public fun toString ()Ljava/lang/String;
 }
 
+public final class io/getstream/video/android/core/telecom/TelecomEvent : java/lang/Enum {
+	public static final field ANSWER Lio/getstream/video/android/core/telecom/TelecomEvent;
+	public static final field DISCONNECT Lio/getstream/video/android/core/telecom/TelecomEvent;
+	public static final field SET_ACTIVE Lio/getstream/video/android/core/telecom/TelecomEvent;
+	public static final field SET_INACTIVE Lio/getstream/video/android/core/telecom/TelecomEvent;
+	public static fun getEntries ()Lkotlin/enums/EnumEntries;
+	public static fun valueOf (Ljava/lang/String;)Lio/getstream/video/android/core/telecom/TelecomEvent;
+	public static fun values ()[Lio/getstream/video/android/core/telecom/TelecomEvent;
+}
+
 public final class io/getstream/video/android/core/utils/AndroidUtilsKt {
 	public static final fun shouldShowRequestPermissionsRationale (Landroid/app/Activity;[Ljava/lang/String;)Z
 }

stream-video-android-core/build.gradle.kts

@@ -148,6 +148,7 @@ dependencies {
     implementation(libs.androidx.core.ktx)
     implementation(libs.androidx.lifecycle.runtime)
     implementation(libs.androidx.lifecycle.process)
+    implementation(libs.androidx.core.telecom)
 
     // coroutines
     implementation(libs.kotlinx.coroutines.core)

stream-video-android-core/src/main/kotlin/io/getstream/video/android/core/Call.kt

@@ -337,9 +337,7 @@ public class Call(
 
         response.onSuccess {
             state.updateFromResponse(it)
-            if (ring) {
-                client.state.addRingingCall(this, RingingState.Outgoing())
-            }
+            if (ring) client.state.addRingingCall(this, RingingState.Outgoing())
         }
         return response
     }
@@ -375,9 +373,9 @@ public class Call(
             clientImpl.permissionCheck.checkAndroidPermissions(clientImpl.context, this)
         // Check android permissions and log a warning to make sure developers requested adequate permissions prior to using the call.
         if (!permissionPass) {
-            logger.w {
+            logger.d {
                 "\n[Call.join()] called without having the required permissions.\n" +
-                    "This will work only if you have [runForegroundServiceForCalls = false] in the StreamVideoBuilder.\n" +
+                    "This will work only if you set [runCallServiceInForeground = false] in StreamVideoBuilder.build().\n" +
                     "The reason is that [Call.join()] will by default start an ongoing call foreground service,\n" +
                     "To start this service and send the appropriate audio/video tracks the permissions are required,\n" +
                     "otherwise the service will fail to start, resulting in a crash.\n" +
@@ -508,6 +506,7 @@ public class Call(
     private fun Call.monitorSession(result: JoinCallResponse) {
         sfuEvents?.cancel()
         sfuListener?.cancel()
+
         startCallStatsReporting(result.statsOptions.reportingIntervalMs.toLong())
         // listen to Signal WS
         sfuEvents = scope.launch {
@@ -797,7 +796,7 @@ public class Call(
         camera.disable()
         microphone.disable()
         client.state.removeActiveCall() // Will also stop CallService
-        client.state.removeRingingCall()
+        client.state.removeRingingCall(willTransitionToOngoing = false)
         cleanup()
     }
 
@@ -1220,8 +1219,7 @@ public class Call(
         logger.d { "[accept] #ringing; no args" }
         state.acceptedOnThisDevice = true
 
-        clientImpl.state.removeRingingCall()
-        clientImpl.state.maybeStopForegroundService(call = this)
+        clientImpl.state.removeRingingCall(willTransitionToOngoing = true)
         return clientImpl.accept(type, id)
     }
 

stream-video-android-core/src/main/kotlin/io/getstream/video/android/core/CallState.kt

@@ -1476,4 +1476,4 @@ private fun getCallingMethod(): String {
     }
 }
 
-private const val REJECT_REASON_TIMEOUT = "timeout"
+internal const val REJECT_REASON_TIMEOUT = "timeout"