릴리스 노트

Windows용 PlanetKit 7.1의 릴리스 노트입니다.

PlanetKit 7.1

릴리스 일자: 2026-08-04

통화 시작 시 초기 오디오 음 소거 상태 지원

1대1 통화 또는 그룹 통화를 시작할 때 초기 오디오(마이크) 음 소거 상태를 지정하는 기능을 추가했습니다. PLNK_INITIAL_MY_AUDIO_STATE_MUTED로 설정하면 통화 시작 시 마이크를 활성화하지 않으므로, 사용자가 음 소거를 해제하기 전까지 마이크 표시기가 표시되지 않습니다.

• 지정하지 않을 경우 기본 상태는 PLNK_INITIAL_MY_AUDIO_STATE_UNMUTED입니다.
• PLNK_INITIAL_MY_AUDIO_STATE_MUTED 상태에서는 로컬 오디오가 캡처되거나 전송되지 않으며, 상대방에게 로컬 사용자의 마이크가 음 소거되었음이 전달됩니다.
• 통화 중 음 소거 해제(MuteMyAudio(false))를 수행하면 해당 시점부터 마이크 및 개인 정보 보호 표시기가 활성화됩니다.

API

변경

• PlanetKitCall class 1-to-1 call

  이전 버전	PlanetKit 7.1.0
  void AcceptCall(bool bPreparation, CallStartMessageOptional pCallStartMessage=NullOptional, EInitialMyVideoState eInitialMyVideoState=PLNK_INITIAL_MY_VIDEO_STATE_RESUME, bool bRecordOnCloud=false)	void AcceptCall(bool bPreparation, CallStartMessageOptional pCallStartMessage=NullOptional, EInitialMyVideoState eInitialMyVideoState=PLNK_INITIAL_MY_VIDEO_STATE_RESUME, bool bRecordOnCloud=false, EInitialMyAudioState eInitialMyAudioState=PLNK_INITIAL_MY_AUDIO_STATE_UNMUTED)

추가

• ConferenceParam class Group call

  • EInitialMyAudioState GetInitialMyAudioState()
  • void SetInitialMyAudioState(EInitialMyAudioState eInitialMyAudioState)

• EInitialMyAudioState enum 1-to-1 callGroup call

  • PLNK_INITIAL_MY_AUDIO_STATE_UNMUTED = 0
  • PLNK_INITIAL_MY_AUDIO_STATE_MUTED = 1

• MakeCallParam class 1-to-1 call

  • EInitialMyAudioState GetInitialMyAudioState()
  • void SetInitialMyAudioState(EInitialMyAudioState eInitialMyAudioState)

카메라 포커스 제어 API 추가

CameraInfo에 카메라 포커스 제어 기능을 추가했습니다. 앱에서 포커스 제어 지원 여부를 확인하고, 자동 및 수동 포커스 모드 간 전환하며, 수동 포커스 값(0~100)을 설정할 수 있습니다. 포커스 제어 지원 여부는 사용 가능한 카메라 목록을 조회할 때 캐시되므로 ChangeCamera 호출 전에도 확인할 수 있습니다.

• SetFocusMode(AUTO)는 단일 호출로 자동 모드로 전환하고 자동 포커스를 실행합니다. 카메라를 중지하고 재시작할 필요가 없습니다.
• SetManualFocusValue는 값만 설정하며 포커스 모드를 변경하지 않습니다. 수동 모드를 활성화하려면 SetFocusMode(MANUAL)을 별도로 호출하세요.
• ChangeCamera 호출 전에 CameraInfo에 설정한 포커스 모드 및 수동 포커스 값은 카메라 시작 시 적용되므로, 카메라를 재시작하지 않고도 원하는 포커스 상태를 미리 설정할 수 있습니다.
• 수동 포커스 값은 카메라의 포커스 범위에 매핑된 정규화된 0~100 척도를 사용합니다(일반적으로 0 = 가장 가까운 거리, 100 = 가장 먼 거리). 단, 정확한 방향 및 단위는 장치에 따라 다를 수 있습니다.
• 카메라가 포커스 제어를 지원하지 않는 경우, 모든 포커스 API는 PLNK_FOCUS_CONTROL_RESULT_NOT_SUPPORTED를 반환하며 통화 및 영상 전송은 정상적으로 계속됩니다.

API

추가

• CameraInfo class 1-to-1 callGroup call

  • EFocusControlResult GetFocusMode(EFocusMode &outFocusMode) const
  • unsigned int GetManualFocusValue() const
  • bool IsFocusModeSupported(EFocusMode focusMode) const
  • EFocusControlResult SetFocusMode(EFocusMode focusMode)
  • EFocusControlResult SetManualFocusValue(unsigned int nValue)

• EFocusControlResult enum 1-to-1 callGroup call

  • PLNK_FOCUS_CONTROL_RESULT_SUCCESS = 0
  • PLNK_FOCUS_CONTROL_RESULT_NOT_SUPPORTED = 1
  • PLNK_FOCUS_CONTROL_RESULT_OUT_OF_RANGE = 2
  • PLNK_FOCUS_CONTROL_RESULT_INTERNAL_ERROR = 3

• EFocusMode enum 1-to-1 callGroup call

  • PLNK_FOCUS_MODE_AUTO = 0
  • PLNK_FOCUS_MODE_MANUAL = 1

예제 코드

PlanetKit::CameraControllerPtr pController = PlanetKit::PlanetKitManager::GetInstance()->GetCameraController();
PlanetKit::CameraInfoArray arrCameras;
pController->GetCapturerInfo(arrCameras);
auto pInfo = arrCameras[0];

bool bManualSupported = pInfo->IsFocusModeSupported(PlanetKit::PLNK_FOCUS_MODE_MANUAL);
bool bAutoSupported   = pInfo->IsFocusModeSupported(PlanetKit::PLNK_FOCUS_MODE_AUTO);

// Set manual focus before activating the camera
if (bManualSupported) {
    pInfo->SetManualFocusValue(50);                          // store value only
    pInfo->SetFocusMode(PlanetKit::PLNK_FOCUS_MODE_MANUAL);  // enter manual mode
}
pController->ChangeCamera(pInfo);                      // starts with manual mode at 50%

// Adjust focus value at runtime (mode unchanged)
pInfo->SetManualFocusValue(80);

// Switch to auto focus
if (bAutoSupported) {
    pInfo->SetFocusMode(PlanetKit::PLNK_FOCUS_MODE_AUTO);         // switch + trigger AF
}