UniVRM [Unity] – Site-Builder.wiki

Transform：左右の目のトランスフォームを指定する
- Left Eye：左目
- Right Eye：右目
Degree Mapping：作動範囲を指定する
- Horizontal Outer：外向き
- Horizontal Inner：内向き
- Vertical Down：上向き
- Vertical Up：下向き

作動範囲の指定

Curve：作動の特性を指定する (※ VRM-1.0 では廃止された)
Curve X Range Degree：
Curve Y Range Degree：実際に動く範囲を指定する (デフォルト：10)

ドキュメント：

LookAt – VRM-1.0 API | UniVRM Programming ドキュメント [公式]

lookAt.ja.md – vrm-c/vrm-specification – GitHub

参考：

VRM モデルの視線制御／目の可動範囲の設定方法 – Qiita

VRM の目の動作 (Look At) を正しく設定する | クロイニャン

VRM モデルの視線が動かない原因 | Mitchie M のブログ

具体的な可動域の数値は「VRM Look At Bone Applyer」の「Degree Mapping」の項目で調整 (@Yohen_XR) – Twitter

アイトラ実装中…なのはいいんですが、VRoidモデルの目線の上下の可動域が想像より大きかったのでビックリしてる。 (@Yohen_XR) – Twitter

VRM モデルの再インポート／モデルデータの更新

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

ドキュメント：

Prefab が Import されるタイミングと上書きの注意 | VRM [公式]

参考：

[1.0] Library を削除するなどの初回アセットロード時、 `Migrate to Vrm 1` オプションを有効にした vrm ファイルアセットがエラーでアセット化されない · Issue #1973 · 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

ドキュメント：

Material | VRM [公式]

MToon シェーダー

Rendering Type

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

こちらのページを参照

VRM にマテリアルを設定する方法

リポジトリ：

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

ドキュメント：

MToon | VRM [公式]

参考：

MToon の設定 – Qiita

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

テクスチャ

参考：

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

コンストレイント

ドキュメント：

Constraint の設定 | VRM [公式]

Node Constraint (VRM-1.0) – GitHub

モデル空間 (VRM-1.0) – GitHub

参考：

[1.0] Constraints: add explainer by 0b5vr · Pull Request #188 · vrm-c/vrm-specification – GitHub

[1.0-draft] Proposal of VRMC_constraints by 0b5vr · Pull Request #144 · vrm-c/vrm-specification – GitHub

コンストレイントをサポートしてほしい · Issue #6 · vrm-c/vrm-specification – GitHub

コントロールリグ (Control Rig)

コントロールリグを用いて、VRM モデルにポーズを付ける。(v0.103 ～)

Animator.getBoneTransform は、コントロールリグにおけるボーンを返す。(v0.104 ～)

参考：

Control Rig – 正規化されていないモデルを操作する | UniVRM Programming ドキュメント [公式]

正規化

※ VRM-1.0 では、モデルを VRM 化する際に正規化を適用しない。

VRM-1.0 は正規化が仕様から除かれました。

—— UniVRM

正規化とは、ヒエラルキーからの回転、スケールの除去。その状態での Binding 行列再生成。です。

すべてのノードの回転が 0 のときが初期姿勢 (T-Pose) であるという仕様で、プログラムから統一的にモデルを操作することが可能でした。

—— UniVRM

参考：

Control Rig – 正規化されていないモデルを操作する | UniVRM Programming ドキュメント [公式]

ユーティリティ (VrmUtility)

ドキュメント：

簡単 API v0.95 | UniVRM Programming ドキュメント [公式]

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

参考：

VRM1として出力されたデータのGLBとしての互換性について · Issue #1906 · vrm-c/UniVRM – GitHub

ポリゴンを両面描画する

参考：

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

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

参考：

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

VRM-1.0 に移行する

（出典：Santarh）

UniVRM-1.0 が使い物にならない劣化具合でヤバいという話。しかもドキュメントが一切ない。VRM-1.0 リリースからだいぶ経つけど工事中でページが空っぽ

(2023年1月3日午後 9:02)

—— @esperecyan

ドキュメント：

VRM-0.x モデルを VRM-1.0 モデルにアップグレードする | VRM [公式]

アップグレードの互換性 | VRM [公式]

Editor でアップグレードする | VRM [公式]

API 更新 | UniVRM Programming ドキュメント [公式]

リンク：

UniVRM 利用アプリケーションの VRM 1.0 への移行について (Santarh) – Speaker Deck

internal is not valid エラー

現象：

internal 修飾子が不正である旨のエラーが発生する。

error CS0106: The modifier 'internal' is not valid for this item

原因：

v0.100.0 以降は、Unity 2020.3 より新しいバージョンの Unity に対応している。

対処法：

Unity 2020.3 以降を使用する。
それ以前の Unity で必要な場合は、UniVRM v0.99.4 を使用する。

参考：

internal modifier isn’t valid? · Issue #2024 · vrm-c/UniVRM – GitHub

サンプル

UPM

パッケージマネージャーで Git URL を指定してインストールした場合、パッケージマネージャーで「In Project」に切り替えて、「VRM-1.0」パッケージを選択して「Samples」から「Import」ボタンを押してプロジェクト内にサンプルコードを複製できる。

パッケージ

VRM10_Samples (VRM_Samples-X.YY.Z_xxxx.unitypackage)
- Model Setup Seed-San (VRM-1.0)
- First Person Sample (VRM-1.0)
- Runtime Exporter Sample (VRM-1.0)
- Viewer (VRM-1.0)
VRM_Samples (UniVRM_samples-X.YY.Z_xxxx.unitypackage)
- Animation Bridge Sample (VRM-0.x)
- First Person Sample (VRM-0.x)
- Runtime Exporter Sample (VRM-0.x)
- Simple Viewer (VRM-0.x)