การแบ่งส่วนเครือข่าย 5G ช่วยให้ผู้ให้บริการสามารถเพิ่มประสิทธิภาพเครือข่ายสำหรับ Use Case ที่เฉพาะเจาะจงได้ คู่มือนี้จะอธิบายวิธีที่แอปสามารถใช้ฟีเจอร์การแบ่งส่วนเครือข่าย
คู่มือนี้ยังครอบคลุมวิธีทริกเกอร์ขั้นตอน UX ของการขายอัปเซลการแบ่งส่วนเครือข่ายในกรณีที่ต้องซื้อก่อนแอปจึงจะเข้าถึงการเชื่อมต่อพรีเมียมได้
ขั้นตอนที่ 1: ประกาศ Intent ของความสามารถระดับพรีเมียม
เพื่อให้คำขอของแอปสำหรับความสามารถในการแบ่งส่วนแบบพรีเมียมได้รับการตอบสนอง แอปของคุณต้องประกาศเจตนาที่จะขอความสามารถดังกล่าวในไฟล์ Manifest ของแอป
ไม่เช่นนั้น คำขอเครือข่ายจะล้มเหลวและแสดงข้อผิดพลาด SecurityException
โดยแอปของคุณต้องประกาศพร็อพเพอร์ตี้ PackageManager.PROPERTY_SELF_CERTIFIED_NETWORK_CAPABILITIES ในไฟล์ AndroidManifest.xml และรวมไฟล์ทรัพยากร XML ที่เกี่ยวข้อง
การประกาศความสามารถในไฟล์ Manifest จะมีลักษณะดังนี้
<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;
}
});
}
Callback 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
หากคำขออนุมัติการซื้อไม่สำเร็จ แอปอาจใช้เครือข่ายเริ่มต้นแทน จะไม่มีลักษณะการทำงานของโฆษณาสำรองอัตโนมัติหากไม่สามารถดำเนินการตามคำขอ Premium Slice ได้
ขั้นตอน UX สำหรับการขายอัปเซลการแบ่งส่วน