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

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

একটি বার্তা পাঠাতে:

  • পাশের প্যানেল থেকে প্রধান পর্যায়ে, notifyMainStage() পদ্ধতি ব্যবহার করুন।
    await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
  • প্রধান পর্যায় থেকে সাইড প্যানেল পর্যন্ত, notifySidePanel() পদ্ধতি ব্যবহার করুন।
    await mainStageClient.notifySidePanel("YOUR_MESSAGE");

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

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

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

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

নোট

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

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

,

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

একটি বার্তা পাঠাতে:

  • পাশের প্যানেল থেকে প্রধান পর্যায়ে, notifyMainStage() পদ্ধতি ব্যবহার করুন।
    await sidePanelClient.notifyMainStage("YOUR_MESSAGE");
  • প্রধান পর্যায় থেকে সাইড প্যানেল পর্যন্ত, notifySidePanel() পদ্ধতি ব্যবহার করুন।
    await mainStageClient.notifySidePanel("YOUR_MESSAGE");

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

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

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

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

নোট

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

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