UniVRM [Unity] – Site-Builder.wiki

Issue #56 に対応して、VRM モデルを再インポートした際に既存の BlendShapeClip, BlendShapeAvatar, Material が存在する場合に自動的には上書きされない仕様になっている。更新した VRM モデルのデータで置き換えたい場合は該当するアセットを VRM モデルの再インポート前に削除しておく。

参考：

VRM を実行時に読み込む

非同期読み込み

バージョン 0.44 以降で LoadAsyc を使う場合、次のような非同期関数でモデルを読み込む。

private async Task<GameObject> LoadVrmAsync(string vrmFilePath)
{
    var parser = new GltfParser();

    await Task.Run(() =>
    {
        var file = File.ReadAllBytes(vrmFilePath);
        parser.ParseGlb(file);
    });

    using (var context = new VRMImporterContext(parser))
    {
        await context.LoadAsync();
        context.EnableUpdateWhenOffscreen();
        context.ShowMeshes();
        context.DisposeOnGameObjectDestroyed();
        return context.Root;
    }
}

VRM-1.0

var vrm = await Vrm10.LoadPathAsync(
    path,
    canLoadVrm0X: true,
    normalizeTransform: true,
    showMeshes: false,
    awaitCaller: new RuntimeOnlyAwaitCaller(),
    materialGenerator: new Vrm10UrpMaterialDescriptorGenerator(),
    vrmMetaInformationCallback: updateMeta,
    ct: cancellationToken
);
if (vrm) {
    m_instance = vrm.GetComponent<RuntimeGltfInstance>();
}

参考：

UniVRM を使って VRM モデルをランタイムロードする方法 – Qiita

RuntimeLoad (1.0～) | UniVRM Programming ドキュメント (vrm-c.github.io)

RuntimeImport 非同期ロード (0.87～) | UniVRM Programming ドキュメント (vrm-c.github.io)

RuntimeImport (0.44～) | UniVRM Programming ドキュメント (vrm-c.github.io)

LoadModel – VRM10_Samples/VRM10Viewer/VRM10ViewerUI.cs at 7ad78c3bb4 – vrm-c/UniVRM

LoadPathAsync – VRM10/Runtime/IO/Vrm10.cs at 7ad78c3bb4 – vrm-c/UniVRM

シェーダー／マテリアル

参考：

Material | VRM [公式]

アプリケーションのビルド | UniVRM Programming Document (vrm-c.github.io)

VRMShaders/README.md – vrm-c/UniVRM – GitHub

エクスポート

VRM モデル (あるいは glTF 形式) のエクスポートに対応しているシェーダーは Standard、Unlit、UniGLTF、VRM 系の以下のシェーダー

glTF レイヤー

Standard
Unlit/Color
Unlit/Texture
Unlit/Transparent
Unlit/Transparent Cutout
UniGLTF/UniUnlit
VRM/UnlitTexture
VRM/UnlitTransparent
VRM/UnlitCutout

VRM レイヤー

VRM/UnlitTransparentZWrite
VRM/MToon

参考：

Export / Import | VRM [公式]

MToon シェーダー

Rendering Type

Opaque：不透明
Cutout：カットアウト (閾値で完全透過と不透明を切り替え)
Transparent：半透明 (アルファチャンネルで透過度をコントロールする)
TransparentWithZWrite：奥行き情報ありの透過

参考：

Santarh/MToon: Toon Shader with Unity Global Illumination – GitHub

MToon の設定 – Qiita

VRM フォーマットで使われる MToon シェーダーのキャラクターセットアップ – Qiita

VRM 形式のアバターの半透明の前後関係 | サンフラワーふじ

MToon リファレンス | VirtualCast wiki

VRM 標準シェーダ MToon の使い方 – SlideShare

MToon | VRM [公式]

テクスチャ

参考：

テクスチャーのインポート | VRM [公式]

表情モーフの設定／編集

モデルにアタッチされている「VRM Blend Shape Proxy」コンポーネントの「Blend Shape Avatar」に設定されているアセットが表情モーフを管理するアセットである。設定されているアセット名をダブルクリックするとアセットを選択状態にしてインスペクターに表示することができる。

VRM モデルをインポートすると、インポートしたディレクトリ下にある「(モデル名).Blendshapes」ディレクトリ内に表情モーフのアセット「BlendShape.asset」及びアニメーションクリップが作成される。

ゲーム再生中は、VRM Blend Shape Proxy に各ブレンドシェイプを 0 ～ 1 で操作するスライダーが現れ、簡易的に表情モーフのテストが行える。

プロジェクトウィンドウで「BlendShape.asset」を選択すると、インスペクターウィンドウで表情モーフを扱える。

Editor タブで Blend Shape Clip の編集
List タブで Blend Shape Clip を一覧表示

Blend Shape Clip

Neutral：基本 (ニュートラル)
A：あ (口開け)
I：い (口を横に引く)
U：う (すぼみ口)
E：え (口を横に引く／下唇を下げる)
O：お (口を開けて唇を突き出す)
Blink：両目閉じ
Blink_L：左目閉じ (ウインク)
Blink_R：右目閉じ (ウインク)
Angry：怒り (眉下げ／への字口)
Fun：楽しい (口角上げ)
Joy：喜び (目閉じ／口開き)
Sorrow：悲しい (困り眉／すぼみ口)
Surprised：驚き (目を見開く／口開き)
Extra：不等号目 (><)
LookUp：上を見る
LookDown：下を見る
LookLeft：左を見る
LookRight：右を見る

15～18 の LookUp、LookDown、LookLeft、LookRight は目線をモーフで制御するタイプのモデルで使用する。

視線をボーンで制御するタイプのモデルでは、VRMLookAtBoneApplyer コンポーネントを使用する。視線をモーフで制御する場合は VRMLookAtBoneApplyer を削除して、代わりに VRMLookAtBlendShapeApplyer コンポーネントを付与する。

「Add BlendShapeClip」ボタンを押して、新しい表情モーフを追加 (新規の BlendShapeClip を作成) することができる。事前定義された表情モーフを追加する場合は Preset から該当するプリセットを選び、それ以外の表情モーフを追加する場合は Unknown を選ぶ。(スクリプトから表情モーフをコントロールする際に、事前定義された表情モーフはプリセット名で指定することができる。)

参考：

VRoid で出力した VRM ファイルの表情調整 | しま

モデルの表情調整と表情データの再利用方法 – Qiita

VRoid Studio 製モデルには実は表情が6つある。牙も生やせるし2種類もある。これらの使い方と調整の方法 | 友黎火の note

Unity で VRM の表情を追加&編集する | 神楽ゆのん

VMagicMirror 向け VRoid Studio 産 VRM モデルに Unity で新規表情パターンを追加 & 微調整する方法 | Vtuber の雑学メモ帳

UniVRM の VRMBlendShapeProxy で表情アニメーション処理を共通化する – Qiita

VRM で数秒後に表情を変化させる | まゆたまガジェット開発逆引き辞典

キャラクターの表情やまばたきの制御方法 | Unity でゲームを作ろう！(unity.moon-bear.com)

ブレンドシェイプの設定 | VRM [公式]

視線制御 | VRM [公式]

URP で使いたい

参考：

VRoid のモデルのマテリアルを URP 対応のマテリアルに変更してみた – Qiita

LWRP / URP support · Issue #368 · vrm-c/UniVRM – GitHub

When unity URP will be supported? · Issue #387 · vrm-c/UniVRM – GitHub

glTF (.glb) をエクスポートする

参考：

glbファイルの作り方 · vrm-c/UniVRM Wiki – GitHub

ポリゴンを両面描画する

参考：

VRM アバターでテクスチャの裏側が透明になってしまうときの解決法 | ミッコちゃん

BVH／モーションキャプチャーデータ

参考：

VRM と BVH (モーションデータ) | 120 のブロマガ

サンプル

VRM_Samples (UniVRM_samples-X.YY.Z_xxxx.unitypackage)
- AnimationBridgeSample
- FirstPersonSample
- RuntimeExporterSample
- SimpleViewer
VRM10_Samples (VRM_Samples-X.YY.Z_xxxx.unitypackage)
- VRM10FirstPersonSample
- VRM10Viewer
UniVRMTest：VRM ビューワー