Difference between revisions of "LlEmail"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 81: Line 81:
|cat3
|cat3
|cat4
|cat4
}}{{OSWikiFeatureNav}}
}}
=== Feature Design Document ===
<div id="box">
(none)
== Open Source Portal ==
 
<div style="padding: 0.5em;">
=== Functional Spec ===
{{{2|}}}
(none)
</div></div>
 
=== Test scripts ===
[https://osiris.lindenlab.com/mediawiki/index.php/Email_Test internal test]
 
=== Discussion for future improvements ===
(none)
 
=== Relationship to other features ===
<b> List of features that need to be tested when this feature changes, and why. </b>
 
[[IM to email]] - verify IM -> email still works.
 
[[Postcards]] - Postcards use email out?
 
 
=== User Guides ===
[http://lslwiki.net/lslwiki/wakka.php?wakka=llemail llEmail on LSLwiki.net]

Revision as of 08:32, 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 = 0;

       //Send an email to the person who touched the prim
       do
           llEmail( email, "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

Search JIRA for related Issues

Tests

Signature

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

Open Source Portal

Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlEmail&oldid=65915"