PacketPeerDTLS

Inherits: PacketPeer < Reference < Object

DTLS数据包客户端。

描述

这个类表示DTLS对等连接。它可以用来连接到DTLS服务器，由DTLSServer.take_connection返回。

警告:当前不支持SSL/TLS证书撤销和证书固定。只要撤销的证书在其他情况下是有效的，都将被接受。如果这是一个问题，您可能希望使用具有短有效期的自动管理证书。

方法

枚举

enum Status:

• STATUS_DISCONNECTED = 0 —- 表示已断开连接的PacketPeerDTLS的状态。

• STATUS_HANDSHAKING = 1 —- 表示当前正在与远程对等方进行握手的PacketPeerDTLS的状态。

• STATUS_CONNECTED = 2 —- 表示连接到远程对等方的PacketPeerDTLS的状态。

• STATUS_ERROR = 3 —- 表示处于一般错误状态的PacketPeerDTLS的状态。

• STATUS_ERROR_HOSTNAME_MISMATCH = 4 —- 显示主机提供的DTLS证书域与请求验证的域不匹配的错误状态。

方法说明

• Error connect_to_peer ( PacketPeerUDP packet_peer, bool validate_certs=true, String for_hostname=””, X509Certificate valid_certificate=null )

使用必须连接的底层PacketPeerUDP（见PacketPeerUDP.connect_to_host）连接一个peer，开始DTLS握手过程。如果validate_certs是true，PacketPeerDTLS将验证远程对等体提交的证书并与for_hostname参数匹配。你可以通过valid_certificate参数指定一个自定义的X509Certificate来进行验证。

• void disconnect_from_peer ( )

断开此对等体的连接，终止DTLS会话。

• Status get_status ( ) const

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

• void poll ( )

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