Segmentacja sieci 5G umożliwia operatorom zwiększenie wydajności sieci w określonych przypadkach użycia. Z tego przewodnika dowiesz się, jak aplikacja może korzystać z funkcji dzielenia sieci na fragmenty.
Z tego przewodnika dowiesz się też, jak aktywować proces UX sprzedaży dodatkowej związanej z dzieleniem sieci na fragmenty w przypadkach, gdy przed uzyskaniem dostępu do połączenia premium wymagany jest zakup.
Krok 1. Zadeklaruj intencje funkcji premium
Aby prośba aplikacji o funkcję premium slicing została uwzględniona, aplikacja musi zadeklarować w manifeście aplikacji zamiar żądania tej funkcji.
W przeciwnym razie żądanie sieciowe nie powiedzie się i zostanie zwrócony błąd SecurityException.
Aby to zrobić, aplikacja musi zadeklarować właściwość PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES w pliku AndroidManifest.xml i zawierać odpowiedni plik zasobów XML.
Deklaracja możliwości w pliku manifestu wygląda tak:
<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
android:resource="@xml/network_capabilities" />
Odpowiedni plik zasobów network_capabilities.xml wygląda tak:
<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
<uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>
Krok 2. Sprawdź, czy funkcja premium jest dostępna
Wywołaj metodę interfejsu API requestNetwork, aby sprawdzić, czy funkcja premium jest dostępna.
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;
}
});
}
Gdy tworzysz obiekt NetworkRequest, dodawana funkcja nie jest tą samą funkcją, którą przekazujesz do interfejsów API TelephonyManager.
Tabela poniżej mapuje stałe z klasy TelephonyManager na odpowiadające im stałe w NetworkCapabilities.
TelephonyManager jak zawsze |
NetworkCapabilities jak zawsze |
|---|---|
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY |
NET_CAPABILITY_PRIORITIZE_LATENCY |
Krok 3. Jeśli funkcja premium nie jest dostępna, sprawdź, czy można ją kupić
thoughtWywołaj metodę interfejsu API isPremiumCapabilityAvailableForPurchase, aby określić, czy wybrana funkcja premium jest dostępna. Ta metoda zwraca wartość true, jeśli funkcję można kupić u operatora za pomocą przepływu pracy powiadomień o sprzedaży dodatkowej.
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;
}
Krok 4. Zainicjuj proces powiadomień o sprzedaży dodatkowej
Po potwierdzeniu, że funkcja premium jest dostępna, aplikacja powinna wywołać metodę purchasePremiumCapability(), aby zainicjować proces powiadomienia o sprzedaży dodatkowej.
Jeśli użytkownik nie kupił jeszcze określonej funkcji i wszystkie warunki wstępne są spełnione, platforma wyświetla użytkownikowi powiadomienie z informacją, że u operatora mogą być dostępne opcje zwiększenia wydajności. Jeśli użytkownik kliknie powiadomienie, platforma otworzy widok internetowy operatora, aby można było kontynuować proces zakupu.
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;
}
});
}
Wywołanie zwrotne parameter przekazane do purchasePremiumCapability() zwraca kod wyniku prośby o zakup.
Kody wyników PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS i PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED oznaczają, że aplikacja może poprosić o wybraną funkcję premium.
Kody wyników na poniższej liście oznaczają nieudane prośby o zakup. Więcej informacji o nich znajdziesz w dokumentacji interfejsu 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
Jeśli prośba o zakup się nie powiedzie, aplikacja może użyć sieci domyślnej. Jeśli nie można zrealizować żądania wycinka premium, nie ma automatycznego działania zastępczego.
Proces UX dotyczący sprzedaży dodatkowej fragmentów