NetworkCallback: apa itu, penerapan dan penanganan jaringan di Android

Apa itu NetworkCallback?

NetworkCallback — adalah kelas abstrak dari paket android.net, yang merupakan bagian dari Android SDK. Ini dirancang untuk menerima pemberitahuan tentang perubahan status koneksi jaringan melalui layanan sistem ConnectivityManager.

Sebelum munculnya NetworkCallback, pengembang menggunakan penerima siaran BroadcastReceiver untuk melacak jaringan. Pendekatan ini memerlukan pendaftaran konstan di manifes, bekerja dengan penundaan, dan tidak memberikan informasi detail tentang karakteristik koneksi. Android 5.0 (API 21) memperkenalkan NetworkCallback sebagai alternatif yang lebih fleksibel dan efisien.

Callback bekerja secara asinkron: aplikasi berlangganan ke peristiwa melalui ConnectivityManager, dan sistem memanggil metode callback saat status jaringan berubah. Ini menghilangkan kebutuhan polling periodik status jaringan, menghemat sumber daya baterai dan prosesor.

Bagaimana callback bekerja di Android

ConnectivityManager mengelola semua antarmuka jaringan perangkat — Wi-Fi, data seluler, Ethernet, VPN. Saat salah satu antarmuka ini berubah, sistem membuat objek Network dan mengirimkannya ke metode yang sesuai dari callback yang terdaftar. Setiap Network memiliki pengenal unik yang berubah saat koneksi ulang.

Callback tidak terikat pada jenis jaringan tertentu — ia dapat melacak semua antarmuka yang tersedia secara bersamaan. Untuk memfilter jenis koneksi, digunakan kelas NetworkRequest, di mana protokol transport yang diperlukan (Wi-Fi, data seluler, Ethernet) dan kemampuan jaringan ditentukan.

Cara mendaftarkan NetworkCallback di aplikasi

Pendaftaran NetworkCallback dilakukan melalui metode ConnectivityManager.registerNetworkCallback. Parameter pertama adalah NetworkRequest.Builder yang menjelaskan persyaratan jaringan, parameter kedua — instance callback. Untuk beroperasi, diperlukan izin ACCESS_NETWORK_STATE di manifes.

class NetworkMonitor(private val context: Context) {

    private val connectivityManager =
        context.getSystemService(Context.CONNECTIVITY_SERVICE)
            as ConnectivityManager

    private val callback =
        object : ConnectivityManager.NetworkCallback() {

        override fun onAvailable(network: Network) {
            Log.d("Network", "Tersedia: ${network}")
        }

        override fun onLost(network: Network) {
            Log.d("Network", "Hilang: ${network}")
        }
    }

    fun register() {
        connectivityManager.registerNetworkCallback(
            NetworkRequest.Builder().build(), callback
        )
    }

    fun unregister() {
        connectivityManager.unregisterNetworkCallback(callback)
    }
}

Pendaftaran di Activity dan Fragment

Disarankan untuk mendaftarkan NetworkCallback saat aplikasi berada di latar depan dan membatalkannya saat beralih ke latar belakang. Di Activity, nyaman menggunakan onStart dan onStop untuk mengelola siklus hidup callback. Di Fragment — onResume dan onPause.

Untuk menyederhanakan manajemen pendaftaran, dapat digunakan komponen Lifecycle-aware. Pustaka AndroidX Lifecycle memungkinkan pembuatan LifecycleObserver kustom yang secara otomatis mendaftarkan dan membatalkan callback saat status siklus hidup berubah.

Pendaftaran di layanan

Untuk tugas latar belakang, pendaftaran dilakukan di Service atau WorkManager. Penting untuk diingat bahwa di Android 8+ layanan latar belakang memiliki batasan untuk memulai. WorkManager dengan NetworkType — cara yang lebih andal untuk menjalankan tugas pada status jaringan tertentu, karena terintegrasi dengan API kompatibilitas dan mempertimbangkan mode Doze.

Metode utama NetworkCallback

NetworkCallback menyediakan serangkaian metode yang dipanggil saat status jaringan berubah. Tidak semua metode harus ditimpa — cukup implementasikan hanya yang diperlukan untuk tugas spesifik aplikasi. onAvailable dan onLost adalah minimal yang diperlukan untuk pemantauan dasar koneksi.

Metode onCapabilitiesChanged

Metode ini adalah kunci untuk mendapatkan informasi detail tentang jaringan. Parameter NetworkCapabilities berisi flag: NET_CAPABILITY_INTERNET — akses internet, NET_CAPABILITY_NOT_METERED — koneksi tak terbatas, NET_CAPABILITY_NOT_ROAMING — tanpa roaming. Juga dapat diketahui penundaan sinyal dan bandwidth.

Portal captive (captive portals) — kasus terpisah: saat terhubung ke jaringan Wi-Fi publik melalui portal, metode onCapabilitiesChanged tidak langsung menampilkan INTERNET. Pertama jaringan tersedia, tetapi tanpa internet — diperlukan otorisasi melalui browser. Pengembang harus mempertimbangkan penundaan ini dalam logika aplikasi.

Metode onBlockedStatusChanged

Dipanggil ketika sistem memblokir lalu lintas jaringan untuk aplikasi — misalnya, saat mengaktifkan mode hemat data atau membatasi data latar belakang. onBlockedStatusChanged memungkinkan aplikasi mengetahui bahwa permintaan jaringannya untuk sementara dilarang dan beralih ke pemrosesan lokal.

Contoh implementasi NetworkCallback

Mari kita lihat implementasi praktis NetworkCallback untuk melacak akses internet dan menangani portal captive. Dalam contoh di bawah ini ditunjukkan pemeriksaan NET_CAPABILITY_INTERNET dan validasi koneksi melalui permintaan HTTP ke server Google.

val networkCallback = object : ConnectivityManager.NetworkCallback() {

    override fun onCapabilitiesChanged(
        network: Network,
        caps: NetworkCapabilities
    ) {
        val hasInternet = caps.hasCapability(
            NetworkCapabilities.NET_CAPABILITY_INTERNET
        )
        val isMetered = caps.hasCapability(
            NetworkCapabilities.NET_CAPABILITY_NOT_METERED
        ).not()

        when {
            hasInternet && isMetered ->
                Log.d("Network", "Data seluler terhubung")
            hasInternet ->
                Log.d("Network", "Wi-Fi terhubung")
            else ->
                Log.d("Network", "Tidak ada akses internet")
        }
    }

    override fun onLost(network: Network) {
        Log.d("Network", "Koneksi hilang: ${network}")
        // Hentikan permintaan jaringan
    }
}

Penanganan portal captive

Saat terhubung ke jaringan publik dengan otorisasi (kafe, bandara), sistem pertama melaporkan onAvailable, tetapi onCapabilitiesChanged mungkin tidak menampilkan INTERNET. Dalam kasus seperti itu, diperlukan pemeriksaan tambahan melalui permintaan HTTP ke endpoint yang stabil, misalnya https://www.google.com/generate_204.

Jika permintaan mengembalikan kode 204 — internet tersedia. Jika pengalihan (301, 302, 307) — diperlukan otorisasi melalui browser. Dalam hal ini, dapat dibuka WebView atau Intent ke URL pengalihan untuk melakukan otentikasi di portal.

fun Context.validateInternet(network: Network) {
    CoroutineScope(Dispatchers.IO).launch {
        try {
            val url = URL("https://www.google.com/generate_204")
            val connection =
                network.openConnection(url) as HttpURLConnection
            connection.instanceFollowRedirects = false
            connection.connect()
            when (connection.responseCode) {
                HttpURLConnection.HTTP_NO_CONTENT ->
                    Log.d("Network", "Internet tersedia")
                in HttpURLConnection.HTTP_MOVED_PERM
                        ..HttpURLConnection.HTTP_TEMP_REDIRECT ->
                    Log.d("Network", "Portal captive terdeteksi")
            }
            connection.disconnect()
        } catch (e: Exception) {
            Log.e("Network", "Validasi gagal: ${e.message}")
        }
    }
}

Perbedaan dari cara pemantauan jaringan lainnya

Sebelum NetworkCallback, metode utama pemantauan jaringan adalah BroadcastReceiver dengan filter android.net.conn.CONNECTIVITY_CHANGE. Pendekatan ini memiliki kekurangan signifikan: penundaan beberapa detik, kurangnya informasi tentang tipe antarmuka, konsumsi daya tinggi karena terus-menerus membangunkan perangkat.

Alternatif modern — LiveData atau StateFlow bersama dengan NetworkCallback. Polanya terdiri dari membungkus callback dalam aliran reaktif yang secara otomatis memberi tahu UI tentang perubahan status. Misalnya, MutableStateFlow dengan tipe NetworkStatus diperbarui di dalam metode callback, dan ViewCollector berlangganan perubahan.

Bekerja dengan mode latar belakang

Mulai Android 10, tingkat pembatasan latar belakang diperketat dan NetworkCallback mungkin tidak dipanggil saat aplikasi di latar belakang. Untuk tugas yang sangat penting — misalnya, memuat data saat jaringan muncul — gunakan WorkManager dengan pembatasan NetworkType.CONNECTED. WorkManager menjamin pelaksanaan tugas saat kondisi jaringan terpenuhi.

Di Android 12+ muncul pembatasan untuk pendaftaran manifes BroadcastReceiver untuk CONNECTIVITY_ACTION. Pengembang wajib bermigrasi ke NetworkCallback atau menggunakan WorkManager. Kebijakan Google Play sejak Agustus 2022 memerlukan penghapusan pendaftaran manifes untuk tindakan ini.