تقطيع شبكة 5G

بالنسبة للأجهزة التي تعمل بنظام Android 12 أو أعلى، يوفر Android دعمًا لتقطيع شبكة 5G، واستخدام المحاكاة الافتراضية للشبكة لتقسيم اتصالات الشبكة الفردية إلى اتصالات افتراضية متعددة ومتميزة توفر كميات مختلفة من الموارد لأنواع مختلفة من حركة المرور. يسمح تقطيع شبكة 5G لمشغلي الشبكات بتخصيص جزء من الشبكة لتوفير ميزات محددة لشريحة معينة من العملاء. يقدم Android 12 إمكانات تقطيع شبكات 5G للمؤسسات التالية، والتي يمكن لمشغلي الشبكات توفيرها لعملائهم من المؤسسات:

تقطيع جهاز المؤسسة للأجهزة المُدارة بالكامل

بالنسبة للمؤسسات التي توفر أجهزة الشركة المُدارة بالكامل لموظفيها، يمكن لموفري الشبكات تزويدهم بواحدة أو أكثر من شرائح شبكة المؤسسة النشطة حيث يتم توجيه حركة المرور على أجهزة الشركة إليها. بدءًا من Android 12، يسمح Android لشركات الاتصالات بتوفير شرائح المؤسسة من خلال قواعد URSP، بدلاً من إعداد الشرائح من خلال شبكات APN.

تقسيم تطبيقات الأعمال للمؤسسات للأجهزة التي تحتوي على ملفات شخصية للعمل

بالنسبة للمؤسسات التي تستخدم حل الملف الشخصي للعمل ، يسمح Android 12 للأجهزة بتوجيه حركة المرور من جميع التطبيقات في الملف الشخصي للعمل إلى شريحة شبكة المؤسسة. يمكن للمؤسسات تمكين هذه الإمكانية من خلال وحدة تحكم سياسة الجهاز (DPC) .

يوفر حل ملف تعريف العمل مستوى تلقائياً من المصادقة والتحكم في الوصول الذي تحتاجه المؤسسات لضمان توجيه حركة المرور من تطبيقات المؤسسة في ملف تعريف العمل فقط إلى شريحة شبكة المؤسسة. لا يلزم تعديل التطبيقات الموجودة في الملف الشخصي للعمل لطلب شريحة شبكة المؤسسة بشكل صريح.

كيف يعمل تقطيع شبكة 5G في AOSP

يقدم Android 12 دعمًا لتقطيع شبكة 5G من خلال الإضافات إلى قاعدة بيانات الهاتف في AOSP ووحدة الربط لدمج واجهات برمجة تطبيقات الاتصال الحالية المطلوبة لتقطيع الشبكة.

توفر منصة الاتصال الهاتفي التي تعمل بنظام Android HAL وواجهات برمجة التطبيقات الهاتفية لدعم التقطيع بناءً على طلبات الشبكة المقدمة بواسطة كود الشبكة الأساسي وإمكانيات التقطيع 5G في المودم. يصف الشكل 1 مكونات ميزة تقطيع شبكة 5G.

الشكل 1. بنية تشريح شبكة 5G في AOSP.

تدعم منصة الهاتف والاتصال:

• تحويل طلبات الشبكة لفئات الشرائح إلى واصفات حركة المرور والتي يتم تمريرها بعد ذلك إلى المودم لمطابقة حركة مرور URSP واختيار المسار
• الرجوع إلى الشبكة الافتراضية في حالة عدم توفر شريحة شبكة المؤسسة
• توجيه حركة المرور من جميع التطبيقات ضمن الملف الشخصي للعمل إلى الاتصال المقابل

• دعم تقطيع المؤسسات

  • اكتشاف وجود ملف تعريف العمل على الجهاز
  • التحقق من الأذونات أو توجيهات التوجيه المقدمة من DPC التي يستخدمها مسؤول تكنولوجيا المعلومات في المؤسسة

تتضمن خدمة الشبكة الأساسية التغييرات التالية على وحدة التوصيل في Android 12:

• يضيف معظم فئات android.net.* العامة أو واجهة برمجة تطبيقات النظام إلى وحدة الربط

• يوسع حدود وحدة الربط لتشمل:

  • f/b/core/java/android/net/…
  • f/b/services/net/…
  • f/b/services/core/java/com/android/server/connectivity/…
  • f/b/services/core/java/com/android/server/ConnectivityService.java
  • f/b/services/core/java/com/android/server/TestNetworkService.java

• ينقل رمز VPN خارج وحدة الربط

يقوم Android 12 بنقل التعليمات البرمجية ذات الإمكانات التالية إلى وحدة الربط:

• تلقي الطلبات من التطبيقات لاتصالات الشبكة
• تلقي الطلبات من النظام (على سبيل المثال، "وضع هذه التطبيقات على شريحة مؤسسة"؛ المقدمة في Android 12)
• إرسال الطلبات من النظام إلى رمز الهاتف الذي يحاول إنشاء شبكات أو شرائح من خلال المرور عبر HAL API والمودم
• إعلام netd بكيفية توجيه حركة المرور على أساس كل تطبيق (مقدم في Android 12)
• إعلام التطبيقات بما يحدث لحركة مرور الشبكة من خلال واجهات برمجة تطبيقات ConnectivityManager مثل NetworkCallback و getActiveNetwork و getNetworkCapabilities .

تطبيق

لدعم تقطيع 5G على الجهاز، يجب أن يحتوي الجهاز على مودم يدعم IRadio 1.6 HAL الذي يحتوي على setupDataCall_1_6 API. تقوم واجهة برمجة التطبيقات هذه بإعداد اتصال بيانات وتتضمن المعلمات التالية لدعم تقطيع 5G:

• trafficDescriptor : يحدد واصف حركة المرور المرسلة إلى المودم
• sliceInfo : يحدد المعلومات الخاصة بشريحة الشبكة التي سيتم استخدامها في حالة تسليم EPDG إلى 5G
• matchAllRuleAllowed : يحدد ما إذا كان استخدام قاعدة URSP الافتراضية لمطابقة الكل مسموحًا به. تقوم المهاتفة بتعيين هذا على true للشبكات الافتراضية ولكن ليس للشرائح. يتم تطبيق قاعدة مطابقة الكل على الشبكات الافتراضية. عندما يطلب أحد التطبيقات شريحة معينة غير متوفرة، يتم الإبلاغ عن الشريحة المحددة على أنها غير متوفرة. بالنسبة لتطبيقات المؤسسة، يمكن أن يعود إطار عمل الاتصال الهاتفي إلى الشبكة الافتراضية إذا لم تكن شبكة المؤسسة متوفرة.

يجب أن تقوم أجهزة المودم أيضًا بتنفيذ واجهة برمجة تطبيقات getSlicingConfig ما لم يتم الإبلاغ عن أنها غير مدعومة بواسطة واجهة برمجة تطبيقات getHalDeviceCapabilities .

متطلبات المؤسسة

يوضح ما يلي متطلبات المؤسسات لاستخدام تقسيم شبكة 5G على الأجهزة في نشر مؤسسة Android.

• تأكد من أن الأجهزة المُدارة بالكامل أو أجهزة الموظفين التي تم إعدادها باستخدام ملف شخصي للعمل تدعم شبكة 5G SA مع أجهزة مودم تدعم واجهة برمجة تطبيقات setupDataCall_1_6 .
• اعمل مع شريك الناقل على إعداد الشريحة والأداء أو خصائص SLA.

تفعيل شرائح 5G على الأجهزة التي تم إعدادها باستخدام ملف شخصي للعمل

بالنسبة للأجهزة التي تم إعدادها باستخدام الملفات الشخصية للعمل، يتم إيقاف تقطيع شبكة 5G افتراضيًا في AOSP. لتمكين تقسيم الشبكة، يمكن لمسؤولي تكنولوجيا المعلومات في المؤسسة تشغيل أو إيقاف تشغيل توجيه حركة مرور تطبيق الملف الشخصي للعمل إلى شريحة شبكة المؤسسة على أساس كل موظف من خلال EMM DPC، والذي يستخدم أسلوب setPreferentialNetworkServiceEnabled في واجهة برمجة تطبيقات DevicePolicyManager (DPM) (المقدمة في Android 12).

يجب على موردي EMM الذين لديهم DPCs مخصصة دمج واجهة برمجة تطبيقات DevicePolicyManager لدعم عملاء المؤسسات.

قواعد URSP

يتضمن هذا القسم معلومات لشركات الاتصالات حول تكوين قواعد URSP لفئات الشرائح المختلفة بما في ذلك المؤسسة، وCBS، وزمن الوصول المنخفض، وحركة مرور النطاق الترددي العالي. عند تكوين قواعد URSP لفئات شرائح مختلفة، يجب على شركات الاتصالات استخدام القيم التالية الخاصة بنظام Android.

بطاقة تعريف	قيمة	وصف
معرف OSId	97a498e3-fc92-5c94-8986-0333d06e4e47	OSId لنظام Android هو الإصدار 5 من UUID الذي تم إنشاؤه باستخدام مساحة الاسم ISO OID والاسم "Android".

يجب على شركات الاتصالات تكوين قواعد URSP لكل حركة مرور شريحة باستخدام مكون واصف حركة المرور كـ "نوع معرف نظام التشغيل + معرف تطبيق نظام التشغيل". على سبيل المثال، يجب أن تحتوي شريحة "ENTERPRISE" على قيمة 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345 . هذه القيمة عبارة عن سلسلة من OSId وطول OSAppId ( 0x0A ) وOSAppId. لمزيد من المعلومات حول نوع مكون واصف الحركة، راجع الجدول 3GPP TS 24.526 5.2.1 .

يصف الجدول التالي قيم OSAppId لفئات الشرائح المختلفة.

فئة شريحة	OSAppId	وصف
مَشرُوع	0x454E5445525052495345	OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE"
المؤسسة2	0x454E544552505249534532	OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE2"
المؤسسة3	0x454E544552505249534533	OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE3"
المؤسسة4	0x454E544552505249534534	OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE4"
المؤسسة5	0x454E544552505249534535	OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE5"
سي بي اس	0x434253	OSAppId هو تمثيل صفيف بايت للسلسلة "CBS"
PRIORITIZE_LATENCY	0x5052494f524954495a455f4c4154454e4359	OSAppId عبارة عن تمثيل لصفيف بايت للسلسلة "PRIORITIZE_LATENCY"
PRIORITIZE_BANDWIDTH	0x5052494f524954495a455f42414e445749445448	OSAppId هو تمثيل صفيف بايت للسلسلة "PRIORITIZE_BANDWIDTH"

مثال لقواعد URSP

تعرض الجداول التالية أمثلة لقواعد URSP للمؤسسات وCBS وزمن الوصول المنخفض وعرض النطاق الترددي العالي وحركة المرور الافتراضية.

المؤسسة 1

يتوفر دعم Enterprise 1 في نظام التشغيل Android 12 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة مرور ENTERPRISE1:

قاعدة URSP رقم 1 (المؤسسة 1)
الأولوية	1 (0x01)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	مَشرُوع
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	مَشرُوع

المؤسسة 2

يتوفر دعم Enterprise 2 في Android 13 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة مرور ENTERPRISE2:

قاعدة URSP رقم 2 (المؤسسة 2)
الأولوية	2 (0x02)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	0x97A498E3FC925C9489860333D06E4E470B454E544552505249534532
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	Enterprise2
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	Enterprise2

المؤسسة 3

يتوفر دعم Enterprise 3 في Android 13 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة مرور ENTERPRISE3:

قاعدة URSP رقم 3 (المؤسسة 3)
الأولوية	3 (0x03)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	0x97A498E3FC925C9489860333D06E4E470B454E544552505249534533
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	Enterprise3
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	Enterprise3

المؤسسة 4

يتوفر دعم Enterprise 4 في Android 13 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة مرور ENTERPRISE4:

قاعدة URSP رقم 4 (المؤسسة 4)
الأولوية	4 (0x04)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	0x97A498E3FC925C9489860333D06E4E470B454E544552505249534534
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	Enterprise4
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	Enterprise4

المؤسسة 5

يتوفر دعم Enterprise 5 في Android 13 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة مرور ENTERPRISE5:

قاعدة URSP رقم 5 (المؤسسة 5)
الأولوية	5 (0x05)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	0x97A498E3FC925C9489860333D06E4E470B454E544552505249534535
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	Enterprise5
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	Enterprise5

سي بي اس

يتوفر دعم CBS في Android 13 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة مرور CBS:

قاعدة URSP رقم 6 (CBS)
الأولوية	6 (0x06)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	0x97A498E3FC925C9489860333D06E4E4703434253
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	cbs
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	cbs

قليل من الكمون

يتوفر دعم زمن الاستجابة المنخفض في Android 13 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة المرور LOW_LATENCY:

قاعدة URSP رقم 7 (زمن الوصول المنخفض)
الأولوية	7 (0x07)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	0x97A498E3FC925C9489860333D06E4E47125052494f524954495a455f4c4154454e4359
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	وقت الإستجابة
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	وقت الإستجابة

عرض النطاق الترددي العالي

يتوفر دعم النطاق الترددي العالي في Android 13 والإصدارات الأحدث. فيما يلي مثال لقاعدة URSP لحركة المرور ذات النطاق العالي HIGH_BANDWIDTH:

قاعدة URSP رقم 8 (النطاق الترددي العالي)
الأولوية	8 (0x08)
واصف حركة المرور رقم 1
معرف نظام التشغيل + نوع معرف تطبيق نظام التشغيل	97A498E3FC925C9489860333D06E4E47145052494f524954495a455f42414e445749445448
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY
المكون رقم 2: DNN	عرض النطاق
واصف اختيار المسار رقم 2
الأولوية	2 (0x02)
المكون رقم 1: DNN	عرض النطاق

تقصير

قاعدة URSP رقم 9 (افتراضي)
الأولوية	9 (0x09)
واصف حركة المرور رقم 1
مطابقة الكل	لا يوجد
واصف اختيار المسار رقم 1
الأولوية	1 (0x01)
المكون رقم 1: S-NSSAI	SST:XX SD:YYYYYY

اختبارات

لاختبار تقطيع شبكة 5G، استخدم الاختبار اليدوي التالي.

لإعداد جهاز للاختبار، قم بما يلي:

1. تأكد من تكوين سياسة URSP بقاعدة غير افتراضية تتطابق مع فئة المؤسسة وأن واصف اختيار المسار المقابل يعين فئة المؤسسة إلى شريحة المؤسسة؛ وقاعدة افتراضية لتوجيه حركة المرور إلى شريحة الإنترنت الافتراضية.

2. تأكد من تكوين الملف الشخصي للعمل على الجهاز.

3. قم بالاشتراك في استخدام تقطيع الشبكة من خلال DPC

لاختبار سلوك تقسيم شبكة 5G، قم بما يلي:

1. تحقق من إنشاء جلسة PDU باستخدام شريحة المؤسسة (على سبيل المثال، باستخدام عنوان IP محدد) وأن التطبيقات الموجودة في ملف تعريف العمل تستخدم جلسة PDU تلك.
2. تحقق من إنشاء جلسة PDU منفصلة باستخدام شريحة الإنترنت الافتراضية وأن التطبيقات الموجودة في ملف التعريف الشخصي تستخدم جلسة PDU.

تقطيع 5G للبيع

تتيح ميزة بيع شرائح 5G، المتوفرة في Android 14-QPR1، لشركات الاتصالات تقديم إمكانات شبكة محسنة (زمن الاستجابة وعرض النطاق الترددي) لمستخدميها من خلال تقطيع شبكة 5G.

تستخدم ميزة بيع شرائح 5G استجابة TS.43 من خادم استحقاق الناقل لتوجيه تدفق الشراء. يمكن لشركات الاتصالات استخدام الاستجابة لتحديد عنوان URL لعرض ويب الشراء الخاص بشركة الاتصالات، وإرسال بيانات إضافية إلى عرض الويب، والإشارة إلى ما إذا كانت الشريحة متوفرة ومتاحة على شبكة شركة النقل.

يمكن لشركات الاتصالات تخصيص سلوك ميزة بيع شرائح 5G باستخدام تكوينات شركة الاتصالات، والتي تتحكم في إمكانية تقديم طلبات الشراء، ومتى يُسمح للتطبيقات بطلب إمكانات متميزة، ومدة انتظار إطار عمل الاتصال الهاتفي للاستجابات من المستخدم أو الشبكة.

توفر ميزة بيع شرائح 5G واجهة تسمى DataBoostWebServiceFlow ، للسماح بالاتصال بين Android وعرض الويب الخاص بمشغل شبكة الجوال.

يوضح الشكل 2 تدفق شراء شرائح 5G:

الشكل 2. تقسيم تدفق الشراء عبر شبكات الجيل الخامس 5G.

عملية الاستحقاق TS.43

عندما يقوم مستخدم بتقديم طلب للحصول على إمكانات الشبكة المحسنة، يطلب إطار عمل الاتصال الهاتفي تكوين استحقاق الخدمة للقدرة المميزة المطلوبة. إذا كانت استجابة TS.43 صالحة، يستخدم إطار عمل الاتصال الهاتفي الحقول من استجابة HTTP لتوجيه طلب الشراء.

شريحة حقول الشراء

يتضمن تكوين استحقاق TS.43 حقول شراء الشرائح التالية:

حالة الاستحقاق

المفتاح: EntitlementStatus

النوع: int

القيم المدعومة: 0 (معطل)، 1 (ممكّن)، 2 (غير متوافق)، 3 (التزويد)، 4 (مضمن)

حالة التزويد

المفتاح: ProvStatus

النوع: int

القيم المدعومة: 0 (غير متوفر)، 1 (متوفر)، 2 (غير متوفر)، 3 (قيد التقدم)

يستخدم إطار عمل الاتصال الهاتفي مزيجًا من حالة الاستحقاق وحالة التوفير لتحديد حالة شراء الشريحة الحالية. يمكن أن تكون النتيجة واحدة مما يلي:

• PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED
• PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_IN_PROGRESS
• PURCHASE_PREMIUM_CAPABILITY_RESULT_ENTITLEMENT_CHECK_FAILED
• PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_ERROR

إذا كانت حالة الاستحقاق هي 1 (ممكّنة) وحالة التوفير هي 0 (غير متوفرة)، فسيعرض إطار عمل الاتصال الهاتفي إشعارًا بالزيادة إلى المستخدم لشراء التعزيز من خلال عرض الويب الخاص بشركة الاتصالات. يصف الجدول التالي سلوك إطار عمل الاتصال الهاتفي لمجموعات مختلفة من قيم حالة التوفير والاستحقاق.

		حالة التزويد
		غير متوفر ( 0 )	المخصص ( 1 ) 1 )	غير متاح ( 2 )	قيد التقدم ( 3 )
حالة الاستحقاق	معطل ( 0 )	فشل	فشل	فشل	فشل
	ممكن ( 1 )	عرض عرض الويب	مباع	مباع	في تَقَدم
	غير متوافق ( 2 )	فشل	فشل	فشل	فشل
	التزويد ( 3 )	خطأ الناقل	خطأ الناقل	في تَقَدم	في تَقَدم
	متضمن ( 4 )	خطأ الناقل	مباع	مباع	خطأ الناقل

مجالات تدفق الخدمة

تحدد استجابة TS.43 عنوان URL وبيانات المستخدم ونوع المحتويات لتخصيص سلوك عرض الويب لشراء شركة الاتصالات. إذا كان نوع المحتويات غير محدد، فسيتم تحميل عنوان URL كطلب GET. إذا كانت بيانات المستخدم موجودة، فسيتم إلحاقها بعنوان URL كمعلمة استعلام (على سبيل المثال، https://www.android.com?encodedValue=Base64EncodedUserData ); وإذا لم يكن موجودًا، فسيتم استخدام عنوان URL كما هو (على سبيل المثال، https://www.android.com ).
إذا تم تحديد نوع المحتويات بتنسيق JSON أو XML، فسيتم تحميل عنوان URL كطلب POST، ويتم إرسال بيانات المستخدم (التي تم فك تشفيرها إذا تم ترميزها في Base 64) كبيانات لطلب POST.

عنوان URL

المفتاح: ServiceFlow_URL

النوع: String

مثال: "https://www.android.com"

بيانات المستخدم

المفتاح: ServiceFlow_UserData

النوع: String

مثال: "encodedValue=Base64EncodedUserData"

نوع المحتويات

المفتاح: ServiceFlow_ContentsType

النوع: String

القيم المدعومة: 0 (غير محدد)، 1 (JSON)، 2 (XML)

تكوينات الناقل

فيما يلي تكوينات شركة الاتصالات المتاحة لتخصيص سلوك ميزة بيع شرائح 5G.

KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAY

قائمة بالإمكانيات المتميزة المدعومة. هذه مصفوفة int من TelephonyManager.PremiumCapability . تشترك هذه الإمكانات المتميزة في نفس القيمة مثل فئة NetworkCapabilities.NetCapability المقابلة. إذا تم طلب إمكانية مميزة ولم يتم تضمينها في هذا التكوين، فسيفشل طلب الشراء مع نتيجة CARRIER_DISABLED .

في Android 14، لا يتم دعم سوى PREMIUM_CAPABILITY_PRIORITIZE_LATENCY .

KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INT

الحد الأقصى اليومي لعدد مرات ظهور إشعار زيادة المبيعات للمستخدم. إذا تم استيفاء الحد الأقصى اليومي، فلن يظهر إشعار زيادة البيع وسيتم تقييد طلبات الشراء (بما في ذلك طلبات خادم الاستحقاق) حتى منتصف ليل اليوم التالي. تفشل طلبات الشراء التي تم إجراؤها بعد الوصول إلى الحد الأقصى اليومي بنتيجة PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED .

KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INT

الحد الأقصى الشهري لعدد المرات التي يظهر فيها إشعار زيادة المبيعات للمستخدم. إذا تم استيفاء الحد الأقصى الشهري، فلن يظهر إشعار زيادة المبيعات وسيتم تقييد طلبات الشراء (بما في ذلك طلبات خادم الاستحقاق) حتى اليوم الأول من الشهر التالي. تفشل طلبات الشراء التي تم إجراؤها بعد الوصول إلى الحد الأقصى الشهري مع نتيجة PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED .

KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRING

عنوان URL لشراء شركة النقل الاحتياطية الذي سيتم عرضه للمستخدم عند النقر فوق إشعار البيع. إذا لم يتم العثور على عنوان URL للشراء في استجابة TS.43 من خادم الاستحقاق، فسيتم استخدام هذه القيمة بدلاً من ذلك. إذا لم يكن عنوان URL من استجابة TS.43 أو تكوين شركة الاتصالات صالحًا، فسيفشل طلب الشراء مع نتيجة PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED .

KEY_PREMIUM_CAPABILITY_SUPPORTED_ON_LTE_BOOL

ما إذا كان سيتم السماح بشراء الإمكانات المتميزة عندما يكون الجهاز متصلاً بشبكة Long-Term Evolution (LTE). إذا true ، فيمكن تقديم طلبات الشراء على كل من LTE وNew Radio (NR). إذا كان false ، فلا يمكن إجراء طلبات الشراء إلا على NR وتفشل الطلبات المقدمة على LTE مع نتيجة PURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE .

KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG

مقدار الوقت المطلوب لعرض إشعار زيادة مبيعات الشراء للمستخدم قبل أن يتم إلغاؤه تلقائيًا. عند إلغاء الإشعار، يتم تقييد الطلبات اللاحقة وتفشل مع نتيجة PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED .

KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG

مقدار الوقت الذي يجب أن يتم فيه التحكم في طلبات الشراء اللاحقة بعد الفشل بسبب انتهاء المهلة أو إلغاء المستخدم. إذا لم ينقر المستخدم على إشعار زيادة مبيعات الشراء خلال المهلة المحددة بواسطة KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG أو إذا قام بإلغاء الإشعار أو رفضه، فسيبدأ مؤقت التراجع هذا. أثناء تنشيط هذا المؤقت، تفشل طلبات الشراء بنتيجة PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED .

KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONG

مقدار الوقت الذي يجب أن يتم فيه التحكم في طلبات الشراء اللاحقة بعد الفشل بسبب شركة الاتصالات أو الشبكة. إذا فشل التحقق من الاستحقاق، أو كان عنوان URL غير متاح، أو كان عنوان URL لشراء شركة النقل يشير إلى فشل، فسيبدأ مؤقت التراجع هذا. أثناء تنشيط هذا المؤقت، تفشل طلبات الشراء بنتيجة PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED .

KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONG

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

واجهة جافا سكريبت

عندما ينقر المستخدم على إشعار تعزيز الشبكة، يظهر للمستخدم كائن WebView مع عنوان URL لشراء شركة الاتصالات. يمكن لشركات النقل استخدام واجهات برمجة التطبيقات المتوفرة في واجهة DataBoostWebServiceFlow Javascript في موقع الشراء الخاص بهم للتواصل مع تطبيق شراء الشرائح.

يمكن لموقع الويب الخاص بشركة الاتصالات الحصول على الإمكانية المتميزة المطلوبة من خلال الطريقة getRequestedCapability() .

إذا نجحت عملية الشراء، فيجب على موقع الويب الخاص بشركة النقل إخطار تطبيق شراء الشريحة من خلال notifyPurchaseSuccessful() أو notifyPurchaseSuccessful(duration) حيث تكون duration معلمة اختيارية تشير إلى المدة المقصودة للشريحة.

إذا لم تنجح عملية الشراء، فيجب على موقع الناقل إخطار تطبيق شراء الشريحة من خلال الطريقة notifyPurchaseFailed(code, reason) ، حيث code هو رمز الفشل الذي يشير إلى سبب الفشل reason هو سبب الفشل الذي يمكن قراءته بواسطة الإنسان إذا كانت عملية الشراء غير ناجحة. رمز الفشل غير معروف.

إذا لم يتم استدعاء أي من طرق الاستجابة هذه، فلن يتم اعتبار عملية الشراء مكتملة وستنتهي مهلة طلب الشراء في النهاية.

فيما يلي رموز الفشل الصالحة التي يمكن لموقع الويب الخاص بشركة النقل إرجاعها في حالة فشل الشراء:

• FAILURE_CODE_UNKNOWN
• FAILURE_CODE_CARRIER_URL_UNAVAILABLE
• FAILURE_CODE_AUTHENTICATION_FAILED
• FAILURE_CODE_PAYMENT_FAILED
• FAILURE_CODE_NO_USER_DATA

عند اكتمال عملية الشراء، يجب على شركة النقل تحديث قواعد URSP بشريحة PRIORITIZE_LATENCY لجهاز المستخدم.