Difference between revisions of "LlWhisper"

From Second Life Wiki
Jump to navigation Jump to search
m (<lsl> example)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function/chat|channel|msg}}{{LSL_Function
|func_id=22
|func_id=22
|func_sleep=0.0
|func_sleep=0.0
Line 7: Line 7:
|p1_type=integer|p1_name=channel
|p1_type=integer|p1_name=channel
|p2_type=string|p2_name=msg
|p2_type=string|p2_name=msg
|func_desc=whispers the text supplied in string '''msg''' on channel supplied in integer '''channel'''.
|func_desc=Whispers the text supplied in string '''msg''' on channel supplied in integer '''channel'''.
|return_text
|return_text
|spec
|spec
|constants={{LSL Constants/Chat}}
|constants
|caveats=*Text can only be a maximum of 1024 bytes.
|caveats=*Text can only be a maximum of 1024 bytes.
*Whispers can only be heard within 10 meters of the speaking object.
*Whispers can only be heard within 10 meters of the speaking object.
Line 21: Line 21:
     }
     }
}</lsl>
}</lsl>
To avoid making your object spam its neighborhood, use llOwnerSay or llInstantMessage.
For communicating with the user or owner it is much better to use [[llDialog]], [[llOwnerSay]] or [[llInstantMessage]] as they won't spam other users.
|helpers
|helpers
|also_events={{LSL DefineRow||[[listen]]|}}
|also_events={{LSL DefineRow||[[listen]]|}}

Revision as of 09:10, 24 May 2008

Summary

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

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

• 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 can only be a maximum of 1024 bytes.
  • Whispers can only be heard within 10 meters of the speaking object.
  • A prim can not hear itself, to prevent problems with recursion.

Examples

<lsl>default {

   state_entry()
   {
       llWhisper(0,"This is an incredibly useless program." );
   }

}</lsl>

For communicating with the user or owner it is much better to use llDialog, llOwnerSay or llInstantMessage 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

Footnotes

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

Signature

function void llWhisper( integer channel, string msg );