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...

IP

Hérite de : Object

Le protocole internet (IP) supporte des fonctionnalités comme la résolution DNS.

Description

IP contient des fonctions de support pour le Protocole Internet (IP). Le support TCP/IP est dans différentes classes (voir StreamPeerTCP et TCPServer). IP fournit le support de résolution DNS du nom d'hôte, à la fois bloquant et sur un thread.

Méthodes

void	clear_cache(hostname: String = "")
void	erase_resolve_item(id: int)
PackedStringArray	get_local_addresses() const
Array[Dictionary]	get_local_interfaces() const
String	get_resolve_item_address(id: int) const
Array	get_resolve_item_addresses(id: int) const
ResolverStatus	get_resolve_item_status(id: int) const
String	resolve_hostname(host: String, ip_type: Type = 3)
PackedStringArray	resolve_hostname_addresses(host: String, ip_type: Type = 3)
int	resolve_hostname_queue_item(host: String, ip_type: Type = 3)

Énumérations

enum ResolverStatus: 🔗

ResolverStatus RESOLVER_STATUS_NONE = 0

Statut du résolveur de noms d'hôtes DNS : Aucun statut.

ResolverStatus RESOLVER_STATUS_WAITING = 1

Statut du résolveur de noms d'hôtes DNS : En attente.

ResolverStatus RESOLVER_STATUS_DONE = 2

Statut du résolveur de noms d'hôtes DNS : Fait.

ResolverStatus RESOLVER_STATUS_ERROR = 3

Statut du résolveur de noms d'hôtes DNS : Erreur.

enum Type: 🔗

Type TYPE_NONE = 0

Type d’adresse : Aucun.

Type TYPE_IPV4 = 1

Type d'adresse : Protocole internet version 4 (IPv4).

Type TYPE_IPV6 = 2

Type d'adresse : Protocole internet version 6 (IPv6).

Type TYPE_ANY = 3

Type d'adresse : N'importe laquelle.

Constantes

RESOLVER_MAX_QUERIES = 256 🔗

Nombre maximal de requêtes de résolution DNS concurrentes permises, RESOLVER_INVALID_ID est renvoyé si dépassé.

RESOLVER_INVALID_ID = -1 🔗

La constante pour un identifiant invalide. Retourné si RESOLVER_MAX_QUERIES est dépassé.

Descriptions des méthodes

void clear_cache(hostname: String = "") 🔗

Enlève toutes les références en cache d'un hôte hostname. Si aucun hostname n'est donné, toutes les adresses IP mises en cache sont supprimées.

void erase_resolve_item(id: int) 🔗

Retire un élément donné id de la file d'attente. Ceci devrait être utilisé pour libérer une file après qu'elle ait terminé pour permettre à plus de requêtes d'arriver.

PackedStringArray get_local_addresses() const 🔗

Renvoie toutes les actuelles adresses IPv4 et IPv6 de l'utilisateur en un tableau.

Array[Dictionary] get_local_interfaces() const 🔗

Renvoie tous les adaptateurs réseau en tant que tableau.

Chaque adaptateur est un dictionnaire de la forme :

{
    "index": "1", # Index de l'interface
    "name": "eth0", # Nom de l'interface
    "friendly": "Ethernet One", # Un nom lisible (peut être vide).
    "addresses": ["192.168.1.101"], # Un tableau d'adresses IP associées à cette interface.
}

String get_resolve_item_address(id: int) const 🔗

Renvoie l'adresse IP d'un nom d'hôte dans la file, compte tenu de son identifiant de file id. Renvoie une chaîne vide lors d'une erreur ou si la résolution n'est pas encore arrivée (voir get_resolve_item_status()).

Array get_resolve_item_addresses(id: int) const 🔗

Renvoie les adresses résolues, ou un tableau vide si une erreur s'est produite ou si la résolution n'a pas encore eu lieu (voir get_resolve_item_status()).

ResolverStatus get_resolve_item_status(id: int) const 🔗

Renvoie le statut d'un nom d'hôte en file d'attente en tant que constante ResolverStatus, compte tenu de son identifiant de file id.

String resolve_hostname(host: String, ip_type: Type = 3) 🔗

Renvoie l'adresse IPv4 ou IPv6 d'un nom d'hôte lorsqu'elle est résolue (méthode bloquante). Le type d'adresse renvoyé dépend de la constante Type donnée comme ip_type.

PackedStringArray resolve_hostname_addresses(host: String, ip_type: Type = 3) 🔗

Résout un nom d'hôte donné de manière bloquante. Les adresses sont renvoyées en tant que tableau d'adresses IPv4 ou IPv6 selon ip_type.

int resolve_hostname_queue_item(host: String, ip_type: Type = 3) 🔗

Crée un élément de file pour résoudre un nom d'hôte vers une adresse IPv4 ou IPv6 en fonction de la constante Type donnée comme ip_type. Renvoie l'identifiant de la file d'attente si réussi, ou RESOLVER_INVALID_ID en cas d'erreur.