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() 🔗
輪詢連接以檢查傳入的封包。經常呼叫此選項以更新狀態並保持連接正常工作。