個人開発 » beatoraja

実装に着手しました。

• ブランチ: feature/411
• 対応方針: VRM 選択/設定の永続化（Tauri オーバーレイ Config に vrm/vrma 追加＋設定ウィンドウ欄、OBS は ?vrm= URL パラメータ）、ロード失敗時の可視フォールバック通知、導入手順・対応制約ドキュメント（docs/avatar-setup.md）を整備する。

対応が完了しました。

概要¶

ペットに使う 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) マージ済み