Korzystanie z funkcji przesyłania wiadomości między ramkami

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ść:

    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.