ফ্রেম-টু-ফ্রেম মেসেজিং ব্যবহার করুন

এই পৃষ্ঠায় বর্ণনা করা হয়েছে কীভাবে সাইড-প্যানেল আইফ্রেমে চলমান একটি অ্যাড-অন থেকে মূল স্টেজ আইফ্রেমে চলমান একটি অ্যাড-অনে ক্লায়েন্ট সাইডে বার্তা পাঠানো যায়। ফ্রেম-টু-ফ্রেম মেসেজিং শুধুমাত্র ক্লায়েন্ট সাইডেই ঘটে, তাই বার্তা ডেলিভারি প্রায় তাৎক্ষণিক হয়।

বার্তা পাঠাতে:

  • সাইড প্যানেল থেকে মূল স্টেজে যেতে notifyMainStage() মেথডটি ব্যবহার করুন।
    await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
  • মূল স্টেজ থেকে সাইড প্যানেলে যেতে notifySidePanel() মেথডটি ব্যবহার করুন।
    await mainStageClient.notifySidePanel("YOUR_MESSAGE");

payload দৈর্ঘ্য অবশ্যই তার নির্দিষ্ট আকারের সীমার মধ্যে থাকতে হবে।

মেসেজটি গ্রহণ করার জন্য, অ্যাড-অনটিকে অবশ্যই frameToFrameMessage কলব্যাকে সাবস্ক্রাইব করতে হবে। নিচের কোড স্যাম্পলটিতে দেখানো হয়েছে কিভাবে একটি frameToFrameMessage কলব্যাকে সাবস্ক্রাইব করতে হয়:

sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
    // YOUR_CODE
});

গিটহাবে থাকা "অ্যানিমেশন" স্যাম্পল অ্যাড-অনটিতে ফ্রেম-টু-ফ্রেম মেসেজিংয়ের একটি সম্পূর্ণ উদাহরণ রয়েছে। অ্যাক্টিভিটি শুরু হওয়ার পর, ব্যবহারকারী যখনই কোনো ইনপুট পরিবর্তন করেন, সাইড প্যানেলটি মেইন স্টেজকে অবহিত করে । আপডেট হওয়া স্টেট পাওয়ার জন্য মেইন স্টেজটিও frameToFrameMessage কলব্যাকে সাবস্ক্রাইব করে

নোট

  • কোনো নির্দিষ্ট অংশগ্রহণকারীর পাঠানো ফ্রেম-টু-ফ্রেম বার্তা শুধুমাত্র সেই অংশগ্রহণকারীই দেখতে পান। অন্যান্য অংশগ্রহণকারীদের কাছে বার্তা বা স্টেট পাঠাতে, অ্যাড-অন স্টেট কীভাবে শেয়ার করতে হয় তা জানুন।

  • মেসেজ পাঠানোর চেষ্টা শুধুমাত্র একবারই করা হয়। মেসেজ গ্রহণ করার জন্য, গ্রহণকারী প্যানেলটি অবশ্যই খোলা থাকতে হবে এবং মেসেজ পাঠানোর আগে অ্যাপটিকে অবশ্যই কলব্যাকে সাবস্ক্রাইব করতে হবে।