--- title: ローカルプレイヤーのコスチュームを変更します slug: world-sdk-guide-ja/ZehZEvAB3E3D1IAFBDabu docTags: createdAt: 2024-09-02T08:34:13.135Z --- ローカルプレイヤーの衣装を所有しているものに変更できます。 ZEPETO.Character.Controller 1.11.3 以上のバージョンをインストールする必要があります。 ## SetCostume APIの使用 ### メソッド | **API** | **説明** | | --------------------------------------------------------------- | ------------------------------------------------------------------------ | | SetCostume($itemCode: string, $complete?: System.Action)\:void; | ローカルプレイヤーの衣装を変更するために、アイテムコード（アイテムID）を引数として入力します。衣装変更が完了したらコールバックを受け取ります。 | ## ローカルプレイヤーの衣装変更の例 ローカルプレイヤーの衣装を変更するには、`SetCostume()`を使用します。 シーンが始まるとローカルプレイヤーを作成し、ローカルプレイヤーが作成されたときに特定のアイテムコードで衣装を変更する例のコードです。 1\) ZEPETO > Typescriptを追加し、スクリプトにChangeLocalPlayerCostumeという名前を付けます。 以下のようにサンプルスクリプトを書いてください。 :::CodeblockTabs ChangeLocalPlayerCostume.ts ```typescript import { SpawnInfo, ZepetoPlayers } from 'ZEPETO.Character.Controller'; import { ZepetoScriptBehaviour } from 'ZEPETO.Script'; import { WorldService } from 'ZEPETO.World'; export default class ChangeLocalPlayerCostume extends ZepetoScriptBehaviour { public itemCode: string; // シーンが始まると、提供されたユーザーIDでプレイヤーを作成し、衣装を変更します。 Start() { // 指定されたユーザーIDで新しいプレイヤーを作成します。 ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true); // ローカルプレイヤーが追加されたときにトリガーされるOnAddedLocalPlayerイベントにリスナーを追加します。 ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => { // 提供されたアイテムコードでChangeCostumeメソッドを呼び出して衣装を変更します。 this.ChangeCostume(this.itemCode); }); } // 提供されたアイテムコードを使用してローカルプレイヤーの衣装を変更するメソッド。 ChangeCostume(itemCode: string) { // LocalPlayerプロパティを使用してローカルプレイヤーインスタンスにアクセスし、提供されたアイテムコードを使用して衣装を設定します。 ZepetoPlayers.instance.LocalPlayer.SetCostume(itemCode, () => { // 衣装の変更が完了したら、成功した変更を示すメッセージをログに記録します。 console.log(`衣装の設定が完了しました : ${itemCode}`); }); } } ``` ::: ### スクリプトの説明 - このスクリプトは、指定されたアイテムコードに従ってローカルプレイヤーの衣装を変更します。 - シーンが開始されると、指定されたユーザーIDでプレイヤーを作成し、`CreatePlayerWithUserId()`関数を使用します。 - ローカルプレイヤーが追加されると、そのイベントがトリガーされるように、OnAddedLocalPlayerイベントリスナーが追加され、`ChangeCostume()`メソッドが呼び出されて衣装が変更されます。 - LocalPlayerプロパティを通じてローカルプレイヤーインスタンスにアクセスし、提供されたアイテムコードを使用して衣装を変更します。衣装の変更が完了すると、`Set Costume Complete`メッセージがログに記録され、成功した変更を示します。 :::hint{type="info"} **📘 **アイテムIDを確認する方法については、マネキンガイドを参照してください。\[[ZEPETO マネキン](docId\:rtsPax0sPfGVFaFOG7LvI)] ::: 2\) \[▶︎(再生)] ボタンを押して実行すると、入力されたアイテムコードに基づいてローカルプレイヤーが作成され、コスチュームが変更されるのがわかります。 ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-9ot0wNN2ut4K4pljvcSHI-20240904-102422.png) コスチューム変更前（左）、コスチューム変更後（右） :::hint{type="danger"} - アイテムが定期商品である場合、期限が切れているかどうかを確認した後に着用されます。期限が切れたアイテムには、`期限切れアイテム`というエラーログが表示されます。 - アイテムがZem有料商品である場合、ローカルプレイヤーが所有しているかどうかを確認した後に着用されます。所有していないアイテムには、`アイテムコードなし`というエラーログが表示されます。 ::: ### アイテムリストを読み込み、服を変更する例。 ユーザーが所有しているアイテムに関する情報を提供する`GetMyItemListAsync()`を利用することで、衣服アイテムのリストを取得できます。 以下の例は、ローカルプレイヤーが所有している衣装を画面に表示し、選択して変更できるようにする方法を示しています。 ### ステップ1. 衣服リストUIを作成する まず、衣服リストのサムネイルと名前が表示されるUIリストリソースを作成します。作成する必要があるリソースは次のとおりです： ### ステップ1-1. アイテムプレハブを作成する ローカルプレイヤーが持っている衣服のリストを読み込んだ後、UIにアイテムのリストを作成します。アイテムプレハブは、作成される各アイテムリストのソースとして機能します。 アイテムプレハブが作成されると、サムネイルとアイテム名がUIに表示されます。 アイテムプレハブには以下の要素が含まれています。 1. Button\_thumbnailオブジェクト：これは、アイテムのサムネイル画像を表示するためにRaw ImageコンポーネントとButtonコンポーネントが登録されているオブジェクトです。 2. Text\_nameオブジェクト：アイテム名が表示されるTextコンポーネントオブジェクトです。 ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Qm6kn6yLAAWhZNwsPWpok-20240904-102422.png) ### ステップ 1-2. キャンバスの設定 キャンバスは、アイテムプレハブが作成されたときに表示されるUI画面です。このキャンバス内にスクロールビューを作成することをお勧めします。そうすることで、大量のアイテムリストを取得できます。 キャンバス内のスクロールビューオブジェクトは以下のように設定されています。 - スクロールビューオブジェクトは、垂直スクロールのみを許可するように設定されています。 - コンテンツオブジェクトは、以下のコンポーネントを設定します： - グリッドレイアウトグループ： - セルサイズ : x: 150, Y: 150 - 制約 : 固定列数 - 制約数 : 5 ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-wLg_pemNWFYxohPdYWt-N-20240904-102422.png) ### ステップ2. アイテムリストを読み込み、衣装を変更するスクリプト ### ステップ 2-1. スクリプトを書く - ZEPETOを追加 > Typescriptにし、スクリプトの名前をMyItemListに変更します。 - 以下のようにサンプルスクリプトを書きます。 :::CodeblockTabs MyItemList.ts ```typescript import { ZepetoScriptBehaviour } from 'ZEPETO.Script'; import { ShopService, ItemKeyword } from 'ZEPETO.Module.Shop'; import { ZepetoPropertyFlag } from 'Zepeto'; import { GameObject, Object, RectTransform, Texture2D, Transform, WaitUntil } from 'UnityEngine'; import { Button, LayoutRebuilder, RawImage, Text } from 'UnityEngine.UI'; import { SpawnInfo, ZepetoPlayers } from 'ZEPETO.Character.Controller'; import { WorldService } from 'ZEPETO.World'; import { Item } from 'ZEPETO.Module.Content'; export default class CheckMyItemList extends ZepetoScriptBehaviour { public itemPrefab: GameObject; public itemCanvas: Transform; // シーンが開始されると、指定されたユーザーIDでプレイヤーを作成し、アイテムを取得して表示します。 Start() { // 指定されたユーザーIDで新しいプレイヤーを作成します。 ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true); // ローカルプレイヤーが追加されたときにトリガーされるOnAddedLocalPlayerイベントにリスナーを追加します。 ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => { // アイテムを取得して表示するためにCoGetMyItemコルーチンを開始します。 this.StartCoroutine(this.CoGetMyItem()); }); } // アイテムを取得して表示するためのコルーチン。 *CoGetMyItem() { // "all"キーワードとフィルターなしでアイテムリストをリクエストします。 var requestItemList = ShopService.GetMyContentItemListAsync(ItemKeyword.all, null); // リクエストが完了するまで待機します。 yield new WaitUntil(() => requestItemList.keepWaiting == false); if (requestItemList.responseData.isSuccess) { let contentItems: Item[] = requestItemList.responseData.items; console.log(contentItems.length); for (let i = 0; i < contentItems.length; ++i) { const property: ZepetoPropertyFlag = contentItems[i].property; // アイテムのサムネイルテクスチャをリクエストします。 var textureReq = contentItems[i].GetThumbnailAsync(); yield new WaitUntil(() => textureReq.keepWaiting == false); let thumbnailTexture: Texture2D = textureReq.responseData.texture; // アイテムプレハブをインスタンス化し、そのプロパティを設定します。 const item = Object.Instantiate(this.itemPrefab, this.itemCanvas) as GameObject; item.GetComponentInChildren().texture = thumbnailTexture; item.GetComponentInChildren().text = contentItems[i].id; // アイテムボタンにクリックリスナーを追加して、クリック時にコスチュームを変更します。 item.GetComponentInChildren