Сегментирование сетей 5G позволяет операторам связи повышать производительность сети для определенных сценариев использования. В этом руководстве рассказывается, как использовать функцию разделения сети в приложении.
В этом руководстве также рассказывается, как запустить процесс продажи нарезки сети, если для доступа к премиум-подключению требуется покупка.
Шаг 1. Объявите намерения для платных функций
Чтобы запрос приложения на доступ к премиум-слайсу был выполнен, в манифесте приложения должно быть указано намерение запросить эту функцию.
В противном случае сетевой запрос завершается ошибкой SecurityException.
Для этого в файле AndroidManifest.xml нужно объявить свойство PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES и добавить соответствующий XML-файл ресурсов.
Декларация возможностей в файле манифеста выглядит следующим образом:
<property android:name="android.net.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES"
android:resource="@xml/network_capabilities" />
Файл ресурсов network_capabilities.xml выглядит следующим образом:
<network-capabilities-declaration> xmlns:android="http://schemas.android.com/apk/res/android">
<uses-network-capability android:name="NET_CAPABILITY_PRIORITIZE_LATENCY"/>
</network-capabilities-declaration>
Шаг 2. Проверьте, доступна ли платная функция
Вызовите API-метод requestNetwork, чтобы определить, доступна ли платная функция.
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;
}
});
}
При создании объекта NetworkRequest вы добавляете не ту же функцию, которую передаете в API TelephonyManager.
В таблице ниже показано, как константы из класса TelephonyManager сопоставляются с константами в NetworkCapabilities.
TelephonyManager: само постоянство |
NetworkCapabilities: само постоянство |
|---|---|
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY |
NET_CAPABILITY_PRIORITIZE_LATENCY |
Шаг 3. Если премиум-функция недоступна, проверьте, можно ли ее купить
Вызовите API-метод isPremiumCapabilityAvailableForPurchase, чтобы определить, доступна ли выбранная платная функция. Этот метод возвращает true, если возможность можно приобрести у оператора связи с помощью рабочего процесса уведомлений о дополнительных продажах.
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;
}
Шаг 4. Настройте уведомления о возможности перехода на более дорогой тариф
Убедившись, что премиум-функция доступна, приложение должно вызвать purchasePremiumCapability(), чтобы инициировать показ уведомления о возможности апсейла.
Если пользователь ещё не приобрел указанную функцию и все предварительные условия выполнены, платформа показывает пользователю уведомление о том, что у его оператора могут быть доступны варианты повышения производительности. Если пользователь нажмет на уведомление, платформа откроет компонент WebView оператора, чтобы можно было продолжить покупку.
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;
}
});
}
Обратный вызов parameter, переданный в purchasePremiumCapability(), возвращает код результата для запроса о покупке.
Коды результатов PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS и PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED означают, что приложение может запросить выбранную платную функцию.
Коды результатов в списке ниже представляют собой неудачные запросы на покупку. Подробную информацию о них можно найти в документации по 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
Если запрос на покупку не удастся выполнить, приложение может использовать сеть по умолчанию. Если запрос на премиум-слайс не может быть выполнен, автоматический переход на резервный вариант не предусмотрен.
UX-процесс для апсейла фрагментов