এই পৃষ্ঠায় বর্ণনা করা হয়েছে যে কীভাবে ক্লায়েন্ট সাইডে মেসেজ পাঠাতে হয়, সাইড-প্যানেল iframe-এ রান করা অ্যাড-অন থেকে প্রধান স্টেজে iframe-এ রান করা অ্যাড-অনে। ফ্রেম-টু-ফ্রেম মেসেজিং শুধুমাত্র ক্লায়েন্ট সাইডে হয়, তাই মেসেজ ডেলিভারি প্রায় তৎক্ষণাৎ হয়।
মেসেজ পাঠাতে:
- সাইড প্যানেল থেকে মূল স্টেজে,
notifyMainStage()পদ্ধতি ব্যবহার করুন।
await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
- মূল স্টেজ থেকে সাইড প্যানেলে,
notifySidePanel()পদ্ধতি ব্যবহার করুন।
await mainStageClient.notifySidePanel("YOUR_MESSAGE");
payload-এর
দৈর্ঘ্য অবশ্যই এর নির্দিষ্ট সাইজের সীমার সাথে মানানসই হতে হবে।
মেসেজ পেতে, অ্যাড-অনকে অবশ্যই
frameToFrameMessage
কলব্যাক সাবস্ক্রাইব করতে হবে। নিচে দেওয়া কোডের নমুনা থেকে জানতে পারবেন কীভাবে
frameToFrameMessage কলব্যাকে সাবস্ক্রাইব করতে হয়:
sidePanelClient.on('frameToFrameMessage', (arg: FrameToFrameMessage) => {
// YOUR_CODE
});
GitHub-এ "অ্যানিমেশন" স্যাম্পেল অ্যাড-অন-এ
ফ্রেম-টু-ফ্রেম মেসেজিংয়ের সম্পূর্ণ উদাহরণ অন্তর্ভুক্ত আছে। অ্যাক্টিভিটি শুরু হওয়ার পরে,
ব্যবহারকারী ইনপুট পরিবর্তন করলেই সাইড প্যানেল মূল স্টেজে বিজ্ঞপ্তি পাঠায়।
এছাড়াও, আপডেট করা স্ট্যাটাস পেতে, মূল স্টেজ frameToFrameMessage কলব্যাক সাবস্ক্রাইব করে।
নোট
কোনও অংশগ্রহণকারীর পাঠানো ফ্রেম-টু-ফ্রেম মেসেজ শুধুমাত্র সেই অংশগ্রহণকারীই দেখতে পাবেন। অন্যান্য অংশগ্রহণকারীদের মেসেজ বা স্ট্যাটাস পাঠাতে, কীভাবে অ্যাড-অন স্ট্যাটাস শেয়ার করবেন তা জানুন।
মেসেজ ডেলিভার করার চেষ্টা একবারই করা হয়। মেসেজ পেতে, মেসেজ পাঠানোর আগে রিসিভিং প্যানেল খোলা থাকতে হবে এবং অ্যাপটিকে অবশ্যই কলব্যাকে সাবস্ক্রাইব করতে হবে।