Difference between revisions of "LlEmail"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Search JIRA for related Issues
m |
(make the example a little less nonsensical) |
||
| Line 35: | Line 35: | ||
|examples= | |examples= | ||
<lsl> | <lsl> | ||
string | string email_address = "somebody@example.com"; // who will receive the messages | ||
default | default | ||
{ | { | ||
state_entry() | state_entry() { | ||
//Send an email to a normal email account | //Send an email to a normal email account | ||
llEmail( | llEmail( email_address, "Look it's an email subject line!", "Testing 1 2 3" ); | ||
} | } | ||
touch_start( integer num_detected ) | touch_start( integer num_detected ) { | ||
integer i = 0; | integer i = 0; | ||
//Send | // Send another email, telling who touched the prim. | ||
do | do | ||
llEmail( | llEmail( email_address, "No touching!", "I was defiled by: " + llDetectedName(i) + "\nKey: " + (string) llDetectedKey(i) ); | ||
while(++i < num_detected); | while(++i < num_detected); | ||
} | } | ||
Revision as of 09:15, 16 July 2008
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llEmail( string address, string subject, string message );| 119 | Function ID |
| 20.0 | Forced Delay |
| 10.0 | Energy |
Sends an email to address with subject and message.
| • string | address | |||
| • string | subject | |||
| • string | message |
The entire message (including the address, subject and other miscellaneous fields) can't be longer then 4096 bytes combined.
Specification
The message is prefixed with information about the prim sending the email.
| Template | Example |
|---|---|
Object-Name: *prim* Region: *simname* (*simpos.x*, *simpos.y*) Local-Position: (*primpos.x*, *primpos.y*, *primpos.z*) *message* |
Object-Name: Object Region: Gibson (254976, 256000) Local-Position: (117, 129, 50) The real message starts here. |
Caveats
- This function causes the script to sleep for 20.0 seconds.
- There is a limit to the number of email messages an object can send in a given amount of time.
- Due to the 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 function for reliable inter-region messaging.
Examples
<lsl> string email_address = "somebody@example.com"; // who will receive the messages
default {
state_entry() {
//Send an email to a normal email account
llEmail( email_address, "Look it's an email subject line!", "Testing 1 2 3" );
}
touch_start( integer num_detected ) {
integer i = 0;
// Send another email, telling who touched the prim.
do
llEmail( email_address, "No touching!", "I was defiled by: " + llDetectedName(i) + "\nKey: " + (string) llDetectedKey(i) );
while(++i < num_detected);
}
}
</lsl>Useful Snippets
<lsl> email( string time, string address, string subj, string message, integer num_left ) {
if(llGetSubString(address, -19, -1) == "@lsl.secondlife.com")//trim the header
message = llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1);
} </lsl>
Notes
- Because of the long delay on this function, it is often called from a second script triggered by link message.
- If you are sending email within Second Life, remember that the address is [key]@lsl.secondlife.com
- Which means if the key returned by llGetKey is "a2e76fcd-9360-4f6d-a924-000000000003", then its email address is "a2e76fcd-9360-4f6d-a924-000000000003@lsl.secondlife.com".
See Also
Deep Notes
Tests
Signature |
|---|
function void llEmail( string address, string subject, string message ); |
Open Source Portal
Feature Design Document
(none)
Functional Spec
(none)
Test scripts
Discussion for future improvements
(none)
Relationship to other features
List of features that need to be tested when this feature changes, and why.
IM to email - verify IM -> email still works.
Postcards - Postcards use email out?