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

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

การใช้งานการเรียกกลับจะส่งข้อมูลเกี่ยวกับสถานะการเชื่อมต่อของอุปกรณ์ รวมถึงความสามารถของเครือข่ายที่เชื่อมต่ออยู่ในปัจจุบันไปยังแอป 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);