Questa pagina descrive come inviare messaggi lato client da un componente aggiuntivo in esecuzione nell'iframe del riquadro laterale a un componente aggiuntivo in esecuzione nell'iframe del palcoscenico principale. La messaggistica frame per frame avviene solo sul lato client, quindi la consegna dei messaggi è quasi istantanea.
Per inviare un messaggio:
- Dal riquadro laterale alla schermata principale, utilizza il metodo
notifyMainStage()
.
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- Dal palco principale al riquadro laterale, utilizza il
metodo
notifySidePanel()
.
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
La lunghezza di payload
deve rispettare il limite di dimensioni specificato.
Per ricevere il messaggio, il componente aggiuntivo deve sottoscrivere
il
callback
frameToFrameMessage
. Il seguente esempio di codice mostra come registrarsi a un callback frameToFrameMessage
:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
Il componente aggiuntivo di esempio"Animazione" su GitHub
include un esempio completo di messaggistica frame per frame. Dopo l'avvio dell'attività,
il riquadro laterale invia una notifica al palco principale ogni volta che l'utente modifica un input.
Il palco principale si iscrive anche al callback frameToFrameMessage
per ricevere lo stato aggiornato.
Note
I messaggi frame per frame inviati da un determinato partecipante sono visibili solo a questo stesso partecipante. Per inviare messaggi o stati ad altri partecipanti, scopri come condividere lo stato del componente aggiuntivo.
Il tentativo di invio del messaggio viene eseguito una sola volta. Per ricevere i messaggi, il pannello di ricezione deve essere aperto e l'app deve sottoscrivere il callback prima dell'invio del messaggio.