Difference between revisions of "LlListen"

From Second Life Wiki
Jump to navigation Jump to search
Line 18: Line 18:
|also_articles
|also_articles
|notes
|notes
|constants
|constants={{LSL Constants/Chat}}
|caveats=*On [[state]] change, all listens are removed automatically. It is a feature.
|caveats=*On [[state]] change, all listens are removed automatically. It is a feature.
*Only 64 listens can simultaneously be open in any single script.
*Only 64 listens can simultaneously be open in any single script.

Revision as of 04:49, 1 March 2007

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, all listens are removed automatically. It is a feature.
  • 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 );