Ç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. Kare kare 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, 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 işlevine de 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. Mesajları almak için alıcı panelin açık olması ve uygulamanın, mesaj gönderilmeden önce geri arama işlemine abone olması gerekir.