個人開発 » beatoraja

方針検討の結論（#406 を方針検討チケットとして確定）

Java/libGDX 単体でのフル VRM1.0 対応は不採用。gdx-gltf スパイク（実機検証済）で、一部 VRM がロード不可・表情モーフ/スキニング/MToon が標準非対応と判明したため。

採用アーキテクチャ:

• 描画: three-vrm（@pixiv/three-vrm, three.js） — VRM1.0 リファレンス実装。MToon/表情/揺れ物/視線フル対応。
• 連携: beatoraja 内蔵 HTTP（既存 ObsHttpServer 拡張）で「状態＋イベント」を配信し Web アバターが購読。#396 子チケット（397/398/399/401/403/405）共通の受け口。
• ローカル表示: Tauri（Rust + WebView2）の透過・最前面オーバーレイ。同一 Web アプリを OBS ブラウザソースとしても併用。

詳細はリポジトリ docs/poc/vrm-avatar-loading.md（決定記録）を参照。

実装は本チケット配下の子チケットで段階的に実施:

• #407 アバター連携フィード基盤（ObsHttpServer 拡張: pet 状態 + イベントSSE）
• #408 three-vrm アバター Web アプリ（VRM1.0 描画 MVP）
• #409 Tauri 透過オーバーレイホスト（ローカル表示）
• #410 アバターリアクション/演出マッピング（結果・機嫌・性格連動）
• #411 VRM 選択・設定とドキュメント（導入手順/対応制約）

対応が完了しました。

概要¶

#406 を方針検討チケットとして確定。Java/libGDX 単体でのフル VRM1.0 対応は不採用とし、three-vrm（Web）＋ beatoraja HTTP フィード＋ Tauri 透過オーバーレイを採用する方針を決定記録としてまとめた。

変更点¶

• docs/poc/vrm-avatar-loading.md を #406 決定記録として作成（採用アーキテクチャ・連携フィード契約・実装ロードマップ）。
• gdx-gltf スパイク（不採用）の知見・エラーエビデンスを付録として保持しつつ、コード/依存（gdx-gltf・JitPack・verifyVrmLoad・VrmLoadSmoke/VrmGltfMetadata）は削除し develop をクリーンに保った。
• 実装は本チケット配下の子チケット #407〜#411 で段階的に実施する。

テスト¶

• .\gradlew.bat test : 成功（全スイート緑）

関連 MR¶

• !83 (feature/406 → develop) マージ済み