Bağlantı durumunu ve bağlantı sayacını izleme

ConnectivityManager, cihazın özelliklerini ve veri aktarım seçeneklerini içeren çeşitli koşullara göre cihazın bir ağa bağlanmasını istemenize olanak tanıyan bir API sağlar.

Geri çağırma uygulaması, uygulamanıza cihazın bağlantı durumu ve o anda bağlı olan ağın özellikleri hakkında bilgi sağlar. API, cihazın uygulamanızın gereksinimlerini karşılayan bir ağa bağlı olup olmadığını belirlemenize olanak tanır.

Ağ isteği yapılandırma

Ağın aktarım türünü (ör. kablosuz veya hücresel bağlantı) ve o anda bağlı olan ağın özelliklerini (ör. internet bağlantısı) belirtmek için bir ağ isteği yapılandırmanız gerekir.

Uygulamanızın ağ bağlantısı ihtiyaçlarını açıklayan bir NetworkRequest beyan edin. Aşağıdaki kod, internete bağlı olan ve taşıma türü için kablosuz, ethernet veya hücresel bağlantı kullanan bir ağ için istek oluşturur.

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

Bazı bağlantıların diğerlerinden çok daha pahalı olabileceğini unutmayın (örneğin, mobil bağlantı genellikle pahalıdır). Bağlantının pahalı olup olmadığını belirlemek için NetworkCapabilities#NET_CAPABILITY_NOT_METERED özelliğini kullanın. Sayaçlı bağlantı kullanırken uygulamanızın veri tüketimini azaltmaya çalışın veya cihazın sayaçsız bağlantısı olana kadar veri tüketimini geciktirin.

Ağ geri çağırma işlevini yapılandırma

NetworkRequest öğesini ConnectivityManager ile kaydettiğinizde, bağlantı durumu ve ağ özelliklerindeki değişikliklerle ilgili bildirimleri almak için bir NetworkCallback uygulamanız gerekir.

NetworkCallback içinde en sık uygulanan işlevler şunlardır:

  • onAvailable(), cihazın NetworkRequest içinde belirtilen özellik ve aktarım türü şartlarını karşılayan yeni bir ağa bağlı olduğunu gösterir.
  • onLost() cihazın ağ bağlantısının kesildiğini gösterir.
  • onCapabilitiesChanged() ağın özelliklerinin değiştiğini gösterir. NetworkCapabilities nesnesi, ağın mevcut özellikleri hakkında bilgi sağlar.

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.
    }
}

Ağ güncellemelerine kaydolma

NetworkRequest ve NetworkCallback değerlerini beyan ettikten sonra, cihazdan bağlanılacak ve NetworkRequest değerini karşılayan bir ağ aramak için requestNetwork() veya registerNetworkCallback() işlevlerini kullanın. Ardından durum NetworkCallback'e bildirilir.

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