VSnap Pose Editor の使い方

VSnap Pose Editor は、Unity Editor 上で Pose / PoseGroup / PoseLibrary をまとめて扱い、モバイル向けの AssetBundle をビルドするためのツールです。メニューの VSnap → Pose Editor から開く ひとつのウィンドウ の中で、上から順に「AnimationClip フォルダからの自動生成」と「PoseLibrary のビルド」ができます。

アプリの使い方 で触れたとおり、AnimationClip を Pose Editor でビルドし、モバイルアプリに取り込む流れになります。

---

事前準備

• Unity は 2022.3 系のプロジェクトにしてください（パッケージが想定しているバージョンです）
• VRChat Creator Companion（VCC）は、すでに入っている状態にしてください
• インターネットにつながる環境にしてください（VPM のリポジトリを取りに行ったり、QR 転送でアップロードしたりするときに必要になります）
• ポーズの元になる AnimationClip を、あとで Assets の下に置けるようにしておいてください

---

VCC でパッケージを導入する

こちらから VCC を開いてリポジトリを追加できます。

1. VCC の Settings → Packages から Add Repository を選びます。
2. 次の URL を入れて追加します。
   https://vsnap.jp/vcc/index.json
3. 対象プロジェクトの Manage Project を開いて、VSnap Pose Editor をインストールします。
4. Unity を開き直して、メニューに VSnap/Pose Editor が出てくるか確認します。

---

エディタウィンドウを開く

Unity のメニューから VSnap → Pose Editor を選ぶと、ひとつにまとまったウィンドウが開きます。ウィンドウの右上あたりにある 日本語 と English で、画面の言語表記を切り替えられます（選んだ内容は EditorPrefs に保存されます）。

---

AnimationClip フォルダから Pose / PoseGroup を自動生成する

ウィンドウの上のほうにある AnimationClip フォルダから Pose / PoseGroup 生成（英語 UI だと Generate Pose/PoseGroup from AnimationClip folder）を使うと、フォルダの中の AnimationClip をまとめて調べて、クリップと同じフォルダ に Pose アセットと PoseGroup を新しく作ったり、更新したりできます。

手順

1. Assets の下に、ポーズ用の AnimationClip をフォルダの形のまま置きます（下のフォルダまで再帰的に探します）。
2. ポーズが入っているフォルダ（Pose Folder）に、いちばん上のフォルダを指定します。
3. 既存アセットを上書き をオフにすると、もうある Pose / PoseGroup はそのまま飛ばします。オンにすると上書き・更新します。
4. サムネイル生成 をオンにすると、それぞれの Pose 用に PNG のサムネイルを作ってアセットに入れます。撮影には、パッケージに入っている Thumbnail シーンの Main Camera を使います。
   • キャラクターを変えたいときは、Thumbnail シーンを開く ボタンでシーンを開いて、CharacterSlot の下に好きな Prefab を置きます。何も置いていないときは、同梱の AvatarSample_A が使われます。
5. Pose / PoseGroup を自動生成 を押して実行します。終わったあと、ウィンドウの下のほうの一覧に CREATE / UPDATE / SKIP のログが出ます。

生成されるファイルの例

• クリップが Example.anim なら、同じフォルダに Example_Pose.asset ができます（サムネイルをオンにしているときは Example_Pose.png も）。
• PoseGroup の名前は、「ルートフォルダから見た相対パス」を _ でつないだ形になります（例：サブフォルダが Dance/Wave なら Dance_Wave.asset）、そのフォルダの中に 1 つずつ作られます。昔の PoseGroup.asset 形式が残っている場合は、できるだけ新しい名前にリネームされます。

自動生成された Pose / PoseGroup を削除 は、今選んでいるルートフォルダの下だけを対象に、ツールが作ったアセットを確認してから消すためのボタンです。違うフォルダを選ばないように気をつけてください。

---

PoseGroup から PoseLibrary をビルドする

ウィンドウの下のほうの PoseGroup から PoseLibrary をビルド では、PoseLibrary を自分で先に作っておかなくても、ライブラリ名 と ビルドに入れる PoseGroup を指定するだけで大丈夫です。ビルドするときに PoseLibrary が自動で作られて、次からも同じアセットが更新されながら使い回されます。

手順

1. ライブラリ名（Library Name）に、好きな名前を入れます。これを全部小文字にした文字列が、AssetBundle のファイル名のもとになります（例：MyPoses なら myposes.bundle）。
2. PoseGroup リストを更新 を押すと、プロジェクトの中の PoseGroup を読み直して、ビルドに入れたいグループにチェックを付けます。
3. プラットフォーム で Android か iOS のどちらかを選びます。
4. AssetBundle をビルドして QR コード生成 なら、ビルドしたあと転送サービスにアップロードして、スマホで読む QR と短い URL が出ます。転送用のパスを取得 の説明に沿って、パス の欄にパスワードを入れてください（入れた値は EditorPrefs に残ります）。
5. AssetBundle をビルドしてローカルフォルダに保存 なら、アップロードはせず、Unity の一時フォルダの下のビルド出力先に .bundle だけ出します。
6. 選択している PoseGroup のサムネイルを自動生成・更新 は、ビルドとは別に、今チェックを付けているグループの中の Pose のサムネイルだけを作り直します。

自動で作られる設定・ライブラリアセット

• ビルド設定：Assets/VSnap/PoseEditor/BuildPoseLibrarySettings.asset
• PoseLibrary：Assets/VSnap/PoseEditor/ の下に、ライブラリ名に合わせた .asset が作られたり更新されたりして、選んだ PoseGroup が poseGroups に入ります。

ビルドがうまくいって条件も揃っていれば、ウィンドウに スマホで開く 用の QR と URL が出ます。アップロードに失敗したときは、出てきたダイアログと Console のメッセージを見てください。

---

うまくいかないとき

• VCC のリポジトリ URL を打ち間違えていないか、ブラウザで index.json が開けるか確かめてみてください
• Unity をいったん終了してから開き直す、または Assets の再インポートを試してみてください
• 「AnimationClip が見つかりません」と言われたら、ポーズが入っているフォルダ の指定が、実際に .anim（AnimationClip）が入っているフォルダの ひとつ上 になっていないか見てみてください
• PoseGroup が一覧に出てこないときは、プロジェクトの中に PoseGroup があるか、先に自動生成まで終わっているか確認してください
• ビルドに失敗したら、Console のエラーログを開いて内容を見てください
• QR 転送でうまくいかないときは、パスの期限切れ、打ち間違い、ネットワークの状態を確認してください