Cocos Creator版特有的注意事项

最終更新： 2023年3月14日

将Cubism SDK for Cocos Creator导入Cocos Creator时的注意事项

在使用Cubism SDK for Cocos Creator中附带的范例模型时，可能无法直接使用它，因为在导入Cubism SDK for Cocos Creator后立即载入顺序不固定。
如果显示错误，请务必使用[Reimport Asset]重新载入model3.json或包含其的文件夹。
此外，将Cubism SDK for Cocos Creator导入Cocos Creator后，[GlobalMaskTexture.asset]可能无法立即正确使用。
在这种情况下，请务必使用[Reimport Asset]重新载入[GlobalMaskTexture.asset]，并重启Cocos Creator。

关于绘制蒙版

GlobalMaskTexture.asset

将Cubism SDK for Cocos Creator导入Cocos Creator后，[GlobalMaskTexture.asset]中可能无法正确绘制蒙版。
在这种情况下，请务必使用[Reimport Asset]重新载入[GlobalMaskTexture.asset]，并重启Cocos Creator。

此外，可以在整个场景上绘制蒙版中使用的纹理。
这种情况下，在Cocos Creator的[Project] – [Project Settings] – [Layers]中为User Layer 19取一个任意名称（比如 MASK），并取消勾选场景Main Camera的Visibility。

TypeScript（JavaScript）语言规范注意事项

Cocos Creator提供的math.Vec2、math.Vec3等类、本SDK提供的IStructLike接口实装类是按照语言规范的副本。

请注意，变更副本成员属性值以处理类似结构的语言（如C#）可能会导致意外行为。

* 本SDK提供的IStructLike接口实装类的成员设置为readonly，可以避免在基本操作中误执行上述操作。

请注意，由于Typescript 4.7.4的语言规范，在以下情况下不会发生错误。

export interface IReadonlySample {
  readonly x: number;
}
export interface ISample {
  x: number;
}
export class Sample {
  public readonly x: number = 0;
}

const a: ISample = new Sample(); // 不会发生错误。
a.x = 1;

const b: IReadonlySample = new Sample();
b.x = 2; // TS: 2540 错误