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

バーチャル背景

ビデオ通話中にバーチャル背景(virtual background)機能を使用して、背景をぼかしたり画像に置き換えたりすることができます。ここでは、バーチャル背景機能の使い方について説明します。

対応する通話タイプSDKの最低バージョン
1対1通話、グループ通話(カンファレンス)PlanetKit 6.0
Warning

バーチャル背景効果を適用すると、CPU使用率が増加します。

概要

CameraControllerクラスは、バーチャル背景機能のためのAPIを提供します。バーチャル背景を設定するためのCameraControllerオブジェクトを取得するには、PlanetKitManager::GetCameraController()を使用します。

PlanetKit::PlanetKitManagerPtr pPlanetKitManager = PlanetKit::PlanetKitManager::GetInstance();
PlanetKit::CameraControllerPtr pCameraController = pPlanetKitManager->GetCameraController();

ぼかし背景を設定する

背景にぼかし(blur)効果を適用するには、SetVirtualBackgroundWithBlur()メソッドを呼び出します。

float blurRadius = 15.0;
pCameraController->SetVirtualBackgroundWithBlur(blurRadius);

SetVirtualBackgroundWithBlur()メソッドには、バーチャル背景に適用されるガウシアンブラー(Gaussian blur)の半径を引数として渡すことができます。半径のデフォルト値は15.0で、1.0から25.0までの値に設定することを推奨します。半径が大きいほど結果はぼやけます。

画像を背景に設定する

背景を画像に切り替えるには、PlanetKit::Imageオブジェクトを引数として、SetVirtualBackgroundWithImage()メソッドを呼び出します。

std::wstring virtualBackgroundPath = L"<PATH_TO_BACKGROUND_IMAGE>";
auto image = PlanetKit::Image::Create(virtualBackgroundPath.c_str());
if (image.HasValue()) {
pCameraController->SetVirtualBackgroundWithImage(*image);
}

バーチャル背景のタイプを確認する

現在、使用中のバーチャル背景のタイプを確認するには、GetCurrentVirtualBackgroundType()メソッドを呼び出します。返却されたPlanetKit::EVirtualBackgroundTypeは、PLNK_VIRTUAL_BACKGROUND_NONEPLNK_VIRTUAL_BACKGROUND_BLURPLNK_VIRTUAL_BACKGROUND_IMAGEのいずれかです。

PlanetKit::EVirtualBackgroundType backgroundType;
backgroundType = pCameraController->GetCurrentVirtualBackgroundType();

バーチャル背景を解除する

バーチャル背景を解除するには、ClearVirtualBackground()メソッドを呼び出します。

pCameraController->ClearVirtualBackground();

関連API

バーチャル背景機能に関連するAPIは次のとおりです。