VRM0.xでMeshAnnotationsのmeshに-1が指定されていると一人称メッシュ作成時にNotImplementedExceptionが発生する問題を回避する

[tsgcpp]

環境情報

• UniVRM version: v0.116.0
• Unity version: Unity-2021.3.27f1
• OS: Windows 10

概要

MeshAnnotationのmeshに-1が指定されているとNotImplementedExceptionが発生することを確認したため、その問題を回避案を提出させていただきます。

問題の流れは以下です。

• Migration時にmeshAnnotationsのmeshに-1が指定されているVRM0.xをロードする
• glTFNode.nodeの初期値 -1 と一致してしまいMeshがあるNodeとして扱われる
• Meshが存在しないNodeにMeshAnnotationsを設定しようとして ここに入り、NotImplementedException が発生する

        "meshAnnotations": [
          {
            "firstPersonFlag": "Auto",
            "mesh": 0
          },
          {
            "firstPersonFlag": "Auto",
            "mesh": -1
          },
          {
            "firstPersonFlag": "Auto",
            "mesh": 2
          }
        ]

UniVRM以外のツールでVRM0.xで上記のようなVRMが作られる場合が有るようでした。

問題の再現方法

• https://github.com/tsgcpp/UniVRM/releases/tag/report_20240106 をcheckout
• Assets/Report/Scenes/Report_ErrorWithMeshAnnotationMinusOne_Vrm10LoadWithFirstPerson.unity を開いてPlayを実行

対応案

• meshAnnotationsのmeshに0未満が指定されていた場合は処理しない

[vrm-github-bot]

Can one of the admins verify this patch?

[ousttrue]

ありがとうございます。

json シリアライズの index 参照は int? 型にすればよかったと反省しています。
開発初期に使用した UnityEngine.JsonUtility は使える型が限られている、という事情もありました。