1대1 통화 화면 공유
1대1 통화에서 화면 공유를 구현하는 예제 코드입니다.
여기서는 MediaProjection API를 사용하여 서비스에서 화면 공유 기능을 구현하는 방법을 설명합니다. 이 구현은 앱이 백그라운드에 있는 경우에도 화면 공유를 유지할 수 있도록 지원합니다.
필수 조건
시작하기 전에 다음 작업을 수행해야 합니다.
필수 권한 추가
AndroidManifest.xml에 다음 권한을 포함시키세요.
<!-- For Foreground Service -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- For Screen Capture on Android 14+ -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
포그라운드 서비스 등록
앱이 백그라운드 상태에서도 화면 공유를 유지하도록 mediaProjection 포그라운드 서비스 유형을 지정하여 서비스를 선언하세요.
<service
android:name=".MyScreenCaptureService"
android:foregroundServiceType="mediaProjection" />
Tip
포그라운드 서비스와 관련된 더 자세한 정보는 Android 공식 문서(Foreground services, Foreground service types are required)를 참조하세요.
송신 측 - 화면 캡처 서비스 구현
이 서비스는 MediaProjection을 사용하여 화면 캡처의 시작 및 중지 작업을 처리하고 1대1 통화와 연동합니다.
class MyScreenCaptureService : Service() {
companion object {
private const val SCREEN_CAPTURE_ID = "Screen capture"
// This can be any dummy number
private const val NOTIFICATION_ID = 315
private const val ACTION_START_SCREEN_CAPTURE = "ACTION_START_SCREEN_CAPTURE"
private const val ACTION_STOP_SCREEN_CAPTURE = "ACTION_STOP_SCREEN_CAPTURE"
private var callInstanceId:Int = 0
private lateinit var mediaProjectionResult:ActivityResult
@Synchronized
@JvmStatic
fun startScreenCapturing(context: Context, instanceId:Int, projectionPermissionResult: ActivityResult) {
val intent = Intent(context, MyScreenCaptureService::class.java).apply {
action = ACTION_START_SCREEN_CAPTURE
this@Companion.callInstanceId = instanceId
mediaProjectionResult = projectionPermissionResult
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
context.startForegroundService(intent)
} else {
context.startService(intent)
}
}
@Synchronized
@JvmStatic
fun stopScreenCapturing(context: Context) {
val intent = Intent(context, MyScreenCaptureService::class.java).apply {
action = ACTION_STOP_SCREEN_CAPTURE
}
context.startService(intent)
}
}
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
val action = intent?.action ?: return START_NOT_STICKY
when (action) {
ACTION_START_SCREEN_CAPTURE -> {
onScreenShareStarted()
}
ACTION_STOP_SCREEN_CAPTURE -> {
onScreenShareStopped()
}
}
return START_NOT_STICKY
}
private fun onScreenShareStarted() {
val notification = createNotification()
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
startForeground(NOTIFICATION_ID, notification, ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION)
} else {
startForeground(NOTIFICATION_ID, notification)
}
mediaProjectionResult.data?.let { data ->
val screenSource = ScreenCapturerVideoSource.getInstance(mediaProjectionResult.resultCode, data)
screenSource.setOnErrorListener { onScreenShareStopped() }
PlanetKit.getCall(callInstanceId)?.let {
it.startMyScreenShare(screenSource) { response ->
if (!response.isSuccessful) {
onScreenShareStopped()
}
}
}
}
}
private fun onScreenShareStopped() {
PlanetKit.getCall(callInstanceId)?.stopMyScreenShare()
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
stopForeground(STOP_FOREGROUND_REMOVE)
}
stopSelf()
}
private fun createNotification(): Notification {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
val channel = NotificationChannel(
SCREEN_CAPTURE_ID,
SCREEN_CAPTURE_ID,
NotificationManager.IMPORTANCE_NONE
)
// Register the channel with the system
val notificationManager =
getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
notificationManager.createNotificationChannel(channel)
}
return NotificationCompat.Builder(
this,
SCREEN_CAPTURE_ID
)
.setSmallIcon(R.drawable.ic_stat_name)
.setContentTitle("Screen share in progress")
.setPriority(NotificationCompat.PRIORITY_LOW)
.setCategory(NotificationCompat.CATEGORY_SERVICE)
.build()
}
}
송신 측 - 액티비티에서 화면 캡처 관리
이 액티비티는 화면 캡처 권한을 요청하고 서비스를 시작하거나 중지하는 방법을 보여줍니다.
class MyCallActivity : AppCompatActivity() {
private var callInstanceId: Int = 0
private val requestMediaProjectionActivityResultLauncher: ActivityResultLauncher<Intent> =
registerForActivityResult(
ActivityResultContracts.StartActivityForResult()
) { projectionPermissionResult: ActivityResult ->
val data = projectionPermissionResult.data
if (projectionPermissionResult.resultCode != RESULT_OK || data == null) {
return@registerForActivityResult
}
MyScreenCaptureService.startScreenCapturing(this, callInstanceId, projectionPermissionResult)
}
private fun requestMyScreenCapture(call: PlanetKitCall) {
callInstanceId = call.instanceId
val mediaProjectionManager =
getSystemService(MEDIA_PROJECTION_SERVICE) as MediaProjectionManager
// This initiates a prompt dialog for the user to confirm screen projection.
requestMediaProjectionActivityResultLauncher.launch(mediaProjectionManager.createScreenCaptureIntent())
}
fun stopMyScreenCapture(context: Context) {
MyScreenCaptureService.stopScreenCapturing(context)
}
}
수신 측 - 화면 공유 업데이트 이벤트 수신
우선 CallListener의 onPeerScreenShareStarted 또는 onPeerScreenShareStopped 이벤트를 통해 피어의 화면 공유가 시작 혹은 중지됐는지 확인합니다.
private val makeAcceptCallListener = object : MakeCallListener, AcceptCallListener {
override fun onPeerScreenShareStarted(call: PlanetKitCall) {
// Add your own implementation.
...
}
override fun onPeerScreenShareStopped(call: PlanetKitCall, hasReason: Boolean, reason: Int) {
// Add your own implementation.
...
}
...
}
수신 측 - 피어의 화면 공유 비디오 렌더링
onPeerScreenShareStarted 이벤트가 발생한 후 PlanetKitVideoView를 추가하여 공유 화면을 표시할 수 있습니다.
var videoView: PlanetKitVideoView
call.addPeerScreenShareView(videoView)
수신 측 - 피어의 화면 공유 비디오 제거 또는 뷰 숨기기
피어의 공유 화면을 렌더링하지 않으려면 PlanetKitCall에서 PlanetKitVideoView를 제거하거나 보이지 않도록 숨깁니다.
-
PlanetKitVideoView제거var videoView: PlanetKitVideoView
call.removePeerScreenShareView(videoView) -
PlanetKitVideoView숨기기var videoView: PlanetKitVideoView
videoView.isVisible = false