View source

{{LSL_Event/fr|event_id=12|event_delay
|event=listen
|p1_type=integer|p1_name=canal|p1_desc
|p2_type=string|p2_name=nom|p2_desc
|p3_type=key|p3_name=id|p3_desc
|p4_type=string|p4_name=message|p4_desc
|event_desc=Déclenché lorsque l'on parle sur un canal, utilisez  [[llListen/fr|llListen]] pour activer et filtrer la lecture.
|constants={{LSL Constants/Chat/fr}}
|spec
|caveats=
*Sur un changement d'[[state/fr|état]] ou une [[llResetScript/fr|réinitialisation du script]], toutes les écoutes sont [[llListenRemove/fr|fermées]] automatiquement.
*Lorsqu'un objet change de propriétaire, toutes les écoutes enregistrées à l'aide de [[llGetOwner§fr|llGetOwner]] ne seront pas automatiquement mises à jour tant que le script n'aura pas été réinitialisé. L'exemple ci-dessous illustre cette particularité.

*Si le message correspond à plusieurs filtres de [[llListen/fr|llListen]] (dans un même script), un seul évènement sera malgré tout généré. 
*Une prim "n'entend" pas ses propres messages dans le chat.
*L'écoute d'une prim se fait un niveau de la prim racine. Cette restriction permet de limiter les risques d'écoute depuis les bords d'une parcelle. Cependant les {{LSLGC/fr|Chat|fonctions de chat}} génèrent bien leur message au niveau de la prim fille (et non au niveau de la prim racine). 
|examples=
Voici un exemple d'utilisation du listen à partir d'un objet qui répondra (une fois) à chaque fois que le propriétaire parlera sur le chat (en "say"). Pour réduire le lag et éviter le spam pour les personnes alentours, il est préférable d'écouter sur un canal autre que le 0 (say) et d'utiliser plutôt un canal altenatif tel que le 5 : '/5 hello'
.
<lsl>// dit 'bip' au propriétaire la première fois que qu'il parle dans le canal principal (say);
integer listen_handle;

default
{
    state_entry()
    {   // Crée une écoute avec la clé du propriétaire, cette section du code n'est pas ré-exécutée automatiquement en cas de changement de propriétaire.
        // Vous pouvez changer le canal 0 en n'importe quel nombre positif (par exemple le 5 (pour parler, utilisez : '/5 hello')
        listen_handle = llListen(0, "", llGetOwner(), "");
    }
    listen( integer canal, string name, key id, string message )
    {
        llOwnerSay("bip");
        // Arrête d'écouter jusqu'à ce que le script soit ré-initialisé.
        llListenRemove(listen_handle);
    }
    on_rez(integer param)
    {   //Déclenché lorsque l'objet est rez, comme par exemple aprés que l'objet ait été vendu.
        llResetScript();//En forçant la ré-initialisation au moment du rez, on force le listen à se ré-enregistrer.
    }
    changed(integer mask)
    {   //Déclenché lorsque l'objet contenant le script change de propriétaire.
        if(mask & CHANGED_OWNER)
        {
            llResetScript();
        }
    }
}</lsl>
|helpers
|also_header
|also_events
|also_functions=
{{LSL DefineRow||[[llListen/fr|llListen]]|Permet de créer une écoute}}
{{LSL DefineRow||[[llListenControl/fr|llListenControl]]|}}
{{LSL DefineRow||[[llListenRemove/fr|llListenRemove]]|Permet de supprimer une écoute}}
{{LSL DefineRow||[[llDialog/fr|llDialog]]|Permet d'ouvrir une boite de dialogue bleue}}
{{LSL DefineRow||[[llOwnerSay/fr|llOwnerSay]]|Envoie un message lisible uniquement par le propriétaire (évite de spammer le  [[PUBLIC_CHANNEL/fr|PUBLIC_CHANNEL]])}}
{{LSL DefineRow||[[llWhisper/fr|llWhisper]]|Envoie une message limité à 10 mètres}}
{{LSL DefineRow||[[llSay/fr|llSay]]|Envoie un message limité à 20 métres}}
{{LSL DefineRow||[[llShout/fr|llShout]]|Envoi un message limité à 100 mètres.}}
{{LSL DefineRow||[[llRegionSay/fr|llRegionSay]]|Envoie un message limité à la région}}
|also_articles
|also_footer
|notes
|mode
|deprecated
|cat1=Communications/fr
|cat2=Chat/fr
|cat3
|cat4
}}