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

From SmartBots Developers Docs
Jump to: navigation, search
Line 15: Line 15:
  
 
{{AdminBot Event after Bot Command|BOT_EVENT_STATUS_REPLY|BOT_EVENT_STATUS_REPLY}}
 
{{AdminBot Event after Bot Command|BOT_EVENT_STATUS_REPLY|BOT_EVENT_STATUS_REPLY}}
{{AdminBot Event after Command Entry|str}} first line - bot status code (see all codes [[Usage/Status_Codes|here]])
+
{{AdminBot Event after Command Entry|str}}String representing the bot's status:
{{AdminBot Event after Command Entry|}} second line - bot expiration date
+
 
{{AdminBot Event after Command Entry|}} third line - bot online status<br />-> ONLINE : Bot is online<br />-> LOGGED OUT : Bot was logged out by gracefully<br />-> CONNECTING : The bot is logging in<br />-> OFFLINE : Bot is expired or has an error
+
# first line - bot status code (see all codes [[Usage/Status_Codes|here]])<br>
 +
# second line - bot expiration date<br>
 +
# 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
 +
 
 
{{AdminBot Event after Command Entry|id}} Bot UUID
 
{{AdminBot Event after Command Entry|id}} Bot UUID
 
{{AdminBot Event after Command End}}
 
{{AdminBot Event after Command End}}

Revision as of 08:26, 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