Skip to main content
Version: 7.1

Release notes

This page provides the release notes of PlanetKit 7.1 for Windows.

PlanetKit 7.1​

Release date: 2026-08-04

Support initial audio mute state on call start​

Added support for specifying the initial audio (microphone) mute state when starting a 1-to-1 call or group call. When set to PLNK_INITIAL_MY_AUDIO_STATE_MUTED, PlanetKit does not activate the microphone at call start, so the microphone indicator is not shown until the user unmutes.

  • The default state is PLNK_INITIAL_MY_AUDIO_STATE_UNMUTED when not specified.
  • In the PLNK_INITIAL_MY_AUDIO_STATE_MUTED state, local audio is neither captured nor transmitted, and the peer is notified that the local user's microphone is muted.
  • Unmuting during the call (MuteMyAudio(false)) activates the microphone and privacy indicator from that point forward.

API​

Changed​

  • PlanetKitCall class 1-to-1 call

    PreviousPlanetKit 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)
Added​

  • 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)

Add camera focus control API​

Added camera focus control to CameraInfo, allowing apps to check whether focus control is supported, switch between auto and manual focus modes, and set a manual focus value (0–100). Focus control support is cached during camera enumeration, so it can be queried before calling ChangeCamera.

  • SetFocusMode(AUTO) switches to auto mode and triggers autofocus in a single call; the camera does not need to be stopped and restarted.
  • SetManualFocusValue only sets the value; it does not change the focus mode. Call SetFocusMode(MANUAL) separately to activate manual mode.
  • The focus mode and manual focus value configured on a CameraInfo before calling ChangeCamera are applied when the camera starts, so you can set the desired focus state up front without restarting the camera.
  • Manual focus values use a normalized 0–100 scale mapped onto the camera's focus range (typically 0 = nearest, 100 = farthest), but the exact direction and units are device-dependent and not guaranteed.
  • If the camera does not support focus control, all focus APIs return PLNK_FOCUS_CONTROL_RESULT_NOT_SUPPORTED; calls and video transmission continue normally.

API​

Added​

  • 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

Example code​

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
}