מעקב אחר סטטוס הקישוריות ומדידת החיבור

ConnectivityManager מספק API שמאפשר לבקש שהמכשיר יתחבר לרשת על סמך תנאים שונים, כולל יכולות המכשיר ואפשרויות להעברת נתונים.

הטמעת הקריאה החוזרת מספקת לאפליקציה מידע על סטטוס החיבור של המכשיר ועל היכולות של הרשת שמחוברת כרגע. ה-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()
ConnectivityStatusType.kt

חשוב לזכור שחיבורים מסוימים יכולים להיות יקרים משמעותית מאחרים (לדוגמה, חיבור סלולרי הוא בדרך כלל יקר). משתמשים ב-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.
    }
}
ConnectivityStatusType.kt

הרשמה לקבלת עדכונים על הרשת

אחרי שמצהירים על NetworkRequest ו-NetworkCallback, משתמשים בפונקציות requestNetwork() או registerNetworkCallback() כדי לחפש רשת להתחברות מהמכשיר שעומדת בתנאי של NetworkRequest. הסטטוס מדווח ל-NetworkCallback.

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