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...
PacketPeerDTLS
繼承: PacketPeer < RefCounted < Object
DTLS 資料包使用者端。
說明
這個類表示 DTLS 對等體連接。它可以用來連接到 DTLS 伺服器,由 DTLSServer.take_connection() 返回。
注意:匯出到 Android 時,在匯出專案或使用一鍵部署前,請確保在 Android 匯出預設中啟用 INTERNET 許可權。否則,任何型別的網路通信都將被 Android 阻止。
警告:目前不支援 TLS 憑證撤銷和憑證綁定。只要撤銷的憑證在其他方面有效,就會被接受。如果這是一個問題,可以使用有效期較短的自動管理憑證。
方法
connect_to_peer(packet_peer: PacketPeerUDP, hostname: String, client_options: TLSOptions = null) |
|
void |
|
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 會話。
Returns the status of the connection.
void poll() 🔗
輪詢連接以檢查傳入的封包。經常呼叫此選項以更新狀態並保持連接正常工作。