Difference between revisions of "LlListen"

From Second Life Wiki
Jump to navigation Jump to search
m (Fix for alphabetical order in Functions list)
Line 1: Line 1:
{{LSL_Function|func_id=25|func_sleep=0.0|func_energy=10.0|func=llListen|sort=Listen
{{LSL_Function
|func=llListen
|sort=Listen
|func_id=25|func_sleep=0.0|func_energy=10.0
|return_type=integer
|return_type=integer
|return_text=that can be used to deactivate or remove the listen.
|return_text=that can be used to deactivate or remove the listen.

Revision as of 03:56, 29 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 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 );