O fracionamento de rede 5G permite que as operadoras melhorem o desempenho da rede para casos de uso específicos. Este guia explica como um app pode usar o recurso de fatiamento de rede.
Este guia também aborda como acionar o fluxo de UX de upsell de fatiamento de rede nos casos em que uma compra é necessária antes que o app possa acessar a conexão premium.
Etapa 1: declarar intents de recursos premium
Para que a solicitação do app de um recurso de fatiamento premium seja atendida,
ele precisa declarar a intenção de solicitar esse recurso no manifesto do app.
Caso contrário, a solicitação de rede vai falhar, gerando um SecurityException.
Para fazer isso, o app precisa declarar a propriedade
PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES no
arquivo AndroidManifest.xml e incluir um arquivo de recurso XML correspondente.
Uma declaração de recurso no arquivo de manifesto tem esta aparência:
<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
android:resource="@xml/network_capabilities" />
O arquivo de recurso network_capabilities.xml correspondente é assim:
<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
<uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>
Etapa 2: verificar se o recurso premium está disponível
Chame o método de API requestNetwork para determinar se o recurso premium está disponível.
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;
}
});
}
Ao criar um objeto NetworkRequest, o recurso adicionado não é o mesmo que você transmite para as APIs TelephonyManager.
A tabela a seguir mapeia as constantes da classe TelephonyManager para as
constantes correspondentes em NetworkCapabilities.
Constante TelephonyManager |
Constante NetworkCapabilities |
|---|---|
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY |
NET_CAPABILITY_PRIORITIZE_LATENCY |
Etapa 3: se o recurso premium não estiver disponível, verifique se ele pode ser comprado
Chame o método de API isPremiumCapabilityAvailableForPurchase para
determinar se o recurso premium selecionado está disponível. Esse método
retorna true se o recurso estiver disponível para compra na operadora
usando o fluxo de trabalho de notificação de 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;
}
Etapa 4: iniciar o fluxo de notificação de upsell
Depois de confirmar que o recurso premium está disponível, o app precisa chamar
purchasePremiumCapability() para iniciar o fluxo de notificação de upsell.
Se o usuário ainda não tiver comprado o recurso especificado e todas as
condições prévias forem atendidas, a plataforma vai mostrar uma notificação
informando que as opções de aumento de desempenho podem estar disponíveis na
operadora. Se o usuário tocar na notificação, a plataforma vai abrir a WebView da operadora para que o processo de compra possa continuar.
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;
}
});
}
O callback parameter transmitido para purchasePremiumCapability() retorna um
código de resultado para o pedido de aprovação de compra.
Os códigos de resultado PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS e
PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED representam
resultados bem-sucedidos em que o app pode solicitar o recurso
premium selecionado.
Os códigos de resultado na lista a seguir representam pedidos de aprovação de compra que falharam. Consulte a referência da API para saber mais sobre eles.
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 o pedido de aprovação de compra falhar, o app poderá usar a rede padrão. Não há comportamento de fallback automático se a solicitação de fração premium não puder ser atendida.
Fluxo de UX para upsell de fatiamento