Cette page explique comment envoyer des messages côté client à partir d'une module complémentaire exécuté dans panneau latéral vers un tag un module complémentaire s'exécutant dans main de l'espace de création. Image à cadre la messagerie n'a lieu que du côté du client, la distribution des messages est donc proche instantanément.
Pour envoyer un message, procédez comme suit :
- Depuis le panneau latéral jusqu'à l'espace de création principal, utilisez la
notifyMainStage().
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- Pour passer de la scène principale au panneau latéral, utilisez la méthode
notifySidePanel().
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
payload
la longueur doit respecter la limite de taille spécifiée.
Pour recevoir le message, le module complémentaire doit s'abonner au rappel frameToFrameMessage. L'exemple de code suivant montre comment s'abonner à un
Rappel frameToFrameMessage:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
Le rapport "Animation" exemple de module complémentaire sur GitHub
comprend un exemple complet de
messagerie frame-to-frame. Une fois l'activité commencée,
Le panneau latéral informe l'étape principale chaque fois que l'utilisateur modifie une entrée.
La scène principale s'abonne également au rappel frameToFrameMessage pour recevoir l'état mis à jour.
Remarques
Les messages de frame à frame envoyés par un participant donné ne sont visibles que par ce même participant. Pour envoyer des messages ou des états aux autres participants : découvrez comment partager le module complémentaire l'état.
La distribution du message n'est tentée qu'une seule fois. Pour recevoir des messages, le destinataire le panneau doit être ouvert et l'application doit s'abonner au rappel avant que le message est envoyé.