Bu sayfada, yan panel iFrame'inde çalışan bir eklentiden ana sahne iFrame'inde çalışan bir eklentiye istemci tarafında nasıl mesaj gönderileceği açıklanmaktadır. Kareden kareye mesajlaşma yalnızca istemci tarafında gerçekleşir. Bu nedenle, mesajlar neredeyse anında teslim edilir.
Mesaj göndermek için:
- Yan panelden ana sahneye geçmek için
notifyMainStage()yöntemini kullanın.
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- Ana sahneden yan panele geçmek için
notifySidePanel()yöntemini kullanın.
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
payload uzunluğu, belirtilen boyut sınırına uygun olmalıdır.
Mesajı almak için eklentinin frameToFrameMessage geri çağırma işlevine abone olması gerekir. Aşağıdaki kod örneğinde, bir frameToFrameMessage geri çağırma işlevine nasıl abone olunacağı gösterilmektedir:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
GitHub'daki "Animasyon" örnek eklentisi, kareden kareye mesajlaşmanın tam bir örneğini içerir. Etkinlik başladıktan sonra yan panel, kullanıcı bir girişi her değiştirdiğinde ana sahneyi bilgilendirir.
Ana sahne, güncellenmiş durumu almak için frameToFrameMessage geri çağırma işlevine de abone olur.
Notlar
Belirli bir katılımcı tarafından gönderilen kareden kareye mesajlar yalnızca aynı katılımcı tarafından görülebilir. Diğer katılımcılara mesaj veya durum göndermek için eklenti durumunu paylaşma hakkında bilgi edinin.
İleti teslimi yalnızca bir kez denenir. Mesajların alınabilmesi için alıcı panelin açık olması ve uygulamanın, mesaj gönderilmeden önce geri çağırmaya abone olması gerekir.