27 মার্চ, 2025 থেকে, আমরা AOSP তৈরি করতে এবং অবদান রাখতে aosp-main এর পরিবর্তে android-latest-release ব্যবহার করার পরামর্শ দিচ্ছি। আরও তথ্যের জন্য, AOSP-তে পরিবর্তনগুলি দেখুন।
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন
আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।
কানেক্টিভিটি ডায়াগনস্টিকস এপিআই সেই অ্যাপগুলিকে অনুমতি দেয় যেগুলি নেটওয়ার্কগুলির মালিকানা বা পরিচালনা করে, যেমন ক্যারিয়ার অ্যাপস, ভিপিএন অ্যাপস এবং ওয়াই-ফাই সাজেশন অ্যাপগুলিকে ফ্রেমওয়ার্ক থেকে ডায়াগনস্টিক নেটওয়ার্ক সংযোগের তথ্য পেতে। এই অ্যাপগুলি কলব্যাক নিবন্ধন করতে পারে এবং তাদের মালিকানাধীন বা পরিচালনা করা নেটওয়ার্কগুলির জন্য সংযোগ তথ্য সহ বিজ্ঞপ্তিগুলি গ্রহণ করতে পারে৷ অ্যাপ্লিকেশানগুলি এমন নেটওয়ার্কগুলির জন্য বিজ্ঞপ্তি পাবে না যেগুলি অ্যাপের মালিকানাধীন বা পরিচালিত নয়৷
নিম্নলিখিত অ্যাপগুলির উদাহরণ রয়েছে যা নেটওয়ার্ক পরিচালনা করে বা তার মালিকানা রাখে:
ক্যারিয়ার অ্যাপ্লিকেশানগুলি: সেলুলার নেটওয়ার্কগুলি পরিচালনা করুন যার জন্য তাদের subId ক্যারিয়ারের বিশেষাধিকার রয়েছে
ওয়াই-ফাই সাজেশন অ্যাপস: নিজস্ব ওয়াই-ফাই নেটওয়ার্ক যা তারা সিস্টেমে সাজেস্ট করে
VPN অ্যাপ্লিকেশানগুলি: তাদের VPN ব্যবহার করে এমন সমস্ত নেটওয়ার্ক পরিচালনা করুন, কিন্তু শুধুমাত্র যখন তারা সক্রিয় VPN হয়
নিম্নলিখিত ক্ষেত্রে কলব্যাক আহ্বান করা হয়:
নেটওয়ার্ক যাচাইকরণ: সিস্টেমটি একটি নির্দিষ্ট নেটওয়ার্কের মূল্যায়ন শেষ করেছে। ConnectivityReport ক্লাস নেটওয়ার্কের বর্তমান অবস্থা এবং যাচাইকরণের অংশ হিসাবে সম্পাদিত যেকোনো পরীক্ষা বা পদ্ধতির ফলাফলের তথ্য প্রদান করে।
public class ConnectivityReport {
Network network;
long reportTimestamp;
LinkProperties linkProperties;
NetworkCapabilities networkCapabilities;
PersistableBundle additionalInfo;
}
ডেটা স্টল সন্দেহজনক: একটি ডেটা স্টল, এমন একটি শর্ত যেখানে IP প্যাকেটগুলি নেটওয়ার্কের মাধ্যমে সঠিকভাবে প্রবাহিত হয় না, সন্দেহ করা হয়। DataStallReport ক্লাস সন্দেহভাজন ডেটা স্টল সম্পর্কে তথ্য প্রদান করে।
public class DataStallReport {
Network network;
long reportTimestamp;
int detectionMethod;
LinkProperties linkProperties;
NetworkCapabilities networkCapabilities;
PersistableBundle stallDetails;
}
কানেক্টিভিটি রিপোর্ট করা হয়েছে: একটি অ্যাপ সিস্টেমে ConnectivityManager#reportNetworkConnectivity এর মাধ্যমে কানেক্টিভিটি রিপোর্ট করেছে। নেটওয়ার্ক এবং রিপোর্ট করা সংযোগ (অ্যাপ বিশ্বাস করে যে নেটওয়ার্ক সংযোগ প্রদান করে বা না করে) শেয়ার করা হয়।
বাস্তবায়ন
কানেক্টিভিটি ডায়াগনস্টিকস এপিআই ব্যবহার করতে, একটি অ্যাপকে প্ল্যাটফর্ম থেকে একটি ConnectivityDiagnosticsManager ইনস্ট্যান্স পেতে হবে। এই দৃষ্টান্তটি ConnectivityDiagnosticsCallback বাস্তবায়ন নিবন্ধন এবং নিবন্ধনমুক্ত করতে ব্যবহার করা উচিত। যে কলব্যাক পদ্ধতিগুলি ওভাররাইড করা হয় না সেগুলি নো-অপস৷
ConnectivityDiagnosticsCallback নিবন্ধন এবং আন-রেজিস্টার করার জন্য নীচে একটি উদাহরণ রয়েছে:
NetworkRequestrequest=newNetworkRequest.Builder().addTransportType(TRANSPORT_CELLULAR).build();// Use an Executor that is appropriate for your use caseExecutorexecutor=Executors.newSingleThreadExecutor();ConnectivityDiagnosticsManagercdm=context.getSystemService(ConnectivityDiagnosticsManager.class);ExampleCallbackcallback=newExampleCallback();cdm.registerConnectivityDiagnosticsCallback(request,executor,callback);...// Collect connectivity information on networks that match with request...cdm.unregisterConnectivityDiagnosticsCallback(callback);
এই পৃষ্ঠার কন্টেন্ট ও কোডের নমুনাগুলি Content License-এ বর্ণিত লাইসেন্সের অধীনস্থ। Java এবং OpenJDK হল Oracle এবং/অথবা তার অ্যাফিলিয়েট সংস্থার রেজিস্টার্ড ট্রেডমার্ক।
2025-07-29 UTC-তে শেষবার আপডেট করা হয়েছে।
[[["সহজে বোঝা যায়","easyToUnderstand","thumb-up"],["আমার সমস্যার সমাধান হয়েছে","solvedMyProblem","thumb-up"],["অন্যান্য","otherUp","thumb-up"]],[["এতে আমার প্রয়োজনীয় তথ্য নেই","missingTheInformationINeed","thumb-down"],["খুব জটিল / অনেক ধাপ","tooComplicatedTooManySteps","thumb-down"],["পুরনো","outOfDate","thumb-down"],["অনুবাদ সংক্রান্ত সমস্যা","translationIssue","thumb-down"],["নমুনা / কোড সংক্রান্ত সমস্যা","samplesCodeIssue","thumb-down"],["অন্যান্য","otherDown","thumb-down"]],["2025-07-29 UTC-তে শেষবার আপডেট করা হয়েছে।"],[],[],null,["# Connectivity Diagnostics API\n\nThe Connectivity Diagnostics API allows apps that own or manage networks, such\nas carrier apps, VPN apps, and Wi-Fi suggestion apps, to receive diagnostic\nnetwork connectivity information from the framework. These apps can register\ncallbacks and receive notifications with connectivity information for the\nnetworks that they own or manage. Apps won't receive notifications for networks\nthat aren't owned or managed by the app.\n\nThe following are examples of apps that manage or own networks:\n\n- **Carrier apps:** Manage cellular networks for which their `subId` has carrier privileges for\n- **Wi-Fi suggestion apps:** Own Wi-Fi networks that they suggest to the system\n- **VPN apps:** Manage all networks that their VPN uses, but only when they are the active VPN\n\nCallbacks are invoked in the following cases:\n\n- **Network validation:** The system finished evaluating a specific network.\n The\n [`ConnectivityReport`](https://developer.android.com/reference/android/net/ConnectivityDiagnosticsManager.ConnectivityReport)\n class provides information on the current state of the network and the\n results of any tests or procedures performed as part of the validation.\n\n public class ConnectivityReport {\n Network network;\n long reportTimestamp;\n LinkProperties linkProperties;\n NetworkCapabilities networkCapabilities;\n PersistableBundle additionalInfo;\n }\n\n- **Data stall suspected:** A data stall, a condition in which IP packets\n aren't properly flowing through the network, is suspected. The\n [`DataStallReport`](https://developer.android.com/reference/android/net/ConnectivityDiagnosticsManager.DataStallReport)\n class provides information about suspected data stalls.\n\n public class DataStallReport {\n Network network;\n long reportTimestamp;\n int detectionMethod;\n LinkProperties linkProperties;\n NetworkCapabilities networkCapabilities;\n PersistableBundle stallDetails;\n }\n\n- **Connectivity reported:** An app has reported connectivity through\n [`ConnectivityManager#reportNetworkConnectivity`](https://developer.android.com/reference/android/net/ConnectivityManager#reportNetworkConnectivity(android.net.Network,%20boolean))\n to the system. The network and reported connectivity (whether the app\n believes the network does or doesn't provide connectivity) is shared.\n\nImplementation\n--------------\n\n| **Note:** Apps registering callbacks must have the [`ACCESS_FINE_LOCATION`](https://developer.android.com/reference/android/Manifest.permission#ACCESS_FINE_LOCATION) permission because connecting to location-specific networks can expose the fine location of the user.\n\nTo use the Connectivity Diagnostics API, an app must obtain a\n[`ConnectivityDiagnosticsManager`](https://developer.android.com/reference/android/net/ConnectivityDiagnosticsManager)\ninstance from the platform. This instance should be used to register and\nunregister\n[`ConnectivityDiagnosticsCallback`](https://developer.android.com/reference/android/net/ConnectivityDiagnosticsManager.ConnectivityDiagnosticsCallback)\nimplementations. Callback methods that aren't overridden are no-ops.\n\nBelow is an example of a\n[`ConnectivityDiagnosticsCallback`](https://developer.android.com/reference/android/net/ConnectivityDiagnosticsManager.ConnectivityDiagnosticsCallback)\nimplementation: \n\n public class ExampleCallback extends ConnectivityDiagnosticsCallback {\n @Override\n public void onConnectivityReportAvailable(@NonNull ConnectivityReport report) {\n ... \n // Log data, take action based on report result, etc\n ... \n }\n\n @Override\n public void onDataStallSuspected(@NonNull DataStallReport report) {\n ... \n // Log data, take action based on report result, etc\n ... \n }\n\n @Override\n public void onNetworkConnectivityReported(\n @NonNull Network network, boolean hasConnectivity) {\n ... \n // Log data, take action based on report result, etc\n ... \n }\n }\n\nTo register callbacks and receive notifications, call\n[`registerConnectivityDiagnosticsCallback`](https://developer.android.com/reference/android/net/ConnectivityDiagnosticsManager#registerConnectivityDiagnosticsCallback(android.net.NetworkRequest,%20java.util.concurrent.Executor,%20android.net.ConnectivityDiagnosticsManager.ConnectivityDiagnosticsCallback)).\nTo unregister callbacks and stop receiving notifications, call\n[`unregisterConnectivityDiagnosticsCallback`](https://developer.android.com/reference/android/net/ConnectivityDiagnosticsManager#unregisterConnectivityDiagnosticsCallback(android.net.ConnectivityDiagnosticsManager.ConnectivityDiagnosticsCallback)).\n| **Note:** The callbacks must be registered and unregistered using the same [`uid`](https://developer.android.com/reference/android/content/pm/ApplicationInfo.html#uid).\n\nBelow is an example for registering and unregistering\n`ConnectivityDiagnosticsCallback`: \n\n NetworkRequest request =\n new NetworkRequest.Builder()\n .addTransportType(TRANSPORT_CELLULAR)\n .build();\n // Use an Executor that is appropriate for your use case\n Executor executor = Executors.newSingleThreadExecutor();\n\n ConnectivityDiagnosticsManager cdm =\n context.getSystemService(ConnectivityDiagnosticsManager.class);\n\n ExampleCallback callback = new ExampleCallback();\n cdm.registerConnectivityDiagnosticsCallback(\n request, executor, callback);\n\n ... \n // Collect connectivity information on networks that match with request\n ... \n\n cdm.unregisterConnectivityDiagnosticsCallback(callback);\n\nValidation\n----------\n\nThe Connectivity Diagnostics API is CTS tested by\n[`ConnectivityDiagnosticsManagerTest`](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Connectivity/tests/cts/net/src/android/net/cts/ConnectivityDiagnosticsManagerTest.java)."]]
