アプリ用データの作成 Creating app data

作業フォルダ

作業フォルダ に、ポーズ用の AnimationClip（.anim）が入っているフォルダを指定します。
このフォルダ配下が、データ作成・管理・アップロードの対象範囲になります。

Pose と PoseGroup とは

VSnap アプリが実際に使うのは Pose と PoseGroup のアセットです。

Pose（{名前}_Pose.asset）

1 つのポーズを表す ScriptableObject です。主な内容は次のとおりです。

項目	内容
poseName	アプリ上で表示するポーズ名
animation	再生する AnimationClip への参照
thumbnail	一覧などで使うサムネイル画像（任意）

作成 を実行すると、各 AnimationClip ごとに、同じフォルダへ {クリップ名}_Pose.asset が作られます。
つまり 1 クリップ = 1 Pose です。

PoseGroup（例: Dance_Wave.asset）

複数の Pose をひとまとめにした ScriptableObject です。アプリでは「ポーズのカテゴリ・グループ」として扱われます。

項目	内容
groupName	グループの表示名
poses	このグループに含める Pose アセットのリスト

作成 では、同じフォルダにある Pose を 1 つの PoseGroup にまとめます。
フォルダ名の階層は groupName に反映されます（例: 作業フォルダから見て Dance/Wave → Dance_Wave）。

関係のイメージ

AnimationClip（.anim）
    ↓ 作成
Pose.asset（Example_Pose.asset など）  … 1 ポーズ
    ↓ 同じフォルダ内でまとめる
PoseGroup.asset（Dance_Wave.asset など）  … ポーズのグループ
    ↓ 管理で選択 → アップロード
PoseLibrary（アプリに配信するライブラリ）

• Pose が「個々のポーズ」、PoseGroup が「その入れ物（フォルダ単位のまとまり）」です。
• アップロード時は、管理リストでチェックした PoseGroup だけがライブラリに含まれます。
• 同じ Pose を複数の PoseGroup から参照することもできます。

アプリ用データ生成

アプリ用データ生成 セクションで、次の設定を行います。

項目	説明
既存のアプリ用データを更新	オンにすると、既にある *_Pose.asset や PoseGroup を上書き更新します。オフのときは既存ファイルはスキップされます。
サムネイル生成	オンにすると、各 Pose 用の PNG サムネイルも作成します。

作成 を押すと、作業フォルダ配下の AnimationClip を再帰的に走査し、次を行います。

• 各クリップと同じフォルダに {クリップ名}_Pose.asset を作成（サムネイル生成オン時は {クリップ名}_Pose.png も）
• フォルダごとに PoseGroup アセットを作成または更新

生成例

• Example.anim → Example_Pose.asset（サムネイル生成オン時は Example_Pose.png も）
• フォルダ Dance/Wave 内のクリップ群 → PoseGroup 名 Dance_Wave のアセット（例: Dance_Wave.asset）

Working folder

Set Working folder to the directory that contains your pose AnimationClip (.anim) files.
Everything under this folder is in scope for creation, management, and upload.

What are Pose and PoseGroup?

The VSnap app consumes Pose and PoseGroup assets. They are built from Unity AnimationClip (.anim) files.

Pose

A ScriptableObject that represents a single pose:

Field	Role
poseName	Label shown in the app
animation	Reference to the AnimationClip to play
thumbnail	Optional preview image

When you click Create, the tool writes {clipName}_Pose.asset next to each clip — one clip, one Pose.

PoseGroup

A ScriptableObject that groups multiple Poses (a category in the app):

Field	Role
groupName	Display name for the group
poses	List of Pose assets in this group

Create builds one PoseGroup per folder, collecting every Pose in that folder.
Folder hierarchy becomes groupName (e.g. Dance/Wave under the working folder → Dance_Wave).

How they relate

AnimationClip (.anim)
    ↓ Create
Pose.asset (e.g. Example_Pose.asset)  … one pose
    ↓ grouped per folder
PoseGroup.asset (e.g. Dance_Wave.asset)  … pose group
    ↓ select in Management → Upload
PoseLibrary (bundle shipped to the app)

• Pose = an individual pose; PoseGroup = the container (one per folder).
• Only checked PoseGroups are packaged when you upload.
• The same Pose asset may appear in more than one PoseGroup.

App data generation

In the App data generation section, configure:

Option	Description
Update existing app data	When enabled, overwrites existing *_Pose.asset and PoseGroup assets. When disabled, existing files are skipped.
Generate thumbnails	When enabled, creates a PNG thumbnail per Pose.

Click Create to recursively scan AnimationClip assets under the working folder and:

• Create {clipName}_Pose.asset beside each clip (and {clipName}_Pose.png when thumbnails are enabled)
• Create or update one PoseGroup asset per folder

Examples

• Example.anim → Example_Pose.asset (plus Example_Pose.png when thumbnails are on)
• Clips under Dance/Wave/ → PoseGroup named Dance_Wave (e.g. Dance_Wave.asset)