아트메쉬에 설정된 유저 데이터 취득 (SDK for Cocos Creator)

업데이트： 2023/03/14

여기에서는 모델에서 아트메쉬에 설정된 「UserData」에 대한 정보를 취득하기까지의 설명을 합니다.

개요

「UserData」는 Cubism 3.1부터 추가된 기능으로 사용자가 아트메쉬에 임의의 메타데이터를 부여할 수 있습니다.
유저 데이터의 취급 방법에 따라서는, 그 아트메쉬를 충돌 감지로 지정하거나 특별한 쉐이딩을 실시하는 등 여러 가지 일에 활용할 수 있습니다.

아트메쉬에 유저 데이터를 설정하는 방법은 여기를 참조하십시오.

아트메쉬에 설정된 유저 데이터를 취득하려면 아래에 설명된 절차를 수행하십시오.

구체적인 기술 예로는 다음과 같은 형태가 있습니다.

import { _decorator, Component, Node } from 'cc';
import CubismUserDataTag from '../extensions/Live2DCubismSdkForCocosExtension/static/assets/Framework/UserData/CubismUserDataTag';
const { ccclass, property } = _decorator;

@ccclass('UserDataTest')
export class UserDataTest extends Component {
  protected start() {
    let userDatas = this.getComponentsInChildren(CubismUserDataTag);

    for (let i = 0; i < userDatas.length; ++i) {
      let data = userDatas[i];
      console.log("id:"+data.node.name + "\n"
      +"value:"+data.value);
    }
  }
}

그런 다음 유저 데이터가 설정된 모델의 Prefab을 Hierarchy에 배치합니다.
배치한 Prefab의 루트에 위에서 만든 UserDataTest 구성 요소를 연결합니다.

모델 가져오기에 대한 자세한 내용은 「이 튜토리얼」을 참조하십시오.

이것으로 설정이 종료됩니다.

이 상태에서 Scene을 실행하면 Console 창에 유저 데이터가 설정된 아트메쉬의 ID와 유저 데이터에 설정된 문자열이 출력됩니다.