Mit 5G-Netzwerk-Slicing können Mobilfunkanbieter die Netzwerkleistung für bestimmte Anwendungsfälle steigern. In diesem Leitfaden wird erläutert, wie eine App die Network-Slicing-Funktion verwenden kann.
In diesem Leitfaden wird auch beschrieben, wie du den UX-Flow für das Upselling von Network Slicing auslöst, wenn ein Kauf erforderlich ist, bevor die App auf die Premium-Verbindung zugreifen kann.
Schritt 1: Intents für Premium-Funktionen deklarieren
Damit die Anfrage deiner App nach einer Premium-Slicing-Funktion berücksichtigt wird, muss deine App im App-Manifest deklarieren, dass sie diese Funktion anfordert.
Andernfalls schlägt die Netzwerkanfrage fehl und es wird ein SecurityException-Fehler ausgegeben.
Dazu muss Ihre App das Attribut PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES in der Datei AndroidManifest.xml deklarieren und eine entsprechende XML-Ressourcendatei enthalten.
Eine Funktionsdeklaration in der Manifestdatei sieht so aus:
<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
android:resource="@xml/network_capabilities" />
Die entsprechende network_capabilities.xml-Ressourcendatei sieht so aus:
<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
<uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>
Schritt 2: Prüfen, ob die Premium-Funktion verfügbar ist
Rufen Sie die API-Methode requestNetwork auf, um festzustellen, ob die Premium-Funktion verfügbar ist.
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;
}
});
}
Wenn Sie ein NetworkRequest-Objekt erstellen, ist die hinzugefügte Funktion nicht dieselbe Funktion, die Sie an die TelephonyManager APIs übergeben.
In der folgenden Tabelle werden die Konstanten aus der Klasse TelephonyManager den entsprechenden Konstanten in NetworkCapabilities zugeordnet.
Immer im TelephonyManager |
Immer im NetworkCapabilities |
|---|---|
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY |
NET_CAPABILITY_PRIORITIZE_LATENCY |
Schritt 3: Wenn die Premium-Funktion nicht verfügbar ist, prüfen Sie, ob sie gekauft werden kann.
Rufen Sie die API-Methode isPremiumCapabilityAvailableForPurchase auf, um zu ermitteln, ob die ausgewählte Premium-Funktion verfügbar ist. Diese Methode gibt true zurück, wenn die Funktion über den Upselling-Benachrichtigungs-Workflow beim Mobilfunkanbieter gekauft werden kann.
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;
}
Schritt 4: Upselling-Benachrichtigungsablauf starten
Nachdem bestätigt wurde, dass die Premium-Funktion verfügbar ist, sollte Ihre App purchasePremiumCapability() aufrufen, um den Ablauf für die Upselling-Benachrichtigung zu starten.
Wenn der Nutzer die angegebene Funktion noch nicht gekauft hat und alle Voraussetzungen erfüllt sind, wird ihm eine Benachrichtigung angezeigt, dass möglicherweise Optionen zur Leistungssteigerung von seinem Mobilfunkanbieter verfügbar sind. Wenn der Nutzer auf die Benachrichtigung tippt, öffnet die Plattform die Webansicht des Mobilfunkanbieters, damit der Kaufvorgang fortgesetzt werden kann.
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;
}
});
}
Der an purchasePremiumCapability() übergebene Callback parameter gibt einen Ergebniscode für die Kaufanfrage zurück.
Die Ergebniscodes PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS und PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED stehen für erfolgreiche Ergebnisse, bei denen Ihre App die ausgewählte Premium-Funktion anfordern kann.
Die Ergebniscodes in der folgenden Liste stehen für fehlgeschlagene Kaufanfragen. Weitere Informationen finden Sie in der API-Referenz.
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
Wenn die Kaufanfrage fehlschlägt, kann Ihre App stattdessen das Standardnetzwerk verwenden. Es gibt kein automatisches Fallback-Verhalten, wenn die Anfrage für das Premium-Slice nicht erfüllt werden kann.
UX-Ablauf für das Slicing-Upselling