IronHSP 仮想ウェブカメラ ガイド

hspvcam DirectShow 仮想カメラプラグイン — 最終更新: 2026-04-18

1. 仮想ウェブカメラとは

仮想ウェブカメラ (Virtual Webcam) とは、物理的なカメラデバイスがなくても、ソフトウェアが生成した映像をあたかもウェブカメラの映像であるかのように OS に認識させる仕組みです。

IronHSP の hspvcam プラグインは DirectShow ソースフィルタ として実装されており、regsvr32 で登録すると Windows のカメラデバイス一覧に「IronHSP Virtual Camera」として表示されます。HSP プログラムから送信した映像を、Zoom、Google Meet、Microsoft Teams、Discord など、カメラ入力に対応するあらゆるアプリケーションで使用できます。

2. アーキテクチャ

hspvcam.dll は1つの DLL で2つの役割を果たします:

この設計のメリット

• 単一 DLL — ブリッジプロセスが不要。hspvcam.dll 一つで完結
• クロスプロセス — 共有メモリを使うため、32bit HSP と 64bit アプリ (またはその逆) の組み合わせでも動作可能
• 高効率 — フレームデータのコピーは memcpy 1回のみ。ネットワーク等を経由しない
• 互換性 — DirectShow はほぼ全てのカメラ対応アプリで使用可能

3. セットアップ手順

3.1 必要なファイル

3.2 DirectShow フィルタの登録

仮想カメラデバイスを OS に認識させるため、管理者権限のコマンドプロンプトで以下を実行します:

; 32bit 版の登録
regsvr32 hspvcam.dll

; 64bit 版の登録 (64bit アプリで使う場合)
regsvr32 hspvcam_64.dll

3.3 登録解除

仮想カメラを削除する場合:

regsvr32 /u hspvcam.dll
regsvr32 /u hspvcam_64.dll

4. クイックスタート

最小限のコードで仮想カメラにフレームを送信する例です:

#include "iron_vcam.hsp"

    ; 640x480, 30fps で仮想カメラを初期化
    vcam_init 640, 480, 30
    if stat != 0 : dialog "失敗" : end

    screen 0, 640, 480
    title "Virtual Webcam"

    repeat
        redraw 0
        color 0, 0, 0 : boxf
        color 255, 255, 255
        pos 10, 10 : mes "Hello Virtual Camera!"
        pos 10, 30 : mes "Frame: " + cnt
        redraw 1

        ; カレントスクリーンを送信
        vcam_send

        await 33   ; 約 30fps
    loop

5. API リファレンス

5.1 高レベル API (iron_vcam.hsp)

#include "iron_vcam.hsp" で利用できるモジュール版 API です。

5.2 低レベル API (hspvcam.as)

#include "hspvcam.as" で利用できる DLL 直接呼び出し API です。

6. DirectShow 仮想カメラの仕組み

6.1 DirectShow とは

DirectShow は Windows のマルチメディアフレームワークで、フィルタグラフと呼ばれるパイプラインでメディアを処理します。カメラデバイスは「ソースフィルタ」として実装され、映像フレームをダウンストリームに配信します。

6.2 hspvcam.dll の COM 登録

regsvr32 hspvcam.dll を実行すると、以下のレジストリエントリが作成されます:

これにより、アプリケーションが CLSID_VideoInputDeviceCategory を列挙したとき (= カメラ一覧を取得したとき) に「IronHSP Virtual Camera」が表示されるようになります。

6.3 フレーム配信の流れ

1. HSP プログラムが vcam_create() で共有メモリとイベントを作成
2. HSP が vcam_send_frame() でフレームデータを共有メモリに書き込み、イベントをシグナル
3. 消費アプリが「IronHSP Virtual Camera」を選択すると、hspvcam.dll がそのプロセス内にロード
4. DirectShow フィルタのストリーミングスレッドが共有メモリを開き、イベントを待機
5. イベントがシグナルされるとフレームを読み出し、IMemInputPin::Receive() でダウンストリームに配信
6. フィルタは consumer_alive フラグを 1 に設定し、HSP 側が接続状態を確認可能

6.4 ピクセルフォーマット

• フォーマット: BGRA (Blue, Green, Red, Alpha) = MEDIASUBTYPE_RGB32
• ビット深度: 各チャンネル 8 bit (32 bpp)
• 走査方向: 共有メモリ内はトップダウン。DirectShow フィルタが自動的にボトムアップに変換
• ストライド: width * 4 (パディングなし)

7. アプリケーションでの仮想カメラ選択

7.1 Zoom

1. 設定 → ビデオ を開く
2. 「カメラ」ドロップダウンから「IronHSP Virtual Camera」を選択
3. プレビューに HSP からの映像が表示される

7.2 Microsoft Teams

1. 設定 → デバイス → カメラ を開く
2. 「IronHSP Virtual Camera」を選択

7.3 Google Meet

1. 設定 (歯車アイコン) → ビデオ を開く
2. カメラのドロップダウンから選択

7.4 Discord

1. 設定 → 音声・ビデオ を開く
2. 「ビデオカメラ」から「IronHSP Virtual Camera」を選択

8. コード例

8.1 基本的な配信

#include "iron_vcam.hsp"

    screen 0, 640, 480
    vcam_init 640, 480, 30
    if stat != 0 : dialog "初期化失敗" : end

    repeat
        redraw 0
        color 0, 0, 64 : boxf
        color 255, 255, 255
        pos 10, 10 : mes "Live from IronHSP!"
        redraw 1
        vcam_send
        await 33
    loop

8.2 接続状態の監視

#include "iron_vcam.hsp"

    vcam_init 640, 480, 30
    if stat != 0 : end

    screen 0, 320, 100

    repeat
        redraw 0
        color 240, 240, 240 : boxf

        if vcam_is_active() {
            color 0, 128, 0
            pos 10, 10 : mes "状態: 配信中"
        } else {
            color 200, 0, 0
            pos 10, 10 : mes "状態: 待機中"
        }

        color 0, 0, 0
        pos 10, 40 : mes "ESC で終了"
        redraw 1

        vcam_send

        getkey k, 27
        if k : break
        await 100
    loop

    vcam_term
    end

8.3 hspcv4 との連携 (カメラ映像にエフェクト)

#include "iron_vcam.hsp"
#include "hspcv4.as"

    cam_w = 640 : cam_h = 480
    vcam_init cam_w, cam_h, 30
    if stat != 0 : end

    ; 物理カメラを開く
    cv4_video_open 0, "0"

    screen 0, cam_w, cam_h

    repeat
        ; カメラからフレーム取得
        cv4_video_read 0, 1

        ; エッジ検出エフェクト
        cv4cvt 2, 1, CV4_BGR2GRAY
        cv4canny 3, 2, 50, 150, 3

        ; HSP 画面に表示
        redraw 0
        cv4getimg 3, bmscr
        redraw 1

        ; 仮想カメラに送信
        vcam_send

        await 33
    loop

9. トラブルシューティング