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