درباره پیام های FCM

FCM مجموعه خاصی از گزینه های تحویل را برای پیام های ارسال شده به دستگاه های Android ارائه می دهد و گزینه های مشابهی را در سیستم عامل های اپل و وب امکان پذیر می کند. به عنوان مثال ، رفتار پیام "Collapsible" از طریق collapse_key FCM ، در اپل از طریق apns-collapse-id ، و در JavaScript/Web از طریق Topic در Android پشتیبانی می شود. برای جزئیات بیشتر ، به توضیحات در این بخش و مستندات مرجع مربوطه مراجعه کنید.

پیام های غیر قابل جمع شدن و قابل جمع شدن

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

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

برای اندروید محدودیت 100 پیام وجود دارد که می توانند بدون فروپاشی ذخیره شوند. در صورت رسیدن به حد ، تمام پیام های ذخیره شده دور ریخته می شوند. هنگامی که دستگاه به صورت آنلاین برگردد ، پیام خاصی دریافت می کند که نشان می دهد به حد رسیده است. سپس برنامه می تواند با درخواست همگام سازی کامل از سرور برنامه ، وضعیت را به درستی اداره کند.

یک پیام قابل جمع شدن پیامی است که در صورت ارسال هنوز به دستگاه ممکن است با یک پیام جدید جایگزین شود.

موارد استفاده متداول از پیام های قابل جمع شدن پیام هایی است که برای گفتن یک برنامه تلفن همراه برای همگام سازی داده های سرور استفاده می شود. یک مثال می تواند یک برنامه ورزشی باشد که کاربران را با آخرین امتیاز به روز می کند. فقط جدیدترین پیام مرتبط است.

برای علامت گذاری یک پیام به صورت قابل جمع شدن در Android ، پارامتر collapse_key را در Payload Message وارد کنید. به طور پیش فرض ، کلید Collapse نام بسته برنامه است که در کنسول Firebase ثبت شده است. سرور FCM می تواند به طور همزمان چهار پیام قابل جمع شدن مختلف را در هر دستگاه ذخیره کند که هر کدام دارای یک کلید فروپاشی متفاوت هستند. اگر از این شماره فراتر بروید ، FCM فقط چهار کلید فروپاشی را نگه می دارد ، بدون اینکه تضمینی در مورد کدام یک از آنها نگهداری شود.

پیام های موضوع بدون بار به طور پیش فرض قابل جمع شدن هستند. پیام های اعلان همیشه قابل جمع شدن هستند و پارامتر collapse_key را نادیده می گیرند.

از کدوم استفاده کنم؟

پیام های قابل جمع شدن از نظر عملکرد انتخاب بهتری هستند ، مشروط بر اینکه برنامه شما نیازی به استفاده از پیام های غیر قابل جمع شدن ندارد. با این حال ، اگر از پیام های قابل جمع شدن استفاده می کنید ، به یاد داشته باشید که FCM فقط اجازه می دهد تا حداکثر چهار کلید مختلف فروپاشی توسط FCM در هر نشانه ثبت نام در هر زمان معین استفاده شود. شما نباید از این تعداد تجاوز کنید ، یا این می تواند عواقب غیرقابل پیش بینی را به همراه داشته باشد.

تعیین اولویت یک پیام

شما دو گزینه برای اختصاص اولویت تحویل به پیام های پایین دست دارید: اولویت عادی و بالا. گرچه رفتار کمی در سکوها متفاوت است ، تحویل پیام های اولویت دار و با اولویت مانند این کار می کند:

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

• اولویت بالا FCM سعی می کند پیام های اولویت بالایی را بلافاصله ارائه دهد حتی اگر دستگاه در حالت Doze باشد. پیام های با اولویت بالا برای محتوای قابل مشاهده کاربر حساس به زمان هستند.

در اینجا نمونه ای از پیام اولویت عادی ارسال شده از طریق پروتکل FCM HTTP V1 برای اطلاع مشترک مجله مبنی بر اینکه محتوای جدید برای بارگیری در دسترس است:

{
  "message":{
    "topic":"subscriber-updates",
    "notification":{
      "body" : "This week's edition is now available.",
      "title" : "NewsMagazine.com",
    },
    "data" : {
      "volume" : "3.21.15",
      "contents" : "http://www.news-magazine.com/world-week/21659772"
    },
    "android":{
      "priority":"normal"
    },
    "apns":{
      "headers":{
        "apns-priority":"5"
      }
    },
    "webpush": {
      "headers": {
        "Urgency": "high"
      }
    }
  }
}

برای جزئیات بیشتر در مورد پلتفرم در تنظیم اولویت پیام:

• مستندات APNS
• اولویت پیام (Android) را تنظیم و مدیریت کنید
• فوریت پیام فشار وب

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "data":{
      "Nick" : "Mario",
      "body" : "great match!",
      "Room" : "PortugalVSDenmark"
    },
    "apns":{
      "headers":{
        "apns-expiration":"1604750400"
      }
    },
    "android":{
      "ttl":"4500s"
    },
    "webpush":{
      "headers":{
        "TTL":"4500"
      }
    }
  }
}