Cocos Creator 버전 특유의 주의점

업데이트： 2023/03/14

Cubism SDK for Cocos Creator를 Cocos Creator로 로드할 때의 주의점

Cubism SDK for Cocos Creator에 동봉된 샘플 모델을 사용할 때 Cubism SDK for Cocos Creator를 로드한 직후에는 가져오기 순서가 일정하지 않으므로 그대로는 사용할 수 없는 경우가 있습니다.
오류 등이 표시된 경우 반드시 model3.json 또는 그것들이 들어간 폴더를 [Reimport Asset]로 다시 가져와 주세요.
Cubism SDK for Cocos Creator를 Cocos Creator로 로드한 직후에는 [GlobalMaskTexture.asset]을 올바르게 사용할 수 없는 경우가 있습니다.
이 경우 반드시 [GlobalMaskTexture.asset]을 [Reimport Asset]으로 다시 가져오고 Cocos Creator를 다시 시작하십시오.

마스크 그리기 정보

GlobalMaskTexture.asset

Cubism SDK for Cocos Creator를 Cocos Creator로 가져온 직후에는 [GlobalMaskTexture.asset]에 마스크가 제대로 렌더링되지 않을 수 있습니다.
이 경우 반드시 [GlobalMaskTexture.asset]을 [Reimport 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 오류