La segmentación de red 5G permite a los operadores mejorar el rendimiento de la red en casos de uso específicos. En esta guía, se explica cómo una app puede usar la función de división de red.
En esta guía, también se explica cómo activar el flujo de UX de venta incremental de la división de red en los casos en que se requiere una compra antes de que la app pueda acceder a la conexión premium.
Paso 1: Declara intents de funciones premium
Para que se respete la solicitud de tu app de una capacidad de división premium,
esta debe declarar su intent de solicitar esa capacidad en el manifiesto de la app.
De lo contrario, la solicitud de red fallará y arrojará un SecurityException.
Para ello, tu app debe declarar la propiedad PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES en el archivo AndroidManifest.xml y, además, incluir un archivo de recursos XML correspondiente.
Una declaración de capacidad en el archivo de manifiesto se ve de la siguiente manera:
<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
android:resource="@xml/network_capabilities" />
El archivo de recursos network_capabilities.xml correspondiente se ve de la siguiente manera:
<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
<uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>
Paso 2: Verifica si la función premium está disponible
Llama al método de la API requestNetwork para determinar si la función premium está disponible.
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;
}
});
}
Cuando compilas un objeto NetworkRequest, la capacidad que agregas no es la misma que pasas a las APIs de TelephonyManager.
En la siguiente tabla, se asignan las constantes de la clase TelephonyManager a las constantes correspondientes en NetworkCapabilities.
Constante TelephonyManager |
Constante NetworkCapabilities |
|---|---|
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY |
NET_CAPABILITY_PRIORITIZE_LATENCY |
Paso 3: Si la función premium no está disponible, verifica si se puede comprar
Llama al método de la API isPremiumCapabilityAvailableForPurchase para determinar si la capacidad premium seleccionada está disponible. Este método devuelve true si la capacidad está disponible para comprarla al operador con el flujo de trabajo de notificación de venta incremental.
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;
}
Paso 4: Inicia el flujo de notificaciones de venta incremental
Después de confirmar que la función premium está disponible, tu app debe llamar a purchasePremiumCapability() para iniciar el flujo de notificaciones de venta incremental.
Si el usuario aún no compró la capacidad especificada y se cumplen todas las condiciones previas, la plataforma le muestra una notificación para informarle que es posible que su operador tenga disponibles opciones de mejora del rendimiento. Si el usuario presiona la notificación, la plataforma abre la vista web del operador para que el proceso de compra pueda 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;
}
});
}
La devolución de llamada parameter que se pasa a purchasePremiumCapability() devuelve un código de resultado para la solicitud de compra.
Los códigos de resultado PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS y PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED representan resultados exitosos en los que tu app puede continuar con la solicitud de la capacidad premium seleccionada.
Los códigos de resultado de la siguiente lista representan solicitudes de compra fallidas. Consulta la referencia de la API para obtener más información sobre ellos.
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
Si la solicitud de compra falla, es posible que tu app use la red predeterminada. No hay un comportamiento de resguardo automático si no se puede completar la solicitud de porción premium.
Flujo de UX para la venta incremental de porciones