Merge branch 'develop'

Author: skydoves

README.md

@@ -115,6 +115,7 @@ Video roadmap and changelog is available [here](https://github.com/GetStream/pro
 
 ### 0.4.0 milestone
 
+- [X] Screensharing from mobile
 - [ ] Complete Livestreaming APIs and Tutorials for hosting & watching
 - [ ] Android SDK development.md cleanup (Daniel)
 - [ ] Upgrade to more recent versions of webrtc (Kanat)
@@ -131,7 +132,6 @@ Video roadmap and changelog is available [here](https://github.com/GetStream/pro
 
 - [ ] Testing on more devices
 - [ ] Enable SFU switching
-- [ ] Screensharing from mobile
 - [ ] Camera controls
 - [ ] Tap to focus
 - [ ] H264 workaround on Samsung 23 (see https://github.com/livekit/client-sdk-android/blob/main/livekit-android-sdk/src/main/java/io/livekit/android/webrtc/SimulcastVideoEncoderFactoryWrapper.kt#L34 and

buildSrc/src/main/kotlin/io/getstream/video/android/Configuration.kt

@@ -6,9 +6,9 @@ object Configuration {
     const val minSdk = 24
     const val majorVersion = 0
     const val minorVersion = 3
-    const val patchVersion = 2
+    const val patchVersion = 3
     const val versionName = "$majorVersion.$minorVersion.$patchVersion"
-    const val versionCode = 7
+    const val versionCode = 8
     const val snapshotVersionName = "$majorVersion.$minorVersion.${patchVersion + 1}-SNAPSHOT"
     const val artifactGroup = "io.getstream"
     const val streamVideoCallGooglePlayVersion = "1.0.0"

docusaurus/docs/Android/02-tutorials/01-video-calling.mdx

@@ -31,7 +31,7 @@ If you're new to android, note that there are 2 `build.gradle` files, you want t
 ```kotlin
 dependencies {
     // Stream Video Compose SDK
-    implementation("io.getstream:stream-video-android-compose:0.3.2")
+    implementation("io.getstream:stream-video-android-compose:0.3.3")
 
     // Optionally add Jetpack Compose if Android studio didn't automatically include them
     implementation(platform("androidx.compose:compose-bom:2023.08.00"))

docusaurus/docs/Android/02-tutorials/02-audio-room.mdx

@@ -35,7 +35,7 @@ If you're new to android, note that there are 2 `build.gradle` files, you want t
 ```groovy
 dependencies {
     // Stream Video Compose SDK
-    implementation("io.getstream:stream-video-android-compose:0.3.2")
+    implementation("io.getstream:stream-video-android-compose:0.3.3")
 
     // Jetpack Compose (optional/ android studio typically adds them when you create a new project)
     implementation(platform("androidx.compose:compose-bom:2023.08.00"))

docusaurus/docs/Android/02-tutorials/03-livestream.mdx

@@ -35,7 +35,7 @@ If you're new to android, note that there are 2 `build.gradle` files, you want t
 ```kotlin
 dependencies {
     // Stream Video Compose SDK
-    implementation("io.getstream:stream-video-android-compose:0.3.2")
+    implementation("io.getstream:stream-video-android-compose:0.3.3")
 
     // Jetpack Compose (optional/ android studio typically adds them when you create a new project)
     implementation(platform("androidx.compose:compose-bom:2023.08.00"))

docusaurus/docs/Android/06-advanced/04-screen-sharing.mdx

@@ -0,0 +1,57 @@
+---
+title: Screen sharing
+description: Setup for screen sharing
+---
+
+## Introduction
+
+The Stream Video Android SDK has support for screen sharing from an Android device. The SDK is using the [Android Media Projection API](https://developer.android.com/guide/topics/large-screens/media-projection) for the capture.
+
+In order for a user to be able to share their screen, they must have the `screenshare` capability configured for the call they are in.
+
+## How to start sharing your screen
+
+You need to be in an active call (have a `Call` instance in Active call state) to start screen sharing.
+
+You must ask the user for screen sharing permission before you can start sharing the screen. The permission is requested by using the [Media Projection API](https://developer.android.com/guide/topics/large-screens/media-projection). And then use the returned intent data from the permission result and call `Call.startScreenSharing(intentData)`.
+
+An example implementation:
+
+```kotlin
+val startMediaProjection = registerForActivityResult(StartActivityForResult()) { result ->
+   if (it.resultCode == Activity.RESULT_OK && it.data != null) {
+       call.startScreenSharing(it.data!!)
+   }
+}
+
+val mediaProjectionManager = context.getSystemService(MediaProjectionManager::class.java)
+startMediaProjection.launch(mediaProjectionManager.createScreenCaptureIntent())
+```
+
+You can check if screen sharing is currently active by observing `call.screenShare.isEnabled`.
+
+## Stopping screen sharing
+
+Screen sharing can be stopped wit `Call.stopScreenSharing()`. It is automatically stopped if the call state goes into Inactive state.
+
+The user can also disable screen sharing directly in the system settings (depending on the OEM there is usually a button in the notification bar for disabling screen sharing).
+
+And the screen sharing can also be disabled through the screen sharing notification action button (described in next section).
+
+## Screen sharing notification
+
+A notification is always displayed to the user when the screen sharing is active. The notification itself can't be hidden and is required by the Android OS. The notification title and description can be customised.
+
+Override string `stream_video_screen_sharing_notification_title` and `stream_video_screen_sharing_notification_description` to customise the notification text.
+
+There is also a "Stop screen sharing" action button on the notification, the text of the button can be modified by overriding `stream_video_screen_sharing_notification_action_stop`.
+
+All notifications in Android need to have a notification channel. The Stream Video Android SDK will automatically create a new channel for the screen sharing notification. You can customise the channel title and description (this is visible to the user in the system application settings). Override `stream_video_screen_sharing_notification_channel_title` and `stream_video_screen_sharing_notification_channel_description`.
+
+```xml
+<string name="stream_video_screen_sharing_notification_title">You are screen sharing</string>
+<string name="stream_video_screen_sharing_notification_description"></string>
+<string name="stream_video_screen_sharing_notification_action_stop">Stop screen sharing</string>
+<string name="stream_video_screen_sharing_notification_channel_title">Screen-sharing</string>
+<string name="stream_video_screen_sharing_notification_channel_description">Required to be enabled for screen sharing</string>
+```

…droid/06-advanced/04-chat-with-video.mdx …droid/06-advanced/05-chat-with-video.mdxdocusaurus/docs/Android/06-advanced/04-chat-with-video.mdx renamed to docusaurus/docs/Android/06-advanced/05-chat-with-video.mdx docusaurus/docs/Android/06-advanced/04-chat-with-video.mdx renamed to docusaurus/docs/Android/06-advanced/05-chat-with-video.mdx

@@ -31,7 +31,7 @@ Let the project sync. It should have all the dependencies required for you to fi
 ```groovy
 dependencies {
     // Stream Video Compose SDK
-    implementation("io.getstream:stream-video-android-compose:0.3.2")
+    implementation("io.getstream:stream-video-android-compose:0.3.3")
     
     // Stream Chat
     implementation(libs.stream.chat.compose)

…ocs/Android/06-advanced/06-recording.mdx …ocs/Android/06-advanced/07-recording.mdxdocusaurus/docs/Android/06-advanced/06-recording.mdx renamed to docusaurus/docs/Android/06-advanced/07-recording.mdx docusaurus/docs/Android/06-advanced/06-recording.mdx renamed to docusaurus/docs/Android/06-advanced/07-recording.mdx

@@ -16,7 +16,11 @@
 
 package io.getstream.video.android.ui.call
 
+import android.app.Activity
+import android.media.projection.MediaProjectionManager
 import android.widget.Toast
+import androidx.activity.compose.rememberLauncherForActivityResult
+import androidx.activity.result.contract.ActivityResultContracts
 import androidx.compose.foundation.background
 import androidx.compose.foundation.clickable
 import androidx.compose.foundation.layout.Column
@@ -29,6 +33,8 @@ import androidx.compose.material.Card
 import androidx.compose.material.Icon
 import androidx.compose.material.Text
 import androidx.compose.runtime.Composable
+import androidx.compose.runtime.collectAsState
+import androidx.compose.runtime.getValue
 import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
@@ -54,6 +60,21 @@ internal fun SettingsMenu(
     val reactions =
         listOf(":fireworks:", ":hello:", ":raise-hand:", ":like:", ":hate:", ":smile:", ":heart:")
 
+    val screenSharePermissionResult = rememberLauncherForActivityResult(
+        contract = ActivityResultContracts.StartActivityForResult(),
+        onResult = {
+            if (it.resultCode == Activity.RESULT_OK && it.data != null) {
+                call.startScreenSharing(it.data!!)
+            }
+            onDismissed.invoke()
+        },
+    )
+
+    val isScreenSharing by call.screenShare.isEnabled.collectAsState()
+    val screenShareButtonText = if (isScreenSharing) {
+        "Stop screen-sharing"
+    } else { "Start screen-sharing" }
+
     Popup(
         alignment = Alignment.BottomStart,
         offset = IntOffset(30, -200),
@@ -92,6 +113,37 @@ internal fun SettingsMenu(
 
                 Spacer(modifier = Modifier.height(12.dp))
 
+                Row(
+                    modifier = Modifier.clickable {
+                        if (!isScreenSharing) {
+                            scope.launch {
+                                val mediaProjectionManager = context.getSystemService(
+                                    MediaProjectionManager::class.java,
+                                )
+                                screenSharePermissionResult.launch(
+                                    mediaProjectionManager.createScreenCaptureIntent(),
+                                )
+                            }
+                        } else {
+                            call.stopScreenSharing()
+                        }
+                    },
+                ) {
+                    Icon(
+                        painter = painterResource(id = R.drawable.stream_video_ic_screensharing),
+                        tint = VideoTheme.colors.textHighEmphasis,
+                        contentDescription = null,
+                    )
+
+                    Text(
+                        modifier = Modifier.padding(start = 20.dp),
+                        text = screenShareButtonText,
+                        color = VideoTheme.colors.textHighEmphasis,
+                    )
+                }
+
+                Spacer(modifier = Modifier.height(12.dp))
+
                 if (showDebugOptions) {
                     Row(
                         modifier = Modifier.clickable {