モデルを読み込んでも全部が白い

最も一般的な原因はファイル名のエンコーディングです。ファイル名が異なる文字エンコーディングを使用している場合、テクスチャを見つけることができません。

• ZIPパッケージの場合、エンコーディングをパッケージ名に追加して、DanceXRがファイル名を解析する方法を理解できるようにします。詳細はこちら →
• ファイル名内の余分なスペースもテクスチャの読み込みを妨げることがあります。PMXEditorでモデルを開き、テクスチャ参照が実際のファイル名と完全に一致しているか確認してください。

髪のマテリアルが透けて見える

透明度の深度プリパスがデフォルトでオンになっています。これは、最上層の透明レイヤーのみをレンダリングすることで透明度のソートを修正します。つまり、積み重ねられた透明レイヤー（層状の髪など）は最上層のみが表示されます。

• すべての透明レイヤーをレンダリングするために、透明度の深度プリパスをオフにします。モデルのマテリアルの順序が正しくない場合、ソートのアーティファクトが発生する可能性があります。
• 完璧な万能の解決策はありません。異なる設定を試して、視覚的な問題が少ないものを使用してください。

ステージモデルのスカイスフィアに穴が開いている、またはピクセル化して見える

これも透明度の深度プリパスが原因です。複数のスカイスフィアが透明な場合、一部の領域では最上層のみが完全にレンダリングされます。

• 透明度の深度プリパスをオフにする、または
• 背景のスカイスフィアを見つけ、そのマテリアルを透明から不透明に変更する。

バグを報告する前に、以下の簡単な修正をお試しください：

1. 最新バージョンに更新 — 問題が新しいリリースですでに解決されている可能性があります。
2. 設定のリセット — 破損した設定ファイルを排除するために、バックアップを取ってから config.json を削除します。
3. ライセンスのリセット — アプリの起動に失敗したり動作がおかしい場合は、インストールディレクトリから license.txt を削除して再起動してみてください。
4. ライブラリキャッシュのクリア — コンテンツライブラリフォルダから cache.json をバックアップして削除し、プレイヤーにファイルの再スキャンを強制します。
5. OpenXRセットアップ — VRが起動しない場合は、VRソフトウェアの設定でアクティブなOpenXRランタイムが正しく設定されているか再確認してください。

ログファイルはどこにありますか？

バグを報告する際、ログファイルを添付すると非常に役立ちます。バグ報告には、Player.log（現在のセッション）とPlayer-prev.log（以前のセッション）を添付してください。

Windows PCのパス:

C:\Users\[User]\AppData\LocalLow\VR Storm Lab\DanceXR [HD|LW|RT]\Player.log

注: [User]をWindowsのユーザー名に置き換えてください。AppDataが隠しフォルダになっている場合は、エクスプローラーで「隠しファイル」を表示する設定にしてください。

Android & Meta Questのパス:

/Android/data/com.vrstormlab.dancexr/files/Player.log

注: デバイスをUSBでPCに接続し、ファイル転送モードを使用してこのファイルを見つけてください。

空だけが表示され、UIやカメラ操作ができない

これは通常、起動時に何らかの問題が発生していることを意味します。以下の手順を順番にお試しください：

• license.txtを削除して再起動する。
• config.jsonを削除する（先にバックアップすること）—これによりすべての設定がリセットされ、破損した設定ファイルが原因の問題が解決します。
• コンテンツライブラリからcache.jsonを削除する（先にバックアップすること）。

起動するたびにクラッシュする—古いバージョンに戻しても改善しない

これは通常、DanceXR自体ではなく、VRランタイムの問題です。

• 複数のVRランタイムがある場合は、別のものに切り替えてみる。
• SteamVRの場合：不要な起動オーバーレイやアドオンを無効にし、クリーン再インストールを試してください。
• SteamVRのdriverフォルダー内で、削除できる最近インストールまたは更新されたものがないか確認する。

VRが起動できない

DanceXRはOpenXRを使用してVRを初期化します。複数のVRランタイムがインストールされている場合は、いずれか一つをアクティブなOpenXRランタイムとして設定する必要があります：

• Oculus / Meta： Oculusアプリを開く → 設定 → ベータ → OpenXRランタイム → 「Oculusをアクティブに設定」
• SteamVR： SteamVRを開く → 左上メニュー → 設定 → 開発者 → 「SteamVRをOpenXRランタイムに設定」
• Windows Mixed Reality： Microsoftストアから「Windows Mixed Reality OpenXR Developer Tools」をダウンロードし、そこからWMRをアクティブに設定する

AndroidまたはMeta Questでコンテンツライブラリを設定するにはどうすればよいですか？

Androidシステムには厳格なファイルアクセス制限があります。デフォルトでは、コンテンツライブラリはアプリの内部ストレージ内に配置されます。

• デバイスをUSB経由でPCに接続し、「ファイル転送」を選択し、/Android/data/com.vrstormlab.dancexr/files/またはルートの/DanceXR/フォルダに移動して、zipや画像ファイルをコピーします。
• AndroidおよびMeta Quest（バージョン2024.3以降）では、DanceXRにストレージ権限を付与して、システムファイルアプリまたは組み込みのコンテンツマネージャーアプリを使用してライブラリを共有・管理します。
• 詳細については、Android & Quest用コンテンツライブラリガイドを参照してください。

再度アクティベートを求められる

大規模なOSまたはハードウェアの変更後、DanceXRはシステムをライセンス発行時と同じものとして認識しない場合があります。アクティベーション手順を再度実行するだけで解決します。追加の費用はかかりません。アクティベーションとライセンスガイドを参照してください。問題がある場合はお問い合わせください。