Per i dispositivi con Android 12 o versioni successive, Android supporta lo slicing della rete 5G, l'utilizzo della virtualizzazione della rete per dividere le singole connessioni di rete in più connessioni virtuali distinte che forniscono quantità diverse di risorse a diversi tipi di traffico. Il network slicing 5G consente agli operatori di rete di dedicare una parte della rete a fornire funzionalità specifiche per un particolare segmento di clienti. Android 12 introduce le seguenti funzionalità di slicing della rete aziendale 5G, che gli operatori di rete possono fornire ai propri clienti aziendali:
Suddivisione dei dispositivi aziendali per i dispositivi completamente gestiti
Per le aziende che forniscono dispositivi aziendali completamente gestiti ai propri dipendenti, i fornitori di rete possono fornire una o più sezioni di rete aziendale attive a cui viene indirizzato il traffico sui dispositivi aziendali. A partire da Android 12, Android consente agli operatori di fornire sezioni aziendali tramite regole URSP, anziché configurare le sezioni tramite APN.
Sezionamento delle app aziendali per dispositivi con profili di lavoro
Per le aziende che utilizzano la soluzione profilo di lavoro, Android 12 consente ai dispositivi di instradare il traffico di tutte le app nel profilo di lavoro a una sezione di rete aziendale. Le aziende possono attivare questa funzionalità tramite un controller dei criteri dei dispositivi (DPC).
La soluzione del profilo di lavoro fornisce un livello automatico di autenticazione e controllo dell'accesso richiesto dalle aziende per garantire che solo il traffico proveniente dalle app aziendali nel profilo di lavoro venga indirizzato alla sezione di rete aziendale. Le app nel profilo di lavoro non devono essere modificate per richiedere esplicitamente la sezione di rete aziendale.
Come funziona lo slicing della rete 5G in AOSP
Android 12 introduce il supporto del network slicing 5G tramite aggiunte al codebase di telefonia in AOSP e al modulo Tethering per incorporare le API di connettività esistenti necessarie per il network slicing.
La piattaforma di telefonia Android fornisce API HAL e di telefonia per supportare lo slicing in base alle richieste di rete inviate dal codice di networking principale e alle funzionalità di slicing 5G nel modem. La figura 1 descrive i componenti della funzionalità di sezionamento della rete 5G.
Figura 1. Architettura di slicing della rete 5G in AOSP.
La piattaforma di telefonia e connettività supporta:
- Conversione delle richieste di rete per le categorie di slice in descrittori di traffico che vengono poi passati al modem per la corrispondenza del traffico URSP e la selezione dell'itinerario
- Eseguire il fallback alla rete predefinita se lo slice di rete aziendale non è disponibile
- Instradamento del traffico da tutte le app nel profilo di lavoro alla connessione corrispondente
Supporto del sezionamento aziendale
- Rilevamento della presenza di un profilo di lavoro sul dispositivo
- Controllo delle autorizzazioni o delle indicazioni stradali fornite dal DPC utilizzato dall'amministratore IT dell'azienda
Il servizio di rete principale include le seguenti modifiche al modulo Tethering in Android 12:
- Aggiunge la maggior parte delle classi API pubbliche o di sistema di Tethering
al modulo
android.net.* Espande i limiti del modulo Tethering per includere:
f/b/core/java/android/net/…f/b/services/net/…f/b/services/core/java/com/android/server/connectivity/…f/b/services/core/java/com/android/server/ConnectivityService.javaf/b/services/core/java/com/android/server/TestNetworkService.java
Sposta il codice VPN dal modulo Tethering
Android 12 sposta il codice con le seguenti funzionalità nel modulo Tethering:
- Ricezione di richieste di connessione di rete dalle app
- Ricezione di richieste dal sistema (ad esempio "inserisci queste app in una sezione aziendale"; introdotto in Android 12)
- Invio di richieste dal sistema al codice di telefonia che tenta di configurare reti o sezioni tramite l'API HAL e il modem
- Comunicare a netd come instradare il traffico in base all'app (introdotto in Android 12)
- Informare le app su cosa sta succedendo al loro traffico di rete tramite
API
ConnectivityManagercomeNetworkCallback,getActiveNetwork,getNetworkCapabilities.
Implementazione
Per supportare lo slicing 5G su un dispositivo, quest'ultimo deve avere un modem che supporti
l'HAL IRadio 1.6, che include l'API
setupDataCall_1_6. Questa API configura una connessione dati e include i seguenti parametri
per supportare lo slicing 5G:
trafficDescriptor: Specifica il descrittore del traffico inviato al modemsliceInfo: specifica le informazioni per lo slice di rete da utilizzare in caso di handover da EPDG a 5GmatchAllRuleAllowed: specifica se è consentito utilizzare una regola URSP predefinita di corrispondenza totale. Telefonia imposta questo valore su true per le reti predefinite, ma non per gli slice. La regola di corrispondenza di tutte le reti viene applicata alle reti predefinite. Quando un'app richiede una sezione specifica non disponibile, questa viene segnalata come non disponibile. Per le app aziendali, il framework Telephony può eseguire il failover sulla rete predefinita se la rete aziendale non è disponibile.
I modem devono anche implementare l'API
getSlicingConfig
a meno che non sia segnalata come non supportata dall'API
getHalDeviceCapabilities.
Requisiti aziendali
Di seguito sono descritti i requisiti per le aziende per utilizzare lo slicing della rete 5G sui dispositivi in un deployment Android Enterprise.
- Assicurati che i dispositivi completamente gestiti o dei dipendenti configurati con un profilo di lavoro
siano compatibili con il 5G SA con modem che supportano l'API
setupDataCall_1_6. - Collabora con il partner operatore per la configurazione e le prestazioni dello slice o le caratteristiche dello SLA.
Attivare lo slicing 5G sui dispositivi configurati con un profilo di lavoro
Per i dispositivi configurati con profili di lavoro, lo slicing della rete 5G è disattivato per
impostazione predefinita in AOSP. Per attivare lo slicing di rete, gli amministratori IT aziendali possono attivare o disattivare il routing del traffico delle app del profilo di lavoro alla sezione di rete aziendale per ogni dipendente tramite il DPC EMM, che utilizza il metodo setPreferentialNetworkServiceEnabled nell'API DevicePolicyManager (DPM) (introdotta in Android 12).
I fornitori EMM con DPC personalizzati devono integrare l'API DevicePolicyManager per supportare i client aziendali.
Regole URSP
Questa sezione include informazioni per gli operatori sulla configurazione delle regole URSP per diverse categorie di slice, tra cui traffico aziendale, CBS, a bassa latenza e ad alta larghezza di banda. Quando configurano le regole URSP per diverse categorie di slice, gli operatori devono utilizzare i seguenti valori specifici per Android.
| ID | Valore | Descrizione |
|---|---|---|
| OSId | 97a498e3-fc92-5c94-8986-0333d06e4e47 |
L'OSId per Android è un UUID versione 5 generato con lo spazio dei nomi ISO OID e il nome "Android". |
Gli operatori devono configurare le regole URSP per ogni slice di traffico con il componente descrittore del traffico come "ID sistema operativo + tipo di ID app sistema operativo". Ad esempio, la sezione "ENTERPRISE"
deve avere un valore di
0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345.
Questo valore è una concatenazione di OSId, della lunghezza di OSAppId (0x0A)
e di OSAppId.
Per ulteriori informazioni sul tipo di componente descrittore del traffico, consulta
3GPP TS 24.526 Table 5.2.1.
La tabella seguente descrive i valori OSAppId per le diverse categorie di sezioni.
| Categoria della sezione | OSAppId | Descrizione |
|---|---|---|
| ENTERPRISE | 0x454E5445525052495345 |
OSAppId è una rappresentazione di array di byte della stringa "ENTERPRISE" |
| ENTERPRISE2 | 0x454E544552505249534532 |
OSAppId è una rappresentazione di array di byte della stringa "ENTERPRISE2" |
| ENTERPRISE3 | 0x454E544552505249534533 |
OSAppId è una rappresentazione di array di byte della stringa "ENTERPRISE3" |
| ENTERPRISE4 | 0x454E544552505249534534 |
OSAppId è una rappresentazione di array di byte della stringa "ENTERPRISE4" |
| ENTERPRISE5 | 0x454E544552505249534535 |
OSAppId è una rappresentazione di array di byte della stringa "ENTERPRISE5" |
| CBS | 0x434253 |
OSAppId è una rappresentazione di array di byte della stringa "CBS" |
| PRIORITIZE_LATENCY | 0x5052494f524954495a455f4c4154454e4359 |
OSAppId è una rappresentazione di array di byte della stringa "PRIORITIZE_LATENCY" |
| PRIORITIZE_BANDWIDTH | 0x5052494f524954495a455f42414e445749445448 |
OSAppId è una rappresentazione di array di byte della stringa "PRIORITIZE_BANDWIDTH" |
Esempi di regole URSP
Le seguenti tabelle mostrano regole URSP di esempio per traffico aziendale, CBS, a bassa latenza, a larghezza di banda elevata e predefinito.
Enterprise 1
Il supporto di Enterprise 1 è disponibile in Android 12 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico ENTERPRISE1:
| Regola URSP n. 1 (enterprise1) | |
|---|---|
| Precedenza | 1 (0x01) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 0x97A498E3FC925C9489860333D06E4E470A454E5445525052495345 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | enterprise |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | enterprise |
Enterprise 2
Il supporto di Enterprise 2 è disponibile in Android 13 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico ENTERPRISE2:
| Regola URSP n. 2 (enterprise2) | |
|---|---|
| Precedenza | 2 (0x02) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534532 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | enterprise2 |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | enterprise2 |
Enterprise 3
Il supporto di Enterprise 3 è disponibile in Android 13 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico ENTERPRISE3:
| Regola URSP n. 3 (enterprise3) | |
|---|---|
| Precedenza | 3 (0x03) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534533 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | enterprise3 |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | enterprise3 |
Enterprise 4
Il supporto di Enterprise 4 è disponibile in Android 13 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico ENTERPRISE4:
| Regola URSP n. 4 (enterprise4) | |
|---|---|
| Precedenza | 4 (0x04) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534534 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | enterprise4 |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | enterprise4 |
Enterprise 5
Il supporto di Enterprise 5 è disponibile in Android 13 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico ENTERPRISE5:
| Regola n. 5 dell'URSP (enterprise5) | |
|---|---|
| Precedenza | 5 (0x05) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 0x97A498E3FC925C9489860333D06E4E470B454E544552505249534535 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | enterprise5 |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | enterprise5 |
CBS
Il supporto di CBS è disponibile in Android 13 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico CBS:
| Regola URSP n. 6 (CBS) | |
|---|---|
| Precedenza | 6 (0x06) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 0x97A498E3FC925C9489860333D06E4E4703434253 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | cbs |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | cbs |
Bassa latenza
Il supporto per la bassa latenza è disponibile in Android 13 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico LOW_LATENCY:
| Regola n. 7 dell'URSP (bassa latenza) | |
|---|---|
| Precedenza | 7 (0x07) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 0x97A498E3FC925C9489860333D06E4E47125052494f524954495a455f4c4154454e4359 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | latenza |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | latenza |
Larghezza di banda elevata
Il supporto della larghezza di banda elevata è disponibile in Android 13 e versioni successive. Di seguito è riportato un esempio di regola URSP per il traffico HIGH_BANDWIDTH:
| Regola URSP n. 8 (larghezza di banda elevata) | |
|---|---|
| Precedenza | 8 (0x08) |
| Descrittore del traffico n. 1 | |
| Tipo di ID sistema operativo + ID app sistema operativo | 97A498E3FC925C9489860333D06E4E47145052494f524954495a455f42414e445749445448 |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
| Componente n. 2: DNN | per il caricamento |
| Descrittore di selezione del percorso n. 2 | |
| Precedenza | 2 (0x02) |
| Componente 1: DNN | per il caricamento |
Predefinito
| Regola URSP n. 9 (predefinita) | |
|---|---|
| Precedenza | 9 (0x09) |
| Descrittore del traffico n. 1 | |
| match-all | N/D |
| Descrittore di selezione del percorso n. 1 | |
| Precedenza | 1 (0x01) |
| Componente 1: S-NSSAI | SST:XX SD:YYYYYY |
Test
Per testare lo slicing della rete 5G, utilizza il seguente test manuale.
Per configurare un dispositivo per il test:
Assicurati che il criterio URSP sia configurato con una regola non predefinita che corrisponda alla categoria aziendale e che il descrittore di selezione dell'itinerario corrispondente mappi la categoria aziendale alla sezione aziendale; e una regola predefinita che indirizzi il traffico alla sezione internet predefinita.
Assicurati che sul dispositivo sia configurato un profilo di lavoro.
Attivare l'utilizzo dello slicing di rete tramite il DPC
Per testare il comportamento dello slicing di rete 5G:
- Verifica che sia stabilita una sessione PDU con lo slice aziendale (ad esempio utilizzando un indirizzo IP specifico) e che le app nel profilo di lavoro utilizzino questa sessione PDU.
- Verifica che sia stabilita una sessione PDU separata con lo slice internet predefinito e che le app nel profilo personale utilizzino la sessione PDU.
Upsell dello slicing 5G
La funzionalità di upsell dello slicing 5G, disponibile a partire da Android 14-QPR1, consente agli operatori di offrire funzionalità di rete migliorate (latenza e larghezza di banda) ai propri utenti tramite lo slicing della rete 5G.
La funzionalità di upsell dello slicing 5G utilizza la risposta TS.43 del server di autorizzazione dell'operatore per guidare il flusso di acquisto. Gli operatori possono utilizzare la risposta per specificare l'URL della webview di acquisto dell'operatore, inviare dati aggiuntivi alla webview e indicare se lo slice è sottoposto a provisioning e disponibile sulla rete dell'operatore.
Gli operatori possono personalizzare il comportamento della funzionalità di upsell dello slicing 5G utilizzando le configurazioni dell'operatore, che controllano se è possibile effettuare richieste di acquisto, quando le app possono richiedere funzionalità premium e per quanto tempo il framework di telefonia attende le risposte dell'utente o della rete.
La funzionalità di upsell dello slicing 5G fornisce un'interfaccia, chiamata
DataBoostWebServiceFlow,
per consentire la comunicazione tra Android e la webview dell'operatore.
La figura 2 mostra il flusso di acquisto dell'upsell dello slicing 5G:
Figura 2. Flusso di acquisto dell'upsell dello slicing 5G.
TS.43 entitlement process
Quando un utente richiede funzionalità di rete avanzate, il framework Telephony richiede la configurazione dei diritti di servizio per la funzionalità premium richiesta. Se la risposta TS.43 è valida, il framework Telephony utilizza i campi della risposta HTTP per gestire la richiesta di acquisto.
Sezionare i campi degli acquisti
La configurazione dei diritti TS.43 include i seguenti campi di acquisto delle slice:
- Stato diritto
Tasto:
EntitlementStatusTipo:
intValori supportati:
0(disattivato),1(attivato),2(incompatibile),3(provisioning),4(incluso)- Stato del provisioning
Tasto:
ProvStatusTipo:
intValori supportati:
0(non eseguito il provisioning),1(provisioning eseguito),2(non disponibile),3(in corso)
Il framework Telephony utilizza la combinazione dello stato dei diritti e dello stato di provisioning per determinare lo stato attuale dell'acquisto della slice. Il risultato può essere uno dei seguenti:
PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASEDPURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_IN_PROGRESSPURCHASE_PREMIUM_CAPABILITY_RESULT_ENTITLEMENT_CHECK_FAILEDPURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_ERROR
Se lo stato del diritto è 1 (attivato) e lo stato del provisioning è 0
(non eseguito), il framework di telefonia mostra una notifica di upsell all'utente
per acquistare il potenziamento tramite la webview dell'operatore. La seguente tabella
descrive il comportamento del framework Telephony per diverse combinazioni di
valori di stato di provisioning e diritto.
| Stato del provisioning | |||||
|---|---|---|---|---|---|
Non eseguito il provisioning (0) |
Provisioned (1 |
Non disponibile (2) |
In corso (3) |
||
| Stato del diritto | Disattivato (0) |
Operazione non riuscita | Operazione non riuscita | Operazione non riuscita | Operazione non riuscita |
Attivato (1) |
Mostra WebView | Già acquistato | Già acquistato | In corso | |
Incompatibile (2) |
Operazione non riuscita | Operazione non riuscita | Operazione non riuscita | Operazione non riuscita | |
Provisioning (3) |
Errore dell'operatore | Errore dell'operatore | In corso | In corso | |
Incluso (4) |
Errore dell'operatore | Già acquistato | Già acquistato | Errore dell'operatore | |
Campi del flusso di servizio
La risposta TS.43 specifica l'URL, i dati utente e il tipo di contenuti da personalizzare
il comportamento della webview di acquisto dell'operatore. Se il tipo di contenuti non è specificato, l'URL viene caricato come richiesta GET. Se i dati utente esistono, vengono aggiunti all'URL come parametro di ricerca (ad esempio, https://www.android.com?encodedValue=Base64EncodedUserData); se non esistono, l'URL viene utilizzato così com'è (ad esempio, https://www.android.com).
Se il tipo di contenuti è specificato in formato JSON o XML, l'URL viene caricato come richiesta POST e i dati utente (decodificati se sono codificati in Base64) vengono inviati come dati per la richiesta POST.
- URL
Tasto:
ServiceFlow_URLTipo:
StringEsempio:
"https://www.android.com"- Dati utente
Tasto:
ServiceFlow_UserDataTipo:
StringEsempio:
"encodedValue=Base64EncodedUserData"- Tipo di contenuti
Tasto:
ServiceFlow_ContentsTypeTipo:
StringValori supportati:
0(non specificato),1(JSON),2(XML)
Configurazioni dell'operatore
Di seguito sono riportate le configurazioni dell'operatore disponibili per personalizzare il comportamento della funzionalità di upsell dello slicing 5G.
KEY_SUPPORTED_PREMIUM_CAPABILITIES_INT_ARRAYUn elenco delle funzionalità premium supportate. Questo è un array di numeri interi di
TelephonyManager.PremiumCapability. Queste funzionalità premium condividono lo stesso valore della classeNetworkCapabilities.NetCapabilitycorrispondente. Se viene richiesta una funzionalità premium e non è inclusa in questa configurazione, la richiesta di acquisto non va a buon fine e viene restituito il risultatoCARRIER_DISABLED.In Android 14 è supportato solo
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY.KEY_PREMIUM_CAPABILITY_MAXIMUM_DAILY_NOTIFICATION_COUNT_INTIl numero massimo giornaliero di volte in cui la notifica di upsell dell'acquisto viene mostrata all'utente. Se viene raggiunto il limite massimo giornaliero, la notifica di upselling non viene mostrata e le richieste di acquisto (incluse le richieste del server dei diritti) vengono limitate fino a mezzanotte del giorno successivo. Le richieste di acquisto effettuate dopo il raggiungimento del massimo giornaliero non vanno a buon fine e restituiscono il risultato
PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.KEY_PREMIUM_CAPABILITY_MAXIMUM_MONTHLY_NOTIFICATION_COUNT_INTIl numero massimo mensile di volte in cui viene mostrata la notifica di upsell dell'acquisto all'utente. Se viene raggiunto il massimo mensile, la notifica di upsell non viene mostrata e le richieste di acquisto (incluse le richieste del server dei diritti) vengono limitate fino al primo giorno del mese successivo. Le richieste di acquisto effettuate dopo il raggiungimento del limite massimo mensile non vanno a buon fine e restituiscono il risultato
PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.KEY_PREMIUM_CAPABILITY_PURCHASE_URL_STRINGL'URL di acquisto dell'operatore di backup da mostrare all'utente quando fa clic sulla notifica di upselling. Se l'URL di acquisto non viene trovato nella risposta TS.43 del server dei diritti, viene utilizzato questo valore. Se né l'URL della risposta TS.43 né la configurazione dell'operatore sono validi, la richiesta di acquisto non va a buon fine e viene restituito il risultato
PURCHASE_PREMIUM_CAPABILITY_RESULT_CARRIER_DISABLED.KEY_PREMIUM_CAPABILITY_SUPPORTED_ON_LTE_BOOLSe consentire l'acquisto di funzionalità premium quando il dispositivo è connesso a Long-Term Evolution (LTE). Se
true, le richieste di acquisto possono essere effettuate sia su LTE sia su New Radio (NR). Sefalse, le richieste di acquisto possono essere effettuate solo su NR e le richieste effettuate su LTE non vanno a buon fine con il risultatoPURCHASE_PREMIUM_CAPABILITY_RESULT_NETWORK_NOT_AVAILABLE.KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONGIl periodo di tempo durante il quale mostrare all'utente la notifica di upsell dell'acquisto prima che venga annullata automaticamente. Quando la notifica viene annullata, le richieste successive vengono limitate e non vanno a buon fine con il risultato
PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.KEY_PREMIUM_CAPABILITY_NOTIFICATION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONGIl periodo di tempo durante il quale le successive richieste di acquisto devono essere limitate dopo un errore dovuto a timeout o annullamento da parte dell'utente. Se l'utente non fa clic sulla notifica di upsell dell'acquisto entro il timeout specificato da
KEY_PREMIUM_CAPABILITY_NOTIFICATION_DISPLAY_TIMEOUT_MILLIS_LONGo se annulla o chiude la notifica, viene avviato questo timer di backoff. Mentre questo timer è attivo, le richieste di acquisto non vanno a buon fine con il risultatoPURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.KEY_PREMIUM_CAPABILITY_PURCHASE_CONDITION_BACKOFF_HYSTERESIS_TIME_MILLIS_LONGIl periodo di tempo durante il quale le successive richieste di acquisto devono essere limitate dopo un errore dovuto all'operatore o alla rete. Se il controllo dei diritti non va a buon fine, l'URL non è disponibile o l'URL di acquisto dell'operatore indica un errore, viene avviato questo timer di backoff. Mentre questo timer è attivo, le richieste di acquisto non vanno a buon fine con il risultato
PURCHASE_PREMIUM_CAPABILITY_RESULT_THROTTLED.KEY_PREMIUM_CAPABILITY_NETWORK_SETUP_TIME_MILLIS_LONGIl periodo di tempo entro il quale la rete deve configurare una configurazione di slicing per la funzionalità premium di acquisto. Durante questo periodo, le successive richieste di acquisto vengono bloccate e restituiscono il risultato
PURCHASE_PREMIUM_CAPABILITY_RESULT_PENDING_NETWORK_SETUP. Se la rete non riesce a configurare una configurazione di slicing in tempo, le app possono richiedere nuovamente l'acquisto di funzionalità premium. La telefonia non considera un acquisto completato finché non viene inviata la configurazione di slicing corrispondente, indipendentemente dal fatto che l'utente abbia pagato o meno l'operatore.
Interfaccia JavaScript
Quando l'utente fa clic sulla notifica di potenziamento della rete, viene visualizzato un oggetto WebView con
l'URL di acquisto dell'operatore. Gli operatori possono utilizzare le API
fornite nell'interfaccia
JavaScript DataBoostWebServiceFlow nel loro sito web di acquisto per comunicare con l'app di acquisto
della fetta.
Il sito web dell'operatore può ottenere la funzionalità premium richiesta tramite il metodo
getRequestedCapability().
Se l'acquisto va a buon fine, il sito web dell'operatore deve comunicare all'app di acquisto della porzione
tramite notifyPurchaseSuccessful() o
notifyPurchaseSuccessful(duration), dove duration è un parametro facoltativo
che indica la durata prevista della porzione.
Se l'acquisto non va a buon fine, il sito web dell'operatore deve comunicarlo all'app di acquisto
della fetta tramite il metodo notifyPurchaseFailed(code, reason), dove code
è il codice di errore che indica il motivo dell'errore e reason è il
motivo dell'errore leggibile, se il codice di errore è sconosciuto.
Se non viene chiamato uno di questi metodi di risposta, l'acquisto non verrà considerato completato e la richiesta di acquisto scadrà.
Di seguito sono riportati i codici di errore validi che il sito web dell'operatore può restituire in caso di errore di acquisto:
FAILURE_CODE_UNKNOWNFAILURE_CODE_CARRIER_URL_UNAVAILABLEFAILURE_CODE_AUTHENTICATION_FAILEDFAILURE_CODE_PAYMENT_FAILEDFAILURE_CODE_NO_USER_DATA
Una volta completato l'acquisto, l'operatore deve aggiornare le
regole URSP
con lo slice PRIORITIZE_LATENCY sul dispositivo dell'utente.