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 參考資料。
PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_IN_PROGRESSPURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLEDPURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_ERRORPURCHASE_PREMIUM_CAPABILITY_RESULT_ENTITLEMENT_CHECK_FAILEDPURCHASE_PREMIUM_CAPABILITY_RESULT_FEATURE_NOT_SUPPORTEDPURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLEPURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_DEFAULT_DATA_SUBSCRIPTIONPURCHASE_PREMIUM_CAPABILITY_RESULT_NOT_FOREGROUNDPURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUPPURCHASE_PREMIUM_CAPABILITY_RESULT_REQUEST_FAILEDPURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLEDPURCHASE_PREMIUM_CAPABILITY_RESULT_TIMEOUTPURCHASE_PREMIUM_CAPABILITY_RESULT_USER_CANCELED
如果購買要求失敗,應用程式可能會改用預設網路。如果無法滿足付費切片要求,系統不會自動切換至備用行為。
追加銷售切片的使用者體驗流程
