Network Slicing verwenden

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.

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

Im UX-Flow wird dem Nutzer eine Benachrichtigung angezeigt, über die er ein Websheet des Mobilfunkanbieters öffnen kann, um den Kauf abzuschließen.
Abbildung 1. UX-Ablauf für das Upselling von Network Slicing von der Benachrichtigung des Mobilfunkanbieters bis zur Kaufbestätigung.