Difference between revisions of "Email"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
m |
||
| Line 2: | Line 2: | ||
|event_id=21|event_delay | |event_id=21|event_delay | ||
|event=email | |event=email | ||
|p1_type=string|p1_name=time|p1_desc | |p1_type=string|p1_name=time|p1_desc=In the <code>(string)[[llGetUnixTime]]</code> format | ||
|p2_type=string|p2_name=address|p2_desc | |p2_type=string|p2_name=address|p2_desc | ||
|p3_type=string|p3_name= | |p3_type=string|p3_name=subject|p3_desc| | ||
p4_type=string|p4_name=message|p4_desc | p4_type=string|p4_name=message|p4_desc | ||
|p5_type=integer|p5_name=num_left|p5_desc | |p5_type=integer|p5_name=num_left|p5_desc=The number of emails left in the email queue | ||
|event_desc=Triggered when task receives email | |event_desc=Triggered when task receives email | ||
|constants | |constants | ||
|spec | |spec | ||
|caveats= | |caveats= | ||
*The email queue is limited to 100 emails, any email after that is bounced. | *The email queue is limited to 100 emails, any email after that is bounced. | ||
* Due to bug {{Jira|SVC-23}} (present since 2005), objects may stop receiving emails completely until either the region is restarted or the object crosses a region boundary (resetting the script doesn't help). Emails sent may eventually be received after a restart/region-cross. Hence, don't rely on this event for reliable inter-region messaging. | * Due to bug {{Jira|SVC-23}} (present since 2005), objects may stop receiving emails completely until either the region is restarted or the object crosses a region boundary (resetting the script doesn't help). Emails sent may eventually be received after a restart/region-cross. Hence, don't rely on this event for reliable inter-region messaging. | ||
Revision as of 22:35, 24 June 2008
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Description
Event: email( string <span title="In the(string)llGetUnixTime format" style="border-bottom:1px dotted; cursor:help;">time, string address, string subject, string message, integer num_left ){ ; }
| 21 | Event ID |
Triggered when task receives email
| • string | time | – | In the (string)llGetUnixTime format
|
|
| • string | address | |||
| • string | subject | |||
| • string | message | |||
| • integer | num_left | – | The number of emails left in the email queue |
Caveats
- The email queue is limited to 100 emails, any email after that is bounced.
- Due to bug SVC-23 (present since 2005), objects may stop receiving emails completely until either the region is restarted or the object crosses a region boundary (resetting the script doesn't help). Emails sent may eventually be received after a restart/region-cross. Hence, don't rely on this event for reliable inter-region messaging.
Examples
This application uses email to have objects check with a central server to see if the owner has the latest version. In the objects: <lsl> string version = "1"; // string type = "lolcube"; default {
on_rez(integer start_param)
{
llEmail("5a634b27-f032-283f-2df2-55ead7724b23@lsl.secondlife.com",
version,
(string)llGetOwner()+","+type);
}
}</lsl> The server: <lsl> default {
state_entry()
{
llSetTimerEvent(15);
}
timer()
{
llGetNextEmail("","");
}
email( string time, string address, string version, string message, integer num_left )
{
if ((integer)version < 2)
{
list info = llCSV2List(llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1));
llGiveInventory(llList2Key(info,0),llList2String(info,1));
}
integer i;
for (i = 0; i < num_left; i++)
{
llGetNextEmail("","");
}
}
} </lsl>
See Also
Functions
| • | llEmail | |||
| • | llGetNextEmail |
Deep Notes
Signature |
|---|
event void email( string time, string address, string subject, string message, integer num_left ); |