본문으로 건너뛰기

PlanetKit 7.0 및 WebPlanetKit 5.6 릴리스

PlanetKit 7.0​

PlanetKit 7.0을 릴리스했습니다.

AndroidiOSmacOSWindows
7.0.07.0.07.0.07.0.0

  1. 통역사를 위한 음량 조절 필터 모드 추가

    • 통역 방에서 통역사는 일반적으로 다른 참가자가 말하는 것을 들으면서 동시에 말합니다. 이와 같이 동시에 말하는(double talk) 상황은 에코 환경으로 감지되기 때문에 마이크 볼륨이 낮아도 음량 조절 필터(auto gain control)가 볼륨을 증가시키지 않습니다. 이 때문에 통역사의 마이크 볼륨이 특정 레벨 이하인 경우 볼륨이 증가하지 않는 문제가 있었습니다.
    • 이 문제를 해결하기 위해 에코 환경에서도 마이크 볼륨을 증가시킬 수 있는 에코 허용(echo tolerance) 모드를 추가했습니다. 이 모드를 사용하면 동시에 말하는 상황에서도 통역사의 목소리가 명확하게 전달됩니다.
    • Windows
      • PLNK_AUTO_GAIN_CONTROL_TYPE_HARDWARE_ECHO_TOLERANCE 모드를 추가했습니다.
      • 참고로 기본 모드는 PLNK_AUTO_GAIN_CONTROL_TYPE_HARDWARE입니다.
    • macOS
      • PlanetKitAutoGainControlMode에 hardwareEchoTolerance 모드를 추가했습니다.
      • 참고로 기본 모드는 hardware입니다.

  2. 더 이상 사용되지 않는 API 키 인증 제거

    • 1대1 통화 및 그룹 통화 설정 API에서 더 이상 사용되지 않는 API 키 기반 인증 방식을 제거했습니다.
    • 이제 액세스 토큰 기반 인증만 지원합니다.

  3. 피어 비디오/화면 공유 요청 메서드 제거

  4. 샘플링 레이트를 사용하는 오디오 API 개선

    • Android
      • 타입 안정성을 개선하고자 정수 기반 샘플링 레이트를 구조화된 enum 방식으로 대체했습니다.
      • 새로운 PlanetKitAudioSampleRate enum은 16kHz, 32kHz, 48kHz 샘플링 레이트를 명확하게 지원합니다.
      • API 일관성이 향상됐고 샘플링 레이트를 더욱 명시적으로 처리할 수 있어 오류를 방지할 수 있습니다.
    • iOS/macOS
      • PlanetKitAudioManager의 샘플링 레이트 속성 타입을 Float64에서 PlanetKitAudioSampleRate enum으로 변경했습니다.
      • PlanetKitAudioSampleRate enum은 지원하는 샘플링 레이트를 사전 정의한 집합을 제공합니다.
      • 설정된 샘플링 레이트는 선호값입니다. PlanetKit은 설정된 레이트로 오디오 세션을 열기 위해 최선을 다하지만, 필요 시 지원 가능한 가장 가까운 레이트로 대체할 수 있습니다.

  5. 짧은 데이터 전송에 상세 실패 이유 추가

    • Android
      • 1대1 통화와 그룹 통화 모두에서 sendShortData에 포괄적인 실패 이유 보고 기능을 추가했습니다.
      • 새로운 PlanetKitSendShortDataFailReason enum은 개발자가 다양한 실패 시나리오를 더 효과적으로 식별하고 처리할 수 있도록 구체적인 오류 코드를 제공합니다.
      • 기존의 범용 PlanetKitRequestCallback을 상세 실패 정보를 포함하는 전용 PlanetKitSendShortDataResultCallback으로 대체했습니다.
      • 짧은 데이터 전송 기능을 사용할 때 이 기능을 이용해 오류 처리, 디버깅, 정보 제공 기능을 개선할 수 있습니다.
    • iOS/macOS
      • 이제 sendShortData의 완료 콜백은 Bool 대신 PlanetKitSendShortDataFailReason을 반환해 잘못된 파라미터, 데이터 크기 제한, 처리율 제한, 타임아웃 등과 같은 상세한 실패 정보를 제공합니다.
    • Windows
      • 1대1 통화와 그룹 통화 모두에서 SendShortData에 포괄적인 실패 이유 보고 기능을 추가했습니다.
      • 새로운 ESendShortDataFailReason enum은 개발자가 다양한 실패 시나리오를 더 효과적으로 식별하고 처리할 수 있도록 구체적인 오류 코드를 제공합니다.

  6. 그룹 통화에서 화면 공유 중지 이유 추가

    • 그룹 통화에서 화면 공유를 중지할 때 이유를 지정하고, 피어가 콜백을 통해 해당 이유를 받을 수 있는 기능을 추가했습니다.
    • 자세한 내용은 API 변경 내역에서 확인해 주세요.

  7. API 변경

WebPlanetKit 5.6​

WebPlanetKit 5.6을 릴리스했습니다.

  1. WebView와 Safari에서 가상 배경 지원

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

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

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

  3. 그룹 통화 비디오 품질 개선

    • 그룹 통화 시 QVGA 해상도 스트림의 최대 비트레이트를 100kbps에서 200kbps로 상향해 비디오 품질을 개선했습니다.
    • 비트레이트 조정은 참여자 수에 따라 다음과 같이 자동으로 적용합니다.
      • 참여자 25명 미만: 최대 비트레이트 200kbps 적용
      • 참여자 25명 이상: 최대 비트레이트 100kbps 적용

  4. Safari 통화 처리 이슈 수정

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

  5. API 변경

마일스톤 업데이트​

마일스톤을 업데이트했습니다. 개발에 참고하시기 바랍니다.

릴리스 노트​

다음과 같이 각 플랫폼별로 더욱 상세한 릴리스 노트를 제공하고 있으니 개발에 참고하시기 바랍니다.

PlanetKit 7.0은 Jupiter 7.9 기반입니다.