llSay

From Second Life Wiki
Revision as of 12:10, 26 June 2007 by Grandma Bates (talk | contribs)
Jump to navigation Jump to search

Summary

Function: llSay( integer channel, string msg );
0.0 Forced Delay
10.0 Energy

Says the text supplied in string msg on channel supplied in integer channel.

• integer channel
• string msg

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

  • Text can only be a maximum of 1024 bytes.
  • Phrases spoken with llSay can only be heard within 20 meters of the speaking object.
  • A prim can not hear itself, to prevent problems with recursion.
  • Consider using llOwnerSay or channel DEBUG_CHANNEL for debugging purposes.

Examples

default {
    state_entry()
    {
        llSay(0,"This is an incredibly useless program." );
    }
}
To avoid making your object spam its neighborhood, use llOwnerSay or llInstantMessage.

Notes

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.,

    llSay(-5243212,"turn on");

It is impossible for an avatar to chat on a negative channel, and extremely unlikely that some other object would accidently say something on such a channel. (Of course, the intended target of the message must be set to 'listen' on this channel.)

If DEBUG_CHANNEL is used as channel, the script will say msg to the Script Warning/Error window. (DEBUG_CHANNEL = 2147483647)

If 0 is used as channel, the script will say msg so anyone can see it as normal chat. All other integers used are private channels.

See Also

Events

•  listen

Functions

•  llListen
•  llOwnerSay
•  llRegionSay Sends chat region wide
•  llWhisper Sends chat limited to 10 meters
•  llShout Sends chat limited to 100 meters
•  llInstantMessage

Deep Notes

Signature

function void llSay( integer channel, string msg );