获取图形网格中设置的用户数据 (SDK for Cocos Creator)

最終更新： 2023年3月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中。
将上面创建的UserDataTest组件附加到置入的Prefab的根。

有关模型载入，请参考“此处”的教程。

这要就完成了设置。

如果在此状态下执行Scene，则设置用户数据的图形网格的ID和用户数据中设置的字符串将输出到Console视窗。