Version: 5.3

최대 링크 대역폭

PlanetKit은 최대 링크 대역폭을 설정하는 기능을 제공합니다. LINE Planet은 총 네트워크 비트레이트를 최대 링크 대역폭까지로 제한합니다. 여기서는 LINE Planet에서 비트레이트를 제어하는 법을 기술합니다.

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

애플리케이션 설정

콜 셋업(call setup) 단계에서 1대1 통화 파라미터 또는 그룹 통화 파라미터를 구성해야 합니다. 이때 최대 송신 링크 대역폭(maxSendLinkBandwidth)과 최대 수신 링크 대역폭(maxRecvLinkBandwidth)을 설정하면 PlanetKit이 이 값을 고려해 총 네트워크 비트레이트를 제한합니다. 통화 유형 및 사용자 유형별로 maxSendLinkBandwidth와 maxRecvLinkBandwidth를 설정하기 위한 API는 다음과 같습니다.

	최대 송신 링크 대역폭 설정 API	최대 수신 링크 대역폭 설정 API
1대1 통화 발신자	`MakeCallParams`의 `maxSendLinkBandwidth`	`MakeCallParams`의 `maxReceiveLinkBandwidth`
1대1 통화 착신자	`VerifyCallParams`의 `maxSendLinkBandwidth`	`VerifyCallParams`의 `maxReceiveLinkBandwidth`
그룹 통화 참여자	`ConferenceParams`의 `maxSendLinkBandwidth`	`ConferenceParams`의 `maxReceiveLinkBandwidth`

이 밖에도 PlanetKit에는 defaultMaxSendLinkBandwidth, defaultMaxRecvLinkBandwidth라는 최대 링크 대역폭의 기본값이 있습니다. PlanetKit은 애플리케이션의 설정과 최대 링크 대역폭의 기본값 중에서 최솟값으로 링크 대역폭을 적용합니다. 이를 localMaxSendLinkBandwidth와 localMaxRecvLinkBandwidth라고 부릅니다.

// Pseudocode description
localMaxSendLinkBandwidth = MIN(maxSendLinkBandwidth, defaultMaxSendLinkBandwidth)
localMaxRecvLinkBandwidth = MIN(maxRecvLinkBandwidth, defaultMaxRecvLinkBandwidth)

최종 적용하는 비트레이트 제한값은 통화 유형에 따라 다릅니다.

Note

WebPlanetKit에는 화면 공유와 관련하여 다음과 같은 제약 사항이 있습니다.

maxSendLinkBandwidth가 1100kbps 미만인 경우
- 화면 공유를 했을 때 실제 비트레이트가 maxSendLinkBandwidth에서 설정한 값을 초과할 수 있습니다.
maxRecvLinkBandwidth가 1100kbps 미만인 경우
- 다른 참가자의 화면 공유를 볼 때 품질이 좋지 않을 수 있습니다.

1대1 통화

PlanetKit은 콜 셋업 단계에서 로컬 사용자의 localMaxSendLinkBandwidth와 원격 사용자(피어)의 localMaxRecvLinkBandwidth 중 최솟값으로 비트레이트를 제한합니다.

// Pseudocode description
maxTransmitBitrate = MIN(localMaxSendLinkBandwidth, peerAttribute.localMaxRecvLinkBandwidth)
maxReceiveBitrate = MIN(localMaxRecvLinkBandwidth, peerAttribute.localMaxSendLinkBandwidth)

그룹 통화

그룹 통화일 때는 1대1 통화와 달리 통화 참여자 사이의 최솟값을 찾지 않고, localMaxSendLinkBandwidth와 localMaxRecvLinkBandwidth으로 비트레이트를 제한합니다.

// Pseudocode description
maxTransmitBitrate = localMaxSendLinkBandwidth  
maxReceiveBitrate = localMaxRecvLinkBandwidth