שימוש בחלוקה לפרוסות ברשת

פריסת רשת 5G מאפשרת לספקי סלולר לשפר את ביצועי הרשת בתרחישי שימוש ספציפיים. במדריך הזה מוסבר איך אפליקציה יכולה להשתמש בתכונה "פריסת רשת".

במדריך הזה מוסבר גם איך להפעיל את תהליך המכירה של חוויית המשתמש ב-network slicing במקרים שבהם נדרשת רכישה לפני שהאפליקציה יכולה לגשת לחיבור הפרימיום.

שלב 1: הצהרה על כוונות לגבי יכולות פרימיום

כדי שהבקשה של האפליקציה ליכולת פריסת פרימיום תאושר, האפליקציה צריכה להצהיר על הכוונה שלה לבקש את היכולת הזו בקובץ המניפסט של האפליקציה. אחרת, הבקשה לאחזור מהרשת תיכשל ותופיע השגיאה SecurityException.

כדי לעשות את זה, האפליקציה צריכה להצהיר על המאפיין PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES בקובץ AndroidManifest.xml ולכלול קובץ משאב XML תואם.

הצהרת יכולת בקובץ המניפסט נראית כך:

<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
          android:resource="@xml/network_capabilities" />

קובץ המשאבים התואם של network_capabilities.xml נראה כך:

<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>

שלב 2: בודקים אם יכולת הפרימיום זמינה

מפעילים את ה-method של ה-API‏ requestNetwork כדי לבדוק אם היכולת המתקדמת זמינה.

Context mContext;
Network mNetwork;

public void requestPremiumCapabilityNetwork(@NetCapability int capability) {
    ConnectvityManager cm = mContext.getSystemService(ConnectivityManager.class);
    NetworkRequest request = NetworkRequest.Builder()
            .addCapability(capability)
            .build();
    cm.requestNetwork(request, new NetworkCallback() {
        @Override
        public void onAvailable(Network network) {
            log("Premium capability %d network is available.", capability);
            mNetwork = network;
        }

        @Override
        public void onLost(Network network) {
            log("Premium capability %d network is not available.", capability);
            mNetwork = null;
        }
    });
}

כשיוצרים אובייקט NetworkRequest, היכולת שמוסיפים היא לא אותה יכולת שמעבירים לממשקי ה-API של TelephonyManager. בטבלה הבאה מופיע מיפוי של הקבועים מהמחלקה TelephonyManager לקבועים התואמים ב-NetworkCapabilities.

‫TelephonyManager משנה לשנה ‫NetworkCapabilities משנה לשנה
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY NET_CAPABILITY_PRIORITIZE_LATENCY

שלב 3: אם תכונת הפרימיום לא זמינה, בודקים אם אפשר לרכוש אותה

מפעילים את ה-method‏ isPremiumCapabilityAvailableForPurchase ב-API כדי לבדוק אם יכולת הפרימיום שנבחרה זמינה. השיטה הזו מחזירה true אם היכולת זמינה לרכישה מהספק באמצעות תהליך העבודה של ההתראה על מכירת אפסל.

Context mContext;

public boolean isPremiumCapabilityAvailableForPurchase(@PremiumCapability int capability) {
    TelephonyManager tm = mContext.getSystemService(TelephonyManager.class);
    boolean isAvailable = tm.isPremiumCapabilityAvailableForPurchase(capability);
    log("Premium capability %d %s available to purchase.",
            capability,
            isAvailable ? "is" : "is not");
    return isAvailable;
}

שלב 4: הפעלת תהליך ההתראה על מכירת מוצר או שירות נוסף (upsell)

אחרי שמוודאים שהיכולת המתקדמת זמינה, האפליקציה צריכה להפעיל את purchasePremiumCapability() כדי להתחיל את תהליך ההתראה על מכירת שדרוג. אם המשתמש עדיין לא רכש את היכולת שצוינה וכל התנאים המוקדמים מתקיימים, הפלטפורמה מציגה למשתמש התראה כדי להודיע לו שיכול להיות שספק הסלולר שלו מציע אפשרויות לשיפור הביצועים. אם המשתמש מקיש על ההתראה, הפלטפורמה פותחת את ה-WebView של הספק כדי שתהליך הרכישה יוכל להמשיך.

Context mContext;

public void purchasePremiumCapability(@PremiumCapability int capability) {
    TelephonyManager tm = mContext.getSystemService(TelephonyManager.class);
    tm.purchasePremiumCapability(capability, Runnable::run, new Consumer<Integer>() {
        @Override
        public void accept(Integer result) {
            log("Purchase premium capability %d result: %d", capability, result);
            int purchaseResult = result;
        }
    });
}

הקריאה החוזרת (callback) של parameter שמועברת אל purchasePremiumCapability() מחזירה קוד תוצאה לבקשת הרכישה.

קודי התוצאה PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS ו-PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED מייצגים תוצאות מוצלחות, שבהן האפליקציה יכולה להמשיך לבקש את יכולת הפרימיום שנבחרה.

קודי התוצאות ברשימה הבאה מייצגים בקשות רכישה שנכשלו. למידע נוסף, קראו את מאמרי העזרה של ה-API.

אם בקשת הרכישה נכשלת, יכול להיות שהאפליקציה תשתמש ברשת שמוגדרת כברירת מחדל. אין התנהגות חלופית אוטומטית אם אי אפשר למלא את הבקשה לפרוסת פרימיום.

תהליך חוויית המשתמש למכירת מוצר או שירות נוסף (upsell) של פריסה לתשלומים

בתהליך חוויית המשתמש, מוצגת למשתמש התראה שפותחת גיליון אלקטרוני של הספק, שבו הוא יכול להשלים את הרכישה.
תרשים 1. תהליך המכירה של שדרוג חבילת הגלישה, מההתראה של הספק ועד לאישור הרכישה.