Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
SceneMultiplayer
繼承: MultiplayerAPI < RefCounted < Object
高階多人遊戲 API 實作。
說明
This class is the default implementation of MultiplayerAPI, used to provide multiplayer functionalities in Godot Engine.
This implementation supports RPCs via Node.rpc() and Node.rpc_id() and requires MultiplayerAPI.rpc() to be passed a Node (it will fail for other object types).
This implementation additionally provide SceneTree replication via the MultiplayerSpawner and MultiplayerSynchronizer nodes, and the SceneReplicationConfig resource.
Note: The high-level multiplayer API protocol is an implementation detail and isn't meant to be used by non-Godot servers. It may change without notice.
Note: When exporting to Android, make sure to enable the INTERNET permission in the Android export preset before exporting the project or using remote deploy. Otherwise, network communication of any kind will be blocked by Android.
屬性
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
方法
void |
clear() |
complete_auth(id: int) |
|
void |
disconnect_peer(id: int) |
send_auth(id: int, data: PackedByteArray) |
|
send_bytes(bytes: PackedByteArray, id: int = 0, mode: TransferMode = 2, channel: int = 0) |
訊號
peer_authenticating(id: int) 🔗
當此 MultiplayerAPI 的 MultiplayerAPI.multiplayer_peer 連接到一個新對等體並設定有效的 auth_callback 時,將發出此訊號。在這種情況下,只有在呼叫 complete_auth() 並傳遞給定的對等體 id 時,才會發出 MultiplayerAPI.peer_connected。在此狀態下,該對等體不會包含在 MultiplayerAPI.get_peers() 返回的列表中(但會包含在 get_authenticating_peers() 返回的列表中),且只會發送和接收身份驗證資料。有關發送身份驗證資料的資訊,請參閱 send_auth()。
peer_authentication_failed(id: int) 🔗
當這個 MultiplayerAPI 的 MultiplayerAPI.multiplayer_peer 與另一個尚未完成授權的對等體斷開連接時觸發。見 peer_authenticating。
peer_packet(id: int, packet: PackedByteArray) 🔗
當這個 MultiplayerAPI 的 MultiplayerAPI.multiplayer_peer 收到帶有自訂資料(見 send_bytes())的 packet 時發出。ID 是發送封包的對等體的對等體 ID。
屬性說明
bool allow_object_decoding = false 🔗
如果為 true,則 MultiplayerAPI 將允許在遠端程式呼叫期間對對象進行編碼和解碼。
警告:反序列化的物件可能包含要執行的程式碼。如果序列化的物件來自不受信任的來源,請勿使用此選項,以避免潛在的安全威脅,例如遠端程式碼執行。
Callable auth_callback = Callable() 🔗
當通過 send_auth() 接收身份驗證資料時要執行的回呼函式。如果 Callable 為空(預設),對等方將在連接後立即自動接受。
如果將其設定為大於 0.0 的值,則對等方可以停留在正在驗證狀態的最長時間,單位為秒,之後身份驗證將自動失敗。見 peer_authenticating 和 peer_authentication_failed 訊號。
int max_delta_packet_size = 65535 🔗
差異量封包的最大大小。值越大,單影格能夠收到完整更新的幾率就越大,但造成網路擁堵的幾率也越大(網路延遲、斷線等)。見 MultiplayerSynchronizer。
int max_sync_packet_size = 1350 🔗
同步封包的最大大小。值越大,單影格能夠收到完整更新的幾率就越大,但丟包的幾率也越大。見 MultiplayerSynchronizer。
bool refuse_new_connections = false 🔗
如果為 true,則 MultiplayerAPI 的 MultiplayerAPI.multiplayer_peer 將拒絕新的傳入連接。
NodePath root_path = NodePath("") 🔗
用於 RPC 和複製的根路徑。將使用相對路徑,而不是絕對路徑,來搜尋 RPC 應該在其上被執行的節點。
這有效地允許場景樹的不同分支,由不同的 MultiplayerAPI 管理,例如允許在同一場景中,同時運作使用者端和伺服器。
啟用或停用伺服器功能,該功能通知使用者端其他對等體的連接/斷開,並在它們之間轉發訊息。當此選項為 false 時,使用者端將不會自動收到其他對等體的通知,也無法通過伺服器向它們發送封包。
注意:在其他對等體連接時更改此選項可能會導致意外行為。
注意:對該功能的支援可能取決於目前的 MultiplayerPeer 配置。請參閱 MultiplayerPeer.is_server_relay_supported()。
方法說明
void clear() 🔗
清除目前 SceneMultiplayer 的網路狀態(除非你知道你在做什麼,否則不應該呼叫這個函式)。
Error complete_auth(id: int) 🔗
完成對由 id 標識的遠端對等體的身份驗證步驟。遠端端也完成身份驗證之後,將會為這個對等體發出 MultiplayerAPI.peer_connected 訊號。不會再從此對等體接收到身份驗證訊息。
如果對等體在完成身份驗證之前斷開連接,無論是由於網路問題、auth_timeout 過期還是手動呼叫 disconnect_peer(),都會發出 peer_authentication_failed 訊號,而不是 MultiplayerAPI.peer_disconnected 訊號。
void disconnect_peer(id: int) 🔗
斷開由 id 標識的對等體的連接,將其從連接的對等體列表中移除,並關閉與它的底層連接。
PackedInt32Array get_authenticating_peers() 🔗
返回目前嘗試使用此 MultiplayerAPI 進行身份驗證的對等方的 ID。
Error send_auth(id: int, data: PackedByteArray) 🔗
將指定的 data 作為身份驗證訊息的一部分發送到由 id 標識的遠端對等方。這可用於驗證對等方,並控制何時發出 MultiplayerAPI.peer_connected(並接受遠端對等方作為連接的對等方之一)。
Error send_bytes(bytes: PackedByteArray, id: int = 0, mode: TransferMode = 2, channel: int = 0) 🔗
向由 id 標識的特定對等體發送給定的原始位元組 bytes(見 MultiplayerPeer.set_target_peer())。預設 ID 為 0,即廣播到所有對等體。