API เพื่อเปลี่ยนตัวละคร ZEPETO เป็นประเภทพื้นฐาน

6min

เมื่ออวตาร ZEPETO เข้าสู่โลกและสวมใส่ไอเท็มการปรับเปลี่ยนร่างกายหรือเลือกขนาดร่างกายที่ใหญ่เกินไปหรือน้อยเกินไป อาจทำให้การเล่นเกมในโลกนั้นถูกขัดขวาง
โดยใช้ API ที่แนะนำในคู่มือนี้ คุณสามารถเปลี่ยนอวตาร ZEPETO กลับไปยังรูปร่างร่างกายเริ่มต้นได้
❗️ ระวัง
แพ็คเกจ ZEPETO.Character.Controller มีให้บริการตั้งแต่เวอร์ชัน 1.11.1 เป็นต้นไป
API
คำอธิบาย
GetBodyModifierProperties()
- คืนข้อมูลเกี่ยวกับส่วนใดของร่างกายที่อวตาร ZEPETO สวมใส่ไอเท็มการปรับเปลี่ยนร่างกาย
DeformDefaultProperties()
- API นี้จะลบไอเท็มการปรับเปลี่ยนร่างกายที่อวตาร ZEPETO สวมใส่และเปลี่ยนกลับไปยังรูปร่างร่างกายเริ่มต้น
DeformDefaultCostume()
- API นี้จะลบไอเท็มการปรับเปลี่ยนร่างกายที่อวตาร ZEPETO สวมใส่ เปลี่ยนกลับไปยังรูปร่างร่างกายเริ่มต้น และแต่งตัวในชุด ZEPETO เริ่มต้น
- สามารถนำไปใช้ที่ระดับผู้เล่น ZEPETO ได้ ในกรณีนี้ ผู้เล่น ZEPETO ทุกคนที่เข้ามาในโลกหลายคนจะถูกลบไอเท็มการปรับเปลี่ยนร่างกายและจะแต่งตัวในชุด ZEPETO เริ่มต้น
﻿
ZepetoPropertyFlag Enum
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
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
﻿
﻿
สคริปต์ตัวอย่าง
โปรดดูสคริปต์ตัวอย่างต่อไปนี้:
TypeScript
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();
         });
         
     }
}

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

API	คำอธิบาย
GetBodyModifierProperties()	- คืนข้อมูลเกี่ยวกับส่วนใดของร่างกายที่อวตาร ZEPETO สวมใส่ไอเท็มการปรับเปลี่ยนร่างกาย
DeformDefaultProperties()	- API นี้จะลบไอเท็มการปรับเปลี่ยนร่างกายที่อวตาร ZEPETO สวมใส่และเปลี่ยนกลับไปยังรูปร่างร่างกายเริ่มต้น
DeformDefaultCostume()	- API นี้จะลบไอเท็มการปรับเปลี่ยนร่างกายที่อวตาร ZEPETO สวมใส่ เปลี่ยนกลับไปยังรูปร่างร่างกายเริ่มต้น และแต่งตัวในชุด ZEPETO เริ่มต้น - สามารถนำไปใช้ที่ระดับผู้เล่น ZEPETO ได้ ในกรณีนี้ ผู้เล่น ZEPETO ทุกคนที่เข้ามาในโลกหลายคนจะถูกลบไอเท็มการปรับเปลี่ยนร่างกายและจะแต่งตัวในชุด ZEPETO เริ่มต้น

อัปเดต 11 Oct 2024

หน้านี้ช่วยคุณได้หรือไม่?

เปลี่ยนชุดผู้เล่นท้องถิ่น

การเปลี่ยนพื้นที่การชนของตัวละคร ZEPETO