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) 🔗

使用必须连接的基础PacketPeerUDP连接开始DTLS握手的packet_peer(参见PacketPeerUDP.connect_to_host())。您可以选择指定验证TLS连接时要使用的client_options。参见TLSOptions.client()TLSOptions.client_unsafe()


void disconnect_from_peer() 🔗

断开此对等点,终止DTLS会话。


Status get_status() const 🔗

返回连接的状态。有关值,请参阅Status


void poll() 🔗

轮询连接以检查传入的数据包。经常调用它来更新状态并保持连接正常工作。