Na tej stronie dowiesz się, jak wysyłać wiadomości po stronie klienta z dodatku działającego w elemencie iframe panelu bocznego do dodatku działającego w elemencie iframe scenariusza głównego. Komunikacja międzyklatkowa odbywa się tylko po stronie klienta, więc dostarczanie wiadomości jest niemal natychmiastowe.
Aby wysłać wiadomość:
- Z panelu bocznego do sceny głównej użyj metody
notifyMainStage()
.
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- Aby przełączyć się z głównego widoku do panelu bocznego, użyj metody
notifySidePanel()
.
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
Długość elementu payload
musi być zgodna z określonym limitem rozmiaru.
Aby otrzymywać te wiadomości, dodatek musi subskrybować wywołanie frameToFrameMessage
. Poniższy przykładowy kod pokazuje, jak zasubskrybować wywołanie zwrotne frameToFrameMessage
:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
Przykładowy dodatek „Animation” na GitHubie zawiera pełny przykład przesyłania wiadomości z ramki na ramkę. Po rozpoczęciu aktywności panel boczny powiadamia główną scenę o każdej zmianie wprowadzonej przez użytkownika.
Etap główny subskrybuje też wywołanie zwrotne frameToFrameMessage
, aby otrzymywać zaktualizowany stan.
Uwagi
Wiadomości wysyłane przez danego uczestnika w ramach funkcji „Ramka po ramce” są tylko widoczne dla tego uczestnika. Aby wysyłać wiadomości lub stan do innych uczestników, dowiedz się, jak udostępniać stany dodatków.
Próba dostarczenia wiadomości jest podejmowana tylko raz. Aby otrzymywać wiadomości, panel odbiorczy musi być otwarty, a aplikacja musi subskrybować wywołanie zwrotne przed wysłaniem wiadomości.