StreamPeerTLS

继承： StreamPeer < RefCounted < Object

处理TLS连接的流对等点。

描述

处理TLS连接的流对等点。此对象可用于连接到TLS服务器或接受单个TLS客户端连接。

注意：导出到Android时，在导出项目或使用一键部署之前，请确保启用Android导出预设中的INTERNET权限。否则，任何形式的网络通信都将被Android阻止。

方法

Error	accept_stream(stream: StreamPeer, server_options: TLSOptions)
Error	connect_to_stream(stream: StreamPeer, common_name: String, client_options: TLSOptions = null)
void	disconnect_from_stream()
Status	get_status() const
StreamPeer	get_stream() const
void	poll()

---

枚举

enum Status: 🔗

Status STATUS_DISCONNECTED = 0

表示已断开连接的StreamPeerTLS的状态。

Status STATUS_HANDSHAKING = 1

握手期间表示StreamPeerTLS的状态。

Status STATUS_CONNECTED = 2

表示连接到主机的StreamPeerTLS的状态。

Status STATUS_ERROR = 3

表示StreamPeerTLS处于错误状态的状态。

Status STATUS_ERROR_HOSTNAME_MISMATCH = 4

显示主机提供的TLS证书域与请求验证的域不匹配的错误状态。

---

方法说明

Error accept_stream(stream: StreamPeer, server_options: TLSOptions) 🔗

使用给定的server_options接受对等连接作为服务器。请参阅TLSOptions.server()。

---

Error connect_to_stream(stream: StreamPeer, common_name: String, client_options: TLSOptions = null) 🔗

使用基础StreamPeerstream连接到对等点，并验证远程证书是否为给定common_name正确签名。您可以传递可选的client_options参数来自定义受信任的证书颁发机构，或禁用通用名称验证。请参阅TLSOptions.client()和TLSOptions.client_unsafe()。

---

void disconnect_from_stream() 🔗

断开与主机的连接。

---

Status get_status() const 🔗

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

---

StreamPeer get_stream() const 🔗

返回accept_stream()或connect_to_stream()中使用的基础StreamPeer连接。

---

void poll() 🔗

轮询连接以检查传入字节。在StreamPeer.get_available_bytes()之前调用它以使其正常工作。