Legacy Documentation: Version 5.1
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

NetworkTransport.Connect

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual
public static function Connect(hostId: int, address: string, port: int, exeptionConnectionId: int, out error: byte): int;
public static int Connect(int hostId, string address, int port, int exeptionConnectionId, out byte error);

Parameters

hostId Host (actually socket) id for this connection.
address Ip4 address.
port Port.
exeptionConnectionId 0 in the case of a default connection.
error Possible error, kOK if it is good.

Returns

int ConnectionId on success (otherwise zero).

Description

Try to establish connection to other peer.

Receive() with event type kConnectEvent(kDisconnectEvent) will be signal that this connection established(cannot be established). Error parameter will return possible error. Function itself will return unique identifier (for the host) of connection.

var connectionId = NetworkTransport.Connect(hostId, "10.10.01.17", 2355, 0, error );
if( error != kOk )
{ 
//cannot allocate resources for connection
}

//... var event = NetworkTransport.Receive(recHostId, recConnectionId, cannelId, buffer, bufferSize, receivedSize, error ); if( event == kConnectEvent ) { if( recHostId == hostId && recConnectionId == connectionId && error == kOK ) ///connection can be used } if( event == kDisconnectEvent ) { if( recHostId == hostId && recConnectionId == connectionId ) { //connection which identified by connectionId cannot be established if( error == kVersionMismatch ) //treansport protocol is different else if( error == kCRCMismatch ) //peer has different network configuration else if( error == kTimeout ) //cannot connect to other peer in period of time, possible peer has not running } }