バーチャル背景
ビデオ通話中にバーチャル背景(virtual background)機能を使用して、背景をぼかしたり画像に置き換えたりすることができます。ここでは、バーチャル背景機能の使い方について説明します。
対応する通話タイプ | SDKの最低バージョン |
---|---|
1対1通話、グループ通話(カンファレンス) | PlanetKit 6.0 |
バーチャル背景効果を適用すると、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_NONE
、PLNK_VIRTUAL_BACKGROUND_BLUR
、PLNK_VIRTUAL_BACKGROUND_IMAGE
のいずれかです。
PlanetKit::EVirtualBackgroundType backgroundType;
backgroundType = pCameraController->GetCurrentVirtualBackgroundType();
バーチャル背景を解除する
バーチャル背景を解除するには、ClearVirtualBackground()
メソッドを呼び出します。
pCameraController->ClearVirtualBackground();
関連API
バーチャル背景機能に関連するAPIは次のとおりです。