EntitySend

Famille: Studio · 2 formes

Ce que fait la commande

Envoie un message à toutes les entités de la scène qui répondent à un identifiant, un nom ou un tag. Leurs scripts le reçoivent par onMessage.

Syntaxe

EntitySend(entity string, message string) → integer

EntitySend(entity string, message string, dataJson string) → integer

Paramètres

Nom	Type	Dans les formes	Rôle
entity	string	toutes	L'identifiant, le nom ou le tag des destinataires. Chaque entité trouvée reçoit le message.
message	string	toutes	Le nom du message.
dataJson	string	2	Données jointes au message, en texte JSON, facultatives. Un texte qui n'est pas du JSON valide part comme simple chaîne.

Chaque forme rend

integer

Le nombre d'entités qui ont reçu le message, 0 si aucune ne correspond.

À savoir

Quand rien ne correspond, un seul avertissement est écrit dans la console par nom.

Exemple · engendré

Forme 1 : la plus courte

DO  Print(EntitySend("value", "hello"))  Sync()LOOP

Forme 2 : avec tous les arguments

DO  Print(EntitySend("value", "hello", "{}"))  Sync()LOOP

EntitySend est appelé et sa réponse est affichée à chaque image. La boucle DO … LOOP n'est pas décorative : un programme BASIC classique s'arrête dès qu'il n'a plus de lignes, et c'est Sync() qui dessine l'image.

Commandes voisines

133 commandes dans Studio