راهنمای توسعه دهندگان برای استقرار Bubble API در یک برنامه اندروید

معرفی

گوگل اخیرا یک API حباب دار در سال 2019 برای نمایش اعلان ها معرفی کرده است. در Android Q، این اعلان‌های سر چت را به عنوان یک API حباب بخشی از پلتفرم اندروید تبدیل کرد. این ویژگی اعلان حباب اولین بار فقط برای دستگاه های پیکسل معرفی شد و مشابه حباب چت فیس بوک مسنجر کار می کرد. در اندروید 10، این نسخه پایدار نبود و کاربران باید آن را از گزینه های توسعه دهنده در تنظیمات خود فعال می کردند.

نسخه نهایی Bubble API با Android 11 عرضه شد. Bubbles یک ویژگی پیش نمایش در اندروید 11 است که به شما کمک می کند بیش از یک کار را انجام دهید یا از بیش از یک برنامه در یک زمان استفاده کنید. اندروید دارای یک تبدیل داخلی است تا تماس‌ها را آسان‌تر و کاربرپسندتر کند. آنها در سیستم اطلاع رسانی تعبیه شده اند و روی سایر برنامه ها شناور هستند.

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

اعلان‌های حباب فقط زمانی ظاهر می‌شوند که نیاز تماس را برآورده کنند. در اینجا برخی از محدودیت ها در مورد زمان نمایش اعلان ها به صورت حباب وجود دارد.

محدودیت ها در اندروید 10

⦁ برای اعلان ها از Messingingstyle استفاده می کنیم و یک چهره اضافه شده است

⦁ هنگام ارسال اعلان ها، برنامه باید در پیش زمینه باشد

محدودیت در اندروید 11

⦁ اعلان ها از MessagingStyle استفاده می کنند

رهنمودها

الزامات مکالمه

⦁ ابتدا، برای برآورده کردن الزامات تماس اعلان – باید میانبرهای پویا یا اشتراک گذاری طولانی مدت را پیاده سازی کنیم و شناسه میانبر را به اعلان سبک پیام خود وصل کنیم.

حباب ها چگونه اجرا می شوند؟

1. نسخه SDK را بررسی کنید

• اولین قدم این است که اطمینان حاصل کنیم که برنامه ما برای اندروید 11 (سطح API 30) هدف گذاری شده است.

Android {
	    compileSdkVersion 30
	    buildToolsVersion "30.0.2"

	    defaultConfig {
	        targetSdkVersion 30
	    }
	}

2. پیکربندی فعالیت

<activity
 	  Android:name=".bubbles.BubbleActivity"
	  Android:theme="@style/AppTheme.NoActionBar"
	  Android:label="@string/title_activity_bubble"
 	  Android:allowEmbedded="true"
 	  Android:resizeableActivity="true"
	/>

• این فعالیت به صورت یک حباب نمایش داده می شود و باید قابلیت تغییر اندازه و جاسازی را داشته باشد.
• بنابراین در اندروید 10، اعلان‌ها به صورت حباب ظاهر نمی‌شوند مگر اینکه documentLaunchMode = “همیشه” را در فایل مانیفست تنظیم کنید. با این حال، در اندروید 11 نیازی به تنظیم این مقدار نیست، زیرا سیستم به طور خودکار documentLaunchMode را برای همه تماس‌ها روی «همیشه» تنظیم می‌کند.

3. نیت ایجاد کنید

• برای پیمایش فعالیت حباب باید یک PendingIntent ایجاد کنیم.

val screen = Intent(context, BubblesActivity::class.java)
val bubbleInt = PendingIntent.getActivity(context, 0, screen, 0 )

4. ابرداده ایجاد کنید

• ما باید ابرداده ایجاد کنیم و کسی پیام را منتقل کند.

Val bubbleData=Notification.BubbleMetadata.Builder(bubbleInt ,
 Icon.createWithResource(context, R.drawable.icon))
.setAutoExpandBubble(true)
.setDesiredHeight(600).build()

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

5. خلق شخصیت

• ما باید یک شی شخص با اطلاعات شریک چت ایجاد کنیم.

val chatPartner = Person.Builder()
    	.setName("Chat partner")
            .setImportant(true)
   	.build()

6. یک میانبر ایجاد کنید

val shortcut =ShortcutInfo.Builder(mContext, shortcutId)
      	.setIntent(Intent(Intent.ACTION_DEFAULT))
     	.setLongLived(true)
      	.setShortLabel(chatPartner.name)
      	.build()

8. یک اعلان ایجاد کنید

• در نهایت اعلان را ایجاد کرده و با استفاده از متد setBubbleMetadata، متادیتا را تنظیم کنید.

val builder = Notification.Builder(context, CHANNEL_ID)
    	  .setContentIntent(contentIntent)
    	  .setSmallIcon(smallIcon)
    	  .setBubbleMetadata(bubbleData)
    	  .setShortcutId(shortcutId)
    	  .addPerson(chatPartner)

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

with(builder) {
   		   setContentTitle("New message")
 		   setSmallIcon(R.drawable.ic_stat_notification)
 		   setCategory(Notification.CATEGORY_MESSAGE)
   		  setContentIntent(
      		  PendingIntent.getActivity(   context,    0,
            	  Intent(context, MainActivity::class.java),
           		   PendingIntent.FLAG_UPDATE_CURRENT
      		  )
    		)
	}
//then call the notification manager to send it
	notificationManager.notify(MY_NOTIFICATION, builder.build())

نتیجه

با دنبال کردن مراحل بالا، یاد خواهید گرفت که چگونه به درستی اعلان های سبک بالون را در برنامه خود اعمال کنید. این وبلاگ همچنین نکات مهمی را که باید هنگام اجرای اعلان‌های حباب به خاطر داشت، برجسته کرد. اگر در مورد این موضوع شک دارید، لطفاً نظر خود را دریغ نکنید و مهندسان DEV IT ما با شما تماس خواهند گرفت.

راهنمای توسعه‌دهنده انتشارات برای استقرار Bubble API در یک برنامه اندروید برای اولین بار در مجله DEV IT ظاهر شد.