PixelPAD 2D - マルチプレイヤー

init_multiplayer() -> None

例
説明
マルチプレイヤープロジェクトにするには、必ず呼び出す必要があります。これはサーバーに接続するものではなく、他のマルチプレイヤー機能を初期化するだけです。
パラメータ
None
パラメータはありません。

戻り値
戻り値はありません。

create_server(size: int) -> None

例
説明
マルチプレイヤーサーバーを作成します。5秒以内に誰もサーバーに参加しなかった場合、サーバーは削除されます。
パラメータ
size
同時にサーバーに接続できるプレイヤーの最大数。2以上20以下である必要があります。

戻り値
戻り値はありません。遅延があるため、関数の結果はget_server_event()で確認できます。イベントの種類は"type": "server_created"になります。

join_server(server_id: str) -> None

例
説明
指定したサーバーIDのサーバーへの接続を試みます。ユーザーがすでにサーバーに接続している場合、一度に接続できるサーバーは1つだけなので、切断されます。
パラメータ
server_id
ユーザーが参加を試みるサーバーのID。

戻り値
戻り値はありません。遅延があるため、関数の結果はget_server_event()で確認できます。イベントの種類は"type": "self_joined"になります。

inspect_server(server_id: str) -> None

例
説明
参加せずに特定のサーバーの情報を取得します
パラメータ
server_id
情報を取得するサーバーのID。

戻り値
戻り値はありません。遅延があるため、関数の結果はget_server_event()で確認できます。イベントの種類は"type": "server_info"になります。

get_server_event() -> dict

例
説明
現在のフレームで、create_server()、join_server()、inspect_server()からの非同期（遅延）応答をチェックします。
パラメータ
None
パラメータはありません。

戻り値
そのフレームで受信したイベントの種類を含む辞書。イベントがない場合はNone。イベントの種類がNoneでない場合、辞書にはリクエストが成功したかどうかを示すブール値のフィールド"status"と、イベントメッセージの文字列（たとえば"server_created"イベントのサーバーID）を含むフィールド"message"も含まれます。

send_message(data: str) -> None

例
説明
同じサーバーに接続している他のすべてのユーザーにデータを送信します。
パラメータ
data
送信する文字列。長さは256文字以下である必要があります。

戻り値
戻り値はありません。

get_messages() -> list

例
説明
get_messages()を最後に呼び出してから、現在のサーバーから受信したすべてのメッセージを取得します。
パラメータ
None
パラメータはありません。

戻り値
受信した文字列メッセージのリスト。古いものから新しいものの順に並びます。メッセージを受信していない場合は空のリストを返します。

get_player_count() -> int

例
説明
現在接続しているサーバーに何人いるかをチェックします。
パラメータ
None
パラメータはありません。

戻り値
現在のサーバーに接続している人数。接続していない場合は0。

leave_server() -> None

例
説明
現在のユーザーを参加中のサーバーから切断します。
パラメータ
None
パラメータはありません。

戻り値
戻り値はありません。

get_servers() -> list

例
説明
現在のプロジェクトに存在するサーバーのリストを取得します
パラメータ
None
パラメータはありません。

戻り値
同じプロジェクトのアクティブなサーバーIDすべてのリスト。1つもない場合は空のリスト。

マルチプレイヤーとサーバー

マルチプレイヤープロジェクトは、他の人と一緒に遊べるプロジェクトです。複数の人が同じキーボードを使う方法もありますが、インターネット経由でも実現でき、離れた場所にいても、それぞれ自分のコンピューターを使って一緒にプロジェクトを遊べます。Pixelpadでは、サーバーを使ってそのようなプロジェクトを作成できます。

サーバーとは、他のコンピューター（クライアントと呼ばれます）からのリクエストを処理して応答するために設計されたコンピューターです。サーバーはこのウェブサイトを含め、非常にさまざまな用途に使われますが、マルチプレイヤープロジェクトを作るためにも使われます。Pixelpadには、サーバーの作成と参加、プロジェクトのすべてのサーバーの確認と一覧表示、サーバー内でのメッセージの送受信を行う関数があります。