모델 무결성 검증

업데이트： 2025/10/14

Cubism SDK는 모델을 로드하기 전에 변조에 의해 모델에 잘못된 데이터가 포함되어 있지 않은지 검증할 수 있습니다.

불특정한 MOC3 파일이 읽어 들여질 것으로 예상되는 경우 csmInitializeModelInPlace로 csmMoc의 오브젝트를 생성하기 전에, 읽어 들이는 MOC3 파일의 무결성을 확인하는 것을 권장합니다.
단, 무결성 검증은 성능에 영향을 줄 가능성이 있으므로 주의하십시오.

모델의 무결성을 검증하려면 Cubism Core의  csmHasMocConsistency()(SDK for Java는  Live2DCubismCore.hasMocConsistency())를 사용합니다.
자세한 내용은 「Cubism Core API 참조」를 참조하십시오.

Cubism SDK for Native의  CubismMoc::Create() , Cubism SDK for Web의  CubismMoc.create() 및 Cubism SDK for Java의  CubismMoc.create() 는 모델을 로드할 때 MOC3 파일의 무결성을 검증합니다.

// Cubism SDK for Native

CubismMoc* CubismMoc::Create(const csmByte* mocBytes, csmSizeInt size, csmBool shouldCheckMocConsistency)
{
    CubismMoc* cubismMoc = NULL;

    void* alignedBuffer = CSM_MALLOC_ALLIGNED(size, Core::csmAlignofMoc);
    memcpy(alignedBuffer, mocBytes, size);

    if (shouldCheckMocConsistency)
    {
        // .moc3의 무결성 확인
        csmBool consistency = HasMocConsistency(alignedBuffer, size);
        if (!consistency)
        {
            CSM_FREE_ALLIGNED(alignedBuffer);

            // 무결성을 확인할 수 없으면 처리하지 않음
            CubismLogError("Inconsistent MOC3.");
            return cubismMoc;
        }
    }

    ...

    return cubismMoc;
}

// Cubism SDK for Web

  public static create(
    mocBytes: ArrayBuffer,
    shouldCheckMocConsistency: boolean
  ): CubismMoc {
    let cubismMoc: CubismMoc = null;

    if (shouldCheckMocConsistency) {
      // .moc3의 무결성 확인
      const consistency = this.hasMocConsistency(mocBytes);

      if (!consistency) {
        // 무결성을 확인할 수 없으면 처리하지 않음
        CubismLogError(`Inconsistent MOC3.`);
        return cubismMoc;
      }
    }

    ...

    return cubismMoc;
  }

// Cubism SDK for Java

    public static CubismMoc create(byte[] mocBytes, boolean shouldCheckMocConsistency) {
        com.live2d.sdk.cubism.core.CubismMoc moc;

        if (mocBytes == null) {
            return null;
        }

        if (shouldCheckMocConsistency) {
            // .moc3의 무결성을 확인.
            boolean consistency = hasMocConsistency(mocBytes);

            if (!consistency) {
                CubismDebug.cubismLogError("Inconsistent MOC3.");
                return null;
            }
        }

        ...

        return cubismMoc;
    }

Cubism SDK의 샘플에서는 디폴트로 로드 시에 무결성 검증을 실시하고 있지만, 이쪽은 임의로 무효화할 수 있습니다.

모델을 불러올 때 무결성 검증을 무효화하려면 SDK for Native의 LAppDefine::MocConsistencyValidationEnable, SDK for Web의 LAppDefine.MOCConsistencyValidationEnable 및 SDK for Java의 LAppDefine.MOC_CONSISTENCY_VALIDATION_ENABLE의 값을 변경합니다.

// Cubism SDK for Native

    // MOC3 무결성 검증 옵션
    const csmBool MocConsistencyValidationEnable = true;

// Cubism SDK for Web

// MOC3 일관성 검증 옵션
export const MOCConsistencyValidationEnable = true;

// Cubism SDK for Java

    /**
     ※MOC3의 무결성을 검증할지 여부. 유효하다면 true.
     */
    public static final boolean MOC_CONSISTENCY_VALIDATION_ENABLE = true;

Unity도 마찬가지로 기본적으로는 CubismMoc.CreateFrom()으로 모델을 가져올 때 무결성을 검증합니다.

// Cubism SDK for Unity

public static CubismMoc CreateFrom(byte[] moc3, bool shouldCheckMocConsistency = true)
{
    if (shouldCheckMocConsistency && !HasMocConsistency(moc3))
    {
        Debug.LogError("This Moc3 is Invalid. This model generation process is aborted and prefab is not created.\n" +
                                   $"Please check Model's Moc version. This CubismCore supported latest Moc version is `{LatestVersion}`.");
        return null;
    }

    var moc = CreateInstance<CubismMoc>();


    moc.Bytes = moc3;


    return moc;
}

새로 추가된 MOC 버전을 얻는 방법

Cubism 5.3 SDK for Native R5 beta2 및 Cubism 5.3 SDK for Web R5 beta2 이상에 추가한 GetMocVersionFromBuffer()를 사용하면 csmHasMocConsistency()에 실패한 경우에도 MOC 파일 버전을 얻을 수 있습니다.

이것은 Cubism 5 SDK for Native R4_1 및 Cubism 5 SDK for Web R4 이전의 SDK로 Cubism 5.3 이후의 기능을 포함한 모델을 불러왔을 때 무결성 검증에서 부정으로 판단되어 버려 MOC 버전을 얻을 수 없기 때문에 새롭게 추가했습니다.