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. Frame-to-frame mesajlaşma yalnızca istemci tarafında gerçekleştiğinden mesaj teslimi neredeyse anında yapılır.
Mesaj göndermek için:
- Yan panelden ana ekrana geçmek için
notifyMainStage()
yöntemini kullanın.
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- Ana ekrandan 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.
Eklentinin mesajı alabilmesi için 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 "Animation" örnek eklentisi
çerçeveden çerçeveye mesajlaşma ile ilgili tam bir örnek 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 arama'ya da abone olur.
Notlar
Belirli bir katılımcı tarafından gönderilen kare kare 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şmayı öğrenin.
İleti teslimi yalnızca bir kez denenir. Mesaj almak için alıcı panelin açık olması ve uygulamanın, mesaj gönderilmeden önce geri çağırma işlemine abone olması gerekir.