llListen

From Second Life Wiki
Revision as of 03:56, 29 March 2007 by Ricky Geesink (talk | contribs) (Fix for alphabetical order in Functions list)
Jump to navigation Jump to search

Summary

Function: integer llListen( integer channel, string name, key id, string msg );
0.0 Forced Delay
10.0 Energy

Sets a callback for msg on channel from name and id.
Returns an integer that can be used to deactivate or remove the listen.

• integer channel any valid integer, positive or negative.
• string name
• key id
• string msg

If msg, name or id are blank there are not used to filter incoming messages.
If id is an invalid key or a null key, it is considered blank.

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

  • On state change or script reset all listens are released.
    • A state change can be used as a shortcut to releasing listens.
  • Only 64 listens can simultaneously be open in any single script.
    • If this number is exceeded an error is shouted.

Examples

See Also

Events

•  listen

Functions

•  llListenRemove Removes a listen
•  llListenControl Enables/Disables a listen
•  llWhisper Sends chat limited to 10 meters
•  llSay Sends chat limited to 20 meters
•  llShout Sends chat limited to 100 meters

Deep Notes

Signature

function integer llListen( integer channel, string name, key id, string msg );