تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

إنشاء تنسيق إشعارات مخصص

لضمان ظهور إشعاراتك بأفضل شكل على مختلف إصدارات Android، استخدِم نموذج الإشعارات العادي لإنشاء إشعاراتك. إذا أردت تقديم المزيد من المحتوى في إشعارك، ننصحك باستخدام أحد نماذج الإشعارات القابلة للتوسيع.

في حال عدم تلبية النماذج التي يوفّرها النظام لاحتياجاتك، يمكنك استخدام تنسيقك الخاص للإشعار.

**تنبيه:** عند استخدام تنسيق إشعار مخصّص، احرص على التأكّد من أنّه يعمل مع مختلف اتجاهات الأجهزة ودقّاتها. على الرغم من أنّ هذه النصيحة تنطبق على جميع تنسيقات واجهة المستخدم، إلا أنّها مهمة بشكل خاص للإشعارات لأنّ المساحة في لوحة الإشعارات محدودة. يعتمد الارتفاع المتاح لتنسيق الإشعار المخصّص على إصدار Android. في بعض الإصدارات، تقتصر تنسيقات العرض المصغّر على 48 وحدة بكسل مستقلة الكثافة على الأقل، وتقتصر تنسيقات العرض المنبثق على 88 وحدة بكسل مستقلة الكثافة على الأقل، وتقتصر تنسيقات العرض الموسّع على 252 وحدة بكسل مستقلة الكثافة على الأقل.

إنشاء تنسيق مخصّص لمنطقة المحتوى

إذا كنت بحاجة إلى تنسيق مخصّص، يمكنك تطبيق NotificationCompat.DecoratedCustomViewStyle على إشعارك. تتيح لك واجهة برمجة التطبيقات هذه توفير تنسيق مخصّص لمنطقة المحتوى التي يشغلها عادةً العنوان والمحتوى النصي، مع الاستمرار في استخدام الزخارف التي يوفّرها النظام لرمز الإشعار والطابع الزمني والنص الفرعي وأزرار الإجراءات.

تعمل واجهة برمجة التطبيقات هذه بطريقة مشابهة لـ نماذج الإشعارات القابلة للتوسيع من خلال الاعتماد على تنسيق الإشعار الأساسي على النحو التالي:

أنشِئ إشعارًا أساسيًا باستخدام NotificationCompat.Builder.
استدعِ setStyle()، مع تمرير مثيل من NotificationCompat.DecoratedCustomViewStyle إليه.
وسِّع تنسيقك المخصّص كمثيل من RemoteViews.
استدعِ setCustomContentView() لضبط التنسيق للإشعار المصغّر.
يمكنك اختياريًا استدعاء setCustomBigContentView() أيضًا لضبط تنسيق مختلف للإشعار الموسّع.

إعداد التنسيقات

تحتاج إلى تنسيق small وآخر large. في هذا المثال، قد يبدو التنسيق smalllayout على النحو التالي:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:text="Small notification, showing only a title" />
</LinearLayout>notification_small.xml

وقد يبدو التنسيق large على النحو التالي:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="300dp"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="Large notification, showing a title and a body." />

    <TextView
        android:id="@+id/notification_body"
        style="@style/TextAppearance.Compat.Notification.Line2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="This is the body. The height is manually forced to 300dp." />
</LinearLayout>notification_large.xml

إنشاء الإشعار وعرضه

بعد أن تصبح التنسيقات جاهزة، يمكنك استخدامها كما هو موضّح في المثال التالي:

val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

// Get the layouts to use in the custom notification.
val notificationLayout = RemoteViews(packageName, R.layout.notification_small)
val notificationLayoutExpanded = RemoteViews(packageName, R.layout.notification_large)

// Apply the layouts to the notification.
val customNotification = NotificationCompat.Builder(context, CHANNEL_ID)
    .setSmallIcon(R.drawable.notification_icon)
    .setStyle(NotificationCompat.DecoratedCustomViewStyle())
    .setCustomContentView(notificationLayout)
    .setCustomBigContentView(notificationLayoutExpanded)
    .build()

notificationManager.notify(666, customNotification)CustomNotification.kt

يُرجى العِلم أنّ لون خلفية الإشعار يمكن أن يختلف باختلاف الأجهزة والإصدارات. طبِّق أنماط مكتبة الدعم، مثل TextAppearance_Compat_Notification للنص و TextAppearance_Compat_Notification_Title للعنوان في تنسيقك المخصّص، كما هو موضّح في المثال التالي. تتكيّف هذه الأنماط مع اختلافات الألوان حتى لا يظهر النص باللون الأسود على خلفية سوداء أو باللون الأبيض على خلفية بيضاء.

<TextView
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:layout_weight="1"
    android:text="@string/notification_title"
    android:id="@+id/notification_title"
    style="@style/TextAppearance.Compat.Notification.Title" />

تجنَّب ضبط صورة خلفية على عنصر RemoteViews، لأنّ ذلك قد يجعل النص غير قابل للقراءة.

عندما يتم عرض إشعار أثناء استخدام المستخدم لتطبيق، تكون النتيجة مشابهة للشكل 1:

طريقة عرض مصغّرة لإشعار مخصّص — **الشكل 1.** يظهر تنسيق إشعار صغير أثناء استخدام تطبيقات أخرى.

يؤدي النقر على سهم التوسيع إلى توسيع الإشعار، كما هو موضّح في الشكل 2:

توسيع طريقة عرض الإشعارات المخصّصة — **الشكل 2.** يظهر تنسيق إشعار كبير أثناء استخدام تطبيقات أخرى.

بعد انتهاء مهلة الإشعار، لا يظهر الإشعار إلا في شريط النظام، الذي يبدو مشابهًا للشكل 3:

إشعار مصغّر في شريط النظام — **الشكل 3.** كيف يظهر تنسيق الإشعار الصغير في شريط النظام

يؤدي النقر على سهم التوسيع إلى توسيع الإشعار، كما هو موضّح في الشكل 4:

إشعار موسّع في شريط النظام — **الشكل 4.** يظهر تنسيق إشعار كبير في شريط النظام.

إنشاء تنسيق إشعار مخصّص بالكامل

إذا لم تكن تريد تزيين إشعارك برمز الإشعار العادي والعنوان، اتّبِع الخطوات السابقة ولكن لا تستدعِ setStyle().