Używanie dzielenia sieci

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ć

thought

Wywoł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.

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

W ramach procesu UX użytkownikowi wyświetla się powiadomienie, które otwiera arkusz internetowy operatora, gdzie można dokonać zakupu.
Rysunek 1. Proces UX sprzedaży dodatkowej fragmentacji sieci od powiadomienia operatora do potwierdzenia zakupu.