프레젠테이션 - 화면 공유

프레젠테이션이란 발표자가 다른 참여자에게 슬라이드 같은 자료를 보여주기 위해 자신의 화면을 공유하는 것을 말합니다. 이 페이지에서는 통화 유형에 따라 프레젠테이션 기능을 사용하는 방법을 설명합니다.

지원 통화 유형	최소 SDK 버전
1대1 통화, 그룹 통화(컨퍼런스)	WebPlanetKit 3.1

Note

PlanetKit은 프레젠테이션에 HD 비디오를 지원하므로, 클라이언트의 네트워크 상태가 좋아야 합니다. 상세한 정보는 네크워크 요구사항을 참고하세요.

1대1 통화 프레젠테이션

발표자는 Call의 startMyScreenShare()와 stopMyScreenShare()를 호출해 프레젠테이션을 시작하거나 종료할 시점을 결정합니다.

관련 API

1대1 통화에서 화면 공유와 관련된 API는 다음과 같습니다. 여기서 카운터파트란 프레젠테이션을 보여줄 피어를 말합니다.

발표자 측 API	설명	카운터파트 측 API	설명
startMyScreenShare()	발표자가 화면 공유 시작	MakeCallDelegate의 evtPeerScreenShareStarted VerifyCallDelegate의 evtPeerScreenShareStarted	발표자의 화면 공유가 시작됨
-	-	addPeerScreenShareView()	애플리케이션이 생성한 뷰 인스턴스를 설정
stopMyScreenShare()	발표자가 화면 공유 종료	MakeCallDelegate의 evtPeerScreenShareStopped VerifyCallDelegate의 evtPeerScreenShareStopped	발표자의 화면 공유가 종료됨
-	-	removePeerScreenShareView()	해제 전에 뷰 인스턴스 제거

카운터파트 측에서는 evtPeerScreenShareStarted 이벤트를 받아 프레젠테이션이 시작되었음을 알게 되면 반드시 뷰 인스턴스를 생성하고 addPeerScreenShareView()를 호출해 PlanetKit이 화면을 렌더링하게 해야 합니다.

프레젠테이션 비디오 데이터는 자동으로 피어에게 스트리밍됩니다.

1대1 통화 프레젠테이션 흐름

1대1 통화에서 프레젠테이션을 시작하는 흐름은 다음과 같습니다.

1대1 통화에서 프레젠테이션을 중지하는 흐름은 다음과 같습니다.

Note

네이티브 PlanetKit과 달리 WebPlanetKit은 화면 공유 종료의 이유를 전달하는 기능을 지원하지 않습니다.

그룹 통화 프레젠테이션

발표자는 Conference의 startMyScreenShare()와 stopMyScreenShare()를 호출해 프레젠테이션을 시작하거나 종료할 시점을 결정합니다.

관련 API

그룹 통화에서 화면 공유와 관련된 API는 다음과 같습니다. 여기서 카운터파트란 그룹 통화에서 프레젠테이션을 보여줄 참여자를 말합니다.

발표자 측 API	설명	카운터파트 측 API	설명
startMyScreenShare()	발표자가 화면 공유 시작	evtPeerScreenShareStarted	발표자의 화면 공유가 시작됨
-	-	addPeerScreenShareView()	애플리케이션이 생성한 뷰 인스턴스를 설정
stopMyScreenShare()	발표자가 화면 공유 종료	evtPeerScreenShareStopped	발표자의 화면 공유가 종료됨
-	-	removePeerScreenShareView()	해제 전에 뷰 인스턴스 제거

evtPeerScreenShareStarted 이벤트를 받아 프레젠테이션이 시작되었음을 알게 되면, 카운터파트는 반드시 뷰 인스턴스를 생성하고 addPeerScreenShareView()를 호출해 PlanetKit이 화면을 렌더링하게 해야 합니다.

그룹 통화 프레젠테이션 흐름

그룹 통화에서 프레젠테이션을 시작하는 흐름은 다음과 같습니다.

그룹 통화에서 프레젠테이션을 중지하는 흐름은 다음과 같습니다.

그룹 통화에서 프레젠테이션이 시작된 후 참여한 사용자의 흐름은 다음과 같습니다.

관련 문서

• 그룹 통화 흐름

관련 예제 코드

• 1대1 통화 화면 공유
• 그룹 통화 화면 공유