Difference between revisions of "LlEmail"

From Second Life Wiki
Jump to navigation Jump to search
m (formatted helper)
m (No detection script should assume there's only one detected agent at a time)
Line 49: Line 49:
     touch_start( integer num_detected )
     touch_start( integer num_detected )
     {
     {
        integer i;
         //Send an email to the person who touched the prim
         //Send an email to the person who touched the prim
         llEmail( email, "No touching!", "I was defiled by: " + llDetectedName(0)+"\nKey: "+(string)llDetectedKey(0) );
         for (i = 0; i < num_detected; i++)
          llEmail( email, "No touching!", "I was defiled by: " + llDetectedName(i) + "\nKey: " + (string) llDetectedKey(i) );
     }
     }
}
}

Revision as of 08:02, 3 May 2008

Summary

Function: llEmail( string address, string subject, string message );

Sends an email to address with subject and message.

• string address
• string subject
• string message

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.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> string email = "";

default {

   state_entry() 
   {
       if(email == "")
           email = (string)llGetKey()+"@lsl.secondlife.com";
       //Send an email to a normal email account
       llEmail( email, "Look it's an email subject line!", "Testing 1 2 3" );
   }
   touch_start( integer num_detected )
   {
       integer i;
       //Send an email to the person who touched the prim
       for (i = 0; i < num_detected; i++)
         llEmail( email, "No touching!", "I was defiled by: " + llDetectedName(i) + "\nKey: " + (string) llDetectedKey(i) );
   }

}

</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

Search JIRA for related Issues

Tests

Signature

function void llEmail( string address, string subject, string message );

Feature Design Document

(none)

Functional Spec

(none)

Test scripts

internal test

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?


User Guides

llEmail on LSLwiki.net