Lo slicing di rete 5G offre agli operatori la possibilità di fornire miglioramenti delle prestazioni di rete per casi d'uso specifici. Questa guida spiega come un'app può utilizzare la funzionalità di network slicing.
Questa guida illustra anche come attivare il flusso UX di upsell dello slicing della rete nei casi in cui è necessario un acquisto prima che l'app possa accedere alla connessione premium.
Passaggio 1: dichiara gli intenti delle funzionalità premium
Affinché la richiesta di una funzionalità di slicing premium venga accettata,
l'app deve dichiarare l'intenzione di richiedere questa funzionalità nel manifest dell'app.
In caso contrario, la richiesta di rete non va a buon fine e genera un errore SecurityException.
Per farlo, l'app deve dichiarare la proprietà PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES nel file AndroidManifest.xml e includere un file di risorse XML corrispondente.
Ecco un esempio di dichiarazione di funzionalità nel file manifest:
<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
android:resource="@xml/network_capabilities" />
Il file di risorse network_capabilities.xml corrispondente ha il seguente aspetto:
<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
<uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>
Passaggio 2: verifica se la funzionalità premium è disponibile
Chiama il metodo API requestNetwork per determinare se la funzionalità premium è disponibile.
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;
}
});
}
Quando crei un oggetto NetworkRequest, la funzionalità che aggiungi non è la stessa che passi alle API TelephonyManager.
La tabella seguente mappa le costanti della classe TelephonyManager alle costanti corrispondenti in NetworkCapabilities.
Costante di TelephonyManager |
Costante di NetworkCapabilities |
|---|---|
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY |
NET_CAPABILITY_PRIORITIZE_LATENCY |
Passaggio 3: se la funzionalità premium non è disponibile, verifica la disponibilità per l'acquisto
Chiama il metodo API isPremiumCapabilityAvailableForPurchase per determinare se la funzionalità premium selezionata è disponibile. Questo metodo restituisce true se la funzionalità è disponibile per l'acquisto dall'operatore utilizzando il workflow di notifica di upsell.
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;
}
Passaggio 4: avvia il flusso di notifiche di upsell
Dopo aver verificato che la funzionalità premium è disponibile, l'app deve chiamare purchasePremiumCapability() per avviare il flusso di notifiche di upsell.
Se l'utente non ha ancora acquistato la funzionalità specificata e tutte le precondizioni sono soddisfatte, la piattaforma mostra all'utente una notifica per informarlo che l'operatore potrebbe offrire opzioni di miglioramento delle prestazioni. Se l'utente tocca la notifica, la piattaforma apre la webview dell'operatore in modo che il processo di acquisto possa continuare.
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;
}
});
}
Il callback parameter passato a purchasePremiumCapability() restituisce un
codice di risultato per la richiesta di acquisto.
I codici dei risultati PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS e
PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED rappresentano
risultati positivi in cui la tua app può procedere alla richiesta della funzionalità
premium selezionata.
I codici dei risultati nel seguente elenco rappresentano richieste di acquisto non riuscite. Per saperne di più, consulta il riferimento 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
Se la richiesta di acquisto non va a buon fine, l'app potrebbe utilizzare la rete predefinita. Non esiste un comportamento di fallback automatico se la richiesta di slice premium non può essere soddisfatta.
Flusso UX per l'upsell di slicing