Hips位置が特殊/ボーンスケール改変アバターで姿勢の高さ・位置がズレる(avatarHeightUnitの算出前提)

[UnisakiStudio]

症状

同根とみられる報告がサポート問い合わせで最多クラスタ(23件)です:

• デルタフレア: デスクトップ時のみ中腰・座りで体が浮き沈み、ビューポイントずれ(高さ調整ツールで一度調整すると解消)
• 森羅: 体の半分が沈む、中腰で視点が服に埋まる(無改変でも発生)
• かににちゃん: ポーズのZ軸がずれた状態で再生、アップロード後は足が前に出る
• キプフェル・くうた・海咲・ミルフィ・怜ほか: すべての姿勢でお尻が床に沈む等
• ボーンスケール改変アバター: 寝姿勢で足が伸びきる、頭固定で頭位置が大幅にずれる

原因(Ver3.0.6 ソースの静的調査)

PosingSystemConverter.cs:1175-1221 でアバターの「背の高さ係数」を

1. RootT.y = 1 のみのクリップをサンプリング(HumanoidのRootT.y=1はhumanScale=Hips接地高に相当)
2. その状態の headBone.position.y / 2 を avatarHeightUnit とする

という方法で算出し、以降のRootT正規化・footheight BlendTree生成(:1700-1790)・頭位置基準の座標補正(:1275-1307)に使用しています。この計算は「Hipsボーンが腰の位置にある標準的なリグ」を前提としており、以下で破綻します:

• Hipsが足元付近にあるリグ: humanScaleが極小になり avatarHeightUnit が実際と大きく乖離
• ボーンスケール改変: humanScaleとメッシュ実寸の乖離で同様のズレ
• 頭のXZオフセットが大きいリグ: 頭位置XZ差し引き補正が過剰/不足になりZ軸ズレとして発現

「高さ調整ツールで一度調整すると直る」のは、調整クリップが誤った初期値を上書きするためで、この原因と整合します。

修正案

高さ係数の算出をhumanScale(Hips)依存からTポーズ実測ベースへ変更する(頭ボーンの実測位置を直接使う等)。

---

Generated by Claude Code

[UnisakiStudio]

ブランチ claude/issue-taiou-t4makp にて一次対応として、変換時に特殊リグを検出して警告する処理を追加しました。

実装した内容(一次対応)

• avatarHeightUnit(RootT.y=1サンプリング時の頭位置÷2)と Animator.humanScale(Hips接地高)の比率を変換時に算出し、標準リグの想定範囲(0.6〜1.5)を外れる場合に「高さ調整機能で一度調整してください」と警告を表示

調査で判明した点

• Ver3.0.6時点で avatarHeightUnit は算出後どこからも参照されていません(デッドコード)。同様に rootTyList も収集のみで未使用です。つまり現状、RootT.yの正規化処理は存在せず、姿勢クリップのRootT.yがそのまま各アバターのhumanScale単位で解釈されるため、humanScaleと実体格が乖離したアバター(Hipsが足元付近・ボーンスケール改変)で高さズレが発現します
• FootHeight用BlendTreeの level ±2 もhumanScale単位のため、同種のアバターでは調整幅もズレます

根本修正案(要Unity実機検証)
RootT.yカーブに補正係数 k = 実測基準 ÷ humanScale を乗算する方式が考えられますが、標準リグでも 頭位置÷2 ≒ 0.92 × humanScale 程度の恒常的なズレがあるため、係数の基準値をそのまま使うと正常なアバターが約8%沈む回帰が起きます。実機で複数の標準アバターを使って基準値(頭位置に対するHips高の期待比率)を校正した上で導入する必要があるため、今回のコミットには含めていません。

---

Generated by Claude Code

[UnisakiStudio]

修正ブランチ claude/issue-taiou-t4makp の体格比率警告について、実機検証の結果です。

検証結果(サポート自動化パイプライン run#11)

森羅 v1.2.8 でNDMFビルドを実行したところ、体格比率警告は発火しませんでした(比率が閾値0.6〜1.5の範囲内)。

森羅は本issueの報告アバターの一つ(「体の半分が沈む」「中腰で視点が服に埋まる」)のため、以下のどちらかが考えられます:

1. 森羅のズレはHips位置比率以外の要因(頭のXZオフセット等)で、現在の警告条件では捕捉できない
2. 閾値0.6〜1.5が緩すぎる

提案

• 報告のあった他のアバター(特にHips位置が極端とされるデルタフレア)で警告が発火するかの確認
• 警告だけでなく、比率に応じた avatarHeightUnit の補正(Tポーズ実測ベースへの切り替え)を本修正として検討

なお警告メッセージ自体の文言・案内(高さ調整ツールへの誘導)は適切だと思います。

---

Generated by Claude Code