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

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

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

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

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

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

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

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

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

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

ฟังก์ชันที่ใช้กันมากที่สุดใน NetworkCallback มีดังนี้

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

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

    // Network capabilities have changed for the network.
    override fun onCapabilitiesChanged(
        network: Network,
        networkCapabilities: NetworkCapabilities
    ) {
        val unmetered =
            networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_NOT_METERED)
        if (!unmetered) {
            // Reduce data usage, or delay it until the network is unmetered.
        }
    }

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

ลงทะเบียนเพื่อรับข้อมูลอัปเดตเกี่ยวกับเครือข่าย

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

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