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