View source for Listen/ja

{{LSL_Event/ja|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=channel|p1_desc
|p2_type=string|p2_name=name|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=チャットによって発生します。 {{LSLG/ja|llListen}} を使って開始と検索条件の設定を行います。
|constants={{LSL Constants/Chat/ja}}
|spec
|caveats=*{{LSLG/ja|state}} の変更または {{LSLG/ja|llResetScript|スクリプトがリセット}} されたときに、全てのリスナーは自動的に {{LSLG/ja|llListenRemove|終了}} します。 
*オブジェクトのオーナーが変更されても、 {{LSLG/ja|llGetOwner}} を使って登録したリスナーはスクリプトがリセットされるまで自動的に更新されません。スクリプターは下の例のような感じでこのようなケースを検出して対処するとよいでしょう。
*メッセージがスクリプトで登録された複数の {{LSLG/ja|llListen}} の条件を満たしていても、 1 つのイベントだけが発生します。
*プリムは自分自身が生成したチャットを拾うことはできません。
*リスナーの位置はリスナーのあるプリムの位置と同じでなく、ルートプリムの位置になります。これは子プリムを使用して区画の境界線を越えて盗聴することを防ぐ目的でそうなっています。 {{LSLGC/ja|Chat|チャット生成系関数}} はこれとは逆に、 (ルートプリムの位置ではなく) 関数を呼び出したプリムの位置となります。
|examples=
オブジェクトのオーナーのチャットを拾って 1 回返答するという、平凡な例です。ラグを減らし、周囲のユーザにスパムとならないよう、 0 以外のチャネルで Listen して、 listen イベントを他のチャネルでチャットされたときに、例えば '/5 hello' などで発生させるようにするともっと良いです。
<source lang="lsl2">// オーナーがメインチャットで何か発言したら、オーナーに beep と発言します。
integer listen_handle;

default
{
    state_entry()
    {   // 呼び出した時点でのオブジェクトのオーナーをリスナーに登録します。
        // オーナーが変更されても自動的に更新されません。
        // 0 を他の正の数字に変えて '/5 hello' のような形式のチャットを拾えるようにしましょう。
        listen_handle = llListen(0, "", llGetOwner(), "");
    }
    listen( integer channel, string name, key id, string message )
    {
        llOwnerSay("beep");
        // スクリプトがリセットされるまでリスナーを停止します。
        llListenRemove(listen_handle);
    }
    on_rez(integer param)
    {   // オブジェクトが rez されたときに発生します。オブジェクトがベンダーで売れた後などです。
        llResetScript();//rez でスクリプトをリセットして、リスナーを再登録させます。
    }
    changed(integer mask)
    {   // スクリプトの入っているオブジェクトのオーナーが変更されたときに発生します。
        if(mask & CHANGED_OWNER)
        {
            llResetScript();
        }
    }
}</source>
|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||{{LSLG/ja|llListen}}|}}
{{LSL DefineRow||{{LSLG/ja|llListenControl}}|}}
{{LSL DefineRow||{{LSLG/ja|llListenRemove}}|}}
{{LSL DefineRow||{{LSLG/ja|llDialog}}|}}
{{LSL DefineRow||{{LSLG/ja|llOwnerSay}}|{{LSLG/ja|PUBLIC_CHANNEL}} でスパムとならないように、オーナーにだけチャットを送ります}}
{{LSL DefineRow||{{LSLG/ja|llWhisper}}|10 メートルに限定したチャットを送ります}}
{{LSL DefineRow||{{LSLG/ja|llSay}}|20 メートルに限定したチャットを送ります}}
{{LSL DefineRow||{{LSLG/ja|llShout}}|100 メートルに限定したチャットを送ります}}
{{LSL DefineRow||{{LSLG/ja|llRegionSay}}|地域全体にチャットを送ります}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications
|cat2=Chat
|cat3
|cat4
}}