本文にスキップする
Version: 7.1

リリースノート

Windows向けPlanetKit 7.1のリリースノートです。

PlanetKit 7.1​

リリース日：2026-08-04

通話開始時の初期音声ミュート状態のサポート​

1対1通話またはグループ通話を開始する際に、初期音声（マイク）ミュート状態を指定できるようになりました。PLNK_INITIAL_MY_AUDIO_STATE_MUTEDに設定すると、PlanetKitは通話開始時にマイクをアクティブにしないため、ユーザーがミュートを解除するまでマイクインジケーターは表示されません。

  • 指定しない場合のデフォルト状態は 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)は1回の呼び出しでオートモードへの切り替えとオートフォーカスのトリガーを行います。カメラを停止して再起動する必要はありません。
  • 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
}