API เพื่อเปลี่ยนตัวละคร ZEPETO เป็นประเภทพื้นฐาน
เมื่ออวตาร ZEPETO เข้าสู่โลกและสวมใส่ไอเท็มการปรับเปลี่ยนร่างกายหรือเลือกขนาดร่างกายที่ใหญ่เกินไปหรือน้อยเกินไป อาจทำให้การเล่นเกมในโลกนั้นถูกขัดขวาง
โดยใช้ API ที่แนะนำในคู่มือนี้ คุณสามารถเปลี่ยนอวตาร ZEPETO กลับไปยังรูปร่างร่างกายเริ่มต้นได้
❗️ ระวัง
- แพ็คเกจ ZEPETO.Character.Controller มีให้บริการตั้งแต่เวอร์ชัน 1.11.1 เป็นต้นไป
API | คำอธิบาย |
|---|---|
GetBodyModifierProperties() | - คืนข้อมูลเกี่ยวกับส่วนใดของร่างกายที่อวตาร ZEPETO สวมใส่ไอเท็มการปรับเปลี่ยนร่างกาย |
DeformDefaultProperties() | - API นี้จะลบไอเท็มการปรับเปลี่ยนร่างกายที่อวตาร ZEPETO สวมใส่และเปลี่ยนกลับไปยังรูปร่างร่างกายเริ่มต้น |
DeformDefaultCostume() | - API นี้จะลบไอเท็มการปรับเปลี่ยนร่างกายที่อวตาร ZEPETO สวมใส่ เปลี่ยนกลับไปยังรูปร่างร่างกายเริ่มต้น และแต่งตัวในชุด ZEPETO เริ่มต้น - สามารถนำไปใช้ที่ระดับผู้เล่น ZEPETO ได้ ในกรณีนี้ ผู้เล่น ZEPETO ทุกคนที่เข้ามาในโลกหลายคนจะถูกลบไอเท็มการปรับเปลี่ยนร่างกายและจะแต่งตัวในชุด ZEPETO เริ่มต้น |
None = 0, Skin = 1, SkinTone = 2, SkinDetail = 3, Face = 4, Eye = 5, EyeLens = 6, Eyebrow = 7,
Beard = 8, Mustache = 9, EyeShadow = 10, EyeLiner = 11, EyeLash = 12, Blusher = 13, Nose = 14,
Mouth = 15, Lips = 16, Hair = 17, ClothesGlasses = 18, ClothesTop = 19, ClothesBottom = 20, ClothesShoes = 21,
ClothesDress = 22, Background = 23, RoomWallpaper = 24, RoomFloor = 25, RoomBottom = 26, RoomTopLeft = 27, RoomTopRight = 28,
RoomMiddleLeft = 29, RoomMiddleRight = 30, Point = 31, Freckles = 32, FaceHair = 33, DoubleEyelid = 34, NailArt = 35,
ClothesSocks = 36, ClothesGlove = 37, AccessoryBracelet = 38, AccessoryNecklace = 39, AccessoryEarring = 40, AccessoryRing = 41, AccessoryHeadwear = 42,
AccessoryPiercing = 43, BoothBackground = 44, LUT = 45, AccessoryMask = 46, FacePainting = 47, AccessoryBag = 48, AccessoryWing = 49,
ClothesCape = 50, ClothesExtra = 51, MannequinFace = 52, WrinkleForehead = 53, WrinkleEye = 54, WrinkleMouth = 55, DoubleEyelidBottom = 56,
WrinkleMongo = 57, AccessoryTail = 58, AccessoryEffect = 59, ClothesDeform = 60, HairExtensions = 61, MakeupSet = 62, FaceContouring = 63,
BaseModel = 64, CreatorLens = 65, BaseDeform = 66
สคริปต์ตัวอย่าง
โปรดดูสคริปต์ตัวอย่างต่อไปนี้:
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, LocalPlayer, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { ZepetoPropertyFlag } from 'Zepeto';
export default class Deform extends ZepetoScriptBehaviour {
private _localPlayer: LocalPlayer;
private _itemProperties : ZepetoPropertyFlag[]
Start() {
ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
// 1. ตัวละครท้องถิ่น - โค้ดเพื่อพิมพ์ว่ามีการติดตั้งรายการเปลี่ยนรูปร่างร่างกายที่ไหน
this._itemProperties = this._localPlayer.zepetoPlayer.character.GetBodyModifierProperties();
console.log(this._itemProperties);
// 2. ตัวละครท้องถิ่น - โค้ดเพื่อถอดรายการเปลี่ยนรูปร่างร่างกาย
this._localPlayer.zepetoPlayer.character.DeformDefaultProperties();
// 3. ตัวละครท้องถิ่น - โค้ดเพื่อถอดรายการเปลี่ยนรูปร่างร่างกายและใส่ชุดปกติ
this._localPlayer.zepetoPlayer.character.DeformDefaultCostume();
});
// 4. โค้ดเพื่อถอดรายการเปลี่ยนรูปร่างร่างกายของผู้เล่นทั้งหมดและใส่ชุดปกติ
ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
ZepetoPlayers.instance.DeformDefaultCostume();
});
}
}
คำอธิบายสคริปต์
1) ข้อมูลช่องรายการปรับเปลี่ยนร่างกายที่สวมใส่โดยผู้เล่นท้องถิ่นจะถูกบันทึกใน this._itemProperties โดย GetBodyModifierProperties() และข้อมูลนั้นจะถูกพิมพ์ไปยังคอนโซล

2) รายการการปรับเปลี่ยนร่างกายทั้งหมดที่สวมใส่โดยผู้เล่นท้องถิ่นจะถูกลบโดย DeformDefaultProperties(), และตัวละครจะถูกเปลี่ยนกลับไปเป็นรูปร่างร่างกายเริ่มต้น.

3) โดย DeformDefaultCostume(), รายการการปรับเปลี่ยนร่างกายทั้งหมดที่สวมใส่โดยผู้เล่นท้องถิ่นจะถูกลบ และพวกเขาจะถูกเปลี่ยนให้มีลักษณะเหมือนสวมใส่ชุด ZEPETO เริ่มต้น.

4) โค้ดด้านล่างนี้จะทำให้ผู้เล่นทุกคนที่เข้ามาในโลกจะต้องถูกลบไอเท็มการปรับแต่งร่างกายทั้งหมดและจะสวมใส่ชุด ZEPETO เริ่มต้น.
- อย่างไรก็ตาม การตั้งค่าหลายผู้เล่นและการดำเนินการสคริปต์เซิร์ฟเวอร์-ไคลเอนต์พื้นฐานจะต้องเสร็จสิ้นล่วงหน้า.
ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
ZepetoPlayers.instance.DeformDefaultCostume();
});
- ใบหน้าของอวตารที่เคลื่อนไหวยังถือเป็นไอเท็มการปรับแต่งร่างกายด้วย.
- ดังนั้น เมื่อใช้ DeformDefaultProperties(), DeformDefaultCostume() APIs โปรดทราบว่าลักษณะของอวตารที่เคลื่อนไหวที่เข้ามาในโลกจะเปลี่ยนแปลงด้วย.