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...
StreamPeerTLS
Eredita: StreamPeer < RefCounted < Object
Un peer di flusso che gestisce le connessioni TLS.
Descrizione
Un peer di flusso che gestisce le connessioni TLS. Questo oggetto può essere utilizzato per connettersi a un server TLS o accettare una singola connessione client TLS.
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.
Tutorial
Metodi
accept_stream(stream: StreamPeer, server_options: TLSOptions) |
|
connect_to_stream(stream: StreamPeer, common_name: String, client_options: TLSOptions = null) |
|
void |
|
get_status() const |
|
get_stream() const |
|
void |
poll() |
Enumerazioni
enum Status: 🔗
Status STATUS_DISCONNECTED = 0
Uno stato che rappresenta uno StreamPeerTLS disconnesso.
Status STATUS_HANDSHAKING = 1
Uno stato che rappresenta uno StreamPeerTLS durante l'handshake.
Status STATUS_CONNECTED = 2
Uno stato che rappresenta uno StreamPeerTLS connesso a un host.
Status STATUS_ERROR = 3
Uno stato che rappresenta uno StreamPeerTLS in stato di errore.
Status STATUS_ERROR_HOSTNAME_MISMATCH = 4
Uno stato di errore che indica una mancata corrispondenza tra il dominio del certificato TLS presentato dall'host e il dominio richiesto per la convalida.
Descrizioni dei metodi
Error accept_stream(stream: StreamPeer, server_options: TLSOptions) 🔗
Accetta una connessione peer come server, utilizzando le opzioni server_options. Vedi TLSOptions.server().
Error connect_to_stream(stream: StreamPeer, common_name: String, client_options: TLSOptions = null) 🔗
Si connette a un peer utilizzando il stream StreamPeer sottostante e verificando che il certificato remoto sia firmato correttamente per il nome comune common_name. È possibile passare il parametro facoltativo client_options per personalizzare le autorità di certificazione attendibili o disabilitare la verifica del nome comune. Vedi TLSOptions.client() e TLSOptions.client_unsafe().
void disconnect_from_stream() 🔗
Si disconnette dall'host.
Restituisce lo stato della connessione.
StreamPeer get_stream() const 🔗
Restituisce la connessione StreamPeer sottostante, utilizzata in accept_stream() o nel connect_to_stream().
void poll() 🔗
Interroga la connessione per verificare i byte in arrivo. Chiamalo subito prima di StreamPeer.get_available_bytes() affinché funzioni correttamente.