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);

ArgumentTypeDescription
socketNetwork Socket IDThe id of the socket to use.
urlStringThe URL or IP to connect to (a string).
portRealThe 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.