برش شبکه 5G به شرکتهای مخابراتی امکان میدهد عملکرد شبکه را برای موارد استفاده خاص تقویت کنند. این راهنما توضیح میدهد که برنامه چگونه میتواند از ویژگی برش شبکه استفاده کند.
این راهنما همچنین نحوه راهاندازی جریان تجربه کاربری بیشفروشی برش شبکه را در مواردی که خرید قبلاز دسترسی برنامه به اتصال ممتاز لازم است پوشش میدهد.
مرحله ۱: اعلام کردن هدفهای قابلیت پولی
برای اینکه درخواست برنامهتان برای قابلیت برش ممتاز پذیرفته شود،
برنامهتان باید قصد خود را برای درخواست آن قابلیت در مانیفست برنامه اعلام کند.
درغیراینصورت، درخواست شبکه ناموفق میشود و SecurityException را برمیگرداند.
برای انجام این کار، برنامهتان باید ویژگی
PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES را در
فایل AndroidManifest.xml اعلام کند و فایل منبع 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>
مرحله ۲: بررسی کنید که آیا قابلیت ممتاز دردسترس است یا نه
با روش میانای برنامهسازی کاربردی 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 میسازید، قابلیتی که اضافه میکنید با قابلیتی که به میاناهای برنامهسازی کاربردی TelephonyManager ارسال میکنید یکسان نیست.
جدول زیر ثابتهای کلاس TelephonyManager را به ثابتهای متناظر در NetworkCapabilities نگاشت میکند.
یادآور همیشگی TelephonyManager |
یادآور همیشگی NetworkCapabilities |
|---|---|
PREMIUM_CAPABILITY_PRIORITIZE_LATENCY |
NET_CAPABILITY_PRIORITIZE_LATENCY |
مرحله ۳: اگر قابلیت ممتاز دردسترس نیست، دردسترس بودن برای خرید را بررسی کنید
روش میانای برنامهسازی کاربردی 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;
}
مرحله ۴: شروع جریان اعلان بیشفروشی
پساز تأیید اینکه قابلیت ممتاز دردسترس است، برنامهتان باید
purchasePremiumCapability() را فراخوانی کند تا جریان اعلان فروش گرانتر را آغاز کند.
اگر کاربر قبلاً قابلیت مشخصشده را خریداری نکرده باشد و همه پیششرطها برآورده شده باشد، پلاتفرم اعلانی به کاربر نشان میدهد تا به او اطلاع دهد که گزینههای تقویت عملکرد ممکن است ازسوی شرکت مخابراتی او دردسترس باشد. اگر کاربر روی اعلان تکضرب بزند، پلاتفرم نمای وب شرکت مخابراتی را باز میکند تا فرایند خرید ادامه یابد.
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 callback passed to purchasePremiumCapability() returns a
result code for the purchase request.
کدهای نتیجه PURCHASE_PREMIUM_CAPABILITY_RESULT_SUCCESS و
PURCHASE_PREMIUM_CAPABILITY_RESULT_ALREADY_PURCHASED نشاندهنده
نتایج موفقیتآمیزی هستند که برنامهتان میتواند برای درخواست قابلیت ممتاز انتخابشده ادامه دهد.
کدهای نتیجه در فهرست زیر نشاندهنده درخواستهای خرید ناموفق است. برای کسب اطلاعات بیشتر درباره آنها، مرجع میانای برنامهسازی کاربردی را ببینید.
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
اگر درخواست خرید ناموفق باشد، ممکن است برنامهتان بهجای آن از شبکه پیشفرض استفاده کند. اگر درخواست برش ممتاز برآورده نشود، هیچ رفتار بازگشت خودکاری وجود ندارد.
جریان تجربه کاربری برای فروش گرانتر برش