ตรวจสอบสถานะการเชื่อมต่อและการวัดการเชื่อมต่อ

ConnectivityManager จะมี API ที่ให้คุณขอให้อุปกรณ์เชื่อมต่อกับเครือข่ายได้ เงื่อนไขต่างๆ ซึ่งรวมถึงความสามารถของอุปกรณ์และตัวเลือกการส่งข้อมูล

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

กำหนดค่าคำขอเครือข่าย

เพื่อระบุประเภทการส่งของเครือข่าย เช่น Wi-Fi หรือเครือข่ายมือถือ และความสามารถของเครือข่ายที่เชื่อมต่ออยู่ในปัจจุบัน เช่น อินเทอร์เน็ต การเชื่อมต่อ คุณต้องกำหนดค่าคำขอเครือข่าย

ประกาศNetworkRequestที่ จะอธิบายความต้องการในการเชื่อมต่อเครือข่ายของแอป โค้ดต่อไปนี้จะสร้าง เครือข่ายที่เชื่อมต่อกับอินเทอร์เน็ตและใช้ Wi-Fi หรือการเชื่อมต่อเครือข่ายมือถือ สำหรับประเภทการขนส่ง

Kotlin

val networkRequest = NetworkRequest.Builder()
        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
        .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
        .build()

Java

NetworkRequest networkRequest = new NetworkRequest.Builder()
        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
        .addTransportType(NetworkCapabilities.TRANSPORT_CELLULAR)
        .build();

โปรดทราบว่าการเชื่อมต่อบางประเภทอาจมีราคาแพงกว่าการเชื่อมต่ออื่นๆ (สำหรับ เช่น การเชื่อมต่อมือถือมักจะราคาแพง) ใช้ NetworkCapabilities#NET_CAPABILITY_NOT_METERED เพื่อระบุว่าการเชื่อมต่อมีค่าใช้จ่ายสูงหรือไม่ เมื่อใช้การเชื่อมต่อแบบจำกัดปริมาณ พยายามลดการใช้อินเทอร์เน็ตของแอป หรือหน่วงเวลาจนกว่าอุปกรณ์จะ การเชื่อมต่อแบบไม่จำกัดปริมาณอินเทอร์เน็ต

กำหนดค่าการเรียกกลับของเครือข่าย

เมื่อลงทะเบียน NetworkRequest กับ ConnectivityManager คุณต้อง ใช้ NetworkCallback เพื่อรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงสถานะการเชื่อมต่อและเครือข่าย ความสามารถ

ฟังก์ชันที่มีการใช้งานบ่อยที่สุดใน NetworkCallback ได้แก่ ดังต่อไปนี้:

• onAvailable() ระบุว่าอุปกรณ์เชื่อมต่อกับเครือข่ายใหม่ที่ตรงตาม ข้อกำหนดเกี่ยวกับความสามารถและประเภทการขนส่งที่ระบุไว้ใน NetworkRequest
• onLost() แสดงว่าอุปกรณ์ขาดการเชื่อมต่อกับเครือข่าย
• onCapabilitiesChanged() แสดงให้เห็นว่าความสามารถของเครือข่ายมีการเปลี่ยนแปลง ออบเจ็กต์ NetworkCapabilities รายการ ให้ข้อมูลเกี่ยวกับความสามารถในปัจจุบันของเครือข่าย

Kotlin

private val networkCallback = object : ConnectivityManager.NetworkCallback() {
    // network is available for use
    override fun onAvailable(network: Network) {
        super.onAvailable(network)
    }

    // Network capabilities have changed for the network
    override fun onCapabilitiesChanged(
            network: Network,
            networkCapabilities: NetworkCapabilities
    ) {
        super.onCapabilitiesChanged(network, networkCapabilities)
        val unmetered = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)
    }

    // lost network connection
    override fun onLost(network: Network) {
        super.onLost(network)
    }
}

Java

private ConnectivityManager.NetworkCallback networkCallback = new ConnectivityManager.NetworkCallback() {
    @Override
    public void onAvailable(@NonNull Network network) {
        super.onAvailable(network);
    }

    @Override
    public void onLost(@NonNull Network network) {
        super.onLost(network);
    }

    @Override
    public void onCapabilitiesChanged(@NonNull Network network, @NonNull NetworkCapabilities networkCapabilities) {
        super.onCapabilitiesChanged(network, networkCapabilities);
        final boolean unmetered = networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED);
    }
};

ลงทะเบียนสำหรับการอัปเดตเครือข่าย

หลังจากที่คุณประกาศ NetworkRequest และ NetworkCallback ให้ใช้ requestNetwork() หรือ registerNetworkCallback() ฟังก์ชันสำหรับค้นหาเครือข่ายเพื่อเชื่อมต่อจากอุปกรณ์ที่เป็นไปตาม NetworkRequest จากนั้นระบบจะรายงานสถานะไปยัง NetworkCallback

Kotlin

val connectivityManager = getSystemService(ConnectivityManager::class.java) as ConnectivityManager
connectivityManager.requestNetwork(networkRequest, networkCallback)

Java

ConnectivityManager connectivityManager =
        (ConnectivityManager) getSystemService(ConnectivityManager.class);
connectivityManager.requestNetwork(networkRequest, networkCallback);