CreateNetClient

Hello World

Content:
- Methods

NetClients can be used to communicate with servers on the web.

net = app.CreateNetClient( type ) → app object: NetClient

You can choose between two different protocols:
The connection based TransmissionControlProtocol which always checks if the data was received correctly and in right order. It is used in most cases because it is very reliable. The downside is that it is relatively slow becaus of the numerous checks.
The connectionless UserDatagramProtocol which sends the data once without any checks so that packages may be corrupt or lost completely during the transmission. Because of that data can be sent as fast as possible and it suits perfectly for games which need a fast update rate between the devices.

Note: A few routers block fast UDP messages by default

Example - TCP Basic click to expand contents

function OnStart()
{
    lay = app.CreateLayout( "linear" );

    web = app.CreateWebView( 1, .5, "ignoreerrors" );
    lay.AddChild( web );

    txt = app.CreateTextEdit( "", 1, .5, "ReadOnly,NoKeyboard" );
    txt.SetTextSize( 12 );
    lay.AddChild( txt );

    app.AddLayout( lay );

    net = app.CreateNetClient( "TCP,Raw" );
    net.SetOnConnect( net_OnConnect );
    net.Connect( "www.randomfunfacts.com", 80 );
}

function net_OnConnect( connected )
{
    if( !connected ) return app.ShowPopup( "Failed to connect!" );

    net.SendText( "GET / HTTP/1.1\r\nHost:www.randomfunfacts.com\r\n\r\n", "UTF-8" );

    var msg = "", s = "";
    do msg += s = net.ReceiveText( "UTF-8" );
    while( s.length > 0 );

    txt.SetText( msg );
    web.LoadHtml( msg );

    net.Disconnect();
}

Copy Copy All Run

Example - TCP AutoReceive click to expand contents

Copy Copy All Run

Example - UDP Messaging click to expand contents

Copy All

Methods

The following methods are available on the NetClient object:

AutoReceive( server, port, mode )

Batch( properties )

Close()

Connect( address, port )

Disconnect()

DownloadFile( file )

GetBroadcastAddress() → String

GetType() → String: “NetClient”

IsConnected()

IsEnabled() → Boolean

ReceiveBytes( mode ) → List: [ bytes ]

ReceiveDatagram( mode, port, timeout, options ) → String

ReceiveDatagrams( port, mode, options )

ReceiveFile( file, wait ) → String

ReceiveText( mode ) → String

ReceiveVideoStream( port, img ) → String

SendBytes( data, mode )

SendDatagram( data, mode, address, port, options )

SendText( text, mode )

SetDataMode( mode )

SetOnConnect( callback )

SetOnDownload( callback )

SetOnReceive( callback )

SetSplitMode( mode, p2, p3 )

SetTimeout( seconds )

WakeOnLan( ip, mac )

net.SetSplitMode
Tells AutoReceive how to split received data. Splitted data will result in multiple OnReceive calls.
p2 and p3 have different purposes for different modes:

mode	p1	p2
Size	Size of one data package	-
End	Byte indicating end of data	-
Start-End	Byte indicating start of data	Byte indicating end of data

Example - TCP Basic click to expand contents

Example - TCP AutoReceive click to expand contents

Example - UDP Messaging click to expand contents

Methods

loading