데이터 및 메시지 기능 개요

PlanetKit은 미디어 스트림 이외의 데이터나 메시지를 보내고 받기 위한 다양한 기능을 제공합니다. PlanetKit에서 제공하는 데이터 및 메시지 기능의 특징은 아래와 같습니다. 기능별 상세 정보는 링크된 문서를 참고하시기 바랍니다.

기능	지원 통화 및 사용자 유형	사용 시점	사용 예시
앱 서버 데이터	1대1 통화(발신자), 그룹 통화	콜 셋업	앱 서버 데이터는 클라이언트가 애플리케이션 서버로 전송하는 데이터입니다. 주로 애플리케이션에서 통화 관련 모니터링을 하고자 할 때 활용할 수 있습니다. 예를 들어 애플리케이션 버전별 그룹 통화 참여 수를 분석하고 싶다면, 앱 서버 데이터에 애플리케이션 버전을 담아서 전송하도록 설계할 수 있습니다.
짧은 데이터 전송	1대1 통화(발신자, 착신자), 그룹 통화	콜 셋업 완료 후	짧은 데이터 전송을 이용하면 애플리케이션에서 아주 간단하게 통화 상대방들에게 짧은 메시지를 전송할 수 있습니다. 매우 간헐적(예: 최소 30초 간격)으로 혹은 특정 조건 하에서 적은 비용으로 메시지나 데이터를 전송하고 싶다면 짧은 데이터 전송을 활용하세요. 예를 들어 그룹 통화 중 사용자의 상태 메시지(자리 비움/바쁨)를 정해진 형식으로 주기적으로 알리고자 하는 상황에서 유용하게 사용할 수 있습니다. 다만 메시지 길이에 제약이 있기 때문에 긴 메시지를 보내야 한다면 데이터 세션을 사용하는 것을 추천합니다. 또한 내부적으로 트랜잭션을 관리하며 데이터 전송 여부 확인 후 몇 차례 재전송을 시도하기는 하지만, 기본적으로 데이터 전송 신뢰성을 제공하지는 않습니다.
콘텐츠 공유	1대1 통화(발신자, 착신자), 그룹 통화	콜 셋업 완료 후	콘텐츠 공유는 시간의 흐름에 따라 달라지는 데이터를 통화 상대방들과 공유하고자 할 때 사용합니다. 콘텐츠 공유를 사용해 공유한 데이터가 변경되면 공유 대상자들에게 이벤트가 발생합니다. 공유 대상 데이터는 콘텐츠 공유 유형에 따라 공유 대상자가 각자 갖고 있을 수도 있고(일반 공유), 해당 방에 하나만 존재할 수도 있습니다(독점적 공유, 방 범위 공유). 독점적 공유의 경우 콘텐츠 공유를 요청한 사람만 데이터를 수정할 수 있으며, 방 범위 공유의 경우 모든 그룹방 참여자가 수정할 수 있습니다. 콘텐츠 공유는 데이터가 업데이트된 후 경과한 시간을 정보로 제공합니다. 애플리케이션은 시간 변화에 따른 데이터가 필요할 때 이를 활용할 수 있는데요. 예를 들어 한 참여자가 영상 재생(예: YouTube 같이 보기)을 공유한 뒤 다른 참여자가 뒤늦게 해당 방에 입장했다면, 콘텐츠 공유 기능이 제공하는 경과 시간 정보를 이용해 현재 다른 참여자가 영상의 어느 부분을 보고 있는지 파악해서 어느 시점부터 재생해야 할지 알 수 있습니다.