미디어 통계
PlanetKit SDK는 최근의 미디어 통계를 유지하기 위해 PlanetKitStatistics를 제공합니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | 1대1 통화: 0.8 그룹 통화, 화면 공유: 0.9 |
미디어 통계 개요
미디어 통계는 SDK 내부적으로 200 밀리초마다 업데이트하므로, 애플리케이션은 최신 통계를 읽어 이와 관련된 UI를 주기적으로 갱신할 수 있습니다.
단, 읽는 간격이 통계 업데이트 주기인 200 밀리초보다 짧으면 변경 내용이 없을 수도 있으므로 주의하세요. 갱신 간격을 어떻게 정해야 할지 확실하지 않다면 1000 밀리초로 설정하기를 권장합니다.
PlanetKitStatistics는 스트림 유형별로 제공됩니다. 아래 표는 각 스트림 유형에 대해 제공하는 통계 정보입니다.
| 스트림 유형 | 패킷 손실 비율 (0~1) | 네트워크 지터 (msec) | 비트레이트 (bps) | 레이턴시 (msec) | 비디오 해상도 (가로 x 세로) | 비디오 FPS (초당 프레임) |
|---|---|---|---|---|---|---|
| 오디오 수신 | 제공 | 제공 | 제공 | 제공 | 미제공 | 미제공 |
| 오디오 전송 | 제공 | 제공 | 제공 | 제공 | 미제공 | 미제공 |
| 비디오 수신 | 제공 | 제공 | 제공 | 제공 | 제공 | 제공 |
| 비디오 전송 | 제공 | 제공 | 제공 | 제공 | 제공 | 제공 |
| 화면 공유 수신 | 제공 | 제공 | 제공 | 제공 | 제공 | 제공 |
| 화면 공유 전송 | 제공 | 제공 | 제공 | 제공 | 제공 | 제공 |
미디어 통계 활성화
미디어 통계를 활성화하려면 통화 유형에 따라 다음 설정을 적용하세요.
- 미디어 통계는 기본적으로 비활성화되어 있습니다.
- 미디어 통계 관련 API에 대한 자세한 내용은 API 레퍼런스를 참고하세요.
1대1 통화
발신자 측에서 미디어 통계를 활성화하려면 makeCall()을 호출하기 전에 PlanetKitMakeCallParamBuilder에서 setEnableStatistics(true)로 설정하세요.
착신자 측에서 미디어 통계를 활성화하려면 verifyCall()을 호출하기 전에 PlanetKitVerifyCallParamBuilder에서 setEnableStatistics(true)로 설정하세요.
그룹 통화
그룹 통화에서 미디어 통계를 활성화하려면 joinConference()를 호출하기 전에 PlanetKitJoinConferenceParamBuilder에서 setEnableStatistics(true)로 설정하세요.
미디어 통계 획득
1대1 통화
미디어 통계를 얻으려면 PlanetKitCall의 getStatistics()를 호출하세요.
그룹 통화
미디어 통계를 얻으려면 PlanetKitConference의 getStatistics()를 호출하세요.
관련 API
미디어 통계 기능과 관련된 API는 다음과 같습니다.
클래스
메서드
1대1 통화
-
PlanetKitMakeCallParamBuilder의setEnableStatistics() -
PlanetKitVerifyCallParamBuilder의setEnableStatistics() -
PlanetKitCall의getStatistics()