コンテンツライブラリ

コンテンツライブラリは、DanceXRがコンテンツを配置し、ユーザーが作成した設定を保存するフォルダです。

コンテンツライブラリの場所

Windows: Windowsでは、システムメニュー（左下の歯車アイコン）内の「コンテンツライブラリ」セクションにある「エクスプローラーで表示」をクリックすることで、コンテンツライブラリを見つけることができます。

Android: 2024.3アップデート以降、コンテンツフォルダはストレージ内の/DanceXR/にあります。古いバージョンを使用している場合は、/Android/data/com.vrstormlab.dancexr/files/にあります。

iPhoneとiPad: ファイルアプリの「私のiPhone」または「私のiPad」セクションでコンテンツライブラリを見つけることができます。DanceXRは、デバイスのルートディレクトリに「DanceXR」というフォルダを作成します。

Oculus Quest: 2024.3以降、コンテンツライブラリはストレージ内の/DanceXR/にあり、古いバージョンでは/Android/data/com.vrstormlab.dancexr/files/にあります。Android版と同様です。

フォルダ構造

DanceXRは、コンテンツライブラリ内の異なるサブフォルダに配置されたさまざまなタイプのコンテンツを検索します。

actors: キャラクターモデル
motion: モーション＆オーディオファイル
stages: ステージ用の3Dモデル
accessory: アクターのボディパーツに取り付けられる3Dモデル
props: 家具などのステージ小道具に使用できる3Dモデル
texture
- cookie: ライトマスク用のテクスチャ
- drawing: ボディペイント機能用の保存された画像
- ground: 地面のテクスチャ地面設定
- mask: モデルに適用できる詳細＆法線マップ
- particle: パーティクルエフェクト用のテクスチャ
- sky: パノラマスカイマップ、HDR形式の使用を推奨
settings: すべての保存された設定。これらのファイルはユーザーによって変更されることを想定していませんが、バックアップとして保持することができます。
scenes: 保存されたシーンファイル。
bundles: すべての必要なアセットを含む、保存されたシーンを含むzipパッケージ。
export: 3Dスナップショット機能を使用すると、ここにエクスポートされたモデルファイルが見つかります。
presets: 保存されたプリセットファイル。DanceXRの同じバージョンを使用している限り、友達とこれらのファイルを共有できます。
videos: 投射およびダイナミックテクスチャマップに使用できるビデオ。MP4形式のみをサポート。
chat: AIチャットシステムに使用されるファイル。
- characters: キャラクターサムネイルとテンプレート。これらは自動生成されますが、修正することが可能です。
- templates: プロンプトテンプレート。修正や新規作成が可能です。
- history: 保存されたチャット履歴
- persona: キャラクターに適用できるパーソナリティの説明
- voices/piper/: TTSシステム用のカスタムボイスモデル

サポートされている形式

3Dモデル: PMX、XPS、OBJ（ステージ小道具用）
オーディオ: OGG、MP3（モバイルプラットフォーム限定）
ビデオ: MP4
モーション: VMD、BVH
テクスチャ: PNG、JPG、HDR（スカイマップ用）

グループ化と整理

複数のファイルが連携して動作するコンテンツの管理を容易にするため、ファイルを整理するためにzipパッケージを使用することをサポートしています。すべての必要なファイルをサブフォルダに保管することも可能で、同様に機能します。

依存ファイル

3Dモデルには通常、複数のファイルが付属しています。1つのファイルがメッシュを記述し、複数の外部ファイルがテクスチャとマテリアル用です。モデルを読み込む際に、テクスチャがメッシュファイルに対して元の位置関係を保っていることを確認してください。 PMXの場合、メッシュファイルは.pmxファイルであり、XPSの場合、メッシュファイルは.xps、.mesh、または.mesh.asciiとなる場合があります。

ファイルサイズを小さく保ち、管理を容易にするため、1つのモデルのすべてのファイルをzipパッケージに保管することが推奨されます。

一部のXPSモデルには代替テクスチャがあります。DanceXRは、フォルダまたはzipパッケージを検索し、モデルで使用されているものに類似したテクスチャファイルを見つけると、自動的にメニューに選択肢として組み込みます。これを機能させるには、代替テクスチャがメインのテクスチャと同じファイル名であることを確認する必要があります。例えば、ベースマップの名前がbase.pngの場合、DanceXRが別のサブフォルダでbase.pngを見つけると、それを代替テクスチャとして自動的に追加します。モデルがzipパッケージ内にある場合、DanceXRは代替テクスチャを検索するためにzipパッケージ全体を検索します。モデルがサブフォルダ内にある場合、メッシュファイルが配置されている場所からすべてのサブフォルダを検索します。代替テクスチャをメッシュファイルフォルダの外に配置すると認識されないため、この点を考慮してください。

Example of actors folder

モーションファイル

通常、モーションデータにはオーディオファイル、キャラクターモーション、カメラモーションが含まれます。DanceXRでは、オーディオ、キャラクターモーション、カメラモーションの束を「ダンスセット」と呼びます。

DanceXRがダンスセットを検出できるようにするには、これらのすべてのファイルをサブフォルダまたはzipパッケージ内に保管するだけで済みます。ただし、その中にはオーディオファイルが1つだけ含まれていることを確認してください。

モーション/オーディオペアのみを持つシンプルなコンテンツの場合、単一のフォルダ内に複数配置できますが、オーディオファイルとモーションファイルが同じ名前であることを確認する必要があります。例えば、「dance.vmd」と「dance.ogg」のようにです。これにより、DanceXRはそれらがペアであることを認識し、ダンスセットを作成します。

また、同じフォルダ内に複数の無関係なモーションファイルやオーディオファイルを配置することも可能です。これらは、他のファイルとは無関係な個々のモーションファイルまたはオーディオファイルとして認識されます。

Example of motion folder

お気に入り、最近、タグシステム

モデルやモーションには、お気に入りとしてマークしたり、タグを追加したりできます。

お気に入りアイテムは「お気に入り」リストに表示され、タグを使用してフィルター結果から検索を絞り込むことができます。

「最近」リストは、頻繁に使用したアイテムを追跡し、迅速なアクセスを可能にします。

これらの機能により、必要なアイテムを簡単に見つけることができます。モデルの場合はアクターメニューのツールセクションで、モーションの場合はオーディオ/モーションメニューでアクセスしてください。

コンテンツライブラリツール

コンテンツライブラリファイルを変更した後、DanceXRは起動時に変更を自動的に検出してコンテンツを再スキャンするはずです。

しかし、自動的に行われない場合や、実行中にファイルを移動した場合は、システムメニュー内のコンテンツライブラリツールを使用して手動で更新することができます。

また、「ライブラリの変更」オプションを使用して、別の場所を指定することもできます。

Google Driveの統合

DanceXRからGoogle Driveからファイルをダウンロードすることができます。ドライブフォルダが制限なく共有されている限り、共有フォルダのURLを入力するだけで、DanceXRがドライブフォルダをスキャンし、ローカルに存在しないファイルをダウンロードすることができます。

AndroidおよびOculus Quest向けコンテンツの準備

Androidシステムには厳格なファイルアクセスルールがあります。通常、アプリはストレージ内のフォルダにアクセスできません。そのため、Android版とQuest版はデフォルトでコンテンツライブラリがアプリストレージ内にあるため、PCを使用してファイルをコピーする必要があります。

2024.3以降、ファイルの管理を少し簡単にするために、ストレージ許可を使用しています。そのため、DanceXRにストレージへのアクセス許可を与える必要があり、システムファイルアプリを使用してファイルを移動およびコピーできるようになります。

古いバージョンを使用するか、アプリ内部ストレージスペースを使用する場合、コンテンツライブラリはここにあります: /Android/data/com.vrstormlab.dancexr/files/。

デモ動画

PC版:

Android上でのコンテンツマネージャーの使用

Questでのコンテンツの読み込み