CallRemote: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 45: Line 45:
-- result is called when the function returns
-- result is called when the function returns
function result(sum)
function result(sum)
     outputChatBox(sum)
     if sum != "ERROR" then
        outputChatBox(sum)
    end
end
end
function addNumbers(number1, number2)
function addNumbers(number1, number2)

Revision as of 00:37, 8 December 2007

This function allows you to call functions that have been exported with HTTP access by other MTA servers. The calls are asynchronous so you do not get an immediate result from the call. You can also use this function to access any standard web page by specifying the URL.

Data is passed to the web page via HTTP POST as raw JSON data. The page should return JSON formated data in the page's body.

You can use the PHP SDK to create PHP pages that can be called by this function. See the PHP SDK page for an example.

In the case when the call fails, a string containing "ERROR" followed by an integer containing the error reason will be passed to the callback function. The reason for failure will be similar to errors found with websites - file not found, server not found and timeouts.

Syntax

bool callRemote ( string host, string resourceName, string functionName, callback callbackFunction, [ arguments... ] )

OR

bool callRemote ( string URL, callback callbackFunction, [ arguments... ] )

Required Arguments

  • host: This is a host name (and optionally port) of the server you wish to connect to.
  • resourceName: This is a name of the resource that contains the exported function you want to call.
  • functionName: This is a string with the name of the function which you want to call.
  • URL: A full URL in the format http://hostname/path/file.ext. A port can be specified with a colon followed by a port number appended to the hostname.
  • callbackFunction: This is the function that should receive the data returned from the remote function call. The argument list should match the format of the data returned. The callback function will be passed a string containing "ERROR" followed by an integer indicating the error code when an error occurs calling the function.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • arguments: Any arguments you may want to pass to the function when it is called. Any number of arguments of can be specified, each being passed to the designated function.

Returns

Returns true if the function has been called, false otherwise.

Example

This example just adds two numbers passed to it by a lua script.

PHP: (for the page that LUA expects to be at http://www.example.com/page.php)

[php]
include( "mta_sdk.php" );
$input = mta::getInput();
mta::doReturn($input[0] + $input[1]);

LUA:

-- result is called when the function returns
function result(sum)
    if sum != "ERROR" then
        outputChatBox(sum)
    end
end
function addNumbers(number1, number2)
    callRemote ( "http://www.example.com/page.php", result, number1, number2 )
end 
addNumbers ( 123, 456 ) -- call the function

See Also