Skip to main content

کانال نوتیفیکیشن

Android
v2.1.0

تعریف کانال نوتیفیکیشن

کانال نوتیفیکیشن که در اندروید نسخه ۸ اضافه شده در واقع یک دسته‌بندی برای اعلان‌های ارسالی به کاربران می‌باشد که می‌توان در این دسته بندی رنگ LED ، صدای اعلان و ... را مشخص کرد

استفاده از کانال نوتیفیکیشن در اندروید ۸ به بالا اجباری می‌باشد و به هر نوتیفیکیشن باید یک کانالی اختصاص داده شود. هنگامی که از کتابخانه پوشه استفاده می‌کنید به صورت پیش‌فرض یک کانال به نوتیفیکیشن‌ها اختصاص داده می‌شود که در صورت تمایل می‌توانید توسط ادامه راهنما کانال سفارشی خودتان را ایجاد کنید تا تنظیمات دلخواه شما را داشته باشد.

البته لازم به ذکر است که بیشتر تنظیماتی که میتوان برای کانال نوتیفیکیشن تعیین کرد از طریق کنسول موقع ارسال نوتیفیکیشن در دسترس هستند و شما می‌توانید از طریق کنسول، رنگ ‌LED، صدای نوتیفیکیشن و ... را تعیین کنید.

نکته: در نظر داشته باشید که در صورت ساخت کانال تنظیمات رنگ LED ، صدای اعلان و ... که در کنسول تنظیم می‌کنید دیگر کار نخواهد کرد و فقط تنظیمات کانال شما برای اعلان ارسالی‌تان اعمال می‌شود. در کنسول شناسه کانالتان را هنگام فرستادن اعلان وارد می‌کنید و هر تنظیمی که برای آن کانال ست کرده باشید هنگام نمایش اعلان اعمال خواهد شد.

وقتی نوتیفیکیشنی را به کانال سفارشی می‌فرستید در نظر داشته‌باشید که کانفیگ نوتیفیکیشن که هنگام ارسال در کنسول تنظیم می‌کنید از بین‌می‌رود و تنظیمات کانال نوتیفیکیشن سفارشی جایگزین آن می‌شود (مثلا صدای اعلان، رنگ LED و ...)

اطلاعات بیشتر در مورد کانال نوتیفیکیشن

اضافه‌کردن کانال نوتیفیکیشن

نسخه‌ی 2.1.0 به بعد

تابع createNotificationChannel

پارامتر ورودیاستفاده
channelIdشناسه‌ای که بتوان کانال را شناسایی کرد. مثلا sportChannel
channelNameنامی که برای کانال خود انتخاب می‌کنید
descriptionتوضیحات دلخواه در مورد کانال
importanceعددی برای مشخص‌کردن میزان اهمیت (اطلاعات بیشتر)
enableLightفعال‌کردن LED
enableVibrationفعال‌کردن ویبره‌ی نوتیفیکیشن
showBadgeفعال‌کردن نمایش بچ در لانچر دستگاه
ledColorرنگ LED (اطلاعات بیشتر)
vibrationPatternپترن ویبره (اطلاعات بیشتر)
String channel = "sportChannel";
String channelName = "My Sport group";
String channelDesc = "This channel holds athletes users";
int importance = 3;
int ledColor = -65536;
bool light = true;
bool vibration = false;
bool badge = true;
var vibrationPatterns = null;

Pushe.createNotificationChannel(
channelId, channelName, channelDesc, importance,
light, vibration, badge, ledColor, vibrationPattern
);

حذف کانال نوتیفیکیشن

نسخه‌ی 2.1.0 به بعد

در صورتی که قصد دارید دستگاه را از کانال لغو عضویت کنید، کد زیر را فراخوانی کنید.

تابع removeNotificationChannel

پارامتر ورودیاستفاده
channelIdشناسه‌ی کانالی که ساخته شده است.
String channelThatWasCreated = "sportChannel";
Pushe.removeNotificationChannel(channelThatWasCreated);

نکته: برای ساخت یا حذف کانال می‌توانید از هر تابعی [حتی غیر پوشه] استفاده کنید.