از پیام فریم به فریم استفاده کنید

این صفحه نحوه ارسال پیام در سمت سرویس گیرنده را از یک افزونه در حال اجرا در 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 مشترک می‌شود .

یادداشت ها

  • پیام های فریم به فریم ارسال شده توسط یک شرکت کننده خاص فقط توسط همان شرکت کننده قابل مشاهده است. برای ارسال پیام یا وضعیت به سایر شرکت‌کنندگان، نحوه اشتراک‌گذاری وضعیت افزودنی را بیاموزید.

  • تحویل پیام فقط یک بار انجام می شود. برای دریافت پیام ها، پنل دریافت باید باز باشد و برنامه باید قبل از ارسال پیام مشترک تماس پاسخگو باشد.