بالنسبة إلى الأجهزة التي تعمل بالإصدار 12 من نظام Android أو إصدار أحدث، يقدّم نظام Android دعمًا لتقسيم شبكة الجيل الخامس، وهو استخدام تقنية المحاكاة الافتراضية للشبكة بهدف تقسيم اتصالات الشبكة الفردية إلى اتصالات افتراضية متعددة ومميّزة توفّر كميات مختلفة من الموارد لأنواع مختلفة من حركة المرور. تتيح تقنية "تقسيم شبكة الجيل الخامس" لمشغّلي الشبكة تخصيص جزء من الشبكة لتوفير ميزات معيّنة لفئة معيّنة من العملاء. يوفّر Android 12 الإمكانات التالية لترقيع شبكات الجيل الخامس للمؤسسات، والتي يمكن لمشغّلي الشبكات توفيرها لعملائهم من المؤسسات:
تقسيم الأجهزة في المؤسسات للأجهزة المُدارة بالكامل
بالنسبة إلى المؤسسات التي توفّر أجهزة الشركة مُدارة بالكامل لموظفيها، يمكن لموفّري الشبكات تزويدهم بشريحة واحدة أو أكثر من شرائح شبكة المؤسسات النشطة، حيث يتم توجيه حركة البيانات على أجهزة الشركة. اعتبارًا من Android 12، يسمح Android لمشغّلي شبكات الجوّال بتوفير شرائح المؤسسات من خلال قواعد URSP بدلاً من إعداد الشرائح من خلال نقاط اتصال APN.
تقسيم تطبيقات الأنشطة التجارية للمؤسسات على الأجهزة التي تتضمّن ملفات عمل
بالنسبة إلى المؤسسات التي تستخدم حلول ملف العمل، يتيح نظام التشغيل Android 12 للأجهزة توجيه الزيارات من جميع التطبيقات في ملف العمل إلى شريحة شبكة المؤسسة. يمكن للمؤسسات تفعيل هذه الميزة من خلال وحدة تحكّم في سياسة الجهاز (DPC).
يقدّم حلّ الملف الشخصي للعمل مستوى تلقائيًا من المصادقة والتحكّم في الوصول الذي تتطلّبه المؤسسات لضمان توجيه الزيارات من تطبيقات المؤسسات في الملف الشخصي للعمل فقط إلى شريحة شبكة المؤسسة. لا يلزم تعديل التطبيقات في ملف العمل لطلب شريحة شبكة المؤسسة بشكل صريح.
طريقة تقسيم شبكات الجيل الخامس (AOSP)
يقدّم نظام التشغيل Android 12 ميزة تقسيم شبكة الجيل الخامس من خلال إضافات إلى قاعدة بيانات الهاتف في AOSP ووحدة ربط الأجهزة لدمج واجهات برمجة التطبيقات الحالية للاتصال المطلوبة لتقسيم الشبكة.
توفّر منصة الاتصال الهاتفي في Android واجهات برمجة التطبيقات HAL وواجهات برمجة التطبيقات الخاصة بالاتصالات الهاتفية لدعم ميزة التقطيع استنادًا إلى طلبات الشبكة التي يقدّمها رمز الشبكات الأساسية وإمكانات التقطيع في شبكة الجيل الخامس في المودم. يصف الشكل 1 مكونات ميزة تقسيم شبكة الجيل الخامس.
الشكل 1: بنية تقسيم شبكة الجيل الخامس في 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 ومودم
- إبلاغ netd بكيفية توجيه الزيارات على أساس كل تطبيق (تم تقديمه في Android 12)
- إبلاغ التطبيقات بما يحدث لحركة بيانات شبكتها من خلال
واجهات برمجة تطبيقات
ConnectivityManager
، مثلNetworkCallback
وgetActiveNetwork
getNetworkCapabilities
التنفيذ
لتفعيل ميزة تقسيم شبكة الجيل الخامس على جهاز، يجب أن يكون الجهاز مزوّدًا بمودم متوافق مع IDE لإصدار IRadio 1.6 الذي يتضمّن واجهة برمجة التطبيقات
setupDataCall_1_6
. تعمل واجهة برمجة التطبيقات هذه على إعداد اتصال بيانات وتتضمّن المَعلمات التالية
لتفعيل تقسيم شبكة الجيل الخامس:
trafficDescriptor
: لتحديد وصف حركة المرور المُرسَل إلى المودم-
sliceInfo
: لتحديد معلومات عن شريحة الشبكة التي سيتم استخدامها في حالة تسليم الخدمة من شبكة EPDG إلى شبكة الجيل الخامس matchAllRuleAllowed
: يحدِّد ما إذا كان مسموحًا باستخدام قاعدة URSP تلقائية تتطابق مع جميع الطلبات. تضبط خدمة الهاتف هذا الخيار على "صحيح" للشبكات التلقائية ولكن ليس للشرائح. يتم تطبيق قاعدة المطابقة الكلّية على الشبكات التلقائية. عندما يطلب تطبيق شريحة معيّنة غير متاحة، يتم الإبلاغ عن الشريحة المحدّدة على أنّها غير متاحة. بالنسبة إلى تطبيقات المؤسسات، يمكن أن يعود إطار عمل "الهاتف" إلى الشبكة التلقائية إذا لم تكن شبكة المؤسسة متاحة.
يجب أن تطبّق أجهزة المودم أيضًا واجهة برمجة التطبيقات
getSlicingConfig
ما لم يتم الإبلاغ عن أنّها غير متوافقة مع واجهة برمجة التطبيقات
getHalDeviceCapabilities
.
متطلبات Enterprise
يوضّح ما يلي متطلبات استخدام المؤسسات لميزة "تقسيم شبكة الجيل الخامس" على الأجهزة في عمليات نشر Android للمؤسسات.
- تأكّد من أنّ الأجهزة المُدارة بالكامل أو أجهزة الموظفين التي تم إعدادها باستخدام ملف شخصي للعمل متوافقة مع شبكة 5G SA مع أجهزة المودم التي تتوافق مع واجهة برمجة تطبيقات
setupDataCall_1_6
. - تعاوَن مع شركة نقل شريكة بخصوص إعداد الشرائح وأدائها أو خصائص اتفاقية مستوى الخدمة.
تفعيل تقسيم شبكة الجيل الخامس على الأجهزة التي تم إعدادها باستخدام ملف عمل
بالنسبة إلى الأجهزة التي تم إعدادها باستخدام ملفات العمل، تكون ميزة تقسيم شبكة الجيل الخامس غير مفعَّلة بشكلٍ default في AOSP. لتفعيل تقسيم الشبكات، يمكن لمشرفي تكنولوجيا المعلومات في المؤسسات تفعيل أو إيقاف توجيه زيارات تطبيق ملف العمل إلى شريحة شبكة المؤسسة،
على أساس كل موظف من خلال وحدة التحكّم بسياسة الجهاز لإدارة الخدمات الجوّالة للمؤسسات، والتي تستخدم الطريقة
setPreferentialNetworkServiceEnabled
في واجهة برمجة التطبيقات
DevicePolicyManager
(DPM) (التي تم طرحها في Android 12).
على مورّدي إدارة الخدمات الجوّالة للمؤسسات (EMM) الذين لديهم وحدات التحكّم بسياسة الجهاز (DPC) دمج واجهة برمجة تطبيقات DevicePolicyManager
لدعم عملاء المؤسسات.
قواعد URSP
يتضمّن هذا القسم معلومات لمشغّلي شبكات الجوّال حول ضبط قواعد URSP لفئَات الشرائح المختلفة، بما في ذلك الشرائح المخصّصة للمؤسسات وCBS وشرائح وقت الاستجابة المنخفض وشرائح الزيارات ذات النطاق الترددي العالي. عند ضبط قواعد URSP لفئَات الشرائح المختلفة، على مشغّلي الشبكات استخدام القيم التالية الخاصة بنظام Android.
رقم التعريف | القيمة | الوصف |
---|---|---|
رقم تعريف نظام التشغيل | 97a498e3-fc92-5c94-8986-0333d06e4e47 |
رقم تعريف نظام التشغيل لنظام Android هو رقم تعريف UUID من الإصدار 5 تم إنشاؤه باستخدام مساحة الاسم ISO OID والاسم "Android". |
على مشغّلي شبكات الجوّال ضبط قواعد URSP لكلّ شريحة من الزيارات باستخدام مكوّن وصف الزيارات "رقم تعريف نظام التشغيل + نوع رقم تعريف تطبيق نظام التشغيل". على سبيل المثال، يجب أن تحتوي شريحة "ENTERPRISE"
على القيمة
0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345
.
هذه القيمة هي تسلسل من OSId وطول OSAppId (0x0A
)
وOSAppId.
لمزيد من المعلومات عن نوع مكوّن وصف حركة المرور، يُرجى الاطّلاع على
3GPP TS 24.526 الجدول 5.2.1.
يوضّح الجدول التالي قيم OSAppId لفئات الشرائح المختلفة.
فئة الشريحة | OSAppId | الوصف |
---|---|---|
ENTERPRISE | 0x454E5445525052495345 |
OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE". |
ENTERPRISE2 | 0x454E544552505249534532 |
OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE2". |
ENTERPRISE3 | 0x454E544552505249534533 |
OSAppId هو تمثيل لمصفوفة بايت من السلسلة "ENTERPRISE3". |
ENTERPRISE4 | 0x454E544552505249534534 |
OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE4". |
ENTERPRISE5 | 0x454E544552505249534535 |
OSAppId هو تمثيل صفيف بايت للسلسلة "ENTERPRISE5". |
CBS | 0x434253 |
OSAppId هو تمثيل مصفوفة بايت للسلسلة "CBS". |
منح الأولوية للوقت | 0x5052494f524954495a455f4c4154454e4359 |
OSAppId هو تمثيل مصفوفة بايت للسلسلة "PRIORITIZE_LATENCY". |
PRIORITIZE_BANDWIDTH | 0x5052494f524954495a455f42414e445749445448 |
OSAppId هو تمثيل مصفوفة بايت للسلسلة "PRIORITIZE_BANDWIDTH". |
أمثلة على قواعد URSP
تعرض الجداول التالية أمثلة على قواعد URSP للمؤسسات وCBS ووقت الاستجابة المنخفض ومعدل نقل البيانات المرتفع وحركة البيانات التلقائية.
المؤسسة 1
يتوفّر دعم Enterprise 1 في الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث. في ما يلي مثال على قاعدة URSP لزيارات ENTERPRISE1:
قاعدة URSP رقم 1 (enterprise1) | |
---|---|
الأولوية | 1 (0x01) |
واصف الزيارات رقم 1 | |
رقم تعريف نظام التشغيل + نوع رقم تعريف تطبيق نظام التشغيل | 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345 |
وصف اختيار المسار رقم 1 | |
الأولوية | 1 (0x01) |
المكوّن 1: S-NSSAI | SST:XX SD:YYYYYY |
المكوّن الثاني: DNN | مؤسسة |
وصف اختيار المسار رقم 2 | |
الأولوية | 2 (0x02) |
المكوّن رقم 1: DNN | مؤسسة |
Enterprise 2
يتوفّر دعم Enterprise 2 في الإصدار 13 من Android والإصدارات الأحدث. في ما يلي مثال على قاعدة URSP لزيارات ENTERPRISE2:
قاعدة URSP رقم 2 (enterprise2) | |
---|---|
الأولوية | 2 (0x02) |
واصف عدد الزيارات رقم 1 | |
رقم تعريف نظام التشغيل + نوع رقم تعريف تطبيق نظام التشغيل | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534532 |
واصف اختيار المسار رقم 1 | |
الأولوية | 1 (0x01) |
المكوّن 1: S-NSSAI | SST:XX SD:YYYYYY |
المكوّن الثاني: DNN | enterprise2 |
وصف اختيار المسار رقم 2 | |
الأولوية | 2 (0x02) |
المكوّن رقم 1: DNN | enterprise2 |
Enterprise 3
يتوفّر دعم Enterprise 3 في الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث. في ما يلي مثال على قاعدة URSP لحركة ENTERPRISE3:
قاعدة URSP رقم 3 (enterprise3) | |
---|---|
الأولوية | 3 (0x03) |
واصف الزيارات رقم 1 | |
رقم تعريف نظام التشغيل + نوع رقم تعريف تطبيق نظام التشغيل | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534533 |
وصف اختيار المسار رقم 1 | |
الأولوية | 1 (0x01) |
المكوّن 1: S-NSSAI | SST:XX SD:YYYYYY |
المكوّن الثاني: DNN | enterprise3 |
وصف اختيار المسار رقم 2 | |
الأولوية | 2 (0x02) |
المكوّن رقم 1: DNN | مؤسسة 3 |
Enterprise 4
يتوفّر دعم Enterprise 4 في الإصدار 13 من نظام Android والإصدارات الأحدث. في ما يلي مثال على قاعدة URSP لزيارات ENTERPRISE4:
قاعدة URSP رقم 4 (enterprise4) | |
---|---|
الأولوية | 4 (0x04) |
وصف عدد الزيارات رقم 1 | |
رقم تعريف نظام التشغيل + نوع رقم تعريف تطبيق نظام التشغيل | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534534 |
وصف اختيار المسار رقم 1 | |
الأولوية | 1 (0x01) |
المكوّن 1: S-NSSAI | SST:XX SD:YYYYYY |
المكون رقم 2: DNN | enterprise4 |
وصف اختيار المسار رقم 2 | |
الأولوية | 2 (0x02) |
المكوّن رقم 1: DNN | enterprise4 |
Enterprise 5
تتوفّر إمكانية استخدام Enterprise 5 في الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث. في ما يلي مثال على قاعدة URSP للزيارات إلى ENTERPRISE5:
قاعدة URSP رقم 5 (enterprise5) | |
---|---|
الأولوية | 5 (0x05) |
واصف الزيارات رقم 1 | |
رقم تعريف نظام التشغيل + نوع رقم تعريف تطبيق نظام التشغيل | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534535 |
واصف اختيار المسار رقم 1 | |
الأولوية | 1 (0x01) |
المكوّن 1: S-NSSAI | SST:XX SD:YYYYYY |
المكوّن 2: DNN | enterprise5 |
وصف اختيار المسار رقم 2 | |
الأولوية | 2 (0x02) |
المكوّن رقم 1: DNN | enterprise5 |
CBS
تتوفّر خدمة 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 | المجلس المركزي |
وقت استجابة بطيء
تتوفّر ميزة "وقت الاستجابة المنخفض" في الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث. في ما يلي مثال على قاعدة 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 | وقت الاستجابة |
معدل نقل بيانات مرتفع
تتوفّر ميزة "النطاق العالي" في الإصدار 13 من نظام Android والإصدارات الأحدث. في ما يلي مثال على قاعدة URSP لزيارات HIGH_BANDWIDTH:
قاعدة URSP رقم 8 (نطاق ترددي مرتفع) | |
---|---|
الأولوية | 8 (0x08) |
وصف عدد الزيارات رقم 1 | |
رقم تعريف نظام التشغيل + نوع رقم تعريف تطبيق نظام التشغيل | 97A498E3FC925C9489860333D06E4E47145052494f524954495a455f42414e445749445448 |
وصف اختيار المسار رقم 1 | |
الأولوية | 1 (0x01) |
المكوّن 1: S-NSSAI | SST:XX SD:YYYYYY |
المكوّن الثاني: DNN | معدّل نقل البيانات |
وصف اختيار المسار رقم 2 | |
الأولوية | 2 (0x02) |
المكوّن رقم 1: DNN | معدل نقل البيانات |
تلقائي
قاعدة URSP رقم 9 (تلقائية) | |
---|---|
الأولوية | 9 (0x09) |
وصف عدد الزيارات رقم 1 | |
match-all | لا ينطبق |
وصف اختيار المسار رقم 1 | |
الأولوية | 1 (0x01) |
المكوّن 1: S-NSSAI | SST:XX SD:YYYYYY |
الاختبار
لاختبار تقسيم شبكة الجيل الخامس، استخدِم الاختبار اليدوي التالي.
لإعداد جهاز للاختبار، اتّبِع الخطوات التالية:
تأكَّد من ضبط سياسة URSP باستخدام قاعدة غير تلقائية تطابق فئة المؤسسة، وأنّ واصف اختيار المسار المقابل يربط فئة المؤسسة بشريحة المؤسسة، وقاعدة تلقائية توجِّه الزيارات إلى شريحة الإنترنت التلقائية.
تأكَّد من ضبط ملف عمل على الجهاز.
تفعيل ميزة "تقسيم الشبكة" من خلال وحدة التحكّم بسياسة الجهاز (DPC)
لاختبار سلوك تقسيم شبكة الجيل الخامس، اتّبِع الخطوات التالية:
- تأكَّد من أنّه تمّ إنشاء جلسة PDU باستخدام شريحة المؤسسة (مثل استخدام عنوان IP محدّد) وأنّ التطبيقات في ملف العمل تستخدم جلسة PDU هذه.
- تأكَّد من إنشاء جلسة PDU منفصلة باستخدام شريحة الإنترنت التلقائية وأنّ التطبيقات في الملف الشخصي تستخدم جلسة PDU.
زيادة المبيعات من خلال تقسيم شبكة الجيل الخامس
تتيح ميزة البيع الإضافي لشرائح شبكة الجيل الخامس، المتوفّرة من الإصدار Android 14-QPR1، لمشغّلي شبكات الجوّال تقديم ميزات مُحسَّنة للشبكة (وقت الاستجابة ومعدّل نقل البيانات) لمستخدميهم من خلال تقسيم شبكة الجيل الخامس.
إنّ ميزة الارتقاء بالمبيعات من إنشاء شبكة الجيل الخامس تعتمد على استجابة TS.43 من خادم أذونات الوصول إلى الموقع الإلكتروني لمشغّل شبكة الجوّال لتعزيز مسار الشراء. يمكن لمشغّلي شبكات الجوّال استخدام الاستجابة لتحديد عنوان URL لعرض الويب الخاص بعملية الشراء لدى مشغّل شبكة الجوّال وإرسال بيانات إضافية إلى عرض الويب والإشارة إلى ما إذا تم توفير الشريحة ومدى توفّرها على شبكة مشغّل شبكة الجوّال.
يمكن لمشغّلي شبكات الجوّال تخصيص سلوك ميزة البيع الإضافي لشرائح شبكة الجيل الخامس باستخدام إعدادات مشغّلي الشبكات التي تتحكّم في إمكانية إرسال طلبات الشراء ، ووقت السماح للتطبيقات بطلب ميزات إضافية، ومدة انتظار إطار عمل خدمات الهاتف للردّ من المستخدم أو الشبكة.
توفّر ميزة البيع الإضافي لشرائح الشبكة من الجيل الخامس واجهة تُعرف باسم
DataBoostWebServiceFlow
،
للسماح بالتواصل بين Android وWebview الخاص بمشغّل شبكة الجوّال.
يعرض الشكل 2 مسار الشراء لبيع شرائح الجيل الخامس الإضافية:
الشكل 2: مسار شراء الارتقاء بالمبيعات من خلال تقسيم شبكة الجيل الخامس
عملية استحقاق TS.43
عندما يطلب مستخدم إمكانات محسّنة للشبكة، يطلب إطار عمل Telephony ضبط إذن الخدمة للميزة المميّزة المطلوبة. إذا كانت استجابة TS.43 صالحة، يستخدم إطار عمل Telephony الحقول من استجابة 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 |
غير متوفّر (2 ) |
جارٍ (3 ) |
||
حالة إذن الاستخدام | المواقع الجغرافية التي تم إيقافها (0 ) |
تعذَّر التحميل | تعذَّر التحميل | تعذَّر التحميل | تعذَّر التحميل |
مفعَّل (1 ) |
عرض WebView | تم شراؤه من قبل | تم شراؤه من قبل | قيد التقدم | |
غير متوافقة (2 ) |
تعذَّر التحميل | تعذَّر التحميل | تعذَّر التحميل | تعذَّر التحميل | |
الإعداد (3 ) |
خطأ في شركة النقل | خطأ لدى مشغِّل شبكة الجوّال | قيد التقدم | قيد التقدم | |
مضمّنة (4 ) |
خطأ في شركة النقل | تم شراؤه من قبل | تم شراؤه من قبل | خطأ لدى مشغِّل شبكة الجوّال |
حقول سير الخدمة
يحدِّد ردّ TS.43 عنوان URL وبيانات المستخدم ونوع المحتوى لتخصيص
سلوك webview لعملية الشراء من مشغّل شبكة الجوّال. إذا لم يتم تحديد نوع المحتوى، يتم تحميل عنوان
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)
إعدادات مشغّل شبكة الجوّال
في ما يلي إعدادات مشغّلي شبكة الجوّال المتاحة لتخصيص سلوك ميزة البيع الإضافي لشرائح شبكة الجيل الخامس.
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
الحد الأقصى اليومي لعدد مرّات ظهور إشعار الترقية عند الشراء للمستخدم. في حال بلوغ الحد الأقصى اليومي، لا يتم عرض إشعار البيع الإضافي ويتم الحد من طلبات الشراء (بما في ذلك طلبات خادم الأذونات) إلى أن حلول midnigh في اليوم التالي. إنّ طلبات الشراء التي يتم إجراؤها بعد الوصول إلى الحد الأقصى اليومي لن تتم بنجاح، وستظهر النتيجة التالية:
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
. إذا تعذّر على الشبكة إعداد إعدادات التقطيع في الوقت المناسب، يمكن للتطبيقات طلب شراء الإمكانات المدفوعة مرة أخرى. لا تُعتبر عملية الشراء مكتملة في خدمات الاتصال الهاتفي إلا بعد إرسال إعدادات التقطيع المقابلة، بغض النظر عمّا إذا كان المستخدم قد دفع رسومًا إلى مشغّل شبكة الجوّال أم لا.
واجهة JavaScript
عندما ينقر المستخدم على إشعار تحسين الشبكة، يظهر له عنصر 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
على جهاز المستخدم.