نمایش نوتیفیکیشن محلی
این عملکرد یک اعلان (نوتیفیکیشن) را بلافاصله و بدون نیاز به سرور روی دستگاه کاربر نمایش میدهد. برخلاف سرویس نوتیفیکیشن که اعلان را از Firebase و از سمت سرور ارسال میکند، اعلان محلی توسط خود اپ ساخته میشود و به اینترنت نیاز ندارد.
تنظیمات
- کلید اعلان: یک نام یکتا برای این اعلان. کلید مبنای شناسه اعلان است؛ اگر اعلان دیگری با همان کلید نمایش داده شود، جایگزین اعلان قبلی میشود. برای لغو اعلان نیز از همین کلید استفاده میشود.
- عنوان: عنوان اعلان.
- متن: متن اصلی اعلان.
- صفحه بعد از لمس: صفحهای که با لمس اعلان باز میشود. خالی گذاشتن آن یعنی فقط خود اپ باز شود.
- داده همراه: یک مقدار متنی دلخواه که همراه اعلان ذخیره میشود و پس از لمس اعلان از متغیر
sys.notification.dataقابل خواندن است.
عنوان، متن، کلید و داده همراه میتوانند شامل متغیر با الگوی {{myvar}} باشند؛ مقدار متغیر در لحظه اجرای عملکرد جایگذاری میشود.
متغیرهای نتیجه
پس از اجرای این عملکرد، متغیرهای سیستمی زیر مقدار میگیرند:
| متغیر | توضیح |
|---|---|
sys.notification.success | آیا نمایش اعلان موفق بود |
sys.notification.error | متن خطا در صورت ناموفق بودن |
sys.notification.id | شناسه عددی ساختهشده از کلید |
sys.notification.key | کلید همین اعلان |
پس از لمس اعلان توسط کاربر نیز sys.notification.opened برابر true و sys.notification.current شامل اطلاعات اعلان بازشده میشود. فهرست کامل در متغیرهای سیستمی آمده است.
نمونه کاربرد
پس از پایان یک فرم، اعلانی با عنوان «سفارش ثبت شد» نمایش دهید و صفحه «پیگیری سفارش» را بهعنوان صفحه بعد از لمس انتخاب کنید. کد پیگیری را در «داده همراه» با الگوی {{orderCode}} قرار دهید تا در صفحه مقصد از sys.notification.data بخوانید.
نکات و محدودیتها
- این قابلیت در نسخه فعلی فقط روی Android و iOS کار میکند. در خروجی وب و دسکتاپ اعلان نمایش داده نمیشود و
sys.notification.errorپر میشود. - در اولین اجرا، اپ مجوز نمایش اعلان را از کاربر میگیرد. اگر کاربر مجوز ندهد، عملکرد ناموفق خواهد بود.
- مجوز اعلان فقط زمانی به اپ اضافه میشود که حداقل از یکی از عملکردهای اعلان استفاده کرده باشید.
- در شبیهساز اپ ادیتور، بهجای اعلان واقعی یک پیغام کوتاه (Toast) با عنوان و متن اعلان نمایش داده میشود.