@shiguredo/virtual-background


JavaScript/TypeScriptで仮想背景機能を実現するためのライブラリです。

背景の画像の差し替えやぼかしを簡単に行うことができます。

なお、背景画像の切り出し部分には@mediapipe/selfie_segmentationを利用しています。

使い方

$3

まずは script タグで JavaScript ファイルを読み込みます:
``html

`

背景ぼかしを行う場合は、以下のようなコードになります:
`html

`

ぼかすのではなく、背景画像を差し替えたい場合には、以下のようにオプションを指定してください:
`html

`

実際の動作はデモページ（
ソースコード）で確認できます。

$3

以下のコマンドでパッケージがインストールできます:
`
$ npm install --save @shiguredo/virtual-background
`

TypeScript での使用方法は次のようになります:
`typescript
import { VirtualBackgroundProcessor } from "@shiguredo/virtual-background";

const assetsPath = "https://cdn.jsdelivr.net/npm/@shiguredo/virtual-background@latest/dist";
const processor = new VirtualBackgroundProcessor(assetsPath);

const options = {
blurRadius: 15, // 背景ぼかし設定
};
const processed_video_track = await processor.startProcessing(original_video_track, options);

...

processor.stopProcessing();
`

サポートブラウザ

本ライブラリは Chrome や Edge 等の Chromium ベースのブラウザか Safari (15.4 以降）で動作します。
それぞれのブラウザでは、映像処理を効率的に行うために以下の機能を利用しています:
- Chromium ベースブラウザ: MediaStreamTrack Insertable Streams (aka Breakout Box)
- Safari: HTMLVideoElement.requestVideoFrameCallback メソッド

ライセンス

Apache License 2.0

`
Copyright 2022-2022, Takeru Ohta (Original Author)
Copyright 2022-2022, Shiguredo Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
`

npm パッケージに同梱されている以下のファイルのライセンスについては
@mediapipe/selfie_segmentation を参照してください:
`
- selfie_segmentation.binarypb
- selfie_segmentation_landscape.tflite
- selfie_segmentation_solution_simd_wasm_bin.wasm
- selfie_segmentation_solution_wasm_bin.wasm
- selfie_segmentation.tflite
- selfie_segmentation_solution_simd_wasm_bin.js
- selfie_segmentation_solution_wasm_bin.js
``