Skip to content

desktop_ja.md

Latest commit

 

History

History
163 lines (101 loc) · 6.94 KB

desktop_ja.md

File metadata and controls

163 lines (101 loc) · 6.94 KB
Raw

iw3-desktop: PCデスクトップ3Dストリーミングツール

概要

iw3-desktopは、PCのデスクトップ画面をリアルタイムで3D変換し、WiFi経由でストリーミング配信するツールです。Meta QuestなどのVRデバイスのブラウザからサイドバイサイド3Dとして視聴できます。

PC上に表示されるあらゆる画像や動画をリアルタイムでVR空間で視聴することが可能です。PCの操作には、引き続きPCのキーボードとマウスを使用し、音声もPCから出力されます。VRデバイスはディスプレイとして機能します。

GUIウィンドウやテキストの深度推定結果は完全ではないため、3D酔いに注意が必要です。本ツールは、基本的に画像や動画を全画面再生する用途を想定しています。

Webストリーミングに加えて、ローカルビューワーとしてのウィンドウ表示にも対応しています。これは、ウィンドウまたは仮想モニターをキャプチャーする機能を持つ3DモニターやVRデスクトップソフトウェア（Virtual DesktopやBigscreenなど）の配信機能を活用するものです。

既知の問題

  • Meta QuestおよびPICO 4での動作は確認済みですが、VisionProでは動作しません。
  • Linux/Wayland環境ではパフォーマンスが著しく低下します。Linuxをご利用の場合はX11環境での使用を推奨します。

セキュリティに関する注意

iw3-desktopは、デフォルトでパスワードなしのHTTPサーバーを起動します。同一ネットワーク内の他のPCからアクセスされる可能性があるため、ご注意ください。

ベーシック認証のパスワードは--passwordオプションで設定できます。

GUIの使用方法

Windowsでnunif-windows-packageを使用している場合、iw3-desktop-gui.batを実行することでGUIが起動します。もしiw3-desktop-gui.batが存在しない場合は、update-installer.batとupdate.batを実行してください。

コマンドラインから起動する場合は、以下のコマンドを使用します。

python -m iw3.desktop.gui

iw3-desktop-gui

CLIの使用方法

以下のコマンドでサーバーを起動します。

python -m iw3.desktop

(Windowsでnunif-windows-packageを使用している場合、nunif-prompt.batを起動し、コンソールから上記のコマンドを入力してください。)

サーバーが正常に起動すると、以下のようなメッセージが表示されます。

Open http://192.168.11.6:1303
Estimated FPS = 30.24, Streaming FPS = 0.00

(192.168.11.6のアドレスは、ネットワーク環境によって異なります。)

ファイアウォールのダイアログが表示された場合は、アクセスを許可してください。

PCのブラウザで表示されたURLを開き、動画が再生されることを確認してください。ウェブページはGoogle ChromeとMeta Quest 2 Browserで動作確認済みです。Firefoxでは動作しません。

LAN内のPCアドレスが正しく検出されない場合は、--bind-addrオプションでIPアドレスを指定できます。

python -m iw3.desktop --bind-addr 192.168.1.2

Meta Questでの視聴方法

Meta Quest 2での動作を確認しています。以下の手順で3D動画を再生できます。

  1. Browserを起動します。
  2. サーバーのURLを入力します。
  3. (オプション) URLをお気に入りに登録します。
  4. 動画を再生します。
  5. Browser右上のアイコンからブラウザを全画面表示にします。
  6. 動画右下のアイコンから動画を全画面表示にします。
  7. Browser下部のフロントメニューのスクリーンアイコンからディスプレイモード > 3Dサイドバイサイドに設定します。
  8. (オプション) カーブウィンドウに設定します。

ディスプレイモードは、動画とブラウザの両方が全画面表示になっている場合にのみ変更できる点にご注意ください。

その後はPCのキーボードとマウスを使用して、表示されているスクリーンを操作できます。

オプション

PICO 4用オプション

ユーザーからの報告によると、PICO 4のブラウザは動画をFull SBSで表示します。

--full-sbsオプションを使用することで、ストリーミング動画をFull SBSに変更できます。

python -m iw3.desktop --full-sbs

デフォルトはHalf SBSです。Meta QuestのブラウザはHalf SBSのみに対応しています。

解像度 (動画解像度)

--stream-heightオプションで画面の垂直方向の解像度を指定できます。デフォルトは1080pxです。

python -m iw3.desktop --stream-height 720

FPS

--stream-fpsオプションでストリーミングのフレームレート（FPS）を指定できます。デフォルトは15FPSです。

python -m iw3.desktop --stream-fps 30

Estimated FPSが指定されたFPSよりも著しく低い場合、PCの性能が指定されたFPSの処理に追いついていないことを意味します。

--batch-size 1での処理のため、FPSは動画変換時よりもかなり低くなります。また、ブラウザの制限により、Streaming FPS = 30を超えるFPSは達成できない可能性があります。

MJPEG 設定

--stream-qualityオプションでJPEGの品質を指定できます（0-100）。

python -m iw3.desktop --stream-quality 80

デフォルトは90です。低い値を指定すると、ネットワークトラフィックが削減されます。

ステレオ設定

GUI/CLIと同じオプションを指定できます。

python -m iw3.desktop --depth-model ZoeD_Any_N --divergence 2 --convergence 0.5 --resolution 518

デフォルトは、--depth-model Any_V2_S --divergence 1 --convergence 1です。

ネットワーク

--bind-addrと--portオプションでHTTPサーバーを起動するアドレスとポートを指定できます。

python -m iw3.desktop --port 7860

サーバーをインターネットに公開する場合（非推奨）：

python -m iw3.desktop --bind-addr 0.0.0.0 --port 7860

認証

--userと--passwordオプションでHTTPベーシック認証を設定できます。

python -m iw3.desktop --password iw3
python -m iw3.desktop --user admin --password 1234

ローカルビューワー

--local-viewerオプションを指定します。

CLIから指定した場合でもGUIウィンドウが表示されるため、wxpythonとOpenGLが必要です（requirements-gui.txtからインストールされます）。