操作
機能 #411
完了
機能 #411:
VRM 選択・設定とドキュメント（導入手順/対応制約）
説明
背景¶
#406 決定記録に基づき、ペットに使う VRM の選択/設定と、導入・制約のドキュメントを整備する。
作業内容¶
- どの VRM ファイルをペットにするかの選択/設定と永続化（パス設定 or ランチャUI）。
- 対応 VRM の制約明示（スパイク知見: VRM1.0 推奨、一部の大きすぎるメッシュは three-vrm/three.js でも要注意 等）。
- OBS ブラウザソース / Tauri オーバーレイの導入手順ドキュメント（
docs/ormanual/）。 - ロード失敗時のフォールバック方針（エラー表示 / 代替表示）。
完了条件¶
- ユーザーが任意の VRM をペットに設定でき、手順ドキュメントが揃う。
依存¶
three-vrm Web アプリ / Tauri オーバーレイホスト。横断的チケット。
エージェント ちゃん さんが12日前に更新
- ステータス を 未着手 から 実装中 に変更
- 進捗率 を 0 から 10 に変更
実装に着手しました。
- ブランチ:
feature/411 - 対応方針: VRM 選択/設定の永続化（Tauri オーバーレイ Config に
vrm/vrma追加＋設定ウィンドウ欄、OBS は?vrm=URL パラメータ）、ロード失敗時の可視フォールバック通知、導入手順・対応制約ドキュメント（docs/avatar-setup.md）を整備する。
エージェント ちゃん さんが12日前に更新
- ステータス を 実装中 から 完了 に変更
- 進捗率 を 10 から 100 に変更
対応が完了しました。
概要¶
ペットに使う VRM を任意に選択・設定できるようにし（永続化）、ロード失敗時の可視フォールバックと、導入手順・対応制約のユーザー向けドキュメントを整備した。#406 系の横断チケット。
変更点¶
-
VRM 選択/設定+永続化: Tauri オーバーレイ
Configにvrm/vrma（任意）を追加。config.json に永続化し、build_urlが percent-encode した?vrm=/?vrma=をアバター URL へ付与（空白/空文字は None 正規化）。設定ウィンドウに VRM / Idle Motion (VRMA) 入力欄を追加。OBS は既存?vrm=URL パラメータ。 -
ロード失敗時フォールバック: アバター Web アプリで VRM ロード失敗時に、無表示ではなく左下の小さな通知（
#vrm-status、「VRM を読み込めませんでした」＋試行パス）を表示。背景透過・吹き出しの挙動は不変、クラッシュなし。VRMA 不在は既存の待機ポーズへフォールバック。 -
ドキュメント:
docs/avatar-setup.mdを新規作成（OBS ブラウザソース版／Tauri オーバーレイ版の導入手順、対応 VRM 制約、VRM 選択の3経路、ロード失敗時のフォールバック方針）。各 README から相互リンク。 - 変更ファイル:
obs/avatar-overlay/src-tauri/src/lib.rs、obs/avatar/{index.html, styles.css, src/main.js, tests/app.spec.js}、obs/avatar-overlay/ui/{index.html, main.js}、docs/avatar-setup.md（新規）ほか README 2 件。計 9 ファイル。
テスト¶
-
.\gradlew.bat compileJava: 成功（Java は無変更のためサニティ確認のみ） - cargo test（overlay
--lib）: 12 件 成功（新規5件） - Playwright（
obs/avatar）: 8 件 成功（新規1件: フォールバック通知表示）
関連 MR¶
- !90 (feature/411 → develop) マージ済み
操作