Difference between revisions of "Email/fr"

Latest revision as of 11:35, 13 April 2009

! Event: email( string temps, string adresse, string sujet, string message, integer nombre restant ){ ; }

21	Event ID
	Delais

Se déclenche suite à llGetNextEmail lorsqu'un mail correspondant aux critères est présent.

• string	temps	–	Dans le format de `(string)llGetUnixTime`
• string	adresse
• string	sujet
• string	message
• integer	nombre restant	–	Nombre de mails restant à traiter.

La liste des emails à traiter est liée à la prim et tout script présent dans la prim peut y accéder.
L'adresse email de la prim se termine par "@lsl.secondlife.com" , llGetKey() + "@lsl.secondlife.com"^[1].

Spécification

Cet évènement est déclenché par llGetNextEmail lorsqu'un email correspond aux filtres de llGetNextEmail (les filtres sont optionnels). Le premier mail correspondant est supprimé de la liste et ses données sont utilisées comme paramètres de l'évènement Email. Si aucun email ne correspond au filtres, l'évènement ne sera pas lancé, même si des emails ont été reçus. En complément des filtres, notez que les emails sont classés dans l'ordre FIFO.

Défauts

La queue de traitement des emails est limitée à 100 mails, tout email supplémentaire sera perdu.
La zone message peut contenir 1000 caractères au maximum. Ce décompte inclut les informations d'en-tête (adresse, sujet, etc.)
Les mails envoyés depuis SL contiendront dans leur en-tête des informations relatives à la prim. Cf. llEmail pour de plus amples informations.
A cause du bug SVC-23 (present depuis 2005), les objets peuvent arréter de recevoir des emails jusqu'à ce que la région soit redemarrée ou que l'objet change de région (relancer le script ne résoud par le problème). Les emails reçus peuvent éventuellement être lus aprés un redemarrage/un changement de région. Donc, ne comptez pas trop sur cet évènement pour des échanges inter-région.

Exemples

<lsl>default {

   state_entry()
   {
       llSetTimerEvent(5.0);
   }

   timer()
   {
       llGetNextEmail("", "");
   }

   email( string time, string address, string subject, string message, integer num_left )
   {
       if (llGetSubString(address, -19, -1) == "@lsl.secondlife.com")
       {//Le Message a été envoyé depuis SL. 
        //Pour cet exemple, nous nous contentons de supprimer l'en-tête 
        //et d'envoyer le message dans le chat local.
           message = llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1);
       }
       
       llSay(0, message);

       if(num_left)
           llGetNextEmail("", "");
   }

}</lsl>

Notes

Pour des astuces sur l'utilisation des emails dans SL, consultez cet article : llEmail.

Voir aussi

Fonctions

•	llEmail	–	Envoie un mail
•	llGetNextEmail	–	Lit le mail suivant

Notes complémentaires

Problèmes

SVC-23

A

La région peut suspendre l'envoi des emails vers les scripts

Notes de bas de page

^ Les adresses emails des autres grilles sont construites autrement : llGetKey() + "@lsl." + grille + ".lindenlab.com"; ainsi pour la beta : grille ="aditi".

Vous cherchez encore des informations ? Peut-être cette page du LSLwiki pourra vous renseigner.

@@ Line 1: / Line 1: @@
-{{LSL_Event/fr
+{{Issues/SVC-23/fr}}{{LSL_Event/fr
 |event_id=21|event_delay
 |event=email
-|p1_type=string|p1_name=temps|p1_desc
+|p1_type=string|p1_name=temps|p1_desc=Dans le format de <code>(string)[[llGetUnixTime/fr|llGetUnixTime]]</code> |p1_hover=Dans le format de (string)llGetUnixTime
 |p2_type=string|p2_name=adresse|p2_desc
 |p3_type=string|p3_name=sujet|p3_desc|
 p4_type=string|p4_name=message|p4_desc
-|p5_type=integer|p5_name=nombre restant|p5_desc
+|p5_type=integer|p5_name=nombre restant|p5_desc=Nombre de mails restant à traiter.
-|event_desc=Se déclenche lorsqu'un objet reçoit un email
+|event_desc=Se déclenche suite à [[llGetNextEmail/fr|llGetNextEmail]] lorsqu'un mail correspondant aux critères est présent.
+|event_footnote=La liste des emails à traiter est liée à la prim et tout script présent dans la prim peut y accéder. <br/> L'adresse email de la prim se termine par "@lsl.secondlife.com" , <code>[[llGetKey/fr|llGetKey]]() + "@lsl.secondlife.com"</code>{{Footnote|1=Les adresses emails des autres grilles sont construites autrement : <code style="font-size: 123%;">[[llGetKey/fr|llGetKey]]() + "@lsl." + grille + ".lindenlab.com"</code>; ainsi pour la beta : grille ={{String|aditi}}.|2=Les adresses emails de la beta grille sont construites autrement : llGetKey() + {{String|@lsl.}} + grille + {{String|.lindenlab.com}}; pour le beta, grille = {{String|aditi}}.}}.
 |constants
-|spec
+|spec=Cet évènement est déclenché par [[llGetNextEmail/fr|llGetNextEmail]] lorsqu'un email correspond aux filtres de [[llGetNextEmail/fr|llGetNextEmail]] (les filtres sont optionnels). Le premier mail correspondant est supprimé de la liste et ses données sont utilisées comme paramètres de l'évènement Email. Si aucun email ne correspond au filtres, l'évènement ne sera pas lancé, même si des emails ont été reçus. En complément des filtres, notez que les emails sont classés dans l'ordre {{HoverText|FIFO|First In First Out (premier entré, premier sorti)}}.
-|caveats=*Le '''temps''' est au format (string)[[llGetUnixTime/fr|llGetUnixTime]].
+|caveats=
-*La queue de traitement des emails est limitée à 100 mails, tout mail supplémentaire sera perdu.
+*La queue de traitement des emails est limitée à 100 mails, tout email supplémentaire sera perdu.
-|examples=
+*La zone message peut contenir 1000 caractères au maximum. Ce décompte inclut les informations d'en-tête ('''adresse''', '''sujet''', etc.)
-Cette application utilise les emails pour que les objets contrôlent auprés d'un serveur central si leur propriétaire a la dernière version.
+*[[llEmail/fr|Les mails envoyés depuis SL]] contiendront dans leur en-tête des informations relatives à la prim. Cf. [[llEmail/fr|llEmail]] pour de plus amples informations.
+* A cause du bug {{Jira|SVC-23}} (present depuis 2005), les objets peuvent arréter de recevoir des emails jusqu'à ce que la région soit redemarrée ou que l'objet change de région (relancer le script ne résoud par le problème).  Les emails reçus peuvent éventuellement être lus aprés un redemarrage/un changement de région. Donc, ne comptez pas trop sur cet évènement pour des échanges inter-région.
-Dans les objets:
+|Constants
-<lsl>
+|examples=<lsl>default
-string version = "1"; //
-string type = "lolcube";
-default
-{
-    on_rez(integer start_param)
-    {
-        llEmail("5a634b27-f032-283f-2df2-55ead7724b23@lsl.secondlife.com",
-            version,
-            (string)llGetOwner()+","+type);
-    }
-}</lsl>
-Dans le serveur:
-<lsl>
-default
 {
      state_entry()
      {
-         llSetTimerEvent(15);
+         llSetTimerEvent(5.0);
      }
      timer()
      {
-         llGetNextEmail("","");
+         llGetNextEmail("", "");
      }
-     email( string time, string address, string version, string message, integer num_left )
+     email( string time, string address, string subject, string message, integer num_left )
      {
-         if ((integer)version < 2)
+         if (llGetSubString(address, -19, -1) == "@lsl.secondlife.com")
-         {
+         {//Le Message a été envoyé depuis SL.
-             list info = llCSV2List(llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1));
+         //Pour cet exemple, nous nous contentons de supprimer l'en-tête
-            llGiveInventory(llList2Key(info,0),llList2String(info,1));
+         //et d'envoyer le message dans le chat local.
+             message = llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1);
          }
-         integer i;
+         llSay(0, message);
-         for (i = 0; i < num_left; i++)
-        {
+         if(num_left)
-             llGetNextEmail("","");
+             llGetNextEmail("", "");
-        }
      }
-}
+}</lsl>
-</lsl>
 |helpers
 |also_header
@@ Line 66: / Line 52: @@
 |also_articles
 |also_footer
-|notes
+|notes=Pour des astuces sur l'utilisation des emails dans SL, consultez cet article : [[llEmail/fr#Prim2Prim_Email|llEmail]].
 |mode
 |deprecated