Çerçeveden mesajlaşmayı kullanın

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:

    await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
    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.