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);