使用網路切片

5G 網路切片可讓電信業者針對特定用途提升網路效能。本指南說明應用程式如何使用網路切片功能。

本指南也說明如何觸發網路切片追加銷售使用者體驗流程,以便在應用程式存取付費連線前,引導使用者購買。

Step 1:宣告進階功能意圖

如要讓應用程式要求進階切片功能,應用程式必須在應用程式資訊清單中宣告要求該功能的意圖。否則,網路要求會失敗,並擲回 SecurityException。

為此,應用程式必須在 AndroidManifest.xml 檔案中宣告 PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES 屬性,並加入對應的 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:確認是否可使用付費功能

呼叫 requestNetwork API 方法,判斷是否可使用付費功能。

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 物件時,新增的功能與傳遞至 TelephonyManager API 的功能「不同」。下表將 TelephonyManager 類別的常數對應至 NetworkCapabilities 中的對應常數。

TelephonyManager熟悉景象 NetworkCapabilities熟悉景象
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY NET_CAPABILITY_PRIORITIZE_LATENCY

步驟 3:如果無法使用付費功能,請確認是否可購買

呼叫 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:啟動追加銷售通知流程

確認進階功能可用後,應用程式應呼叫 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;
        }
    });
}

傳遞至 purchasePremiumCapability() 的 parameter 回呼會傳回購買要求的結果代碼。

結果代碼 PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS 和 PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED 代表成功結果,應用程式可以繼續要求所選的付費功能。

下列清單中的結果代碼代表購買要求失敗。如要進一步瞭解這些欄位,請參閱 API 參考資料。

如果購買要求失敗,應用程式可能會改用預設網路。如果無法滿足付費切片要求,系統不會自動切換至備用行為。

追加銷售切片的使用者體驗流程

使用者體驗流程會向使用者顯示通知,開啟電信業者網頁表單,讓使用者完成購買。
圖 1. 網路切片追加銷售使用者體驗流程,從電信業者通知到購買確認。