Unity:VRMのランタイムロードがなんもわからん

こちら「2019年なんもわからんカレンダー」１月３日の記事です。

前回の記事は
Kazushige Mori(Cz_mirror) (@Cz_mirror) | Twitter さんによる「SmartRig Bipedなんもわからん。。」でした。

cz-mirror.hatenablog.com

前書き

自分だけの3Dキャラクターをあらゆるゲームに登場させるという、全人類の悲願(笑)がまさに今日成就しようとしています。
ウソだと思うあなた、次の VRoid Hub のサイトの文句をちょっと調べてみてください。

>いま、あなたのキャラクターが動き出す。
hub.vroid.com

自慢の3Dキャラを3分でおひろめ。

登録したキャラで遊べちゃう。

お気に入りがなければ、自分ですぐに作れます。

ということで VRoid Hub で公開されている VRM （3Dキャラクターデータフォーマット）をゲーム実行後にダウンロードして読み込ませる方法を確かめたいと思いまして
なんもわからん状態から調べて完全に理解した状態まで来たので、実装詳細を記録しておきます。

VRM を Unity ゲームで読み込むには？

VRM - dwango on GitHub 公式ドキュメントにざっと目を通し、次の UniVRM を使うと良いことが確認できました。
github.com

そんな UniVRM を使って VRM をランタイムロードするには？と調べるとドンピシャな記事を見つけました。
qiita.com

こちらの記事の内容で完全に理解できてしまうのですが、本記事では Unity 初心者にもわかるように詳細に作業ログを残します。

Unity Hub から Unity を起動

簡単な操作ですが、Unity Hub は比較的新しいツールなので、Unity ベテランの方でも使ったことがない人もいます。
今回は Unity 2018.3.0f2 を使い、空のプロジェクトを作成して起動しました。

UniVRM パッケージをインポート

次の UniVRM の README に従って最新のUniVRM-0.xx.unitypackageファイルをダウンロードして、Unityにインポートします。
GitHub - dwango/UniVRM: Unity package that can import and export VRM format

Humanoid適当アニメーションデータを用意

Unity の公開アセット（無料）の中から Unity ちゃんの歩行アニメーションをダウンロードして、Unityにインポートします。
unity-chan.com

ブレンドツリーのアニメーションコントローラを作成

こちらの過去記事で紹介している WalkRun ステートを持つ AnimatorController が用意できればゴールです。
simplestar-tech.hatenablog.com

ランタイムロードのコードを記述

GameManager.cs

using System.IO;
using UnityEngine;
using VRM;

public class GameManager : MonoBehaviour
{
    [SerializeField]
    GameObject m_target;
    [SerializeField]
    RuntimeAnimatorController m_animCtrl;

    private void Start()
    {
        LoadModel("C:/Users/simpl/Downloads/Vita.vrm");
    }

    void LoadModel(string path)
    {
        if (!File.Exists(path))
        {
            Debug.LogError("file not found path = " + path);
            return;
        }

        Debug.LogFormat("{0}", path);
        var context = new VRMImporterContext();
        var file = File.ReadAllBytes(path);
        context.ParseGlb(file);
        context.Load();
        context.ShowMeshes();
        context.EnableUpdateWhenOffscreen();
        context.ShowMeshes();
        SetModel(context.Root);
    }

    void SetModel(GameObject go)
    {
        if (go != null)
        {
            var lookAt = go.GetComponent<VRMLookAtHead>();
            if (lookAt != null)
            {
                go.AddComponent<Blinker>();

                lookAt.Target = m_target.transform;
                lookAt.UpdateType = UpdateType.LateUpdate; // after HumanPoseTransfer's setPose
            }

            var animCtrl = go.GetComponent<Animator>();
            if (animCtrl && animCtrl.runtimeAnimatorController == null)
            {
                animCtrl.runtimeAnimatorController = m_animCtrl;
            }
        }
    }
}