LlWhisper

From Second Life Wiki

Jump to: navigation, search

Contents

Summary

Function: llWhisper( integer channel, string msg );

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

• integer channel – output 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.
PUBLIC_CHANNEL 0x0 Chat channel that broadcasts to all nearby users.

Caveats

  • Messages sent on PUBLIC_CHANNEL 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 PUBLIC_CHANNEL or DEBUG_CHANNEL will be dropped until the send rate is again below 200/2sec for the previous 2 sec. Dropped messages, despite being dropped still count against the limit.
  • Text can be a maximum of 1024 bytes. This can convey 1024 ASCII characters, or 512 UTF-8 characters such as á
  • Whispers can only be heard within 10 meters of the speaking prim (rather than the root). This is contrary to how listens work, where a message can only be heard by any prim in the object if and only if the root prim is capable of hearing it.
  • A prim can not hear itself, this to prevent problems with recursion. It can however hear other prims within the same object.
All Issues ~ Search JIRA for related Bugs

Examples

For better readability of your code, you can make use of certain mnemonic constants such as PUBLIC_CHANNEL instead of channel 0 and DEBUG_CHANNEL instead of channel +2,147,483,647. 

default
{
    state_entry()
    {
        // PUBLIC_CHANNEL has the integer value 0
        llWhisper(PUBLIC_CHANNEL, "This is an incredibly useless program.");
    }
}
For communicating with the user or owner it is preferable to use llOwnerSay or llInstantMessage or llRegionSayTo as they won't spam other users.

See Also

Events

•  listen

Functions

•  llListen
•  llOwnerSay
•  llRegionSay – Sends chat region wide
•  llSay – Sends chat limited to 20 meters
•  llShout – Sends chat limited to 100 meters
•  llInstantMessage

Deep Notes

Search JIRA for related Issues

This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.
Retrieved from "http://wiki.secondlife.com/wiki/LlWhisper"
Personal tools