API untuk mengubah karakter ZEPETO ke tipe tubuh dasar

6min

Ketika avatar ZEPETO memasuki dunia dengan mengenakan item modifikasi tubuh atau telah memilih bentuk tubuh yang terlalu besar atau kecil, hal ini dapat menghambat permainan di dunia tersebut.
Dengan menggunakan API yang diperkenalkan dalam panduan ini, Anda dapat mengubah karakter ZEPETO kembali ke bentuk tubuh defaultnya.
❗️ Peringatan
Paket ZEPETO.Character.Controller tersedia dari versi 1.11.1 dan seterusnya.
API
Deskripsi
GetBodyModifierProperties()
- Mengembalikan informasi tentang bagian tubuh mana yang dikenakan item modifikasi tubuh oleh karakter ZEPETO.
DeformDefaultProperties()
- API ini menghapus item modifikasi tubuh yang dikenakan oleh karakter ZEPETO dan mengubahnya kembali ke bentuk tubuh defaultnya.
DeformDefaultCostume()
- API ini menghapus item modifikasi tubuh yang dikenakan oleh karakter ZEPETO, mengubahnya ke bentuk tubuh defaultnya, dan mendandani dengan kostum ZEPETO default.
- Ini juga dapat diterapkan di tingkat Pemain ZEPETO. Dalam hal ini, semua pemain ZEPETO yang memasuki dunia multiplayer akan memiliki item modifikasi tubuh mereka dihapus dan akan mengenakan kostum ZEPETO default.
﻿
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
﻿
﻿
Contoh Skrip
Silakan merujuk ke skrip contoh berikut:
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. Karakter lokal - Kode untuk mencetak di mana item perubahan bentuk tubuh dipasang
             this._itemProperties = this._localPlayer.zepetoPlayer.character.GetBodyModifierProperties();
             console.log(this._itemProperties);
             
             // 2. Karakter lokal - kode untuk melepas item perubahan bentuk tubuh
             this._localPlayer.zepetoPlayer.character.DeformDefaultProperties();
             
             // 3. Karakter lokal - kode untuk melepas item perubahan bentuk tubuh dan mengenakan kostum default
             this._localPlayer.zepetoPlayer.character.DeformDefaultCostume();
             
         });
 
       	 // 4. Kode untuk melepas semua item perubahan bentuk tubuh pemain dan mengenakan kostum default
         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. Karakter lokal - Kode untuk mencetak di mana item perubahan bentuk tubuh dipasang
             this._itemProperties = this._localPlayer.zepetoPlayer.character.GetBodyModifierProperties();
             console.log(this._itemProperties);
             
             // 2. Karakter lokal - kode untuk melepas item perubahan bentuk tubuh
             this._localPlayer.zepetoPlayer.character.DeformDefaultProperties();
             
             // 3. Karakter lokal - kode untuk melepas item perubahan bentuk tubuh dan mengenakan kostum default
             this._localPlayer.zepetoPlayer.character.DeformDefaultCostume();
             
         });
 
       	 // 4. Kode untuk melepas semua item perubahan bentuk tubuh pemain dan mengenakan kostum default
         ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
             ZepetoPlayers.instance.DeformDefaultCostume();
         });
         
     }
}
﻿
﻿
Deskripsi Skrip
1) Informasi slot item modifikasi tubuh yang dikenakan oleh Pemain Lokal disimpan di this._itemProperties oleh GetBodyModifierProperties() dan informasi tersebut dicetak ke konsol
﻿
﻿
2) Semua item modifikasi tubuh yang dikenakan oleh Pemain Lokal dihapus oleh DeformDefaultProperties(), dan karakter diubah kembali ke bentuk tubuh defaultnya.
﻿
﻿
3) Dengan DeformDefaultCostume(), semua item modifikasi tubuh yang dikenakan oleh Pemain Lokal dihapus, dan mereka diubah menjadi penampilan mengenakan kostum ZEPETO default.
﻿
﻿
4) Kode di bawah ini memastikan bahwa semua pemain yang memasuki dunia akan memiliki semua item modifikasi tubuh mereka dihapus dan akan mengenakan kostum ZEPETO default.
Namun, pengaturan multiplayer dan implementasi skrip server-client dasar harus diselesaikan terlebih dahulu.
TypeScript
ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
	ZepetoPlayers.instance.DeformDefaultCostume();
});
ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
	ZepetoPlayers.instance.DeformDefaultCostume();
});
﻿
﻿
﻿
Wajah avatar yang dianimasikan juga diklasifikasikan sebagai item modifikasi tubuh.
Oleh karena itu, saat menggunakan DeformDefaultProperties(), DeformDefaultCostume() API, harap dicatat bahwa penampilan avatar yang dianimasikan yang memasuki dunia juga akan berubah.
﻿

API	Deskripsi
GetBodyModifierProperties()	- Mengembalikan informasi tentang bagian tubuh mana yang dikenakan item modifikasi tubuh oleh karakter ZEPETO.
DeformDefaultProperties()	- API ini menghapus item modifikasi tubuh yang dikenakan oleh karakter ZEPETO dan mengubahnya kembali ke bentuk tubuh defaultnya.
DeformDefaultCostume()	- API ini menghapus item modifikasi tubuh yang dikenakan oleh karakter ZEPETO, mengubahnya ke bentuk tubuh defaultnya, dan mendandani dengan kostum ZEPETO default. - Ini juga dapat diterapkan di tingkat Pemain ZEPETO. Dalam hal ini, semua pemain ZEPETO yang memasuki dunia multiplayer akan memiliki item modifikasi tubuh mereka dihapus dan akan mengenakan kostum ZEPETO default.

Diperbarui 11 Oct 2024

Apakah halaman ini membantu Anda?

SEBELUMNYA

Ubah kostum pemain lokal

BERIKUTNYA

Mengubah area tabrakan karakter ZEPETO