DTLS packet peer.
This class represents a DTLS peer connection. It can be used to connect to a DTLS server, and is returned by DTLSServer.take_connection.
Note: When exporting to Android, make sure to enable the
INTERNET permission in the Android export preset before exporting the project or using one-click deploy. Otherwise, network communication of any kind will be blocked by Android.
Warning: SSL/TLS certificate revocation and certificate pinning are currently not supported. Revoked certificates are accepted as long as they are otherwise valid. If this is a concern, you may want to use automatically managed certificates with a short validity period.
get_status ( ) const
poll ( )
STATUS_DISCONNECTED = 0 --- A status representing a
PacketPeerDTLSthat is disconnected.
STATUS_HANDSHAKING = 1 --- A status representing a
PacketPeerDTLSthat is currently performing the handshake with a remote peer.
STATUS_CONNECTED = 2 --- A status representing a
PacketPeerDTLSthat is connected to a remote peer.
STATUS_ERROR = 3 --- A status representing a
PacketPeerDTLSin a generic error state.
STATUS_ERROR_HOSTNAME_MISMATCH = 4 --- An error status that shows a mismatch in the DTLS certificate domain presented by the host and the domain requested for validation.
peer beginning the DTLS handshake using the underlying PacketPeerUDP which must be connected (see PacketPeerUDP.connect_to_host). If
PacketPeerDTLS will validate that the certificate presented by the remote peer and match it with the
for_hostname argument. You can specify a custom X509Certificate to use for validation via the
void disconnect_from_peer ( )
Disconnects this peer, terminating the DTLS session.
Status get_status ( ) const
Returns the status of the connection. See Status for values.
void poll ( )
Poll the connection to check for incoming packets. Call this frequently to update the status and keep the connection working.