Difference between revisions of "TotalControl for LSL/Events"

From SmartBots Developers Docs
Jump to: navigation, search
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE: Events}}
+
{{DISPLAYTITLE: TotalControl Events}}
AdminBot raises events to inform your script about errors, chat IMs and other things happened. To catch it, use the LSL ''link_message'' event (see [[AdminBot for Bots/Examples|AdminBot Examples]] for usage patterns).
+
TotalControl library raises events to inform your script about errors, chat IMs and other things happened. To catch them, use the LSL ''link_message'' event (see [[TotalControl for LSL/Examples|TotalControl Examples]] for usage patterns).
  
 
== Parsing Events ==
 
== Parsing Events ==
Line 6: Line 6:
  
 
<syntaxhighlight lang="lsl">
 
<syntaxhighlight lang="lsl">
link_message( integer sender_num, integer num, string str, key id )
+
link_message(integer sender_num, integer num, string str, key id) { ... }
 
</syntaxhighlight>
 
</syntaxhighlight>
  
For AdminBot, '''num''' will contain the event code (see below). '''str''' and '''id''' value depend on the event.
+
For TotalControl, '''num''' will contain the event code (see below). '''str''' and '''id''' values depend on the event.
  
 
== Events List ==
 
== Events List ==
  
The following events can be raised by AdminBot for Bots gateway:
+
The following events can be raised by TotalControl:
  
 
{{API_Table_start|Command|Description}}
 
{{API_Table_start|Command|Description}}
Line 23: Line 23:
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_STATUS_REPLY}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_STATUS_REPLY}}
  
{{API_Group|Group Messaging}}
+
{{API_Group|Listeners}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_SUCCESS}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_SUCCESS}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_LOCAL_CHAT}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_LOCAL_CHAT}}
Line 30: Line 30:
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_MONEY}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_MONEY}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_DIALOG}}
 
{{API_Entry|HTTP Bot Command|BOT_EVENT_LISTEN_DIALOG}}
 +
 +
 +
{{API_Group|Request Responses}}
 +
{{API_Entry|HTTP Bot Command|BOT_LIST_GROUPS_REPLY}}
 +
{{API_Entry|HTTP Bot Command|BOT_LIST_GROUP_ROLES_REPLY}}
 +
{{API_Entry|HTTP Bot Command|BOT_GET_BALANCE_REPLY}}
 +
{{API_Entry|HTTP Bot Command|BOT_ATTACHMENTS_REPLY}}
 +
{{API_Entry|HTTP Bot Command|BOT_LOCATION_REPLY}}
 +
{{API_Entry|HTTP Bot Command|BOT_NOTECARD_CREATE_REPLY}}
 +
{{API_Entry|HTTP Bot Command|BOT_NOTECARD_READ_REPLY}}
  
 
{{API_Table_end}}
 
{{API_Table_end}}

Latest revision as of 16:29, 6 March 2019

TotalControl library raises events to inform your script about errors, chat IMs and other things happened. To catch them, use the LSL link_message event (see TotalControl Examples for usage patterns).

Parsing Events

LSL link_message event has the following syntax:

link_message(integer sender_num, integer num, string str, key id) { ... }

For TotalControl, num will contain the event code (see below). str and id values depend on the event.

Events List

The following events can be raised by TotalControl:

Command Description

Status

BOT_SETUP_SUCCESS Raised when Bot has been set successfully
BOT_SETUP_FAILED Raised when there was an error setting the bot
BOT_COMMAND_FAILED Raised when command error occurs.
BOT_EVENT_STATUS_REPLY Raised when bot status is received.

Listeners

BOT_EVENT_LISTEN_SUCCESS Raised when a listener has successfully been established
BOT_EVENT_LISTEN_LOCAL_CHAT Raised when Bot sees a message in local chat
BOT_EVENT_LISTEN_IM Raised when Bot receives an instant message
BOT_EVENT_LISTEN_INVENTORY Raised when Bot receives an inventory item
BOT_EVENT_LISTEN_MONEY Raised when Bot receives a payment
BOT_EVENT_LISTEN_DIALOG Raised when Bot receives a dialog menu


Request Responses

BOT_LIST_GROUPS_REPLY Raised when Bot receives list of groups
BOT_LIST_GROUP_ROLES_REPLY Raised when Bot receives list of roles for a group
BOT_GET_BALANCE_REPLY Raised when balance is successfully requested
BOT_ATTACHMENTS_REPLY Raised when Bot receives list of attachments
BOT_LOCATION_REPLY Raised when bot returns its location
BOT_NOTECARD_CREATE_REPLY Raised when balance is successfully requested
BOT_NOTECARD_READ_REPLY Raised when when balance is successfully requested