ドキュメント
ドキュメントを参照する
最も早く答えを見つける方法はドキュメントです。機能ページでは各オプションが詳しく説明されており、トラブルシューティングガイドでは最も一般的な問題を取り上げています。
コミュニティ
Discordに参加する
DanceXRコミュニティはDiscordで活発です。他のユーザーを見つけ、作品を共有し、同じ問題を経験した人からすばやく回答を得ましょう。
よくある質問
よくある質問(FAQ)
空だけ表示されてUIやカメラ操作ができない
起動時に何らかの問題が発生していることが多いです。以下の順番でお試しください:
license.txtを削除して再起動するconfig.jsonをバックアップして削除する — 設定がリセットされ、破損した設定ファイルが原因の問題が解決します- コンテンツライブラリから
cache.jsonをバックアップして削除する
毎回クラッシュする — 古いバージョンに戻しても改善しない
これは通常DanceXR自体の問題ではなく、VRランタイムの問題です。
- 複数のVRランタイムがある場合は別のものに切り替えてみる
- SteamVRの場合:不要なスタートアップオーバーレイやアドオンを無効にする。クリーンインストールも試してください
- SteamVRの
driverフォルダーに最近インストールまたは更新されたものがないか確認する
再アクティベーションを求められる
OSのアップデート、ハードウェアのアップグレード、その他のシステム変更後にデバイスIDが変わることがあります。アクティベーション手順をもう一度実行するだけで解決します。問題がある場合はお問い合わせください。
VRが起動できない
DanceXRはOpenXRを使用してVRを初期化します。複数のVRランタイムがインストールされている場合は、いずれかをアクティブなOpenXRランタイムとして設定する必要があります:
- Oculus / Meta: OculusアプリをOpen → 設定 → ベータ → OpenXRランタイム → 「Oculusをアクティブに設定」
- SteamVR: SteamVRを開く → 左上メニュー → 設定 → 開発者 → 「SteamVRをOpenXRランタイムに設定」
- Windows Mixed Reality: MicrosoftストアでWMR OpenXRデベロッパーツールをインストールし、WMRをアクティブに設定する
モデルを読み込んでも全部白い
最も一般的な原因はファイル名のエンコーディングです。異なる文字エンコーディングを使用しているとテクスチャが見つからない場合があります。
- ZIPパッケージの場合は、パッケージ名にエンコーディング情報を追加することでDanceXRが正しく解析できます。詳細はこちら →
- ファイル名の余分なスペースもテクスチャの読み込みを妨げます。PMXEditorでモデルを開いてテクスチャ参照が実際のファイル名と一致しているか確認してください
髪のマテリアルが透けて見える
デフォルトで透明度の深度プリパスがオンになっています。これにより最上位の透明レイヤーのみがレンダリングされ、重なった透明レイヤー(髪など)が透けて見えることがあります。
- 透明度の深度プリパスをオフにすることで全ての透明レイヤーをレンダリングできますが、マテリアルの順序が正しくない場合に表示の乱れが生じる可能性があります
- 完璧な解決策はありません — 異なる設定を試してより問題の少ないものを使用してください
ステージモデルのスカイスフィアに穴があったりピクセル化して見える
これも透明度の深度プリパスが原因です。複数のスカイスフィアが透明な場合、一部の領域では最上位のレイヤーのみが完全にレンダリングされます。
- 透明度の深度プリパスをオフにする、または
- 背景のスカイスフィアを見つけてマテリアルを透明から不透明に変更する
トラブルシューティング
ログファイルの場所
バグを報告する際にログファイルを添付すると非常に役立ちます。ログファイルにはエラーの発生時の記録が含まれており、問題を素早く診断できます。
ログファイルの場所(PC):
C:\Users\[ユーザー名]\AppData\LocalLow\VR Storm Lab\DanceXR HD
最後のフォルダー名はバージョンによって異なります — DanceXR HD、DanceXR LW、または DanceXR RT の場合があります。
AppData フォルダーが見つからない場合は、まず エクスプローラーで隠しファイルを表示する設定 にしてください。
フォルダーを開いたら Player.log(現在のセッション)と Player-prev.log(前のセッション)を報告に添付してください。
クイックフィックス
報告する前に
まず以下の手順を試してください — 多くの問題はこれで解決します:
- 最新バージョンに更新する — 問題がすでに修正されている可能性があります
- 設定をリセットする —
config.jsonをバックアップして削除し、設定ファイルの破損を除外する - ログを確認する —
Player.logを開いてERRORまたはExceptionを検索して問題を特定する - VRが起動しない — OpenXRランタイムが正しく設定されているか確認する(上記のFAQを参照)
- 白いテクスチャ — テクスチャ参照のファイル名のエンコーディングと余分なスペースを確認する
これらで解決しない場合は、報告する価値があります。
お問い合わせ