トラブルシューティング

サブシステムではなく、症状から探してください。下のどれにも当てはまらないときは それでも解決しないときへ進んでください。

ダッシュが出てこない

vrOS は、呼び出しのアクションが発火したときにダッシュを表示します。それを発火させ る入力は vrOS の中にはありません。コントローラーのバインドは SteamVR が持ってい て、vrOS はアクションを登録するだけです。

1. SteamVR を開き、コントローラー バインドへ進みます。使っているコントローラーに 対して vrOS が並び、付属の既定バインドが読み込まれているはずです。
2. VR の中で設定を開き、操作へ進みます。vrOS が今見ているバイン ドがそのまま表示され、「STEAMVR で編集」で SteamVR のバインド画面が該当のページ で開きます。デスクトップのウィンドウではこれらの行は空で、ボタンも無効です — この表示には動作中の VR セッションが必要です。

既定では、割り当てられている入力はダブルタップです。そのままのダブルタップはすべ てを隠す / 表示し、手のポーズを構えたままダブルタップすると、ダッシュだけを切り替 えます（出荷時の既定のポーズは、左手のフィンガーガンです）。コード、ポーズ、どち らの手かは、いずれも設定 → 操作にあります。1 回の押下が両方のコードを満たしたとき はダッシュのコードが勝ちます — ダッシュはいつでも呼び戻せるということです。

vrOS は、SteamVR がすでに動いているときにそこへ接続します。自分から起動することは ありません。FAQを参照してください。

すべて消えたが、SteamVR は正常

それは「すべて隠す」です。もう一度ダブルタップすれば戻ります。ピン留めしたオー バーレイは対象外で、表示されたままです。ダッシュの一覧や デスクトップウィンドウから 1 つのオーバーレイを表示すると、それだ けが現れます。「すべて隠す」は見え方だけの話です。保存されることはなく、VR 側が再 起動するようなことがあれば、オーバーレイは表示された状態で戻ってきます。

SteamVR のクラッシュのあとオーバーレイが消えた

自然に戻ります。VR ランタイム、GPU、キャプチャ API に触れる処理はすべて別の監視付 き子プロセスで動き、永続する状態はすべてコアアプリにあります。ランタイムが落ちて もコアは無傷です。子プロセスは切り離され、ランタイムが戻るのを待って、接続し直し ます。子プロセス自身が死んだ場合は、vrOS がバックオフをはさんで再起動し、コアの状 態から作り直します — その場で、レイアウトもそのままで。

戻ってこない唯一のケースは、クラッシュループです。短い時間に失敗が繰り返される と、vrOS は子プロセスの再起動をやめ、無駄に暴れる代わりに、トレイとデスクトップの ウィンドウにエラーを出します。エラーはそこで読んでください。

パネルは出ているが、何も反応しない

まず SteamVR 自体が完全に接続されているか確認してください。映像ケーブルはつながっ ているのに USB がつながっていないヘッドセットでは、SteamVR は半分だけ接続された状 態になります。パネルは描画されますが、トラッキングも入力も届かず、ダッシュは静止 画のように見えます。ダッシュが死んで見える原因としては、これがいちばん多いもので す。他を調べる前に、SteamVR がヘッドセットとコントローラーを準備完了として報告し ているか照合してください。

クリックやキー入力が違う場所へ行く

vrOS には、入力を VR とデスクトップのどちらに渡すかを決める調停役がひとつだけあり、 その仕事は邪魔をしないことです。今どちらに渡っているかはダッシュ上のチップに出ます。 VR、切替、デスクトップのいずれかです。

• 物理のマウスやキーボードに触れると、入力はただちにデスクトップへ戻ります。机 にぶつかった程度なら短いロックアウト、意図的で継続したマウスの動きならより長い ロックアウトになります。
• VR が入力を取り戻すのは、オーバーレイの上で意図的にトリガーを引いたときだけで す。コントローラーを動かしただけでは取り戻しません。
• 入力は、最後にクリックしたキャプチャパネルへ届きます。キー入力が違うウィンドウ に落ちるときは、まず目的のパネルをトリガーでクリックしてください。
• 物理キーボードで入力した直後は、VR キーボードは表示されたまま、数秒間だけ効かな くなります。そのロックアウトの間、キーは中途半端に効くのではなく、まったく効き ません。トリガーでパネルをクリックすれば取り戻せます。

全体のモデルは入力とVR キーボードにあります。

特定のウィンドウだけクリックが効かない (Windows)

Windows は、送り手より高い権限で動いているウィンドウへの注入された入力を拒否しま す。vrOS は意図的に昇格せずに動き、自分を昇格させることもないので、管理者として動 いているウィンドウは、パネルからのクリックもキー入力も受け付けません。ソースのピ ッカーはそうしたウィンドウにバッジを付けるので、キャプチャする前に分かります。可 能であれば、そのアプリを管理者権限なしで起動してください。

キャプチャしたウィンドウに琥珀色のバッジが出る

琥珀色は、ソースのウィンドウが OS のレベルで最小化されているという意味です。キャ プチャは止まり、パネルは最後のフレームをそのまま平らに保ち、描き直しは 0 回になり ます。「復元」を使ってください — オーバーレイの行と、追加の一覧の行の両方にありま す — ウィンドウを元に戻し、落ち着いたところでソースを一覧に載せ直します。

最小化ではなくソースそのものが失われている場合は、パネルがソース喪失と表示しま す。ウィンドウが閉じられたということです。オーバーレイを削除して（「確認」と 「キャンセル」による 2 段階です）、もう一度キャプチャしてください。

保存したプリセットを呼び出すと、まず最小化されたソースを元に戻してからレイアウト を適用するので、プリセットが固まったパネルだらけで戻ってくることはありません。

オーバーレイが思わぬ場所に戻ってきた

既定では、ワールドにアンカーしたオーバーレイを表示すると、今立っている場所に呼び 寄せられ、与えた配置はそのまま保たれます。行のトグル、プリセットの呼び出し、 「すべて隠す」からの復帰、起動時の復元のいずれもこれに当てはまります。ピン留めし たオーバーレイは、部屋の中で置いたその場所をそのまま保ちます。どちらの挙動も 設定 → 一般のスイッチで、新しいオーバーレイの既定値や、そもそも再起動時にオーバー レイを復元するかどうかの隣にあります。オーバーレイごとの「中央に戻す」は、そのパ ネルを 1 つだけ手元に引き戻します。パネルと プレイスペースを参照してください。

音が違うデバイスから出る

設定 → オーディオのルーティングは、チャンネルごとに出力デバイスを 1 つ割り当てま す。サウンドボードの再生、仮想マイクへの送り、そして UI とキーボードのフィードバ ックです。空欄は、システム既定の出力を意味します。

設定したデバイスが接続されていないときは、ペインにデバイス未接続と出ます。そのチ ャンネルの音は、知らないうちにどこか別の場所へ移されるのではなく、待機します。唯 一の例外は UI のチャンネルで、こちらはシステム既定にフォールバックします。キー ボードのフィードバックが無音になるほうが、移動するより困るからです。デバイスを挿 し直せばチャンネルは結び直されますし、システム既定デバイスの変更も、再起動なしで 反映されます。音量 0 がミュートで、別のミュートのスイッチはありません。

パフォーマンスの数値がおかしく見える

まずパフォーマンスから始めてください。とくに誤解を招きやすい 表示が 2 つあります。

ドライバー時間。 各コアのセルには、DPC と割り込み時間のための細い副バーが付い ています。ドライバー時間が 0 のときは出ません。健全なマシンでは、ほとんどのコア秒 がそれに当たります。2 本のバーは軸が違い — コアのバーは 0 から 100 パーセント、副 バーは 0 から 25 です — 細いバーのほうが、小さい数値を表しながら高く描かれること があります。正確な数字は、セルにホバーするかフォーカスすると開く表示から読んでく ださい。コア、ビジー率、DPC、ISR です。DPC が数パーセントのまま居座り続けているコ アは、アプリケーションの処理ではなく、遅延されたドライバーの処理をしています。あ るテスト機では、あるコアがビジー 9.23 パーセント、そのうち 4.62 パーセントが DPC でした — そのコアの時間の半分はドライバーで、プロセスの一覧では決してそうとは分か りません。Linux では、同じ 2 つの量が irq と softirq から来ます。

トップのプロセスと I/O の行。 どちらも、システム全体のプロセス表を 2 秒ごとに 1 回読む処理から来ていて、その読み取りはダッシュが表示されている間だけ行われま す。名前は実行ファイルの名前です。設定 → 一般でプロセスモニターをオフにすると、両 方が隠れ、読み取りも止まります。

領域の配置（ストリップ、クラシック、コンソール、拡大）とデバイスバンドも、 設定 → 一般にあります。

Linux についての注記

キャプチャはデスクトップの画面共有ポータルを通るので、表示されるピッカーは、デス クトップ環境そのもののダイアログです。そこでキャンセルすると、キャプチャは始まり ません。

Linux ホストから Quest 系のヘッドセットへ無線でストリーミングする場合、Steam Link は Linux ホスト側で上流が壊れています。WiVRn か Monado、ALVR、あるいは有線のヘッド セットを使ってください。

設定の保存場所

Windows では %APPDATA%\vrOS\config.toml、Linux では $XDG_CONFIG_HOME/vros/config.toml です。このファイルは、設定を初めて変更したとき に作られます。それまでは、ファイルがないことが既定値を意味します。

注意

このファイルを手で編集する場合は、キー名を正確に保ってください。知らないキーは、 黙って何も起きないのではなく、はっきりと読み込みを失敗させます。範囲外の数値は、 警告とともにいちばん近い境界へ丸められます。

それでも解決しないとき

• Discord — いちばん速く、他の利用者もいます。
• support.vros.cat — 公開のトラッカーにバグ報告を登録 し、追える番号が発行されます。

OS、ヘッドセット、使っている VR ランタイム（SteamVR、または Monado と WiVRn）、そ しておかしくなる直前に何をしていたかを書き添えてください。vrOS にはテレメトリーが なく、クラッシュレポートも送信しないので、自分で送らない限り、問題について私たち に届くものは何もありません。