애플리케이션 가이드

이 페이지에서는 서브그룹 API 사용과 관련된 지침을 제공합니다. 서브그룹 API를 이용하는 애플리케이션을 구현할 때는 아래 항목에 유의해야 합니다.

1. 서브그룹 멤버만 서브그룹에 미디어(오디오, 비디오, 공유 화면)를 보낼 수 있습니다.
   • 서브그룹에 가입하지 않은 참여자는 서브그룹에 미디어를 보내지 못합니다.
2. 서브그룹 멤버만 서브그룹의 미디어(오디오, 비디오, 공유 화면)를 받을 수 있습니다.
   • 서브그룹에 가입하지 않은 참여자는 서브그룹의 미디어를 받지 못합니다.
3. 서브그룹 이름은 NULL 문자를 포함한 길이가 16바이트보다 짧아야 합니다.
4. 서브그룹 이름은 유일해야 합니다.
   • LINE Planet Cloud는 서브그룹 이름을 이용해 각 서브그룹을 구별합니다.
   • subscribe() 메서드를 호출할 때 같은 서브그룹 이름을 인자로 사용하면 같은 서브그룹에 가입됩니다.
5. 서브그룹 속성이 다르면 서브그룹 가입에 실패합니다.
   • 서브그룹 속성은 subscribe() 메서드로 설정하며, 이 메서드는 peerUpdate, videoUpdate, dataSession에 해당하는 파라미터를 받습니다.
   • 같은 서브그룹에 속한 서브그룹 멤버는 반드시 위 파라미터에 같은 값을 사용해야 합니다.
   • 다른 서브그룹 속성을 사용한 참여자가 가입하려고 하면, wrongAttribute라는 PlanetKitSubgroupSubscribeFailReason과 함께 가입에 실패합니다.
   • peerUpdate를 NONE, dataSession을 TRUE로 설정한 조합은 지원하지 않으니 사용하지 마세요. 이렇게 설정하면 wrongAttribute라는 PlanetKitSubgroupSubscribeFailReason과 함께 가입에 실패합니다.
6. 서브그룹 미디어는 각자 독립적입니다.
   • 애플리케이션은 오디오와 비디오를 각각 다른 서브그룹에 전송할 수 있습니다.
7. 서브그룹 개수에는 제한이 있습니다.
   • 서브그룹을 생성하면 LINE Planet Cloud의 리소스를 많이 소비합니다.
   • 그룹 통화당 서브그룹 최대 개수는 30개입니다.
   • 서브그룹 수가 이미 최대에 이르렀다면, overMaxSubgroupCount라는 PlanetKitSubgroupSubscribeFailReason과 함께 가입에 실패합니다.
8. 아래와 같이 어떤 서브그룹에서 미디어가 오고 있는지 확인할 수 있습니다.
   • 오디오: PlanetKit이 현재 활성화된 발언자의 오디오 볼륨과 사용자 ID, 서브그룹 이름을 함께 제공합니다.
   • 비디오: PlanetKitConferencePeer의 currentVideoSubgroupName으로 서브그룹 이름을 얻을 수 있습니다.
   • 화면 공유: PlanetKitConferencePeer의 currentScreenShareSubgroupName으로 서브그룹 이름을 얻을 수 있습니다.
9. 서브그룹에서 탈퇴하기 전에 서브그룹에 보내던 모든 미디어(오디오, 비디오, 공유 화면)를 중지해야 합니다.

관련 문서

서브그룹 기본 개념에 더 많은 정보가 있습니다.