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 的伺服器。如果使用者已經連線到某個伺服器，會先被中斷連線，因為同一時間只能連線到一個伺服器。
參數
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"，說明請求是否成功，以及欄位 "message"，內含事件訊息字串，例如 "server_created" 事件中的伺服器 id。

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 的串列；沒有時為空串列。

多人連線與伺服器

多人連線專案是可以和其他人一起玩的專案。有時是讓多人共用同一個鍵盤，但也可以透過網際網路進行，讓大家各自用自己的電腦，即使身在不同地方也能一起玩。PixelPAD 讓你透過伺服器來建立這類專案。

伺服器是專門用來處理並回應其他電腦（通常稱為用戶端）請求的電腦。伺服器的用途非常廣泛，包括這個網站，也可以用來製作多人連線專案。PixelPAD 提供的函式可以建立和加入伺服器、查看專案的所有伺服器，以及在伺服器中傳送和接收訊息。