يتيح تقسيم شبكة الجيل الخامس لمشغّلي شبكات الجوّال تحسين أداء الشبكة في حالات استخدام معيّنة. يوضّح هذا الدليل كيفية استخدام أحد التطبيقات لميزة تقسيم الشبكة.
يتناول هذا الدليل أيضًا كيفية تفعيل مسار تجربة المستخدم لبيع ميزات إضافية في تقسيم الشبكة في الحالات التي تتطلّب إجراء عملية شراء قبل أن يتمكّن التطبيق من الوصول إلى الاتصال المميّز.
الخطوة 1: الإعلان عن الأهداف المتعلّقة بالميزات المدفوعة
لكي تتم الموافقة على طلب تطبيقك للحصول على ميزة تقسيم الشبكة المميّزة،
يجب أن يوضّح تطبيقك نيته في طلب هذه الميزة في ملف بيان التطبيق.
وإلا، سيتعذّر تنفيذ طلب الشبكة وسيظهر الخطأ 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>
الخطوة 2: التحقّق من توفّر الميزة المدفوعة
استخدِم طريقة واجهة برمجة التطبيقات 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 |
الخطوة 3: إذا لم تكن الميزة المدفوعة متاحة، تحقَّق من توفّرها للشراء
استدعِ طريقة واجهة برمجة التطبيقات 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() لبدء عملية إرسال إشعارات الارتقاء بالمبيعات.
إذا لم يسبق للمستخدم شراء الميزة المحدّدة وتم استيفاء جميع الشروط المسبقة، ستعرض المنصة إشعارًا للمستخدم لإعلامه بأنّ خيارات تحسين الأداء قد تكون متاحة من مشغّل شبكة الجوّال. إذا نقر المستخدم على الإشعار، تفتح المنصة عرض الويب الخاص بمشغّل شبكة الجوّال
ليتمكّن المستخدم من مواصلة عملية الشراء.
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 نتائج ناجحة يمكن لتطبيقك من خلالها المتابعة لطلب الميزة المدفوعة المحدّدة.
تمثّل رموز النتائج في القائمة التالية طلبات الموافقة على الشراء التي تعذّر إكمالها. يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات لمزيد من المعلومات عنها.
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
إذا تعذّر طلب الموافقة على الشراء، قد يستخدم تطبيقك الشبكة التلقائية بدلاً من ذلك. لا تتوفّر ميزة احتياطية تلقائية في حال تعذُّر تلبية طلب شريحة الشبكة المميّزة.
مسار تجربة المستخدم لبيع شرائح إضافية