验证.motion3.json的一致性

最終更新： 2026年5月22日

Cubism SDK可以在导入.motion3.json前验证模型是否包含因篡改而导致的无效数据。

如果需要导入未指定的.motion3.json文件，建议在使用CubismMotion生成副本前确认要导入的.motion3.json文件的一致性。
但是，请注意一致性验证可能会影响性能。

为了验证模型一致性，SDK for Unity使用Framework的CubismMotion3Json.HasConsistency()，其他则使用Framework的CubismMotionJson::HasConsistency()。

Cubism SDK for Native中的CubismMotion::Parse()仅在启用CSM_DEBUG宏时，才会在导入模型时验证.motion3.json文件的一致性。

// Cubism SDK for Native
void CubismMotion::Parse(const csmByte* motionJson, const csmSizeInt size)
{
    CubismMotionJson* json = CSM_NEW CubismMotionJson(motionJson, size);

    if (!json->IsValid())
    {
        CSM_DELETE(json);
        return;
    }

    if (shouldCheckMotionConsistency)
    {
        csmBool consistency = json->HasConsistency();
        if(!consistency)
        {
            CSM_DELETE(json);

            CubismLogError("Inconsistent motion3.json.");
            return;
        }
    }
…
    CSM_DELETE(json);
}

Cubism SDK for Web中的CubismMotion.parse()仅当CubismMotion._debugMode为true时，才会在导入模型时验证.motion3.json文件的一致性。

// Cubism SDK for Web
public parse(
    motionJson: ArrayBuffer,
    size: number,
    shouldCheckMotionConsistency: boolean = false
): void {
    ...

    if (shouldCheckMotionConsistency) {
      const consistency = json.hasConsistency();
      if (!consistency) {
        json.release();
        CubismLogError('Inconsistent motion3.json.');
        return;
      }
    }

    ...

可以使用CubismMotion.setDebugMode()变更CubismMotion._debugMode。

Cubism SDK for Java中的CubismMotion.parse()仅当CubismFrameworkConfig.CSM_DEBUG为true时，才会在导入模型时验证.motion3.json文件的一致性。

// Cubism SDK for Java
private void parse(byte[] motionJson, boolean shouldCheckMotionConsistency) {
    ...

    if (shouldCheckMotionConsistency) {
        boolean consistency = json.hasConsistency();

         if (!consistency) {
            CubismDebug.cubismLogError("Inconsistent motion3.json.");
            return;
        }
    }

    ...

Cubism SDK for Unity中的CubismMotion3Json.LoadFrom()仅当shouldCheckMotionConsistency为true时入.motion3.json时验证文件的一致性。

// Cubism SDK for Unity
public static CubismMotion3Json LoadFrom(string motion3Json, bool shouldCheckMotionConsistency = true)
{
    ...

    if (shouldCheckMotionConsistency)
    {
        var consistency = cubismMotion3Json.HasConsistency();
        if (!consistency)
        {
            return null;
        }
    }

    ...