DTLSServer

DTLSServer

实现 DTLS 服务器的辅助类。

描述

该类用于存储 DTLS 服务器的状态。在 setup 之后，它将连接的 PacketPeerUDP 转换为 PacketPeerDTLS，通过 take_connection 接受它们作为 DTLS 客户端。在底层，这个类用于存储服务器的 DTLS 状态和 cookie。为什么需要状态和 cookie 的原因不在本文档的范围内。

下面是一个如何使用它的小例子：

GDScriptC#

# server_node.gd
extends Node
var dtls := DTLSServer.new()
var server := UDPServer.new()
var peers = []
func _ready():
    server.listen(4242)
    var key = load("key.key") # 你的私钥。
    var cert = load("cert.crt") # 你的 X509 证书。
    dtls.setup(key, cert)
func _process(delta):
    while server.is_connection_available():
        var peer: PacketPeerUDP = server.take_connection()
        var dtls_peer: PacketPeerDTLS = dtls.take_connection(peer)
        if dtls_peer.get_status() != PacketPeerDTLS.STATUS_HANDSHAKING:
            continue # 由于 cookie 交换，50% 的连接会失败，这是正常现象。
        print("对等体已连接！")
        peers.append(dtls_peer)
    for p in peers:
        p.poll() # 必须轮询以更新状态。
        if p.get_status() == PacketPeerDTLS.STATUS_CONNECTED:
            while p.get_available_packet_count() > 0:
                print("从客户端收到消息：%s" % p.get_packet().get_string_from_utf8())
                p.put_packet("你好 DTLS 客户端".to_utf8_buffer())

// ServerNode.cs
using Godot;
public partial class ServerNode : Node
{
    private DtlsServer _dtls = new DtlsServer();
    private UdpServer _server = new UdpServer();
    private Godot.Collections.Array<PacketPeerDTLS> _peers = new Godot.Collections.Array<PacketPeerDTLS>();
    public override void _Ready()
    {
        _server.Listen(4242);
        var key = GD.Load<CryptoKey>("key.key"); // 你的私钥。
        var cert = GD.Load<X509Certificate>("cert.crt"); // 你的 X509 证书。
        _dtls.Setup(key, cert);
    }
    public override void _Process(double delta)
    {
        while (Server.IsConnectionAvailable())
        {
            PacketPeerUDP peer = _server.TakeConnection();
            PacketPeerDTLS dtlsPeer = _dtls.TakeConnection(peer);
            if (dtlsPeer.GetStatus() != PacketPeerDtls.Status.Handshaking)
            {
                continue; // 由于 cookie 交换，50% 的连接会失败，这是正常现象。
            }
            GD.Print("对等体已连接！");
            _peers.Add(dtlsPeer);
        }
        foreach (var p in _peers)
        {
            p.Poll(); // 必须轮询以更新状态。
            if (p.GetStatus() == PacketPeerDtls.Status.Connected)
            {
                while (p.GetAvailablePacketCount() > 0)
                {
                    GD.Print($"从客户端收到消息：{p.GetPacket().GetStringFromUtf8()}");
                    p.PutPacket("你好 DTLS 客户端".ToUtf8Buffer());
                }
            }
        }
    }
}

GDScriptC#

# client_node.gd
extends Node
var dtls := PacketPeerDTLS.new()
var udp := PacketPeerUDP.new()
var connected = false
func _ready():
    udp.connect_to_host("127.0.0.1", 4242)
    dtls.connect_to_peer(udp, false) # 生产环境中请使用 true 进行证书校验！
func _process(delta):
    dtls.poll()
    if dtls.get_status() == PacketPeerDTLS.STATUS_CONNECTED:
        if !connected:
            # 尝试联系服务器
            dtls.put_packet("回应是… 42！".to_utf8_buffer())
        while dtls.get_available_packet_count() > 0:
            print("已连接：%s" % dtls.get_packet().get_string_from_utf8())
            connected = true

// ClientNode.cs
using Godot;
using System.Text;
public partial class ClientNode : Node
{
    private PacketPeerDtls _dtls = new PacketPeerDtls();
    private PacketPeerUdp _udp = new PacketPeerUdp();
    private bool _connected = false;
    public override void _Ready()
    {
        _udp.ConnectToHost("127.0.0.1", 4242);
        _dtls.ConnectToPeer(_udp, validateCerts: false); // 生产环境中请使用 true 进行证书校验！
    }
    public override void _Process(double delta)
    {
        _dtls.Poll();
        if (_dtls.GetStatus() == PacketPeerDtls.Status.Connected)
        {
            if (!_connected)
            {
                // 尝试联系服务器
                _dtls.PutPacket("回应是… 42！".ToUtf8Buffer());
            }
            while (_dtls.GetAvailablePacketCount() > 0)
            {
                GD.Print($"已连接：{_dtls.GetPacket().GetStringFromUtf8()}");
                _connected = true;
            }
        }
    }
}

方法

Error	setup ( TLSOptions server_options )
PacketPeerDTLS	take_connection ( PacketPeerUDP udp_peer )

方法说明

Error setup ( TLSOptions server_options )

设置 DTLS 服务器以使用给定的 server_options。请参阅 TLSOptions.server。

PacketPeerDTLS take_connection ( PacketPeerUDP udp_peer )

尝试与给定 udp_peer 启动 DTLS 握手，必须已连接到该 udp_peer（请参阅 PacketPeerUDP.connect_to_host）。

注意：必须检查返回的 PacketPeerUDP 的状态是否为 PacketPeerDTLS.STATUS_HANDSHAKING，因为正常情况下，50% 的新连接会因为 cookie 交换而无效。

Previous Next

Built with Sphinx using a theme provided by Read the Docs.