タグ & レイヤー
6 分
Unityのタグとレイヤー機能を使用して、ワールドを開発できます。
タグ
Unityで使用したのと同じ方法でタグ機能を使用できます。
❗️ 注意 最大64個のタグを使用できます。

以下は、ZEPETOキャラクターにタグを設定するためのサンプルコードです。
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, ZepetoPlayer, ZepetoPlayers } from 'ZEPETO.Character.Controller';
export default class PlayerTag extends ZepetoScriptBehaviour
{
private zepetoCharacter :ZepetoCharacter;
Start()
{
ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
this.zepetoCharacter = ZepetoPlayers.instance.LocalPlayer.zepetoPlayer.character;
// プレイヤータグを設定
this.zepetoCharacter.gameObject.tag = "Player";
});
}
}
以下は、Tag関数を使用するためのサンプルコードです。
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject } from 'UnityEngine';
export default class TagExample extends ZepetoScriptBehaviour {
Start() {
let findObj = GameObject.FindGameObjectWithTag("customTag");
if (findObj != null) {
console.log(`name : ${findObj.name}`);
}
}
}

📘 Unity Tag情報 https://docs.unity3d.com/Manual/Tags.html
レイヤー
Unityで使用したのと同じようにLayer機能を使用できます。
❗️ 注意 レイヤー番号20から27を使用できます。


以下はZEPETOキャラクターのレイヤーを設定するためのサンプルコードです。
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, ZepetoPlayer, ZepetoPlayers } from 'ZEPETO.Character.Controller';
export default class PlayerLayer extends ZepetoScriptBehaviour
{
private zepetoCharacter :ZepetoCharacter;
Start()
{
ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
this.zepetoCharacter = ZepetoPlayers.instance.LocalPlayer.zepetoPlayer.character;
// プレイヤーレイヤーを設定
this.zepetoCharacter.gameObject.layer = 20;
});
}
}
以下は、Layer関数を使用するためのサンプルコードです。
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Camera, Input, Physics, RaycastHit } from 'UnityEngine';
export default class LayerExample extends ZepetoScriptBehaviour {
Update() {
if (Input.GetMouseButtonDown(0)) {
let ray = Camera.main.ScreenPointToRay(Input.mousePosition);
let ref = $ref<RaycastHit>();
let layerMask = 1 << 20;
if (Physics.Raycast(ray, ref, 100, layerMask)) {
let hitInfo = $unref(ref);
console.log(`name : ${hitInfo.collider.gameObject.name}`);
}
}
}
}

📘 Unityレイヤー情報 https://docs.unity3d.com/Manual/Layers.html