UniVRM/docs/api/vrm1_runtime_load.md

RuntimeLoad

Runtime Normalization (from v0.92.0)

VRM-1.0 は、ノードの 回転・スケールの削除 をしません。 後方互換性のため、 RuntimeLoad 時に動的に 回転・スケールの削除 する機能を提供します。

VRM-0.x のエクスポート時の正規化に相当する処理です

以下のように doNormalize に true を付与してください。

using (var loader = new Vrm10Importer(vrm, 
    // normalize option
    doNormalize: true))
{
    RuntimeGltfInstance instance = await loader.LoadAsync();
    return instance;
}

Migration(VRM-0 to VRM-1)

VRM-1.0 は、 VRM-0.x もロードできます。 その場合、あたらしい meta への変換が発生し互換性の無い部分はすべて 不許可 の値になります。 このため、変換前のライセンスにアクセスする API を提供します。

サンプルの Assets\VRM10\Samples\VRM10Viewer\VRM10ViewerUI.cs も参照してください。

static IMaterialDescriptorGenerator GetVrmMaterialDescriptorGenerator(bool useUrp)
{
    if (useUrp)
    {
        return new Vrm10UrpMaterialDescriptorGenerator();
    }
    else
    {
        return new Vrm10MaterialDescriptorGenerator();
    }
}

async Task<RuntimeGltfInstance> LoadAsync(string path)
{
    GltfData data = new AutoGltfFileParser(path).Parse();

    // doMigrate: true で旧バージョンの vrm をロードできます。
    if (Vrm10Data.TryParseOrMigrate(data, doMigrate: true, out Vrm10Data vrm))
    {
        // vrm
        using (var loader = new Vrm10Importer(vrm, 
        materialGenerator: GetVrmMaterialDescriptorGenerator(m_useUrpMaterial.isOn)))
        {
            // migrate しても thumbnail は同じ
            var thumbnail  = await loader.LoadVrmThumbnailAsync();

            if (vrm.OriginalMetaBeforeMigration != null)
            {
                // migrated from vrm-0.x. use OriginalMetaBeforeMigration
                UpdateMeta(vrm.OriginalMetaBeforeMigration, thumbnail);
            }
            else
            {
                // load vrm-1.0. use newMeta
                UpdateMeta(vrm.VrmExtension.Meta, thumbnail);
            }

            // モデルをロード
            RuntimeGltfInstance instance = await loader.LoadAsync();
            return instance;
        }
    }
    else{
        throw new Exception("not vrm");
    }
}