llInstantMessage

   Outdated templated used

Please change the template from 'LSLFunctionAll' to 'LSL_Function' (just replace 'LSLFunctionAll' with 'LSL_Function', do this after fixing any other erorr messages.

Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

InstantMessage

llInstantMessage

  Either 'func_desc' or 'return_type' & 'return_text' must be defined

(Please use 'return_text' & 'return_type' or 'func_desc' to summarize the functions actions.)

Summary

Function: llInstantMessage( key user, string message );

118	Function ID
2.0	Forced Delay
10.0	Energy

• key	user
• string	message

Sends an Instant Message specified in the string message to the user specified by the key key.

Caveats

• This function causes the script to sleep for 2.0 seconds.The calling script is delayed for 2 seconds to prevent Instant Message spamming. For applications where this is problematic, it's possible to place the call to llInstantMessage in a child script and pass the information to that script via other means. The message sent can not be longer than 1024 bytes.

All Issues ~ Search JIRA for related Bugs

Examples

<lsl>

key owner;

default {

   on_rez(integer start_param)
   {
    owner=llGetOwner();  // get the key of the objects owner.
   }
   touch_start(integer total_num)
   {        
   llInstantMessage(owner,llKey2Name(owner)+", " + (string)total_num +" Avatar(s) touched me!");

   }

}

</lsl>

Notes

Instant Messaging has the benefit of allowing communication from an object to an avatar anywhere in the Grid. The downsides are, other objects can not recieve Instant Messages, nor, can an Avatar Instant Message an object. It's a one way communication avenue. Also the 2 second script delay can also be considered a downside in some applications.

Deep Notes

Search JIRA for related Issues

Signature
function void llInstantMessage( key user, string message );