Live2D アニメーションとマッピング
このページは、AnySoul が現在使っている Live2D runtime に合わせて更新されています。再利用可能な clips、rule / base behavior が持つ priority、scope を持つ base behaviors、そして priority tier 単位のパラメータ仲裁が前提です。
現在の Authoring モデル
Section titled “現在の Authoring モデル”今の構成は 3 層で考えると分かりやすいです。
- Clips: 再利用可能なアニメーション資産
- Rules: どの条件で clip を再生するか
- Base Behaviors:
idle/activeの背景レイヤーを長時間スケジュールするもの
これらは Full Editor を中心に author するのが現在の基本です。
Playback Stack
Section titled “Playback Stack”実行時はおおむね次の順で解決されます。
- Parameters で作った中立ポーズ
- 必要であれば legacy idle motion
- 現在有効な base behavior scope（
idleまたはactive） - 現在一致している rules
- lip sync / focus dispatch
同一パラメータについて重要なのは次です。
- まず priority tier で分ける
- 高い tier が低い tier より先に解決される
- 同じ tier 内では
Multiply/Addを先に処理 - その後
Overrideが残りウェイトを消費 - 上位 tier のフルウェイト
Overrideがあると、下位 tier はそのパラメータに影響できない
つまり、低優先度の base noise が高優先度の「頭固定」rule に漏れてくるべきではありません。
Clip は再利用可能な資産です。1 つの clip を複数の rules や base behaviors から参照できます。
今の重要ルール
Section titled “今の重要ルール”runtime の優先度は clip 資産のものではありません。
優先度を持つのは:
- Rule
- Base Behavior
古い資料にある “clip priority” は旧表現として見てください。
Clip の作り方
Section titled “Clip の作り方”- Add Clip で手動作成
- Create From Expression で
.exp3.jsonを取り込む - Import Motion As Clip で
.motion3.jsonを取り込む - Template で定番パターンを生成
Clip に含まれるもの
Section titled “Clip に含まれるもの”- parameter tracks
- keyframes
- playback mode
- end behavior
- release 設定
- 各 track の blend mode
- 各 track の modifier
Playback Modes
Section titled “Playback Modes”| モード | 向いている用途 |
|---|---|
One Shot | 短いリアクションやジェスチャー |
Loop | speaking cycle や ambient motion のような持続状態 |
Repeat N | 回数を正確に決めたい動き |
Completion と Release
Section titled “Completion と Release”Clip は次も定義します。
- bound to trigger duration か
- complete even if trigger ends か
- track が stop するか hold then release するか
- release にどれくらい時間を使うか
Tracks, Blend Modes, Modifiers
Section titled “Tracks, Blend Modes, Modifiers”各 clip は実際には複数の parameter track の集まりです。
Track Blend Mode
Section titled “Track Blend Mode”blend mode は track 単位 です。
| モード | 挙動 | 典型用途 |
|---|---|---|
Override | そのパラメータを取りにいく | 表情姿勢、動作姿勢、「頭固定」など |
Add | 既存結果へオフセットを加える | 呼吸、微揺れ、補助モーション |
Multiply | 現在値を比率で変える | 特殊効果、振幅調整 |
本当に重ねたい動きだけを Add にしてください。より強い clip が来たら止まってほしい動きなら、適切な priority と Override で設計する方が自然です。
Track Modifiers
Section titled “Track Modifiers”Modifier はキーフレーム補間後に値を加工します。
keyframed value -> modifier chain -> final track write現在使えるタイプ:
WiggleDriftSinePulseSpringLoopNoiseClamp
inspector の Mod ON/OFF で、生の keyframe と modifier 込みの結果を切り替えて見比べられます。
Virtual Focus
Section titled “Virtual Focus”仮想パラメータ:
__focus_x____focus_y__
は通常の track と同じようにアニメーションできます。視線の漂いを作るのに最適です。
Rules は runtime 状態を clips に接続します。
現在の rule 条件は次を扱えます。
- emotion
- action
- tool call
- text
- thinking
- idle
text 条件では message text と thinking text を分けて検証できるので、推測ではなく Sequence Tester で確認するのが安全です。
All-Match
Section titled “All-Match”AnySoul は all-match です。
- 条件を満たすすべての rule が発火
- 1 つの rule 内で複数 clip group を並列再生可能
- 複数 rule も同時に有効になれる
そのため、パラメータ所有権の設計がとても重要です。
Rule が持つもの
Section titled “Rule が持つもの”Rule 自身が持つのは:
- priority（
0 idle、1 normal、2 emotion、3 force） - 1 つ以上の clip groups
- 各 group の selection mode
- 各 group の weight
- 各 group の timeScale
Clip Groups
Section titled “Clip Groups”clip group は clip 変体を選ぶ仕組みです。
- group 同士は並列で再生
- group 内部では
random/sequential weightで強さを調整timeScaleで速度を調整
Base Behaviors
Section titled “Base Behaviors”Base Behaviors は、現在のシステムで長時間背景レイヤーを扱う標準手段です。
各 base behavior は 1 つの scope に属します。
Idle BaseActive Base
実行時にはどちらか 1 つの scope だけが有効です。非 idle rule が一致しているかどうかで切り替わります。
現在の base behavior mode:
Loop one clipPick one per idle sessionRandom playlist
さらに次も設定できます。
- cycle transition duration
- handoff transition duration
- scope transition duration
- priority
Legacy Idle Motion
Section titled “Legacy Idle Motion”モデルに legacy idle motion がある場合、それを idle-base 再生に参加させることもできます。これは Rules 側で設定します。
Sequence Tester
Section titled “Sequence Tester”Sequence Tester は runtime 挙動を確認する最短ルートです。
次の入力を順番に再生できます。
- emotion
- action
- tool call
- text
- thinking
- 明示的な idle step
ここでは次が確認できます。
- 現在の state
- 現在の base scope
base onlyかbase + rule overlayか- 一致中の rules
- 一致中の base behaviors
さらに sequence 再生中は inspector の Parameter Control で:
- 今そのパラメータを誰が握っているか
- どの writer が suppress されているか
を確認できます。
Timeline Preview Base
Section titled “Timeline Preview Base”inspector の Preview Base では、clip / rule のプレビュー先を切り替えられます。
| モード | 意味 |
|---|---|
Baseline | authored neutral pose の上だけで見る |
Idle Base | idle-scope base behavior の上で見る |
Active Base | active-scope base behavior の上で見る |
微妙な overlay を調整するときは非常に重要です。
実用的な Authoring のコツ
Section titled “実用的な Authoring のコツ”- 呼吸、視線の漂い、待機時の揺れは Base Behaviors に置く
- リアクションや明確な状態姿勢は Rules に置く
- 下位の動きを止めたいパラメータには
Overrideを使う - 同じ tier でも自然に重ねたい補助運動には
Addを使う - 単独プレビューでは正しいのに runtime で崩れるなら、まず:
- rule priority
- base behavior priority
- track blend mode
- preview base mode
- parameter-control inspector
次のステップ
Section titled “次のステップ”- Live2D はじめに: 全体フローを確認
- パラメータリファレンス: baseline、lip sync、motions、expressions、parts
- Live2D カーブエディタ: graph editor と timeline shortcuts