본문으로 건너뛰기
Version: 5.6

릴리스 노트

WebPlanetKit 5.6의 릴리스 노트입니다.

WebPlanetKit 5.6​

릴리스 일자: 2026-04-24

WebView와 Safari에서 가상 배경 지원​

가상 배경 기능의 지원 범위를 Safari 브라우저와 WebView 환경까지 확대했습니다.

  • 기존에는 Chromium 기반 브라우저(Chrome, Edge)에서만 가상 배경을 사용할 수 있었습니다.
  • 이번 업데이트를 통해 데스크톱 및 iOS Safari와 iOS/Android WebView 환경에서도 가상 배경 기능을 이용할 수 있습니다.

가상 배경 안정성 개선 및 준비 상태 확인 API 추가​

  • 가상 배경 플러그인의 안정성을 개선했습니다.
    • ML(machine learning) 모델이 완전히 로드되기 전에 가상 배경을 시작하면 오류가 발생할 수 있습니다. 이를 방지해 플러그인의 안정성을 높였습니다.
    • 이제 플러그인은 초기화 중 들어온 가상 배경 시작 요청을 자동으로 큐에 저장하고 준비가 완료되면 처리를 시작합니다.
  • 가상 배경 플러그인의 사용 가능 여부를 확인할 수 있는 몇 가지 편리한 API를 추가했습니다.
    • 이 API를 이용해 가상 배경 효과를 시작하기 전에 준비 상태를 직접 확인하거나 초기화가 완료될 때까지 대기하도록 구현할 수 있습니다.

API​

추가​

  • Call class 1-to-1 call

    • function waitForVirtualBackgroundInitialization()
    • function isVirtualBackgroundReady()

  • Conference class Group call

    • function waitForVirtualBackgroundInitialization()
    • function isVirtualBackgroundReady()

  • MediaStreamManager class 1-to-1 callGroup call

    • function waitForVirtualBackgroundInitialization()
    • function isVirtualBackgroundReady()

예제 코드​

  • 플러그인이 준비될 때까지 대기
const virtualBackground = new PlanetKitVirtualBackground();

await virtualBackground.waitForVirtualBackgroundInitialization();
virtualBackground.startVirtualBackgroundBlur(video, canvas, 15);
  • 플러그인 준비 상태 확인
const virtualBackground = new PlanetKitVirtualBackground();

if (virtualBackground.isVirtualBackgroundReady()) {
  virtualBackground.startVirtualBackgroundBlur(video, canvas, 15);
}

그룹 통화 비디오 품질 개선​

그룹 통화 시 QVGA 해상도 스트림의 최대 비트레이트를 100kbps에서 200kbps로 상향해 비디오 품질을 개선했습니다.

비트레이트 조정은 참여자 수에 따라 다음과 같이 자동으로 적용합니다.

  • 참여자 25명 미만: 최대 비트레이트 200kbps 적용
  • 참여자 25명 이상: 최대 비트레이트 100kbps 적용

Safari 통화 처리 이슈 수정​

Safari에서 발생하던 두 가지 문제를 수정해 통화 안정성과 신뢰도를 높였습니다.

  • 브라우저 내비게이션: Safari에서 브라우저 '뒤로 가기' 버튼을 이용해 통화 페이지를 벗어날 때 진행되는 통화 정리 처리를 개선했습니다.
  • 네트워크 핸드오버: Safari 환경에서 네트워크 전환 중 통화 종료 이벤트 알림이 중복으로 발생하던 현상을 수정했습니다.