View source for LlListen/ja

{{LSL_Function/ja
|func=llListen
|sort=Listen
|func_id=25|func_sleep=0.0|func_energy=10.0
|return_type=integer
|return_text=listenを無効か除去可能
|p1_type=integer|p1_name=channel|p1_desc=any valid integer, positive or negative.
|p2_type=string|p2_name=name
|p3_type=key|p3_name=id
|p4_type=string|p4_name=msg
|func_desc='''name'''と'''id'''から'''channel'''上に'''msg'''のコールバックが設定されます。
|func_footnote='''msg'''、'''name'''か'''id'''が空の場合は、入ってくるメッセージはフィルタにかかりません。
'''id'''が無効か、[[NULL_KEY/ja|null key]]の場合、空とみなされます。<br/>
|spec=[[listen/ja|listen]][[event/ja|イベント]]が作動されるため、主要に判定する基準をフィルタで強く設定すべきです。すべての基準はlistenイベントが生成したものを一致させつづけるだけです。最初に、メッセージはチャンネル'''channel'''上で伝送されつづけます。'''name'''が設定されている場合、話し手の名前を'''name'''と正確に一致すべきです。'''id'''が有効な場合、[[NULL_KEY|null]]ではないkeyは話し手のkeyと同等にすべきです。'''msg'''が設定されている場合、話し手のメッセージと'''msg'''を正確に一致すべきです。
|also_functions={{LSL DefineRow||[[llListenRemove/ja|llListenRemove]]|listenを解除します}}
{{LSL DefineRow||[[llListenControl/ja|llListenControl]]|listenを有効（無効）にします}}
{{LSL DefineRow||[[llWhisper/ja|llWhisper]]|10メートルを限度としてチャットを送信します}}
{{LSL DefineRow||[[llSay/ja|llSay]]|20メートルを限度としてチャットを送信します}}
{{LSL DefineRow||[[llShout/ja|llShout]]|100メートルを限度としてチャットを送信します}}
{{LSL DefineRow||[[llRegionSay/ja|llRegionSay]]|現在のSimを限度としてチャットを送信します}}
|also_events={{LSL DefineRow||[[listen/ja|listen]]|}}
|also_tests
|also_articles
|notes=チャンネル0は避けて、避ける可能性のあるnameやidを設定します([http://rpgstats.com/wiki/index.php?title=Lag Lag])。llListen(0,"","","")はチャット範囲の皆からのチャットを聞くため確実にラグとなりやすく、それらのコストは回避すべきです。
|constants={{LSL Constants/Chat/ja}}
|caveats=*[[state/ja|ステート]]変更あるいは[[llResetScript/ja|スクリプトリセット]]で、すべてのlistenは自動で除去されます。
**ステート変更はlistenの開放のショートカットのように使えます。
*65listenまでが何らかの単独スクリプトで同時に開くことができます。
**この数を超えた場合、''Script run-time error''と''Too Many Listens''エラーを引き起こします。
*マイナス域のチャットナンバーでチャットは、クライアントのダイアログボックスを除いて出力することはできません。
**これはオブジェクト同士のコミュニケーションの典型的なつくりです。
**これはクライアント上に置かれた人為的な限度かもしれず、プロトコルによるものではありません。
|examples=
オブジェクトオーナからの何らかのチャットを聞き、一度だけ返答する、些細な例です。ラグの削減と周囲のユーザのスパムを回避するため、0以外の広範囲チャンネルから選んでlistenすることと、'/5 hello'のような、選択チャンネル上でのチャットによるlistenイベントで作動することです。
<lsl>// says beep to owner the first time owner says something in main chat;
integer listen_handle;

default
{
    state_entry()
    {   //Registers the listen to the owner of the object at the moment of the call.
        // This does not automatically update when the owner changes.
        // Change 0 to another positive number to listen for '/5 hello' style of chat.
        listen_handle = llListen(0, "", llGetOwner(), "");
    }
    listen( integer channel, string name, key id, string message )
    {
        llOwnerSay("beep");
        // Stop listening until script is reset
        llListenRemove(listen_handle);
    }
    on_rez(integer param)
    {   //Triggered when the object is rezed, like after the object had been sold from a vendor
        llResetScript();//By resetting the script on rez it forces the listen to re-register.
    }
    changed(integer mask)
    {   //Triggered when the object containing this script changes owner.
        if(mask & CHANGED_OWNER)
        {
            llResetScript();
        }
    }
}</lsl>
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}