あなたの世界を作りなさい
プレイヤーとキャラクター: 上級
ボットプレイヤー作成ガイド
15min
ボットプレイヤーは、マルチプレイヤーの世界を開始するのに十分な人数がいないときや、プレイヤーが世界から離脱したときに補填するために使用されます。
ボットプレイヤーの動作は、各コンテンツに対して実装する必要があります。
このガイドは、ボットプレイヤーを作成する一般的な方法を説明しています。
📘 ボットプレイヤー作成ガイドは、マルチプレイヤーガイドに基づいています。[マルチプレイを作る]
1-1. マルチプレイヤースキーマに「IsBot」というブール値を追加します。
1-2. サーバースクリプト index.ts にボットプレイヤーを作成するための以下の関数を定義し、必要なポイントで呼び出します。
index.ts
1// `CreateBot()` メソッドは、指定された `userId` を持つボットプレイヤーを作成するために使用されます。
2CreateBot(userId: string) {
3
4 // 提供された `userId` を使用してボットプレイヤーのセッションIDを生成します。
5 const sessionId = "Bot_" + userId;
6
7 // 同じセッションIDを持つボットプレイヤーがすでに存在するか確認します。存在する場合は、重複を作成せずに戻ります。
8 if (this.state.players.has(sessionId)) {
9 return;
10 }
11
12 // ボットプレイヤーのための新しい `Player` オブジェクトを作成します。
13 const player: Player = new Player();
14 player.sessionId = sessionId;
15 if (userId) {
16 player.zepetoUserId = userId;
17 }
18 player.isBot = true;
19
20 // セッションIDをキーとして使用して、ボットプレイヤーを状態のプレイヤーマップに追加します。
21 this.state.players.set(player.sessionId, player);
22 this._botMap.set(sessionId, player);
23}
👍 ヒント
- 特定のユーザーの userId は、ボットプレイヤーキャラクターを作成するために事前に保存されています。
- サーバーの OnJoin に接続しているクライアントの userId を確認することで、特定のユーザーの UserId を確認できます。以下のスクリプトをサーバースクリプトに書いた後、関連するワールドから接続してください。
index.ts
1onJoin(client: SandboxPlayer) {
2 console.log(client.userId);
3}
2-1. サーバーがボットプレイヤーを作成する場合、クライアントはそれを OnJoinPlayer() で新しいプレイヤーとして認識します。
- プロジェクトを作成 > 作成 > ZEPETO > TypeScript として作成し、BotPlayerManager に名前を変更します。
- OnAddedPlayer() にロジックを追加して各プレイヤーを作成し、ボットプレイヤーを区別してその ZEPETO キャラクターを作成するロジックを追加します。
BotPlayerManager.ts
1import { ZepetoCharacter, ZepetoPlayers } from 'ZEPETO.Character.Controller';
2import { Room } from 'ZEPETO.Multiplay';
3import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
4import { ZepetoWorldMultiplay } from 'ZEPETO.World';
5
6export default class BotPlayerManager extends ZepetoScriptBehaviour {
7
8 public zepetoWorldMultiplay: ZepetoWorldMultiplay;
9
10 // 現在の部屋とボットプレイヤーデータを保存するためのプライベート変数。
11 private _room: Room;
12 private _botMapData: Map<string, ZepetoCharacter> = new Map<string, ZepetoCharacter>();
13
14 Start() {
15
16 // `ZepetoWorldMultiplay` コンポーネントからの `RoomJoined` イベントをリッスンします。
17 this.zepetoWorldMultiplay.RoomJoined += (room: Room) => {
18 this._room = room;
19 }
20
21 // `ZepetoPlayers.instance` からの `OnAddedPlayer` イベントをリッスンして、新しく追加されたプレイヤーを処理します。
22 ZepetoPlayers.instance.OnAddedPlayer.AddListener((userId: string) => {
23
24 // `userId` を使用して部屋の状態から現在のプレイヤーデータを取得します。
25 const currentPlayer = this._room.State.players.get_Item(userId);
26
27 // プレイヤーがボットかどうかを確認し、ボットプレイヤーとして設定します。
28 if (currentPlayer.isBot) {
29 this.SetBotPlayer(currentPlayer.sessionId);
30 }
31 });
32 }
33}
2-2. SetBotPlayer関数を作成して、ボットプレイヤーにタグと同期コンポーネントを追加し、それらを制御するスクリプトを作成します。
- ボットプレイヤーのデータを管理するために、Map形式で_botMapDataに保存します。
BotPlayerManager.ts
1// `SetBotPlayer()`メソッドは、プレイヤーをボットとして設定するために使用されます。
2SetBotPlayer(userId: string) {
3
4 // `userId`を使用してボットプレイヤーに関連付けられたZEPETOキャラクターを取得します。
5 const bot = ZepetoPlayers.instance.GetPlayer(userId).character;
6
7 // 識別のためにキャラクターの名前を`userId`に設定します。
8 bot.gameObject.name = userId;
9
10 // ボットプレイヤーのデータを`userId`をキーとして_botMapDataマップに保存します。
11 this._botMapData.set(userId, bot);
12}
👍 ヒント ボットプレイヤーの動作を制御するために、SetBotPlayer()に追加のスクリプトや設定を追加できます。
開始するために特定の数のプレイヤーが必要なワールドでは、時々プレイヤーが不足していて、ワールドが開始するまで長い間待たなければなりません。
この場合、Botプレイヤーを追加することで世界を開始できます。
3-1. index.tsでサーバーがクライアントからメッセージを受信したときにCreateBot()を実行する関数を登録します。
TypeScript
1async OnCreate() {
2
3 // 与えられたuserIdでボットプレイヤーを作成する"CreateBot"メッセージを処理します。
4 this.onMessage("CreateBot", (client, message) => {
5 this.CreateBot(message);
6 });
7}
3-2. クライアントスクリプトBotPlayerManager.tsで、サーバーに"CreateBot"メッセージを送信する関数を書きます。
- 関数を実行する方法は、ボタンを押してメッセージを送信することです。
- 作成されるBotプレイヤーのユーザーIDを文字列としてメッセージを通じて送信します。
BotPlayerManager.ts
1public buttonCreateBot: Button;
2public botPlayerId: string;
3
4Start() {
5
6 // ボットプレイヤーを作成するメッセージを送信するために"Create Bot"ボタンにクリックリスナーを追加します。
7 this.buttonCreateBot.onClick.AddListener(() => {
8 this._room.Send("CreateBot", this.botPlayerId);
9 });
10}
3-3. さて、サーバーとランタイムを実行すると、ボットプレイヤーがボタンを押すと作成されるのがわかります。
プレイヤーが不足している場合、ボットプレイヤーを追加して世界を開始できます。
4-1. サーバースクリプトで、OnJoin中に以下のコードを追加して、プレイヤーの数を確認し、4人以上のプレイヤーがいるときにワールドを開始します。
- CreateBot()内でプレイヤーの数を確認する関数を追加します。
- StartWorld()関数内でプレイの数をカウントする機能を追加します。
index.ts
1 async onJoin(client: SandboxPlayer) {
2
3 // プレイヤーが参加した後、部屋のプレイヤー数を確認します。
4 this.CheckPlayerNumber();
5}
6
7// `CheckPlayerNumber()`メソッドは、部屋のプレイヤー数を確認し、4人以上のプレイヤーがいる場合にワールドを開始します。
8CheckPlayerNumber() {
9
10 // 現在のプレイヤー数をコンソールに出力します。
11 console.log(`プレイヤー数, ${this.state.players.size}`);
12
13 // 部屋に4人以上のプレイヤーがいる場合、ワールドを開始します。
14 if (this.state.players.size >= 4) {
15 this.StartWorld();
16 }
17}
18
19// `CreateBot()`メソッドは、指定された`userId`を持つボットプレイヤーを作成するために使用されます。
20CreateBot(userId: string) {
21
22 // 提供された`userId`を使用してボットプレイヤーのセッションIDを生成します。
23 const sessionId = "Bot_" + userId;
24
25 // 同じセッションIDを持つボットプレイヤーがすでに存在するか確認します。存在する場合は、重複を作成せずに戻ります。
26 if (this.state.players.has(sessionId)) {
27 return;
28 }
29
30 // ボットプレイヤーのために新しい`Player`オブジェクトを作成します。
31 const player: Player = new Player();
32 player.sessionId = sessionId;
33 if (userId) {
34 player.zepetoUserId = userId;
35 }
36 player.isBot = true;
37
38 // セッションIDをキーとして、状態のプレイヤーマップにボットプレイヤーを追加します。
39 this.state.players.set(player.sessionId, player);
40 this._botMap.set(sessionId, player);
41
42 // ボットプレイヤーを追加した後、部屋のプレイヤー数を確認します。
43 this.CheckPlayerNumber();
44}
45
46
47private playTime: number = 0;
48
49// `StartWorld()`メソッドは、プレイ時間を増加させ、すべてのクライアントに"StartWorld"メッセージをブロードキャストします。
50StartWorld() {
51 this.playTime += 1;
52
53 // ワールドの開始と現在のプレイ時間を示すメッセージを出力します。
54 console.log("ワールドを開始します！");
55 this.broadcast("StartWorld", this.playTime);
56}
- サーバーでは、実際のプレイヤーが部屋に参加するときに OnJoin が実行されます。したがって、CreateBot を介して Bot プレイヤーが作成され、OnJoin を介してプレイヤーが入るとき、checkPlayerNumber() は人数を追加します。
4-2. クライアントスクリプト BotPlayerManager.ts で、サーバーから StartWorld メッセージを受信したときに実行される StartWorld() を記述します。
BotPlayerManager.ts
1Start() {
2
3 // `ZepetoWorldMultiplay` コンポーネントからの `RoomJoined` イベントをリッスンします。
4 this.zepetoWorldMultiplay.RoomJoined += (room: Room) => {
5
6 // "StartWorld" メッセージタイプのメッセージハンドラーを追加します。
7 this._room.AddMessageHandler("StartWorld", (playTime: number) => {
8 this.StartWorld(playTime);
9 });
10}
11
12// `StartWorld()` メソッドは、提供された `playTime` でワールドが開始されるときに呼び出されます。
13StartWorld(playTime: number) {
14
15 // `playTime` とともにワールド開始メッセージを表示します。
16 console.log(`Start World : ${playTime}`);
17}
4-3. 実行時に、Bot プレイヤーを含む 4 人以上のプレイヤーがいる場合、サーバーコンソールとクライアントのコンソールに「World Start」というログが表示されます。
以下は、追加されたボットプレイヤーをローカルプレイヤーの位置に移動させ、移動位置を同期させるサンプルコードです。
5-1. まず、サーバーのindex.tsでクライアントから受信したメッセージのときにボットプレイヤーを移動させるコードを書きます。MoveBotが受信されると、
TypeScript
1async OnCreate() {
2
3 // "MoveBot"メッセージを処理し、ボットプレイヤーを指定された位置に移動させます。
4 this.onMessage("MoveBot", (client, message) => {
5 this.MoveBot(client, message);
6 });
7}
8
9// `MoveBot()`メソッドは、受信したメッセージに基づいてボットプレイヤーを指定された位置に移動させます。
10MoveBot(client: SandboxPlayer, message: string) {
11 // クライアントから受信したJSONメッセージを解析して位置情報を抽出します。
12 const position = JSON.parse(message);
13
14 // ユーザーのセッションIDと解析された位置データを持つ新しいメッセージオブジェクトを作成します。
15 const newMessage = {
16 user: client.sessionId,
17 positionX: position.x,
18 positionY: position.y,
19 positionZ: position.z
20 }
21
22 // 新しいメッセージデータをJSON文字列としてすべてのクライアントに"MoveBotToPosition"メッセージをブロードキャストします。
23 this.broadcast("MoveBotToPosition", JSON.stringify(newMessage));
24}
5-2. クライアントスクリプトのBotPlayerManager.tsで、buttonCallBotが押されたときにローカルプレイヤーの位置をサーバーに送信するSendBotPosition()を書きます。
- メッセージ MoveBotToPosition がサーバーから受信されたときに、すべてのボットプレイヤーをメッセージに含まれる位置情報に移動させるコードを書いてください。
BotPlayerManager.ts
1public buttonCallBot: Button;
2
3Start(){
4
5 // `ZepetoWorldMultiplay` コンポーネントからの `RoomJoined` イベントをリッスンします。
6 this.zepetoWorldMultiplay.RoomJoined += (room: Room) => {
7 this._room = room;
8
9 // "StartWorld" メッセージタイプのメッセージハンドラーを追加します。
10 this._room.AddMessageHandler("StartWorld", (playTime: number) => {
11 this.StartWorld(playTime);
12 });
13
14 // ボタン "Call Bot" にクリックリスナーを追加して、ボットプレイヤーの位置を送信するメッセージを送ります。
15 this.buttonCallBot.onClick.AddListener(() => {
16 this.SendBotPosition();
17 });
18}
19
20// このメソッドは、ボットの動きの同期のためにローカルプレイヤーのキャラクターの位置をサーバーに送信します。
21SendBotPosition() {
22
23 // ローカルプレイヤーのキャラクターの位置を取得します。
24 const localPlayerPosition = ZepetoPlayers.instance.LocalPlayer.zepetoPlayer.character.transform.position;
25
26 // ローカルプレイヤーのキャラクターの x, y, z 座標を含む位置オブジェクトを作成します。
27 const position = {
28 x: localPlayerPosition.x,
29 y: localPlayerPosition.y,
30 z: localPlayerPosition.z
31 }
32
33 // 位置オブジェクトを JSON 文字列に変換し、"MoveBot" メッセージタイプでサーバーに送信します。
34 this._room.Send("MoveBot", JSON.stringify(position));
35 }
36
37MoveBotToPosition(message) {
38
39 // クライアントから受信した JSON メッセージを解析して位置情報を抽出します。
40 const jsonMessage = JSON.parse(message);
41 const position = new Vector3(jsonMessage.positionX, jsonMessage.positionY, jsonMessage.positionZ);
42
43 // `_botMapData` マップ内の各ボットキャラクターを指定された位置に移動させ、x および z 軸に小さなランダムオフセットを加えます。
44 this._botMapData.forEach((character: ZepetoCharacter) => {
45 // `MoveToPosition()` メソッドを使用してキャラクターを指定された位置に移動させます。
46 // ここでは、ボットの自然な動きを作成するために、ターゲット位置に小さなランダムオフセットを追加します。
47 character.MoveToPosition(position + new Vector3(Random.Range(0.5, 1), 0, Random.Range(0.5, 1)));
48 });
49}
5-3. さて、ランタイムでボットプレイヤーを作成し、buttonCallBot ボタンを押すと、作成されたボットプレイヤーがローカルプレイヤーのキャラクターの位置に移動するのが見えるはずです。
BotPlayerManager.ts
1import { Random, Vector3 } from 'UnityEngine';
2import { Button } from 'UnityEngine.UI';
3import { ZepetoCharacter, ZepetoPlayers } from 'ZEPETO.Character.Controller';
4import { Room } from 'ZEPETO.Multiplay';
5import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
6import { ZepetoWorldMultiplay } from 'ZEPETO.World';
7
8export default class BotPlayerManager extends ZepetoScriptBehaviour {
9
10 // Inspectorから必要なコンポーネントと設定を参照するための公開プロパティ。
11 public zepetoWorldMultiplay: ZepetoWorldMultiplay;
12 public buttonCreateBot: Button;
13 public buttonCallBot: Button;
14 public botPlayerId: string;
15
16 // 現在の部屋とボットプレイヤーデータを保存するためのプライベート変数。
17 private _room: Room;
18 private _botMapData: Map<string, ZepetoCharacter> = new Map<string, ZepetoCharacter>();
19
20 Start() {
21
22 // `ZepetoWorldMultiplay`コンポーネントからの`RoomJoined`イベントをリッスンします。
23 this.zepetoWorldMultiplay.RoomJoined += (room: Room) => {
24 this._room = room;
25
26 // "StartWorld"メッセージタイプのメッセージハンドラーを追加します。
27 this._room.AddMessageHandler("StartWorld", (playTime: number) => {
28 this.StartWorld(playTime);
29 });
30 }
31
32 // 新しく追加されたプレイヤーを処理するために`ZepetoPlayers.instance`からの`OnAddedPlayer`イベントをリッスンします。
33 ZepetoPlayers.instance.OnAddedPlayer.AddListener((userId: string) => {
34
35 // `userId`を使用して部屋の状態から現在のプレイヤーデータを取得します。
36 const currentPlayer = this._room.State.players.get_Item(userId);
37
38 // プレイヤーがボットかどうかを確認し、そうであればボットプレイヤーとして設定します。
39 if (currentPlayer.isBot) {
40 this.SetBotPlayer(currentPlayer.sessionId);
41 }
42 });
43
44 // ボットプレイヤーを作成するためのメッセージを送信するために"Create Bot"ボタンにクリックリスナーを追加します。
45 this.buttonCreateBot.onClick.AddListener(() => {
46 this._room.Send("CreateBot", this.botPlayerId);
47 });
48
49 this.zepetoWorldMultiplay.RoomJoined += (room: Room) => {
50 this._room = room;
51
52 this._room.AddMessageHandler("MoveBotToPosition", (message: string) => {
53 this.MoveBotToPosition(message);
54 });
55 }
56
57 // ボットプレイヤーの位置を送信するためのメッセージを送信するために"Call Bot"ボタンにクリックリスナーを追加します。
58 this.buttonCallBot.onClick.AddListener(() => {
59 this.SendBotPosition();
60 });
61 }
62
63 // `SetBotPlayer()`メソッドはプレイヤーをボットとして設定するために使用されます。
64 SetBotPlayer(userId: string) {
65
66 // ボットプレイヤーに関連付けられたZEPETOキャラクターを`userId`を使用して取得します。
67 const bot = ZepetoPlayers.instance.GetPlayer(userId).character;
68
69 // 識別のためにキャラクターの名前を`userId`に設定します。
70 bot.gameObject.name = userId;
71
72 // ボットプレイヤーのデータを`userId`をキーとして`_botMapData`マップに保存します。
73 this._botMapData.set(userId, bot);
74 }
75
76 // `StartWorld()`メソッドは、指定された`playTime`で世界が開始されると呼び出されます。
77 StartWorld(playTime: number) {
78
79 // `playTime`と共に世界開始メッセージを出力します。
80 console.log(`Start World : ${playTime}`);
81 }
82
83 // このメソッドは、ボットの動きの同期のためにローカルプレイヤーのキャラクターの位置をサーバーに送信します。
84 SendBotPosition() {
85
86 // ローカルプレイヤーのキャラクターの位置を取得します。
87 const localPlayerPosition = ZepetoPlayers.instance.LocalPlayer.zepetoPlayer.character.transform.position;
88
89 // ローカルプレイヤーのキャラクターのx、y、z座標を含む位置オブジェクトを作成します。
90 const position = {
91 x: localPlayerPosition.x,
92 y: localPlayerPosition.y,
93 z: localPlayerPosition.z
94 }
95
96 // 位置オブジェクトをJSON文字列に変換し、"MoveBot"メッセージタイプでサーバーに送信します。
97 this._room.Send("MoveBot", JSON.stringify(position));
98 }
99
100 // このメソッドは、サーバーがクライアントから"MoveBot"メッセージを受信したときに呼び出され、ボットキャラクターを指定された位置に移動させます。
101 MoveBotToPosition(message) {
102
103 // クライアントから受信したJSONメッセージを解析して位置情報を抽出します。
104 const jsonMessage = JSON.parse(message);
105 const position = new Vector3(jsonMessage.positionX, jsonMessage.positionY, jsonMessage.positionZ);
106
107 // `_botMapData`マップ内の各ボットキャラクターを指定された位置に小さなランダムオフセットを加えて移動させます。
108 this._botMapData.forEach((character: ZepetoCharacter) => {
109 // `MoveToPosition()`メソッドは、キャラクターを指定された位置に移動させるために使用されます。
110 // ここでは、ボットの自然な動きを作成するために、ターゲット位置に小さなランダムオフセットが追加されます。
111 character.MoveToPosition(position + new Vector3(Random.Range(0.5, 1), 0, Random.Range(0.5, 1)));
112 });
113 }
114}
Text
1import { Sandbox, SandboxOptions, SandboxPlayer } from "ZEPETO.Multiplay";
2import { DataStorage } from "ZEPETO.Multiplay.DataStorage";
3import { Player, Transform, Vector3 } from "ZEPETO.Multiplay.Schema";
4
5export default class extends Sandbox {
6
7 storageMap: Map<string, DataStorage> = new Map<string, DataStorage>();
8
9 // ボットプレイヤーのマップデータを _botMap として保存
10 private _botMap: Map<string, Player> = new Map<string, Player>();
11 private playTime: number = 0;
12
13 constructor() {
14 super();
15 }
16
17 onCreate(options: SandboxOptions) {
18
19 // Room オブジェクトが作成されたときに呼び出されます。
20 // Room オブジェクトの状態またはデータの初期化を処理します。
21
22 this.onMessage("onChangedTransform", (client, message) => {
23
24 this.state.players.get(client.sessionId);
25
26 const player = this.state.players.get(client.sessionId);
27
28 const transform = new Transform();
29 transform.position = new Vector3();
30 transform.position.x = message.position.x;
31 transform.position.y = message.position.y;
32 transform.position.z = message.position.z;
33
34 transform.rotation = new Vector3();
35 transform.rotation.x = message.rotation.x;
36 transform.rotation.y = message.rotation.y;
37 transform.rotation.z = message.rotation.z;
38
39 if (player) {
40 player.transform = transform;
41 }
42 });
43
44 this.onMessage("onChangedState", (client, message) => {
45 const player = this.state.players.get(client.sessionId);
46 if (player) {
47 player.state = message.state;
48 player.subState = message.subState;
49 }
50 });
51
52 // 指定された userId でボットプレイヤーを作成する "CreateBot" メッセージを処理します。
53 this.onMessage("CreateBot", (client, message) => {
54 this.CreateBot(message);
55 });
56
57 // 指定された位置にボットプレイヤーを移動する "MoveBot" メッセージを処理します。
58 this.onMessage("MoveBot", (client, message) => {
59 this.MoveBot(client, message);
60 });
61 }
62
63 // `CreateBot()` メソッドは、指定された `userId` でボットプレイヤーを作成するために使用されます。
64 CreateBot(userId: string) {
65
66 // 提供された `userId` を使用してボットプレイヤーのセッション ID を生成します。
67 const sessionId = "Bot_" + userId;
68
69 // 同じセッション ID のボットプレイヤーがすでに存在するか確認します。存在する場合は、重複を作成せずに戻ります。
70 if (this.state.players.has(sessionId)) {
71 return;
72 }
73
74 // ボットプレイヤーのための新しい `Player` オブジェクトを作成します。
75 const player: Player = new Player();
76 player.sessionId = sessionId;
77 if (userId) {
78 player.zepetoUserId = userId;
79 }
80 player.isBot = true;
81
82 // セッション ID をキーとして、状態のプレイヤーマップにボットプレイヤーを追加します。
83 this.state.players.set(player.sessionId, player);
84 this._botMap.set(sessionId, player);
85
86 // ボットプレイヤーを追加した後、部屋のプレイヤー数を確認します。
87 this.CheckPlayerNumber();
88 }
89
90 // `CheckPlayerNumber()` メソッドは、部屋のプレイヤー数を確認し、4人以上のプレイヤーがいる場合にワールドを開始します。
91 CheckPlayerNumber() {
92
93 // 現在の部屋のプレイヤー数をコンソールに出力します。
94 console.log(`プレイヤー数, ${this.state.players.size}`);
95
96 // 部屋に4人以上のプレイヤーがいる場合、ワールドを開始します。
97 if (this.state.players.size >= 4) {
98 this.StartWorld();
99 }
100 }
101
102 // `StartWorld()` メソッドは、プレイ時間を増加させ、すべてのクライアントに "StartWorld" メッセージをブロードキャストします。
103 StartWorld() {
104 this.playTime += 1;
105
106 // ワールドの開始と現在のプレイ時間を示すメッセージを出力します。
107 console.log("ワールドを開始！");
108 this.broadcast("StartWorld", this.playTime);
109 }
110
111 // `MoveBot()` メソッドは、受信したメッセージに基づいてボットプレイヤーを指定された位置に移動します。
112 MoveBot(client: SandboxPlayer, message: string) {
113 // クライアントから受信した JSON メッセージを解析して位置情報を抽出します。
114 const position = JSON.parse(message);
115
116 // ユーザーのセッション ID と解析された位置データを持つ新しいメッセージオブジェクトを作成します。
117 const newMessage = {
118 user: client.sessionId,
119 positionX: position.x,
120 positionY: position.y,
121 positionZ: position.z
122 }
123
124 // 新しいメッセージデータを JSON 文字列としてすべてのクライアントに "MoveBotToPosition" メッセージをブロードキャストします。
125 this.broadcast("MoveBotToPosition", JSON.stringify(newMessage));
126 }
127
128 async onJoin(client: SandboxPlayer) {
129
130 // schemas.json で定義されたプレイヤーオブジェクトを作成し、初期値を設定します。
131 console.log(`[OnJoin] sessionId : ${client.sessionId}, HashCode : ${client.hashCode}, userId : ${client.userId}`)
132
133 const player = new Player();
134 player.sessionId = client.sessionId;
135
136 if (client.hashCode) {
137 player.zepetoHash = client.hashCode;
138 }
139 if (client.userId) {
140 player.zepetoUserId = client.userId;
141 }
142
143 // [DataStorage] 入力されたプレイヤーの DataStorage をロードします
144 const storage: DataStorage = client.loadDataStorage();
145
146 this.storageMap.set(client.sessionId, storage);
147
148 let visit_cnt = await storage.get("VisitCount") as number;
149 if (visit_cnt == null) visit_cnt = 0;
150
151 console.log(`[OnJoin] ${client.sessionId} の訪問回数 : ${visit_cnt}`)
152
153 // [DataStorage] プレイヤーの訪問回数を更新し、その後ストレージを保存します
154 await storage.set("VisitCount", ++visit_cnt);
155
156 // セッション ID を使用してプレイヤーオブジェクトを管理します。これはクライアントオブジェクトの一意のキー値です。
157 // クライアントは、プレイヤーオブジェクトに追加された情報を players オブジェクトに add_OnAdd イベントを追加することで確認できます。
158 this.state.players.set(client.sessionId, player);
159
160 // プレイヤーが参加した後、部屋のプレイヤー数を確認します。
161 this.CheckPlayerNumber();
162 }
163
164 onTick(deltaTime: number): void {
165 // サーバーで設定された各時間に繰り返し呼び出され、特定の間隔イベントを deltaTime を使用して管理できます。
166 }
167
168 async onLeave(client: SandboxPlayer, consented?: boolean) {
169
170 // allowReconnection を設定することで、回路の接続を維持できますが、基本的なガイドではすぐにクリーンアップします。
171 // クライアントは、プレイヤーオブジェクトが削除された情報を players オブジェクトに add_OnRemove イベントを追加することで確認できます。
172 this.state.players.delete(client.sessionId);
173 }
174}
