対応VRMモデル仕様ガイド

アヴィネージの「モデルを置き換える」機能で、自分のVRMアバターを読み込ませるための仕様ガイドです。VRoid Studioの標準的な出力であれば、そのまま動作します。

概要

項目	内容
対応フォーマット	VRM 1.0（推奨・保証ライン）、VRM 0.x（読み込み可）
自動判定	ファイルヘッダを解析し、VRM 1.0 / 0.x を自動判定して両対応
必須要件	Humanoidボーン（標準的なヒューマノイドリグ）
推奨要件	VRM 1.0 標準Expressions（表情プリセット一式）
欠けている場合	エラーにはならず、対象機能のみ省略して動作継続

対応フォーマット

アヴィネージは読み込んだVRMファイルのヘッダ情報から、VRM拡張（VRMC_vrm）の有無を判定し、VRM 1.0とVRM 0.xの両方を自動的に判別して読み込みます。ファイル選択時に手動でバージョンを指定する必要はありません。

バージョン	対応状況	備考
VRM 1.0	推奨・保証ライン	VRoid Studio等の標準的な出力ならそのまま動作
VRM 0.x	ベータ対応	従来形式。読み込みは可能だが表情・口パクに不具合が出る場合あり

VRM 0.x はベータ対応

VRM 0.x 形式のモデルも読み込めますが、ベータ対応の位置づけです。アプリはファイルのヘッダから 0.x を自動判定し、「モデルを置き換える」画面で 0.x ファイルを選ぶと次の注記を表示します。

VRM 0.x はベータ対応です。表情・口パクに不具合が出る場合があります。VRM 1.0 を推奨します。

VRM 0.x では表情データの持ち方が VRM 1.0 と異なる（0.x は BlendShapeClip/blendShapeGroups、1.0 は Expressions プリセット）ため、口パク（a/i/u/e/o）や感情（joy/angry/sorrow 等）の対応表情が欠けていたり名称が一致しないと、口が動かない・表情が変化しないことがあります。安定した動作を求める場合は VRM 1.0 形式でのエクスポートを推奨します。

必須要件

Humanoidボーン

モデルは標準的なヒューマノイドリグ（Humanoidボーン構成）である必要があります。待機モーションや仕草などのアニメーションはこのボーン構成に依存するため、Humanoid対応していないモデルは正しく動作しません。VRoid Studioを含む主要な3DCGツールの標準出力は、通常この要件を満たしています。

推奨要件: VRM 1.0 標準Expressions（表情プリセット）

アヴィネージはモデルのインポート時に、VRM 1.0の標準Expressions（表情プリセット）の有無を検査します。欠けている場合でもインポート自体はエラーになりません。該当する表情機能のみが省略され、それ以外は通常どおり動作します（グレースフルフォールバック）。

リップシンク（口パク）用

Expression	用途
aa	母音「あ」
ih	母音「い」
ou	母音「う」
ee	母音「え」
oh	母音「お」

この5母音が欠けていると、「口パクは動作しません」という警告が表示されます。会話自体は継続しますが、口の動きは伴いません。

感情表現用

Expression	用途
happy	喜び
angry	怒り
sad	悲しみ
relaxed	リラックス
surprised	驚き

これらが欠けていると、「感情表現は無効になります」という警告が表示されます。表情は変化しませんが、会話・音声・アニメーションは通常どおり動作します。

まばたき（blink）

blink Expressionを持たせておくと、自動まばたきが自然になります。必須ではありませんが推奨します。

アプリ固有の感情タグ（任意対応・上級者向け）

アヴィネージはAIの応答テキストに感情タグを埋め込み、対応するBlendShapeを動かして表情を変化させます。標準同梱キャラクター「RYUXiA」では、VRoid Studio出力の標準BlendShape名（Fcl_*系）にマッピングしています。

タグ	感情	使用するBlendShape（VRoid標準名）
[DEF]	通常（デフォルト）	なし（素の状態）
[JOY]	喜び・笑顔	Fcl_EYE_Joy, Fcl_BRW_Joy
[SAD]	悲しい	Fcl_EYE_Sorrow, Fcl_BRW_Sorrow
[ANG]	怒り	Fcl_EYE_Angry, Fcl_BRW_Angry
[SUR]	驚き	Fcl_EYE_Surprised, Fcl_BRW_Surprised
[FUN]	楽しい	Fcl_EYE_Fun, Fcl_BRW_Fun

これらのFcl_*系BlendShapeを持つモデル（VRoid Studioの標準出力）であれば、感情タグに応じた表情がそのまま動作します。持たないモデルでは該当する感情表現のみ省略され、無表情のまま会話は継続します。

自作モデルで感情表現まで再現したい上級者は、上記のBlendShape名（Fcl_EYE_Joy、Fcl_BRW_Joy 等）を自モデルに用意することで対応できます。

VRoid Studioからの出力手順

VRoid Studioを利用している場合、以下の手順で出力すればアヴィネージの保証ラインを満たします。

VRoid Studioで対象アバターを開く
「エクスポート」から「VRM」を選択
エクスポート形式は VRM 1.0 を選択する
表情プリセット（Expressions）が含まれる状態でエクスポートする（VRoid Studioの標準設定のままでよい）
ポリゴン数が多い場合は、ポリゴン削減設定を有効にすることを推奨（ファイルサイズ・読み込み速度の観点）
ボーン設定はデフォルトのままでよい（Humanoid構成が自動的に維持される）

VRoid Studioの標準出力設定は、そのままアヴィネージの保証ラインを満たします。特別な調整は不要です。

トラブルシューティング

症状	原因	対処
口が動かない	aa / ih / ou / ee / oh（母音Expression）が無い	VRM 1.0形式で、表情プリセットを含めて再エクスポート
表情が変わらない	happy等の標準Expressions、またはFcl_*系BlendShapeが無い	表情プリセットを含めて再エクスポート、または対応するBlendShapeを追加
モデルが表示されない／インポートに失敗する	壊れたVRMファイル、または非対応形式	アプリは失敗時に元のモデルのまま継続し、エラー通知を表示します。ファイルサイズが極端に大きい場合はポリゴン数・テクスチャサイズを削減してください
元のキャラクターに戻したい	-	設定のキャラクターセクションにある「デフォルトに戻す」ボタンで、標準キャラクター（RYUXiA）に戻せます

まとめ

対応レベル	要件	未対応時の挙動
必須	Humanoidボーン	アニメーションが正しく動作しない
推奨	VRM 1.0 標準Expressions（母音5種・感情5種・blink）	該当機能のみ省略、他は通常動作
任意（上級者向け）	Fcl_*系BlendShape（RYUXiAの感情タグ対応）	感情タグ表情のみ省略

VRoid Studioで標準的にVRM 1.0エクスポートしたモデルであれば、これらすべてを満たした状態でアヴィネージにそのまま読み込めます。

トップページに戻る