Difference between revisions of "TotalControl for LSL/Commands/BOT STATUS QUERY"

From SmartBots Developers Docs
Jump to: navigation, search
Line 24: Line 24:
 
* ONLINE - Bot is online
 
* ONLINE - Bot is online
 
* LOGGED OUT - Bot was logged out by gracefully
 
* LOGGED OUT - Bot was logged out by gracefully
* CONNECTING - The bot is logging in.
+
* CONNECTING - The bot is logging in
* OFFLINE - Bot is expired or has an error.
+
* OFFLINE - Bot is expired or has an error
  
 
Example:
 
Example:

Revision as of 08:36, 4 March 2019

Queries the selected bot status (useful to determine the subscription length). Result is being returned using BOT_EVENT_STATUS_REPLY event

llMessageLinked(LINK_SET,BOT_STATUS_QUERY,"","");

Variables

The following table shows input values (you send them with the API call) and returned output values.

Variable Required Description


str yes ---
id yes ---

Return value

The result of this command will be returned to your script using BOT_EVENT_STATUS_REPLY event:

link_message( integer sender, integer num, string str, key id )
sender link number of a sender prim
num BOT_EVENT_STATUS_REPLY
str String representing the bot's status:
  1. first line - bot status code (see all codes here)
  2. second line - bot expiration date
  3. third line - bot online status

Online statuses:

  • ONLINE - Bot is online
  • LOGGED OUT - Bot was logged out by gracefully
  • CONNECTING - The bot is logging in
  • OFFLINE - Bot is expired or has an error

Example:

OK
2019-03-10 00:00
LOGGED OUT
id Bot UUID