במכשירים עם Android מגרסה 12 ואילך, Android מספקת תמיכה בפילוח של רשת 5G, בשימוש בווירטואליזציה של הרשת לחלק חיבורי רשת בודדים למספר חיבורים וירטואליים ייחודיים שמספקים כמויות שונות של משאבים לסוגים שונים של תנועה. 5G פריסת רשת מאפשרת למפעילי רשת לייעד חלק מהרשת מתן תכונות ספציפיות לפלח מסוים של לקוחות. Android 12 כולל את יכולות הפילוח של רשתות 5G לארגונים, שבהן מפעילי רשתות יכולים לספק ללקוחות הארגוניים שלהם:
פילוח לפי מכשירים ארגוניים במכשירים מנוהלים
לארגונים שמספקים מנוהלת במלואה מכשירים של החברה לעובדים שלהם, ספקי רשתות יכולים לספק להם או קטעי רשת פעילים יותר של הארגון שבהם יש תנועה במכשירי החברה מועברים אל. החל מ-Android 12, אפשר להשתמש ב-Android לספקים כדי לספק פרוסות נתונים לארגונים באמצעות כללי URSP, במקום להגדיר פרוסות דרך נקודות APN.
פילוח הדוחות שמתייחסים לאפליקציות עסקיות ב-Enterprise
לארגונים שמשתמשים פרופיל העבודה פתרון Android 12 מאפשר למכשירים לנתב את תנועה מכל האפליקציות פרופיל עבודה לפרוסת רשת של ארגון. ארגונים יכולים להפעיל את האפשרות הזו באמצעות Device Policy Controller (DPC)
הפתרון של פרופיל העבודה מספק רמת אימות אוטומטית בקרת גישה, שארגונים דורשים לוודא שרק תנועה אפליקציות לארגונים בפרופיל העבודה מנותבות לפלח הרשת הארגונית. לא צריך לשנות אפליקציות בפרופיל העבודה כדי לבקש במפורש פרוסת רשת ארגונית.
איך חלוקת רשת של 5G פועלת ב-AOSP
ב-Android 12 נוספה תמיכה בפילוח ברשת של 5G באמצעות תוספות לקוד הבסיס של הטלפוניה ב-AOSP מודול של שיתוף אינטרנט בין מכשירים (tethering) כדי לשלב ממשקי API קיימים של קישוריות שנדרשים לפילוח הרשת.
פלטפורמת הטלפוניה של Android מספקת ממשקי API HAL וטלפוניה כדי לתמוך הפילוח מבוסס על בקשות רשת שהוגשו על ידי קוד הליבה של הרשת ו-5G לחיתוך סרטונים במודם. איור 1 מתאר את הרכיבים של רשת 5G תכונת הפילוח ברשת.
איור 1. ארכיטקטורת הפילוח של רשת 5G ב-AOSP.
פלטפורמת הטלפוניה והקישוריות תומכת:
- המרת בקשות רשת לקטגוריות של פרוסות תיאורי תנועה ואחר כך מועברות למודם כדי לבצע התאמה ונתיב של תעבורת נתונים מסוג URSP בחירה
- חזרה לרשת ברירת המחדל אם פרוסת הרשת הארגונית לא זמינים
- לנתב תנועה מכל האפליקציות בפרופיל העבודה אל החיבור התואם
תמיכה בפילוח הדוחות שמתייחסים לארגונים
- זיהוי הנוכחות של פרופיל עבודה במכשיר
- בבדיקה אם יש הרשאות או הוראות ניתוב שסופקו על ידי בקר DPC שמשמש את האדמין ב-IT בארגון
שירות הרשת המרכזי כולל את השינויים הבאים בשיתוף האינטרנט בין מכשירים המודול ב-Android 12:
- הוספת רוב
android.net.*
המחלקות הציבוריות או ה-API של המערכת אל 'שיתוף אינטרנט בין מכשירים' מודול הרחבת הגבולות של המודול של שיתוף אינטרנט בין מכשירים (tethering) כך שיכלול את:
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 מעבירה קוד עם היכולות הבאות למודול של שיתוף האינטרנט בין מכשירים:
- קבלת בקשות מאפליקציות לחיבורי רשת
- לקבל בקשות מהמערכת (לדוגמה, "להציב את האפליקציות האלה Enterprise slice"; הושקו ב-Android 12)
- שליחת בקשות מהמערכת לקוד הטלפוניה בניסיון להגדיר רשתות או פרוסות נתונים באמצעות מעבר דרך ממשק ה-API של HAL והמודם
- מידע נטו לנתב תנועה לפי אפליקציה (התחילה בשנת Android 12)
- עדכון האפליקציות על מה שקורה לתנועת הגולשים שלהן ברשת באמצעות
ConnectivityManager
ממשקי API כמוNetworkCallback
,getActiveNetwork
,getNetworkCapabilities
הטמעה
כדי לתמוך בפילוח ברשת 5G במכשיר, צריך שיהיה במכשיר מודם שתומך
מכשיר IRadio 1.6 HAL שכולל את
setupDataCall_1_6
API. ה-API הזה מגדיר חיבור נתונים וכולל את הפרמטרים הבאים
לתמיכה בפילוח 5G:
trafficDescriptor
: מציין מתאר תנועה שנשלח למודםsliceInfo
: מציין את המידע של פרוסת הרשת שבה יש להשתמש במקרה של העברת מ-EPDG ל-5GmatchAllRuleAllowed
: מציין אם להשתמש ב-URSP מסוג ברירת מחדל להתאמת הכול מותר להשתמש בכלל. תכונת הטלפוניה מגדירה את הערך כ-True לרשתות ברירת מחדל אבל לא לפרוסות. הכלל של התאמת הכול חל על ברירת המחדל עמוקה מאוד, כשהאפליקציה מבקשת פלח ספציפי שאינו לכן הפלח הספציפי ידווח כלא זמין. עבור אפליקציות לארגונים, מסגרת הטלפוניה יכולה לחזור לברירת המחדל אם הרשת הארגונית לא זמינה.
המודמים חייבים גם להטמיע את
getSlicingConfig
API, אלא אם צוין שהוא לא נתמך על ידי
getHalDeviceCapabilities
API.
דרישות לארגונים
בהמשך מתוארות הדרישות שארגונים יכולים להשתמש בפילוח ברשת 5G במכשירים בפריסה ארגונית של Android.
- לוודא שבמכשירים מנוהלים או במכשירים של עובדים מוגדרים פרופיל עבודה
תומך ב-5G SA עם מודמים שתומכים
setupDataCall_1_6
API. - אפשר לעבוד עם שותף הספק על הגדרת פלח והביצועים שלו או על הסכם רמת השירות למאפיינים.
הפעלה של פילוח לפי 5G במכשירים שהוגדרו באמצעות פרופיל עבודה
במכשירים שבהם מוגדר פרופיל עבודה, הפילוח ברשת 5G מושבת על ידי
כברירת מחדל ב-AOSP. כדי להפעיל פילוח רשת, אדמינים ב-IT בארגון יכולים להפעיל
מניתוב התנועה של אפליקציות בפרופיל העבודה לפרוסת הרשת הארגונית
לכל עובד באמצעות בקר DPC של EMM, שמשתמש
setPreferentialNetworkServiceEnabled
ב-method
DevicePolicyManager
(DPM)
API (הושק ב-Android 12).
ספקי EMM עם בקרי DPC בהתאמה אישית חייבים לשלב את ה-API של DevicePolicyManager
כדי
תומכים בלקוחות ארגוניים.
כללי URSP
הקטע הזה כולל מידע לספקים לגבי הגדרת כללי URSP עבור קטגוריות שונות של פלחים, כולל ארגון, CBS, זמן אחזור קצר, ותנועה ברוחב פס גבוה. כשמגדירים כללי URSP עבור קטגוריות שונות של פלחים, הספקים חייבים להשתמש בקודים הבאים של Android ערכים.
מזהה | ערך | תיאור |
---|---|---|
מזהה OS | 97a498e3-fc92-5c94-8986-0333d06e4e47 |
מזהה ה-OSId ל-Android הוא UUID בגרסה 5 שנוצר עם מרחב השמות ISO OID והשם "Android". |
הספקים חייבים להגדיר כללי URSP לכל פרוסה בתנועה עם התנועה
רכיב המתאר כ'מזהה מערכת ההפעלה + סוג מזהה האפליקציה של מערכת ההפעלה'. לדוגמה, הקוד "ENTERPRISE"
ערך הפלח חייב להיות
0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345
הערך הזה הוא שרשור של ה-OSId, אורך ה-OSAppId (0x0A
),
וגם OSAppId.
למידע נוסף על סוג הרכיב של מתאר התנועה, ראו
3GPP TS 24.526 טבלה 5.2.1.
בטבלה הבאה מתוארים ערכי OSAppId לקטגוריות השונות של הפלחים.
קטגוריית הפלח | מזהה OSApp | תיאור |
---|---|---|
ארגון | 0x454E5445525052495345 |
ה-OSAppId הוא ייצוג של מערך בייטים של המחרוזת 'ENTERPRISE' |
ENTERPRISE2 | 0x454E544552505249534532 |
ה-OSAppId הוא ייצוג של מערך בייטים של המחרוזת 'ENTERPRISE2' |
ENTERPRISE3 | 0x454E544552505249534533 |
ה-OSAppId הוא ייצוג של מערך בייטים של המחרוזת 'ENTERPRISE3' |
ENTERPRISE4 | 0x454E544552505249534534 |
ה-OSAppId הוא ייצוג של מערך בייטים של המחרוזת 'ENTERPRISE4' |
ENTERPRISE5 | 0x454E544552505249534535 |
ה-OSAppId הוא ייצוג של מערך בייטים של המחרוזת 'ENTERPRISE5' |
CBS | 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 (enterprise1) | |
---|---|
קדימות | 1 (0x01) |
מתאר תנועה מס' 1 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345 |
מתאר בחירת מסלול מס' 1 | |
קדימות | 1 (0x01) |
רכיב מס' 1: S-NSSAI | SST:XX SD:YYYYYY |
רכיב מס' 2: DNN | Enterprise |
מתאר בחירת מסלול מס' 2 | |
קדימות | 2 (0x02) |
רכיב מס' 1: DNN | Enterprise |
ארגון 2
תמיכה ב-Enterprise 2 זמינה ב-Android מגרסה 13 ואילך. דוגמה לכלל URSP לתנועה של ENTERPRISE2:
כלל URSP מס' 2 (enterprise2) | |
---|---|
קדימות | 2 (0x02) |
מתאר תנועה מס' 1 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 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 (enterprise3) | |
---|---|
קדימות | 3 (0x03) |
מתאר תנועה מס' 1 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 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 (enterprise4) | |
---|---|
קדימות | 4 (0x04) |
מתאר תנועה מס' 1 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534534 |
מתאר בחירת מסלול מס' 1 | |
קדימות | 1 (0x01) |
רכיב מס' 1: S-NSSAI | SST:XX SD:YYYYYY |
רכיב מס' 2: DNN | ארגון4 |
מתאר בחירת מסלול מס' 2 | |
קדימות | 2 (0x02) |
רכיב מס' 1: DNN | ארגון4 |
ארגון 5
תמיכה ב-Enterprise 5 זמינה ב-Android מגרסה 13 ואילך. דוגמה לכלל URSP לתנועה של ENTERPRISE5:
כלל URSP מס' 5 (enterprise5) | |
---|---|
קדימות | 5 (0x05) |
מתאר תנועה מס' 1 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 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 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 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 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 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 | |
מזהה OS + סוג מזהה אפליקציה של מערכת ההפעלה | 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 מוגדרת עם כלל שאינו ברירת מחדל תואם לקטגוריית הארגון ושבחירת הנתיב המתאימה רכיב descriptor ממפה את קטגוריית הארגון לפלח הארגוני. וגם כלל ברירת מחדל שמפנה את התנועה לפלח האינטרנט שמוגדר כברירת מחדל.
צריך לוודא שמוגדר פרופיל עבודה במכשיר.
הבעת הסכמה לשימוש בחיתוך רשת דרך בקר ה-DPC
כדי לבדוק את ההתנהגות של חיתוך ברשת 5G, מבצעים את הפעולות הבאות:
- מוודאים שנוצרה סשן PDU עם פרוסת הארגון (עבור באמצעות כתובת IP ספציפית), ואפליקציות בפרופיל העבודה משתמשות את סשן ה-PDU.
- מוודאים שנוצרה סשן PDU נפרד עם חיבור האינטרנט שמוגדר כברירת מחדל והאפליקציות בפרופיל האישי ישתמשו בסשן ה-PDU.
מכירת מוצר או שירות נוסף (upsell) ברשת 5G
תכונת החיתוך של רשת 5G בגרסת 5G, זמינה עכשיו Android 14-QPR1, מאפשר לספקים להציע רשת משופרת יכולות (זמן אחזור ורוחב פס) למשתמשים באמצעות פילוח ברשת של 5G.
תכונת החיתוך של רשת 5G ב-5G מתבססת על תגובת TS.43 מהספק שרת הרשאה להניע את תהליך הרכישה. ספקי הסלולר יכולים להשתמש בתשובה כדי לציין את כתובת ה-URL עבור WebView רכישה של הספק, לשלוח נתונים נוספים ותציינו אם הפרוסה הוקצתה וזמינה הרשת של הספק.
ספקי סלולר יכולים להתאים אישית את ההתנהגות של תכונת הפילוח לפי 5G באמצעות הגדרות ספק, שקובעות אם ניתן לאפשר בקשות רכישה כאשר אפליקציות מורשות לבקש יכולות פרימיום, וכמה זמן ה-framework של הטלפוניה מחכה לתגובות מהמשתמש או מהרשת.
תכונת החיתוך של רשת ה-5G של רשת 5G מספקת ממשק שנקרא
DataBoostWebServiceFlow
,
כדי לאפשר תקשורת בין Android לבין WebView של הספק.
איור 2 מציג את תהליך הרכישה של חלוקת הנתונים למכירת מוצר או שירות נוסף (upsell) באמצעות 5G:
איור 2. תהליך הרכישה של מכירת מוצר או שירות נוסף (upsell) באמצעות 5G.
תהליך הרשאה ל-TS.43
כשמשתמש שולח בקשה ליכולות רשת משופרות, התכונה 'טלפוניה' ה-framework מבקש את ההגדרה של הרשאת השירות עבור יכולת פרימיום. אם תגובת TS.43 תקינה, ה-framework של הטלפוניה משתמש השדות מתגובת ה-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
(לא מוקצה), מסגרת הטלפוניה מציגה התראה למכירת מוצר או שירות נוסף (upsell)
למשתמש לרכוש את ההגדלה דרך WebView של ספק הסלולר. הטבלה הבאה
מתארת את ההתנהגות של ה-framework של הטלפוניה לשילובים שונים של
ערכי סטטוס ההרשאות וההקצאה.
סטטוס ההקצאה | |||||
---|---|---|---|---|---|
לא מוקצה (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)
הגדרות הספק
הגדרות הספק הזמינות להתאמה אישית של ההתנהגות של תכונת הפילוח של רשת 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
מספר הפעמים המקסימלי החודשי שבו מוצגת ההודעה על הגדלת המכירה של המוצר למשתמש. אם הגעת למספר המקסימלי של החודש, ההתראה על מכירת מוצר או שירות נוסף לא תוצג ובקשות רכישה (כולל בקשות לשרתי הרשאות) עוברות ויסות נתונים (throttle) עד ליום הראשון של החודש הבא. בקשות רכישה שבוצעו אחרי הגעת למקסימום החודשי
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
האם לאפשר רכישה של יכולות פרימיום כשהמכשיר שמקושרת לאבולוציה לטווח ארוך (LTE). אם הערך שלו הוא
true
, בקשות רכישה יכולות להיות שנוצר גם ב-LTE וגם ברדיו חדש (NR). אם המיקוםfalse
, בקשות רכישה אפשר לשלוח רק ב-NR ובקשות שנשלחות ב-LTE נכשלות עםPURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE
תוצאה אחת.KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONG
משך הזמן עד להצגת ההתראה על מכירת מוצר או שירות נוסף (upsell) למשתמש לפני כן היא מבוטלת באופן אוטומטי. אם ההתראה מתבטלת, בקשות מווסתות וייכשלו
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 לרכישה על ידי הספק מוצגת למשתמש. ספקים יכולים להשתמש בממשקי ה-API
שצוינו
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
למכשיר של המשתמש.