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) 🔗
使用必须连接的基础PacketPeerUDP连接开始DTLS握手的packet_peer(参见PacketPeerUDP.connect_to_host())。您可以选择指定验证TLS连接时要使用的client_options。参见TLSOptions.client()和TLSOptions.client_unsafe()。
void disconnect_from_peer() 🔗
断开此对等点,终止DTLS会话。
返回连接的状态。有关值,请参阅Status。
void poll() 🔗
轮询连接以检查传入的数据包。经常调用它来更新状态并保持连接正常工作。