Halaman ini menjelaskan cara mengirim pesan di sisi klien dari add-on yang berjalan di iframe panel samping ke add-on yang berjalan di iframe tahap utama. Frame ke frame pesan hanya terjadi pada sisi klien, sehingga pengiriman pesan hampir secara instan.
Untuk mengirim pesan:
- Dari panel samping ke panggung utama, gunakan
notifyMainStage().
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- Dari layar utama ke panel samping, gunakan
notifySidePanel().
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
payload
panjangnya harus sesuai dengan batas ukuran yang ditetapkan.
Untuk menerima pesan, add-on harus berlangganan
tindakan
frameToFrameMessage
. Contoh kode berikut menunjukkan cara berlangganan
Callback frameToFrameMessage:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
"Animasi" contoh add-on di GitHub
menyertakan contoh lengkap pengiriman pesan {i>frame-to-frame<i}. Setelah aktivitas dimulai,
panel samping memberi tahu tahap utama setiap kali pengguna mengubah input.
Tahap utama juga berlangganan callback frameToFrameMessage
untuk menerima status yang diperbarui.
Catatan
Pesan frame ke frame yang dikirim oleh peserta tertentu hanya dapat dilihat oleh peserta yang sama. Untuk mengirim pesan atau status kepada peserta lain, pelajari cara membagikan status add-on.
Pengiriman pesan hanya dilakukan satu kali. Untuk menerima pesan, panel penerima harus terbuka dan aplikasi harus berlangganan callback sebelum pesan dikirim.