ใช้การแบ่งเครือข่าย

การแบ่งส่วนเครือข่าย 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

หากคำขออนุมัติการซื้อไม่สำเร็จ แอปอาจใช้เครือข่ายเริ่มต้นแทน จะไม่มีลักษณะการทำงานของโฆษณาสำรองอัตโนมัติหากไม่สามารถดำเนินการตามคำขอ Premium Slice ได้

ขั้นตอน UX สำหรับการขายอัปเซลการแบ่งส่วน

ขั้นตอน UX จะแสดงการแจ้งเตือนแก่ผู้ใช้ซึ่งจะเปิดชีตบนเว็บของผู้ให้บริการที่ผู้ใช้สามารถทำการซื้อให้เสร็จสมบูรณ์ได้
รูปที่ 1 ขั้นตอน UX ของการขายอัปเซลการแบ่งส่วนเครือข่ายตั้งแต่การแจ้งเตือนของผู้ให้บริการไปจนถึงการยืนยันการซื้อ