بالنسبة للأجهزة التي تعمل بنظام 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، استخدم الاختبار اليدوي التالي.
لإعداد جهاز للاختبار، قم بما يلي:
تأكد من تكوين سياسة URSP بقاعدة غير افتراضية تتطابق مع فئة المؤسسة وأن واصف اختيار المسار المقابل يعين فئة المؤسسة إلى شريحة المؤسسة؛ وقاعدة افتراضية لتوجيه حركة المرور إلى شريحة الإنترنت الافتراضية.
تأكد من تكوين الملف الشخصي للعمل على الجهاز.
قم بالاشتراك في استخدام تقطيع الشبكة من خلال DPC
لاختبار سلوك تقسيم شبكة 5G، قم بما يلي:
- تحقق من إنشاء جلسة PDU باستخدام شريحة المؤسسة (على سبيل المثال، باستخدام عنوان IP محدد) وأن التطبيقات الموجودة في ملف تعريف العمل تستخدم جلسة PDU تلك.
- تحقق من إنشاء جلسة 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
لجهاز المستخدم.