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 错误