network_connect_async

This function sends a request to connect to a server.

The function takes the Network Socket ID to connect through (see network_create_socket) and requires you to give the IP address to connect to (a string, can be IPv4 or IPv6) as well as the port to connect through. If the connection fails a value of less than 0 will be returned.

The connection uses a special protocol that ensures only GameMaker games connect to each other, however if you need to connect to a server that is not a GameMaker game, you can use network_connect_raw_async. Note that this function is asynchronous, generating an Asynchronous Networking event of the type network_type_non_blocking_connect.

NOTE This function uses a TCP-like socket (i.e. network_socket_tcp). It may work with other socket types as well, but this isn't guaranteed.

 

Syntax:

network_connect_async(socket, url, port);

Argument Type Description
socket Network Socket ID The id of the socket to use.
url String The URL or IP to connect to (a string).
port Real The port to connect to.

 

Returns:

Real

 

Example:

client = network_create_socket(network_socket_tcp);
network_connect_async(client, "192.134.0.1", 6510);

The above code will create a new TCP socket then attempt make an asynchronous connection through that to the given IP address on port 6510.