ビデオのバックグラウンド効果を有効にする

2025-06-30

ビデオ効果機能を使用すると、ユーザーは背景のぼかしやビデオの置換など、ビデオ通話に視覚効果を追加できます。これは、特にテレヘルス、テレバンク、仮想ヒアリングなどのコンテキストで、気が散る情報を排除し、機密情報を保護するのに役立ちます。背景ぼかしはプライバシーを強化し、カスタムの背景を可能にし、通話をより魅力的でパーソナライズします。

注

呼び出し効果ライブラリは、WebJS 用の Azure Communication Calling クライアントライブラリでのみ動作するように設計されており、個別に使用することはできません。

ビデオ効果を実装する

パッケージをインストールする

重要

Web デスクトップブラウザーの背景のぼかしと背景の置換は一般公開されています。このクイックスタートでは、1.13.1 またはそれ以上のバージョンの Azure Communication Services Calling SDK、および 1.0.1 以上の Azure Communication Services Calling Effects SDK バージョンを使用します。現在、ビデオの背景効果を作成するためのデスクトップブラウザーのサポートは、Chrome と Microsoft Edge Desktop Browser (Windows と Mac) と Mac Safari Desktop でのみサポートされています。

重要

Android Chrome および Android Edge モバイルブラウザーの背景ぼかしと背景の置換は、ビルド 1.34.1 以降の WebJS SDK バージョン以降の一般提供で利用できます。 Android モバイルブラウザーにバックグラウンド効果を実装するには、バージョン 1.1.4 以降の呼び出し効果パッケージを使用する必要があります。

JavaScript 用の Azure Communication Services SMS SDK をインストールするには、npm install コマンドを使用します。

npm install @azure/communication-calling-effects --save

npm パッケージ「通話用通信効果」の詳細については、「通信呼び出し効果」を参照してください。

注

現在、使用可能なビデオ効果は 2 つあります。

背景ぼかし
背景を画像に置き換える (縦横比は 16:9 で互換性があること)

Azure Communication Calling SDK でビデオ効果を使用するには、LocalVideoStream を作成したら、VideoEffects の LocalVideoStream 機能 API を取得してビデオ効果を開始または停止する必要があります。

import * as AzureCommunicationCallingSDK from '@azure/communication-calling'; 

import { BackgroundBlurEffect, BackgroundReplacementEffect } from '@azure/communication-calling-effects'; 

// Get the video effects feature API on the LocalVideoStream 
// (here, localVideoStream is the LocalVideoStream object you created while setting up video calling)
const videoEffectsFeatureApi = localVideoStream.feature(AzureCommunicationCallingSDK.Features.VideoEffects); 


// Subscribe to useful events 
videoEffectsFeatureApi.on(‘effectsStarted’, () => { 
    // Effects started
});

videoEffectsFeatureApi.on(‘effectsStopped’, () => { 
    // Effects stopped
}); 

videoEffectsFeatureApi.on(‘effectsError’, (error) => { 
    // Effects error
});

背景ぼかし

// Create the effect instance 
const backgroundBlurEffect = new BackgroundBlurEffect(); 

// Recommended: Check support by using the isSupported method on the feature API
const backgroundBlurSupported = await videoEffectsFeatureApi.isSupported(backgroundBlurEffect);

if (backgroundBlurSupported) { 
    // Use the video effects feature API we created to start effects
    await videoEffectsFeatureApi.startEffects(backgroundBlurEffect); 
}

背景をイメージに置き換える

この効果の背景として必要なイメージの URL を指定する必要があります。

重要

URL が画像ではない場合、または到達不能か読み取り不可の場合、startEffects メソッドは失敗します。

注

現在サポートされているイメージ形式は、png、jpg、jpeg、tiff、bmp です。

現在サポートされている縦横比は 16:9 です。

const backgroundImage = 'https://linkToImageFile'; 

// Create the effect instance 
const backgroundReplacementEffect = new BackgroundReplacementEffect({ 
    backgroundImageUrl: backgroundImage
}); 

// Recommended: Check support by using the isSupported method on the feature API
const backgroundReplacementSupported = await videoEffectsFeatureApi.isSupported(backgroundReplacementEffect);

if (backgroundReplacementSupported) { 
    // Use the video effects feature API as before to start/stop effects 
    await videoEffectsFeatureApi.startEffects(backgroundReplacementEffect); 
}

この効果のイメージを変更するには、それを、configure メソッドを介して渡します。

const newBackgroundImage = 'https://linkToNewImageFile'; 

await backgroundReplacementEffect.configure({ 
    backgroundImageUrl: newBackgroundImage
});

切り替え効果は、ビデオ効果機能 API 上で同じ方法を使用して実行できます。

// Switch to background blur 
await videoEffectsFeatureApi.startEffects(backgroundBlurEffect); 

// Switch to background replacement 
await videoEffectsFeatureApi.startEffects(backgroundReplacementEffect);

アクティブな効果をチェックする場合はいつでも、activeEffects プロパティを使用できます。

activeEffects プロパティを使用すると、現在アクティブな効果の名前を持つ配列が返され、アクティブな効果がない場合は空の配列が返されます。

// Using the video effects feature API
const currentActiveEffects = videoEffectsFeatureApi.activeEffects;

効果を停止するには:

await videoEffectsFeatureApi.stopEffects();

つや消しガラスの背景効果を追加する

つや消しガラスの背景は、背景のぼかしのプライバシーと、選択した画像のカスタマイズを組み合わせて、つや消しガラスの窓に似た洗練された効果を生み出します。この効果を実現するには、透明な PNG 画像をカスタム背景としてアップロードします。この画像は、会社のロゴや独自のデザインなどです。つや消しガラス効果は、背景の一部としてグラフィックを維持しながら、画像の透明な領域をぼかします。つや消しガラスの外観を使用するには、1.1.3 パッケージのバージョン以上を使用する必要があります。

つや消しの PNG 画像を準備するときに最適な結果を得るには、次の点に注意してください。

解像度: 高品質の背景に 1920 x 1080 ピクセルを使用する
完全な不透明度を避ける: ロゴなどの色付きのコンテンツは、透明度がわずかな場合に最適に表示されます。 75% の不透明度をお勧めします
ステンシルの中間灰色の前景: 透明度のあるグレースケール PNG の場合は、透明度パターンが明るいおよび暗い背景の両方で表示されるように、完全な画像を中間灰色 (値 128) にすることをお勧めします。

注

iOS Calling SDK でビデオ効果を使用するために、Azure Communication Services は機械学習モデルを顧客のデバイスにダウンロードします。アプリケーションのプライバシーに関する注記を確認し、必要に応じて更新することをお勧めします。

ビデオ効果機能を使用すると、ビデオ通話のビデオに効果を追加できます。背景ぼかしにより、ユーザーは、参加者の背後にある気を散らすものを取り除くメカニズムを利用できます。これにより、参加者はバックグラウンドに破壊的なアクティビティや機密情報が示されることなく通信できます。

この機能は、プロバイダーまたは患者が機密情報や個人データを保護するために周囲を隠したい場合がある遠隔医療のコンテキストで最も役立ちます。背景ぼかしは、ユーザーのプライバシーを保護するために、テレバンクや仮想ヒアリングを含むすべての仮想予定シナリオに適用できます。

ビデオ効果を実装する

注

iOS 版でのビデオエフェクトのサポートは、最近の iOS メジャーバージョン 2 つに限定されます。たとえば、iOS の新しいメジャーバージョンがリリースされたとき、iOS の要件は、その最新バージョンと直近のバージョン 1 つになります。

現在使用できるビデオ効果は、背景ぼかしの 1 つです。

LocalVideoEffectsFeature オブジェクトには、次の API 構造があります。

enable: LocalVideoStream インスタンスのビデオ効果を有効にします。
disable: LocalVideoStream インスタンスのビデオ効果を無効にします。
isSupported: LocalVideoStream インスタンスで Video Effect がサポートされているかどうかを示します。
onVideoEffectEnabled: ビデオ効果が正常に有効になったときにトリガーされるイベント。
onVideoEffectDisabled: ビデオ効果が正常に無効になったときにトリガーされるイベント。
onVideoEffectError: ビデオ効果の操作が失敗したときにトリガーされるイベント。

LocalVideoEffectsFeature オブジェクトを取得したら、イベントをサブスクライブできます。イベントには、didEnableVideoEffect、didDisableVideoEffect、didReceiveVideoEffectError というデリゲートがあります。

Azure Communication Calling SDK で Video Effects を使用するには、LocalVideoStreamを作成したら、LocalVideoStreamのVideoEffects機能 API を取得して、ビデオ効果を有効または無効にする必要があります。

// Obtain the Video Effects feature from the LocalVideoStream object that is sending the video.
@State var localVideoEffectsFeature: LocalVideoEffectsFeature?
localVideoEffectsFeature = self.localVideoStreams.first.feature(Features.localVideoEffects)

// Subscribe to the events
public func localVideoEffectsFeature(_ videoEffectsLocalVideoStreamFeature: LocalVideoEffectsFeature, didEnableVideoEffect args: VideoEffectEnabledEventArgs) {
        os_log("Video Effect Enabled, VideoEffectName: %s", log:log, args.videoEffectName)
    }
public func localVideoEffectsFeature(_ videoEffectsLocalVideoStreamFeature: LocalVideoEffectsFeature, didDisableVideoEffect args: VideoEffectDisabledEventArgs) {
    os_log("Video Effect Disabled, VideoEffectName: %s", log:log, args.videoEffectName)
}
public func localVideoEffectsFeature(_ videoEffectsLocalVideoStreamFeature: LocalVideoEffectsFeature, didReceiveVideoEffectError args: VideoEffectErrorEventArgs) {
    os_log("Video Effect Error, VideoEffectName: %s, Code: %s, Message: %s", log:log, args.videoEffectName, args.code, args.message)
}

次に、API の使用を開始して、ビデオ効果を有効または無効にします。

localVideoEffectsFeature.enable(effect: backgroundBlurVideoEffect)
localVideoEffectsFeature.disable(effect: backgroundBlurVideoEffect)

背景ぼかし

背景ぼかしは、アプリケーションが人の背景をぼかすために有効にするビデオ効果です。背景ビデオ効果を使用するには、有効なLocalVideoStreamからLocalVideoEffectsFeature機能を取得する必要があります。

新しい背景ぼかしのビデオ効果オブジェクトを作成します。
```
@State var backgroundBlurVideoEffect: BackgroundBlurEffect?
```

BackgroundBlurEffect がサポートされているかどうかを確認し、Enable オブジェクトで videoEffectsFeature を呼び出します。

if((localVideoEffectsFeature.isSupported(effect: backgroundBlurVideoEffect)) != nil)
{
    localVideoEffectsFeature.enable(effect: backgroundBlurVideoEffect)
}

背景ぼかしのビデオ効果を無効にするには:

localVideoEffectsFeature.disable(effect: backgroundBlurVideoEffect)

背景置換

背景の置換は、ユーザーが独自のカスタム背景を設定できるようにするビデオ効果です。背景置換効果を使用するには、有効なLocalVideoStreamからLocalVideoEffectsFeature機能を取得する必要があります。

以下のようにして新しい背景置換ビデオ効果オブジェクトを作成します。
```
@State var backgroundReplacementVideoEffect: BackgroundReplacementEffect?
```

バッファーを通して画像を渡すことでカスタム背景を設定します。

let image = UIImage(named:"image.png")
guard let imageData = image?.jpegData(compressionQuality: 1.0) else {
return
}
backgroundReplacementVideoEffect.buffer = imageData

BackgroundReplacementEffect がサポートされているかどうかを確認し、Enable オブジェクトで videoEffectsFeature を呼び出します。

if((localVideoEffectsFeature.isSupported(effect: backgroundReplacementVideoEffect)) != nil)
{
    localVideoEffectsFeature.enable(effect: backgroundReplacementVideoEffect)
}

背景置換ビデオ効果を無効にするには:

localVideoEffectsFeature.disable(effect: backgroundReplacementVideoEffect)

注

Android Calling SDK でビデオ効果を使用できるように、機械学習モデルがお客様のデバイスにダウンロードされます。アプリケーションのプライバシーに関する注記を確認し、必要に応じて更新することをお勧めします。

ビデオ効果機能を使用すると、ビデオ通話のビデオに効果を追加できます。背景ぼかしにより、ユーザーは、参加者の背後にある気を散らすものを取り除くメカニズムを利用できます。これにより、参加者はバックグラウンドに破壊的なアクティビティや機密情報が示されることなく通信できます。この機能は遠隔医療のコンテキストで特に役立ちます。医療提供者や患者が、機密情報や個人データを保護するために自分の周囲をぼかすことができるからです。背景ぼかしは、ユーザーのプライバシーを保護するために、テレバンクや仮想ヒアリングを含むすべての仮想予定シナリオに適用できます。

この記事は、Android 用アプリへの 1 対 1 のビデオ通話の追加に関する記事に基づいています。

ビデオ効果の使用

注

Android 版でのビデオエフェクトのサポートは、最近の Android メジャーバージョン 4 つに限定されます。たとえば、Android の新しいメジャーバージョンがリリースされたとき、Android の要件は、その最新バージョンと直近のバージョン 3 つになります。

現在使用できるビデオ効果は、背景ぼかしの 1 つです。

VideoEffectsLocalVideoStreamFeature オブジェクトには、次の API 構造があります。

enableEffect: LocalVideoStream インスタンスのビデオ効果を有効にします。
disableEffect: LocalVideoStream インスタンスのビデオ効果を無効にします。
OnVideoEffectEnabledListener: ビデオ効果が正常に有効になったときにトリガーされるイベント。
OnVideoEffectDisabledListener: ビデオ効果が正常に無効になったときにトリガーされるイベント。
OnVideoEffectErrorListener: ビデオ効果の操作が失敗したときにトリガーされるイベント。

VideoEffectEnabledEvent、VideoEffectDisabledEvent、およびVideoEffectErrorEventオブジェクトには、次の API 構造があります。

getVideoEffectName: イベントをトリガーしたビデオ効果の名前を取得します。

VideoEffectsLocalVideoStreamFeature オブジェクトを取得したら、イベントをサブスクライブできます。

// Obtain the Video Effects feature from the LocalVideoStream object that is sending the video.
VideoEffectsLocalVideoStreamFeature videoEffectsFeature = currentVideoStream.feature(Features.LOCAL_VIDEO_EFFECTS);

// Create event handlers for the events
private void handleOnVideoEffectEnabled(VideoEffectEnabledEvent args) {
}
private void handleOnVideoEffectDisabled(VideoEffectDisabledEvent args) {
}
private void handleOnVideoEffectError(VideoEffectErrorEvent args) {
}
 
// Subscribe to the events
videoEffectsFeature.addOnVideoEffectEnabledListener(this::handleOnVideoEffectEnabled);
videoEffectsFeature.addOnVideoEffectDisabledListener(this::handleOnVideoEffectDisabled);
videoEffectsFeature.addOnVideoEffectErrorListener(this::handleOnVideoEffectError);

次に、API の使用を開始して、ビデオ効果を有効または無効にします。

videoEffectsFeature.enableEffect( {{VIDEO_EFFECT_TO_DISABLE}} );
videoEffectsFeature.disableEffect( {{VIDEO_EFFECT_TO_DISABLE}} );

背景ぼかし

背景ぼかしは、アプリケーションが人の背景を青にできるようにするビデオ効果です。バックグラウンドビデオエフェクトを使用するには、有効なVideoEffectsLocalVideoStreamFeatureからLocalVideoStream機能を取得する必要があります。

背景ぼかしのビデオ効果を有効にするには:

VideoEFfects 機能を取得し、イベントをサブスクライブするメソッドを作成します:

private void handleOnVideoEffectEnabled(VideoEffectEnabledEvent args) {
   Log.i("VideoEffects", "Effect enabled for effect " + args.getVideoEffectName());
}
private void handleOnVideoEffectDisabled(VideoEffectDisabledEvent args) {
   Log.i("VideoEffects", "Effect disabled for effect " + args.getVideoEffectName());
}
private void handleOnVideoEffectError(VideoEffectErrorEvent args) {
   Log.i("VideoEffects", "Error " + args.getCode() + ":" + args.getMessage()
           + " for effect " + args.getVideoEffectName());
}

VideoEffectsLocalVideoStreamFeature videoEffectsFeature;
public void createVideoEffectsFeature() {
    videoEffectsFeature = currentVideoStream.feature(Features.LOCAL_VIDEO_EFFECTS);
    videoEffectsFeature.addOnVideoEffectEnabledListener(this::handleOnVideoEffectEnabled);
    videoEffectsFeature.addOnVideoEffectDisabledListener(this::handleOnVideoEffectDisabled);
    videoEffectsFeature.addOnVideoEffectErrorListener(this::handleOnVideoEffectError);
}

新しい背景ぼかしのビデオ効果オブジェクトを作成します。

BackgroundBlurEffect backgroundBlurVideoEffect = new BackgroundBlurEffect();

EnableEffect オブジェクトで videoEffectsFeature を呼び出します。

public void enableBackgroundBlur() {
    videoEffectsFeature.enableEffect(backgroundBlurEffect);
}

背景ぼかしのビデオ効果を無効にするには:

public void disableBackgroundBlur() {
    videoEffectsFeature.disableEffect(backgroundBlurEffect);
}

背景置換

背景置換は、ユーザーの背景を置き換えられるようにするビデオ効果です。バックグラウンドビデオエフェクトを使用するには、有効なVideoEffectsLocalVideoStreamFeatureからLocalVideoStream機能を取得する必要があります。

背景置換ビデオ効果を有効にするには:

VideoEFfects 機能を取得し、イベントをサブスクライブするメソッドを作成します:

private void handleOnVideoEffectEnabled(VideoEffectEnabledEvent args) {
   Log.i("VideoEffects", "Effect enabled for effect " + args.getVideoEffectName());
}
private void handleOnVideoEffectDisabled(VideoEffectDisabledEvent args) {
   Log.i("VideoEffects", "Effect disabled for effect " + args.getVideoEffectName());
}
private void handleOnVideoEffectError(VideoEffectErrorEvent args) {
   Log.i("VideoEffects", "Error " + args.getCode() + ":" + args.getMessage()
           + " for effect " + args.getVideoEffectName());
}

VideoEffectsLocalVideoStreamFeature videoEffectsFeature;
public void createVideoEffectsFeature() {
    videoEffectsFeature = currentVideoStream.feature(Features.LOCAL_VIDEO_EFFECTS);
    videoEffectsFeature.addOnVideoEffectEnabledListener(this::handleOnVideoEffectEnabled);
    videoEffectsFeature.addOnVideoEffectDisabledListener(this::handleOnVideoEffectDisabled);
    videoEffectsFeature.addOnVideoEffectErrorListener(this::handleOnVideoEffectError);
}

以下のようにして新しい背景置換ビデオ効果オブジェクトを作成します。

BackgroundReplacementEffect backgroundReplacementVideoEffect = new BackgroundReplacementEffect();

バッファーを通して画像を渡すことでカスタム背景を設定します。

//example of where we can get an image from, in this case, this is from assets in Android folder
InputStream inputStream = getAssets().open("image.jpg");
Bitmap bitmap = BitmapFactory.decodeStream(inputStream);
ByteArrayOutputStream stream = new ByteArrayOutputStream();
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, stream);
byte[] data = stream.toByteArray();
ByteBuffer dataBuffer = ByteBuffer.allocateDirect(data.length);
dataBuffer.put(data);
dataBuffer.rewind();
backgroundReplacementVideoEffect.setBuffer(dataBuffer);

EnableEffect オブジェクトで videoEffectsFeature を呼び出します。

public void enableBackgroundReplacement() {
    videoEffectsFeature.enableEffect(backgroundReplacementVideoEffect);
}

背景置換ビデオ効果を無効にするには:

public void disableBackgroundReplacement() {
    videoEffectsFeature.disableEffect(backgroundReplacementVideoEffect);
}

注

Windows Calling SDK でビデオ効果を使用するには、機械学習モデルが顧客のデバイスにダウンロードされます。アプリケーションのプライバシーに関する注記を確認し、必要に応じて更新することをお勧めします。

この記事は、Windows 用アプリへの 1 対 1 のビデオ通話の追加に関する記事に基づいています。

ビデオ効果の使用

現在使用できるビデオ効果は、背景ぼかしの 1 つです。

VideoEffectsLocalVideoStreamFeature オブジェクトには、次の API 構造があります。

EnableEffect: LocalVideoStream インスタンスのビデオ効果を有効にします。
DisableEffect: LocalVideoStream インスタンスのビデオ効果を無効にします。
VideoEffectEnabled: ビデオ効果が正常に有効になったときにトリガーされるイベント。
VideoEffectDisabledListener: ビデオ効果が正常に無効になったときにトリガーされるイベント。
VideoEffectErrorListener: ビデオ効果の操作が失敗したときにトリガーされるイベント。

VideoEffectEnabledEvent、VideoEffectDisabledEvent、およびVideoEffectErrorEventオブジェクトには、次の API 構造があります。

VideoEffectName: イベントをトリガーしたビデオ効果の名前を取得します。

VideoEffectsLocalVideoStreamFeature オブジェクトを取得したら、イベントをサブスクライブできます。

Azure Communication Calling SDK でビデオ効果を使用するために、変数を MainPage に追加します。

public sealed partial class MainPage : Page
{
    private LocalVideoEffectsFeature localVideoEffectsFeature;
}

LocalVideoStreamを作成したら、ビデオ効果を有効または無効にするために、LocalVideoStreamのVideoEffects機能 API を取得する必要があります。

private async void CameraList_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    var selectedCamera = CameraList.SelectedItem as VideoDeviceDetails;
    cameraStream = new LocalOutgoingVideoStream(selectedCamera);
    InitVideoEffectsFeature(cameraStream);
    
    var localUri = await cameraStream.StartPreviewAsync();
    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
    {
        LocalVideo.Source = MediaSource.CreateFromUri(localUri);
    });
}

public void InitVideoEffectsFeature(LocalOutgoingVideoStream videoStream){
    localVideoEffectsFeature = videoStream.Features.VideoEffects;
    localVideoEffectsFeature.VideoEffectEnabled += LocalVideoEffectsFeature_VideoEffectEnabled;
    localVideoEffectsFeature.VideoEffectDisabled += LocalVideoEffectsFeature_VideoEffectDisabled;
    localVideoEffectsFeature.VideoEffectError += LocalVideoEffectsFeature_VideoEffectError;
}

// Create event handlers for the events
private void LocalVideoEffectsFeature_VideoEffectEnabled(object sender, VideoEffectEnabledEventArgs args)
{
}

private void LocalVideoEffectsFeature_VideoEffectDisabled(object sender, VideoEffectDisabledEventArgs args)
{
}

private void LocalVideoEffectsFeature_VideoEffectError(object sender, VideoEffectErrorEventArgs args)
{
}
 
// Subscribe to the events
videoEffectsFeature.VideoEffectEnabled += VideoEffectsFeature_OnVideoEffectEnabled;
videoEffectsFeature.VideoEffectDisabled += VideoEffectsFeature_OnVideoEffectDisabled;
videoEffectsFeature.VideoEffectError += VideoEffectsFeature_OnVideoEffectError;

次に、API の使用を開始して、ビデオ効果を有効または無効にします。

videoEffectsLocalVideoStreamFeature.EnableEffect( {{VIDEO_EFFECT_TO_ENABLE}} );
videoEffectsLocalVideoStreamFeature.DisableEffect( {{VIDEO_EFFECT_TO_DISABLE}} );

背景ぼかし

背景ぼかしは、アプリケーションが人の背景をぼかすために有効にするビデオ効果です。背景ビデオ効果を使用するには、有効なLocalVideoStreamからVideoEffectsLocalVideoStreamFeature機能を取得する必要があります。

背景ぼかしのビデオ効果を有効にするには:

BackgroundBlurEffect インスタンスを MainPage に追加します。

public sealed partial class MainPage : Page
{
    private BackgroundBlurEffect backgroundBlurVideoEffect = new BackgroundBlurEffect();
}

VideoEFfects 機能を取得し、イベントをサブスクライブするメソッドを作成します:

private async void LocalVideoEffectsFeature_VideoEffectEnabled(object sender, VideoEffectEnabledEventArgs e)
{
    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, async () =>
    {
        BackgroundBlur.IsChecked = true;
    });
}

private async void LocalVideoEffectsFeature_VideoEffectDisabled(object sender, VideoEffectDisabledEventArgs e)
{
    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, async () =>
    {
        BackgroundBlur.IsChecked = false;
    });
}

private void LocalVideoEffectsFeature_VideoEffectError(object sender, VideoEffectErrorEventArgs e)
{
    String effectName = args.VideoEffectName;
    String errorCode = args.Code;
    String errorMessage = args.Message;

    Trace.WriteLine("VideoEffects VideoEffectError on effect " + effectName + "with code "
        + errorCode + "and error message " + errorMessage);
}

次のように背景ぼかし効果を有効または無効にします。

private async void BackgroundBlur_Click(object sender, RoutedEventArgs e)
{
    if (localVideoEffectsFeature.IsEffectSupported(backgroundBlurVideoEffect))
    {
        var backgroundBlurCheckbox = sender as CheckBox;
        if (backgroundBlurCheckbox.IsChecked.Value)
        {
            localVideoEffectsFeature.EnableEffect(backgroundBlurVideoEffect);
        }
        else
        {
            localVideoEffectsFeature.DisableEffect(backgroundBlurVideoEffect);
        }
    }
}

背景置換

背景の置換は、アプリケーションが人の背景を置き換えることを可能にするビデオ効果です。バックグラウンドビデオエフェクトを使用するには、有効なVideoEffectsLocalVideoStreamFeatureからLocalVideoStream機能を取得する必要があります。

背景置換ビデオ効果を有効にするには:

BackgroundReplacementEffect インスタンスを MainPage に追加します。

public sealed partial class MainPage : Page
{
    private BackgroundReplacementEffect backgroundReplacementVideoEffect = new BackgroundReplacementEffect();
}

VideoEFfects 機能を取得し、イベントをサブスクライブするメソッドを作成します:

private async void LocalVideoEffectsFeature_VideoEffectEnabled(object sender, VideoEffectEnabledEventArgs e)
{
    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, async () =>
    {
        BackgroundReplacement.IsChecked = true;
    });
}

private async void LocalVideoEffectsFeature_VideoEffectDisabled(object sender, VideoEffectDisabledEventArgs e)
{
    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, async () =>
    {
        BackgroundReplacement.IsChecked = false;
    });
}

private void LocalVideoEffectsFeature_VideoEffectError(object sender, VideoEffectErrorEventArgs e)
{
    String effectName = args.VideoEffectName;
    String errorCode = args.Code;
    String errorMessage = args.Message;

    Trace.WriteLine("VideoEffects VideoEffectError on effect " + effectName + "with code "
        + errorCode + "and error message " + errorMessage);
}

バッファーを通して画像を渡すことでカスタム背景を設定します。

//example of getting the image from storage folder
MemoryBuffer memoryBuffer = new MemoryBuffer(0);
StorageFolder InstallationFolder = Windows.ApplicationModel.Package.Current.InstalledLocation;
StorageFile file = InstallationFolder.GetFileAsync("image.jpg").GetAwaiter().GetResult();
if (File.Exists(file.Path))
{
    byte[] imageBytes = File.ReadAllBytes(file.Path);
    memoryBuffer = new MemoryBuffer((uint)imageBytes.Length);
    using (IMemoryBufferReference reference = memoryBuffer.CreateReference())
    {
        byte* dataInBytes;
        uint capacityInBytes;

        (reference.As<IMemoryBufferByteAccess>()).GetBuffer(out dataInBytes, out capacityInBytes);
        for (int i = 0; i < imageBytes.Length; i++)
        {
            dataInBytes[i] = imageBytes[i];
        }
    }
    return memoryBuffer;
}
backgroundReplacementVideoEffect.Buffer = memoryBuffer;

以下のようにして背景置換効果を有効または無効にします。

private async void BackgroundReplacement_Click(object sender, RoutedEventArgs e)
{
    if (localVideoEffectsFeature.IsEffectSupported(backgroundReplacementVideoEffect))
    {
        var backgroundReplacementCheckbox = sender as CheckBox;
        if (backgroundReplacementCheckbox.IsChecked.Value)
        {
            localVideoEffectsFeature.EnableEffect(backgroundReplacementVideoEffect);
        }
        else
        {
            localVideoEffectsFeature.DisableEffect(backgroundReplacementVideoEffect);
        }
    }
}

次のステップ

Calling Hero サンプルを確認してください。
UI ライブラリの使用を開始します。
Calling SDK の機能について確認する。
通話のしくみの詳細について確認する。

次の方法で共有

ビデオのバックグラウンド効果を有効にする

ビデオ効果を実装する

パッケージをインストールする

背景ぼかし

背景をイメージに置き換える

つや消しガラスの背景効果を追加する

ビデオ効果を実装する

背景ぼかし

背景置換

ビデオ効果の使用

背景ぼかし

背景置換

ビデオ効果の使用

背景ぼかし

背景置換

次のステップ

フィードバック

その他のリソース