Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
PacketPeerDTLS
Eredita: PacketPeer < RefCounted < Object
Peer di pacchetto DTLS.
Descrizione
Questa classe rappresenta una connessione DTLS a un peer. Può essere utilizzata per connettersi a un server DTLS ed è restituita da DTLSServer.take_connection().
Nota: Quando si esporta su Android, assicurarsi di abilitare l'autorizzazione INTERNET nella preimpostazione d'esportazione Android prima di esportare il progetto o di utilizzare la distribuzione con un clic. Altrimenti, qualsiasi tipo di comunicazione di rete sarà bloccata da Android.
Attenzione: La revoca del certificato TLS e il pinning del certificato non sono attualmente supportati. I certificati revocati sono accettati a patto che siano validi altrimenti. Se questo è un problema, potresti voler utilizzare certificati gestiti automaticamente con un breve periodo di validità.
Metodi
connect_to_peer(packet_peer: PacketPeerUDP, hostname: String, client_options: TLSOptions = null) |
|
void |
|
get_status() const |
|
void |
poll() |
Enumerazioni
enum Status: 🔗
Status STATUS_DISCONNECTED = 0
Uno stato che rappresenta un PacketPeerDTLS che è disconnesso.
Status STATUS_HANDSHAKING = 1
Uno stato che rappresenta un PacketPeerDTLS che sta attualmente effettuando l'handshake con un peer remoto.
Status STATUS_CONNECTED = 2
Uno stato che rappresenta un PacketPeerDTLS che è connesso a un peer remoto.
Status STATUS_ERROR = 3
Uno stato che rappresenta un PacketPeerDTLS in uno stato di errore generico.
Status STATUS_ERROR_HOSTNAME_MISMATCH = 4
Uno stato di errore che indica una mancata corrispondenza tra il dominio del certificato DTLS presentato dall'host e il dominio richiesto per la validazione.
Descrizioni dei metodi
Error connect_to_peer(packet_peer: PacketPeerUDP, hostname: String, client_options: TLSOptions = null) 🔗
Collega un packet_peer che inizia l'handshake DTLS attraverso il PacketPeerUDP sottostante, che deve essere connesso (vede PacketPeerUDP.connect_to_host()). È possibile specificare facoltativamente le opzioni del clienti (client_options) da utilizzare durante la verifica delle connessioni TLS. Vedi TLSOptions.client() e TLSOptions.client_unsafe().
void disconnect_from_peer() 🔗
Disconnette questo peer, terminando la sessione DTLS.
Restituisce lo stato della connessione.
void poll() 🔗
Interroga la connessione per controllare i pacchetti in arrivo. Chiamalo frequentemente per aggiornare lo stato e mantenere la connessione funzionante.