ক্রোনেটইঞ্জিন

const val ACTIVE_REQUEST_COUNT_UNKNOWN = -1: Int

সক্রিয় অনুরোধ সংখ্যার মান অজানা।

const val CONNECTION_METRIC_UNKNOWN = -1: Int

একটি সংযোগ মেট্রিকের মান অজানা।

const val EFFECTIVE_CONNECTION_TYPE_2G = 3: Int

কার্যকরী সংযোগের ধরণ হিসেবে আনুমানিক মান হলো ২জি।

const val EFFECTIVE_CONNECTION_TYPE_3G = 4: Int

কার্যকরী সংযোগের ধরণ হিসেবে ৩জি অনুমান করা হয়েছে।

const val EFFECTIVE_CONNECTION_TYPE_4G = 5: Int

কার্যকরী সংযোগের ধরণ হিসেবে ৪জি অনুমান করা হয়েছে।

const val EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1: Int

ডিভাইসটি অফলাইন।

const val EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2: Int

কার্যকরী সংযোগের ধরণ হিসেবে ধীরগতির ২জি-কে অনুমান করা হচ্ছে।

const val EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0: Int

কার্যকরী সংযোগের ধরণটির আনুমানিক মান অজানা।

const val UNBIND_NETWORK_HANDLE = -1: Long

পূর্ববর্তী যেকোনো নেটওয়ার্ক বাইন্ডিং বাতিল করার জন্য যে মানটি ব্যবহার করা হবে।

fun addRequestFinishedListener(listener: RequestFinishedInfo.Listener!): Unit

একটি লিসেনার রেজিস্টার করে, যা প্রতিটি অনুরোধের শেষে অনুরোধের তথ্যসহ কল ​​করা হয়।

লিসেনার কর্তৃক প্রদত্ত একটি java.util.concurrent.Executor এর উপর লিসেনারটিকে কল করা হয়।

fun addRttListener(listener: NetworkQualityRttListener!): Unit

একটি লিসেনার রেজিস্টার করে, যা নেটওয়ার্ক কোয়ালিটি এস্টিমেটর কোনো স্যাম্পল রাউন্ড ট্রিপ টাইম শনাক্ত করলেই কল করা হয়। এটি অবশ্যই enableNetworkQualityEstimator পরে কল করতে হবে, অন্যথায় এটি একটি এক্সেপশন থ্রো করবে। রাউন্ড ট্রিপ টাইম নেটওয়ার্ক স্ট্যাকের বিভিন্ন স্তরে রেকর্ড করা হতে পারে, যার মধ্যে রয়েছে TCP, QUIC এবং URL রিকোয়েস্ট লেয়ার। এই লিসেনারটি enableNetworkQualityEstimator এ পাস করা java.util.concurrent.Executor এর উপর কল করা হয়।

fun addThroughputListener(listener: NetworkQualityThroughputListener!): Unit

একটি লিসেনার রেজিস্টার করে, যা নেটওয়ার্ক কোয়ালিটি এস্টিমেটর যখনই কোনো স্যাম্পল থ্রুপুট মেজারমেন্ট প্রত্যক্ষ করে, তখনই কল করা হয়। এটি অবশ্যই enableNetworkQualityEstimator পরে কল করতে হবে। যখন অন্তত একটি URL রেসপন্স পাওয়া যায়, সেই সময়ে সক্রিয় নেটওয়ার্ক ইন্টারফেসের মাধ্যমে পঠিত বাইট পরিমাপ করে থ্রুপুট অবজারভেশন গণনা করা হয়। এই লিসেনারটি enableNetworkQualityEstimator এ পাস করা java.util.concurrent.Executor এর উপর কল করা হয়।

fun bindToNetwork(networkHandle: Long): Unit

ইঞ্জিনটিকে নির্দিষ্ট নেটওয়ার্ক হ্যান্ডেলের সাথে সংযুক্ত করে। এই ইঞ্জিনের মাধ্যমে তৈরি করা সমস্ত অনুরোধ এই হ্যান্ডেলের সাথে যুক্ত নেটওয়ার্কটি ব্যবহার করবে। যদি এই নেটওয়ার্কটি সংযোগ বিচ্ছিন্ন হয়ে যায়, তবে সমস্ত অনুরোধ ব্যর্থ হবে; নেটওয়ার্ক সংযোগ বিচ্ছিন্ন হওয়ার সময় অনুরোধ প্রক্রিয়াকরণের কোন পর্যায়ে ত্রুটিটি ঘটবে, তার উপর নির্ভর করবে। Network#getNetworkHandle এর মাধ্যমে নেটওয়ার্ক হ্যান্ডেল পাওয়া যায়। এটি শুধুমাত্র অ্যান্ড্রয়েড মার্শমেলো থেকে উপলব্ধ।

fun configureNetworkQualityEstimatorForTesting(
    useLocalHostRequests: Boolean,
    useSmallerResponses: Boolean,
    disableOfflineCheck: Boolean
): Unit

পরীক্ষার জন্য নেটওয়ার্ক কোয়ালিটি এস্টিমেটর কনফিগার করে। রাউন্ড ট্রিপ টাইম ও থ্রুপুট লিসেনার যোগ করার আগে এবং নেটওয়ার্ক কোয়ালিটি এস্টিমেটর সক্রিয় করার পরে এটি অবশ্যই কল করতে হবে।

abstract fun createURLStreamHandlerFactory(): URLStreamHandlerFactory!

HTTP এবং HTTPS ট্র্যাফিক পরিচালনা করার জন্য একটি URLStreamHandlerFactory তৈরি করে। setURLStreamHandlerFactory এর মাধ্যমে এই ক্লাসের একটি ইনস্ট্যান্স ইনস্টল করা যায়, যার ফলে openConnection-এর মাধ্যমে তৈরি করা সমস্ত অনুরোধের জন্য ডিফল্টরূপে এই CronetEngine-টি ব্যবহৃত হয়।

ক্রোনেট সিস্টেমের মাধ্যমে প্রদত্ত কিছু HTTP বৈশিষ্ট্য ব্যবহার করে না:

• HttpResponseCache.install() এর মাধ্যমে HTTP ক্যাশে ইনস্টল করা হয়।
• setDefault মাধ্যমে ইনস্টল করা HTTP প্রমাণীকরণ পদ্ধতি
• setDefault মাধ্যমে ইনস্টল করা HTTP কুকি স্টোরেজ

ক্রোনেট HTTPS প্রোটোকল ব্যবহার করে করা অনুরোধগুলোকে সমর্থন ও উৎসাহিত করলেও, এটি HttpsURLConnection API-এর জন্য কোনো সমর্থন প্রদান করে না। এই সমর্থনের অভাবের মধ্যে সিস্টেমের মাধ্যমে প্রদত্ত কিছু নির্দিষ্ট HTTPS বৈশিষ্ট্য ব্যবহার না করাও অন্তর্ভুক্ত:

• HttpsURLConnection.setDefaultHostnameVerifier() এর মাধ্যমে HTTPS হোস্টনেম ভেরিফায়ার ইনস্টল করা হয়।
• HttpsURLConnection.setDefaultSSLSocketFactory() এর মাধ্যমে HTTPS সকেট ফ্যাক্টরি ইনস্টল করা হয়।

fun getActiveRequestCount(): Int

সক্রিয় অনুরোধের সংখ্যা ফেরত দেয়।

UrlRequest.start() মেথডটি কোনো এক্সেপশন থ্রো না করলে, একটি রিকোয়েস্ট সেই মেথডে "অ্যাক্টিভ" হয়ে যায়। যখন সমস্ত কলব্যাক রিটার্ন করে এবং ভবিষ্যতে আর কোনো অতিরিক্ত কলব্যাক ট্রিগার করা যায় না, তখন এটি ইনঅ্যাক্টিভ হয়ে যায়। বাস্তবে, এর মানে হলো onSucceeded/onCanceled/onFailed রিটার্ন করার পর এবং সমস্ত রিকোয়েস্ট ফিনিশড লিসেনার রিটার্ন করার পর রিকোয়েস্টটি ইনঅ্যাক্টিভ হয়ে যায়। আরও তথ্যের জন্য Cronet রিকোয়েস্টের লাইফসাইকেল দেখুন ।

fun getDownstreamThroughputKbps(): Int

নেটওয়ার্ক কোয়ালিটি এস্টিমেটর দ্বারা গণনাকৃত ডাউনস্ট্রিম থ্রুপুট অনুমান (কিলোবিট প্রতি সেকেন্ডে) ফেরত দেয়। মানটি অনুপলব্ধ হলে CONNECTION_METRIC_UNKNOWN এ সেট করুন। এটি অবশ্যই enableNetworkQualityEstimator পরে কল করতে হবে, অন্যথায় এটি একটি এক্সেপশন থ্রো করবে।

fun getEffectiveConnectionType(): Int

নেটওয়ার্ক কোয়ালিটি এস্টিমেটর দ্বারা গণনাকৃত কার্যকর সংযোগ প্রকারের একটি আনুমানিক মান ফেরত দেয়। এই মানটির গণনা শুরু করতে enableNetworkQualityEstimator কল করুন।

fun getHttpRttMs(): Int

নেটওয়ার্ক কোয়ালিটি এস্টিমেটর দ্বারা গণনাকৃত HTTP RTT আনুমানিক মান (মিলিসেকেন্ডে) ফেরত দেয়। মানটি অনুপলব্ধ হলে CONNECTION_METRIC_UNKNOWN এ সেট করুন। এটি অবশ্যই enableNetworkQualityEstimator পরে কল করতে হবে, অন্যথায় এটি একটি এক্সেপশন থ্রো করবে।

fun getTransportRttMs(): Int

নেটওয়ার্ক কোয়ালিটি এস্টিমেটর দ্বারা গণনাকৃত ট্রান্সপোর্ট RTT আনুমানিক মান (মিলিসেকেন্ডে) ফেরত দেয়। মানটি অনুপলব্ধ হলে CONNECTION_METRIC_UNKNOWN এ সেট করা হয়। এটি অবশ্যই enableNetworkQualityEstimator পরে কল করতে হবে, অন্যথায় এটি একটি এক্সেপশন থ্রো করবে।

abstract fun newUrlRequestBuilder(
    url: String!,
    callback: UrlRequest.Callback!,
    executor: Executor!
): UrlRequest.Builder!

UrlRequest জন্য একটি বিল্ডার তৈরি করে। তৈরি হওয়া UrlRequest অবজেক্টগুলোর সমস্ত কলব্যাক executor এর থ্রেডগুলোতে আহ্বান করা হবে। নেটওয়ার্কিং অপারেশন ব্লক হওয়া এবং শাটডাউনের সময় এক্সেপশন ঘটা প্রতিরোধ করার জন্য, executor অবশ্যই execute কলকারী থ্রেডে কোনো টাস্ক চালাতে নেই।

abstract fun openConnection(url: URL!): URLConnection!

URL url দ্বারা নির্দিষ্ট রিসোর্সের সাথে একটি নতুন সংযোগ স্থাপন করে।

দ্রষ্টব্য: Cronet-এর java.net.HttpURLConnection ইমপ্লিমেন্টেশনে কিছু সীমাবদ্ধতা রয়েছে, বিস্তারিত জানতে createURLStreamHandlerFactory দেখুন।

fun removeRequestFinishedListener(listener: RequestFinishedInfo.Listener!): Unit

একটি সমাপ্ত অনুরোধ লিসেনার মুছে ফেলে।

fun removeRttListener(listener: NetworkQualityRttListener!): Unit

যদি পূর্বে addRttListener দিয়ে রাউন্ড ট্রিপ টাইমের কোনো লিসেনার রেজিস্টার করা হয়ে থাকে, তবে এটি তা সরিয়ে দেয়। অবজারভেশন গ্রহণ বন্ধ করার জন্য একটি NetworkQualityRttListener যোগ করার পরে এটি কল করা উচিত।

fun removeThroughputListener(listener: NetworkQualityThroughputListener!): Unit

থ্রুপুটের একটি লিসেনার সরিয়ে দেয়। পর্যবেক্ষণ গ্রহণ বন্ধ করার জন্য, addThroughputListener ব্যবহার করে একটি NetworkQualityThroughputListener যোগ করার পরে এটি কল করা উচিত।

abstract fun shutdown(): Unit

কোনো সক্রিয় অনুরোধ না থাকলে CronetEngine বন্ধ করে দেয়, অন্যথায় একটি ব্যতিক্রম (exception) প্রদর্শন করে।

নেটওয়ার্ক থ্রেডে কল করা যাবে না - যে থ্রেড থেকে Cronet, Executor-কে কল করে (যা Executor-এর কলব্যাক আহ্বানকারী থ্রেড থেকে ভিন্ন)। CronetEngine এর সমস্ত রিসোর্স পরিষ্কার না হওয়া পর্যন্ত এটি ব্লক হয়ে থাকতে পারে।

fun startNetLogToDisk(dirPath: String!, logAll: Boolean, maxSize: Int): Unit

একটি নির্দিষ্ট ডিরেক্টরিতে সীমিত আকারে নেটলগ লগিং শুরু করে। নেটলগটিতে সমস্ত সক্রিয় ক্রোনেটইঞ্জিন দ্বারা নির্গত ইভেন্টগুলো থাকবে। ডিবাগিংয়ের জন্য নেটলগটি উপযোগী। লগিং বন্ধ হয়ে গেলে stopNetLog , ডেটাগুলো dirPath এর netlog.json ফাইলে লেখা হবে। যদি লগিং বাধাগ্রস্ত হয়, তবে আপনি https://chromium.googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py ব্যবহার করে .inprogress সাবডিরেক্টরিতে থাকা ফাইলগুলো ম্যানুয়ালি স্টিচ করতে পারেন। Chrome ব্রাউজারে chrome://net-internals/#import-এ গিয়ে লগটি দেখা যাবে।

abstract fun startNetLogToFile(fileName: String!, logAll: Boolean): Unit

একটি ফাইলে নেটলগ লগিং শুরু করে। নেটলগটিতে সমস্ত সক্রিয় ক্রোনেটইঞ্জিন দ্বারা নির্গত ইভেন্টগুলি থাকবে। ডিবাগিংয়ের জন্য নেটলগটি উপযোগী। ক্রোম ব্রাউজার ব্যবহার করে chrome://net-internals/#import -এ গিয়ে ফাইলটি দেখা যাবে।

abstract fun stopNetLog(): Unit

NetLog লগিং বন্ধ করে এবং ফাইলটি ডিস্কে ফ্লাশ করে। যদি কোনো লগিং সেশন চালু না থাকে, তবে এই কলটি উপেক্ষা করা হয়।