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.

PacketPeerDTLS

繼承: PacketPeer < RefCounted < Object

DTLS 資料包使用者端。

說明

這個類表示 DTLS 對等體連接。它可以用來連接到 DTLS 伺服器,由 DTLSServer.take_connection() 返回。

注意:匯出到 Android 時,在匯出專案或使用一鍵部署前,請確保在 Android 匯出預設中啟用 INTERNET 許可權。否則,任何型別的網路通信都將被 Android 阻止。

警告:目前不支援 TLS 憑證撤銷和憑證綁定。只要撤銷的憑證在其他方面有效,就會被接受。如果這是一個問題,可以使用有效期較短的自動管理憑證。

方法

Error

connect_to_peer(packet_peer: PacketPeerUDP, hostname: String, client_options: TLSOptions = null)

void

disconnect_from_peer()

Status

get_status() const

void

poll()


列舉

enum Status: 🔗

Status STATUS_DISCONNECTED = 0

表示已斷開連接的 PacketPeerDTLS 的狀態。

Status STATUS_HANDSHAKING = 1

表示目前正在與遠端對等方進行握手的 PacketPeerDTLS 的狀態。

Status STATUS_CONNECTED = 2

表示連接到遠端對等方的 PacketPeerDTLS 的狀態。

Status STATUS_ERROR = 3

表示處於一般錯誤狀態的 PacketPeerDTLS 的狀態。

Status STATUS_ERROR_HOSTNAME_MISMATCH = 4

顯示主機提供的 DTLS 憑證域與請求驗證的域不配對的錯誤狀態。


方法說明

Error connect_to_peer(packet_peer: PacketPeerUDP, hostname: String, client_options: TLSOptions = null) 🔗

連接 packet_peer 並開始使用底層的 PacketPeerUDP 進行 DTLS 握手,進行握手時 PacketPeerUDP 必須已連接(見 PacketPeerUDP.connect_to_host())。你還可以指定驗證 TLS 連接時使用的 client_options。見 TLSOptions.client()TLSOptions.client_unsafe()


void disconnect_from_peer() 🔗

斷開此對等體的連接,終止 DTLS 會話。


Status get_status() const 🔗

Returns the status of the connection.


void poll() 🔗

輪詢連接以檢查傳入的封包。經常呼叫此選項以更新狀態並保持連接正常工作。