Cocos Creator版特有的注意事项

最終更新: 2023年3月14日

此页面适用于Cubism 4.2及更早版本的旧版本。 点击此处查看最新页面

将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 错误
请问这篇文章对您有帮助吗?
关于本报道,敬请提出您的意见及要求。