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

Na tej stronie opisujemy, 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 głównego obszaru. Wiadomości między klatkami są przesyłane tylko po stronie klienta, więc dostarczanie wiadomości jest niemal natychmiastowe.

Aby wysłać wiadomość:

    await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
  • Aby przenieść element z głównego widoku do panelu bocznego, użyj metody notifySidePanel().
    await mainStageClient.notifySidePanel("YOUR_MESSAGE");

Długość payload musi być zgodna z określonym limitem rozmiaru.

Aby otrzymać wiadomość, dodatek musi zasubskrybować wywołanie zwrotne frameToFrameMessage. Poniższy przykładowy kod pokazuje, jak zasubskrybować wywołanie zwrotne frameToFrameMessage:

sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
    // YOUR_CODE
});

Przykładowy dodatek „Animation” w GitHubie zawiera pełny przykład przesyłania wiadomości między klatkami. Po rozpoczęciu aktywności panel boczny powiadamia główną scenę za każdym razem, gdy użytkownik zmieni dane wejściowe. Główna scena subskrybuje też frameToFrameMessagewywołanie zwrotne, aby otrzymywać zaktualizowany stan.

Uwagi

  • Wiadomości wysyłane przez danego uczestnika w ramach jednej klatki są widoczne tylko dla tego uczestnika. Aby wysyłać wiadomości lub stan do innych uczestników, dowiedz się, jak udostępniać stan dodatku.

  • Wiadomość jest dostarczana tylko raz. Aby odbierać wiadomości, panel odbiorczy musi być otwarty, a aplikacja musi subskrybować wywołanie zwrotne przed wysłaniem wiadomości.