Status Codes
From SmartBots Developers Docs
Revision as of 05:27, 19 May 2017 by Chevonn Edelmann (Talk | contribs)
"Command status codes" are additional information you receive with the TotalControl event.
How to get the code
Events come to your script using link_message:
link_message( integer sender_num, integer num, string str, key id )
The "Command status code" is located in the str variable (while num holds the TotalControl event ID).
Status Codes
The possible status codes are listed below:
| Possible events | Status code | Description |
|---|---|---|
Success code | ||
| BOT_EVENT_STATUS_REPLY | OK | Command succeed, bot subscription valid. |
Command fails | ||
| BOT_COMMAND_FAILED | UNKNOWN_COMMAND | The command you've sent is unknown. Try upgrading to the most newest version. |
| BOT_COMMAND_FAILED | SERVICE_UNAVAILABLE | This SmartBots service is not available for you. Refer to SmartBots Services page for details. |
| BOT_COMMAND_FAILED BOT_SETUP_FAILED BOT_EVENT_STATUS_REPLY |
BOT_NOTSET | You are trying to issue the command, but TotalControl does not know your Bot yet (use BOT_SETUP_SETBOT command) |
Bot status fails | ||
| BOT_COMMAND_FAILED BOT_SETUP_FAILED BOT_EVENT_STATUS_REPLY |
BOT_NOTEXIST | The bot you are trying to use does not exist. You have to visit http://www.smartbots2life.com and list your personal bot |
| BOT_SETUP_FAILED | BOT_WRONGCODE | You have specified the wrong Access Code while setting the bot using BOT_SETUP_SETBOT. |
| BOT_COMMAND_FAILED BOT_SETUP_FAILED BOT_EVENT_STATUS_REPLY |
BOT_NOTPAID | You've listed your bot with SmartBots, but did not paid your subscription yet. |
| BOT_COMMAND_FAILED BOT_SETUP_FAILED BOT_EVENT_STATUS_REPLY |
BOT_EXPIRED | Your SmartBots subscription has expired. The expiration date attached. |
| BOT_COMMAND_FAILED BOT_SETUP_FAILED BOT_EVENT_STATUS_REPLY |
BOT_NOTSETUP | Editor will process and start your order shortly. Please wait a bit. |
ExampleThe following example shows how to parse bot setup error. In this example we receive the BOT_SETUP_FAILED event: this means that TotalControl can't use the bot you've asked. We should try to understand what's wrong with the bot (usually bot name error, or SmartBots subscription has expired). link_message(integer sender,integer cmd, string data, key id) {
/////////////////// Bot setup failed event
if(cmd==BOT_SETUP_FAILED) {
// We split the string parameter to the lines
list parts=llParseString2List(data,["\n"],[]);
// The first line is a status code, and second line is the bot expiration date
string code=llList2String(parts,0);
string expires=llList2String(parts,1);
// Inform user
llOwnerSay("TotalControl bot setup failed:\n"+
"error code: "+code+"\n"+
"expired: "+expires);
}
}
|
||
