llRegionSayTo

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr 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/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

Say

llRegionSayTo

	Pre-release Documentation Warning!
	This function is not available yet. This documentation was written prior to its final release so it may not match the final implementation.

Summary

Function: llRegionSayTo( key target, integer channel, string msg );

364	Function ID
0.0	Forced Delay
10.0	Energy

Says the text supplied in string msg on channel supplied in integer channel to the object or avatar specified by target

• key	target
• integer	channel	–	output chat channel, any integer value
• string	msg	–	message to be transmitted

Channel Constant		Description
DEBUG_CHANNEL	0x7FFFFFFF	Chat channel reserved for script debugging and error messages, broadcasts to all nearby users.
PUBLIC_CHANNEL	0x0	Chat channel that broadcasts to all nearby users. This channel is sometimes referred to as: open chat, local chat and public chat.

Caveats

• Messages sent on channel zero^[1] and DEBUG_CHANNEL are throttled to a rate of <200/10sec, per region, per owner/user.
  • Once the rate is exceeded, all following messages on channel zero or DEBUG_CHANNEL will be dropped until the send rate is again below 200/10sec for the previous 10 sec. Dropped messages, despite being dropped still count against the limit.
• Text is spoken directly to the object or avatar within the same region as the script.
• Scripts on other prims can not listen and receive these text messages, with an exception for attachments described below.
• Text can be a maximum of 1023 bytes.
• A prim cannot hear itself, to prevent problems with recursion.
• Sending text on DEBUG_CHANNEL is not supported
• Text sent to an avatar's ID on channel zero will be sent to the viewer.
• Text sent to an avatar's ID on non-zero channels can be heard by any attachment on the avatar

All Issues ~ Search JIRA for related Bugs

Examples

<lsl>default {

   touch()
   {
       llRegionSayTo(llGetDetectedKey(0), 0, "You touched this!");
   }

}</lsl>

Notes

• Channel 0 is the PUBLIC_CHANNEL. This should only be used for chat intended to be sent to the viewer.
• If one object 'says' something to another object (e.g., a button that, when touched, turns on a lamp), it is a good idea to use a very negative channel, e.g.,

<lsl>

   llRegionSayTo("55499a64-45c3-4b81-8880-8ffb5a7c251b",-5243212,"turn on");

</lsl> Negative channels are popular for script communications because the client is unable to chat directly on those channels ("/-xxxx message" won't chat "message" on channel "-xxxx", it will chat "/-xxxx message" on channel zero). The only way to do so prior to llTextBox was to use llDialog which was limited to 24 bytes.

See Also

Events

•

listen

–

Receives chat

Functions

•	llListen	–	Ask for listen events
•	llInstantMessage	–	Sends chat to the owner only (or to some other user only) to avoid spamming the PUBLIC_CHANNEL
•	llOwnerSay	–	Sends chat to the owner only to avoid spamming the PUBLIC_CHANNEL
•	llRegionSay	–	Sends chat region wide
•	llSay	–	Sends chat limited to 20 meters
•	llShout	–	Sends chat limited to 100 meters
•	llWhisper	–	Sends chat limited to 10 meters

Articles

•

Hello Avatar

Deep Notes

Search JIRA for related Issues

Footnotes

1. ^ Channel zero is also known as: PUBLIC_CHANNEL, open chat, local chat and public chat

Signature
function void llRegionSayTo( key target, integer channel, string msg );