تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

CronetEngine

abstract class CronetEngine

الفئات الفرعية المباشرة المعروفة

CronetEngineBase

CronetEngineBase

الفئات الفرعية غير المباشرة المعروفة

JavaCronetEngine

JavaCronetEngine

‫java.net.HttpURLConnection التي تستند إلى CronetEngine

محرك لمعالجة UrlRequest، ويستخدم أفضل حزمة HTTP متاحة على النظام الأساسي الحالي. يمكن إنشاء مثيل لهذه الفئة باستخدام Builder.

ملخّص

الأنواع المتداخلة
`class CronetEngine.Builder` أداة إنشاء `CronetEngine`، تتيح ضبط `CronetEngine` في وقت التشغيل.
`abstract class CronetEngine.Builder.LibraryLoader` تم إيقاف هذه الفئة نهائيًا. لم يكن System.loadLibrary موثوقًا به في الإصدارات التي تقل عن 23 من minSDK أو تساويه، وتم استخدام هذه الطريقة لتوفير أدوات تحميل بديلة وأكثر موثوقية.

الأنواع المتداخلة

class CronetEngine.Builder

أداة إنشاء CronetEngine، تتيح ضبط CronetEngine في وقت التشغيل.

abstract class CronetEngine.Builder.LibraryLoader

تم إيقاف هذه الفئة نهائيًا.

لم يكن System.loadLibrary موثوقًا به في الإصدارات التي تقل عن 23 من minSDK أو تساويه، وتم استخدام هذه الطريقة لتوفير أدوات تحميل بديلة وأكثر موثوقية.

الثوابت
`const Int`	`ACTIVE_REQUEST_COUNT_UNKNOWN = -1` قيمة عدد الطلبات النشطة غير معروفة
`const Int`	`CONNECTION_METRIC_UNKNOWN = -1` قيمة مقياس الاتصال غير معروفة.
`const Int`	`EFFECTIVE_CONNECTION_TYPE_2G = 3` تقدير نوع الاتصال الفعّال هو الجيل الثاني.
`const Int`	`EFFECTIVE_CONNECTION_TYPE_3G = 4` تقدير نوع الاتصال الفعّال هو 3G.
`const Int`	`EFFECTIVE_CONNECTION_TYPE_4G = 5` تقدير نوع الاتصال الفعّال هو 4G.
`const Int`	`EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1` الجهاز غير متصل بالإنترنت.
`const Int`	`EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2` تقدير نوع الاتصال الفعّال هو شبكة الجيل الثاني البطيئة.
`const Int`	`EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0` تقدير نوع الاتصال الفعّال غير معروف.
`const Long`	`UNBIND_NETWORK_HANDLE = -1` القيمة التي سيتم استخدامها للتراجع عن أي ربط سابق بالشبكة

طُرق وضع التصميم العامة
`CronetEngine()`

الدوال العامة
`Unit`	`addRequestFinishedListener(listener: RequestFinishedInfo.Listener!)` تسجّل هذه السمة معالجًا يتم استدعاؤه بعد انتهاء كل طلب مع معلومات الطلب.
`Unit`	`addRttListener(listener: NetworkQualityRttListener!)` تسجِّل هذه الطريقة أداة معالجة يتم استدعاؤها عندما يرصد مقدّر جودة الشبكة وقت نقل البيانات ذهابًا وإيابًا.
`Unit`	`addThroughputListener(listener: NetworkQualityThroughputListener!)` تسجّل هذه الطريقة أداة معالجة يتم استدعاؤها عندما يشهد مقدّر جودة الشبكة قياسًا لسرعة معالجة البيانات.
`Unit`	`bindToNetwork(networkHandle: Long)` يربط المحرّك بمقبض الشبكة المحدّد.
`Unit`	`configureNetworkQualityEstimatorForTesting( useLocalHostRequests: Boolean, useSmallerResponses: Boolean, disableOfflineCheck: Boolean )` تضبط هذه السمة أداة تقدير جودة الشبكة لأغراض الاختبار.
`abstract URLStreamHandlerFactory!`	`createURLStreamHandlerFactory()` تنشئ هذه السمة `URLStreamHandlerFactory` للتعامل مع الزيارات الواردة من HTTP وHTTPS.
`Int`	`getActiveRequestCount()` تعرِض هذه السمة عدد الطلبات النشطة.
`Int`	`getDownstreamThroughputKbps()` تعرض هذه السمة تقديرًا لمعدّل نقل البيانات من الخادم إلى الجهاز (بالكيلوبت في الثانية) الذي يحسبه مقدّر جودة الشبكة.
`Int`	`getEffectiveConnectionType()` تعرض هذه السمة تقديرًا لنوع الاتصال الفعّال الذي تم احتسابه بواسطة أداة تقدير جودة الشبكة.
`abstract ByteArray<Byte>!`	`getGlobalMetricsDeltas()` تم إيقاف هذه الوظيفة نهائيًا. في الإصدارات الحديثة من Cronet، سيؤدي ذلك دائمًا إلى عرض مصفوفة فارغة.
`Int`	`getHttpRttMs()` تعرض هذه السمة تقديرًا لوقت الاستجابة الكامل لبروتوكول HTTP (بالمللي ثانية) الذي تم احتسابه بواسطة أداة تقدير جودة الشبكة.
`Int`	`getTransportRttMs()` تعرض هذه السمة تقديرًا لوقت الاستجابة الكامل (RTT) لعملية النقل (بالمللي ثانية) الذي تم احتسابه بواسطة أداة تقدير جودة الشبكة.
`abstract String!`	`getVersionString()`
`abstract UrlRequest.Builder!`	`newUrlRequestBuilder( url: String!, callback: UrlRequest.Callback!, executor: Executor! )` تنشئ هذه الدالة أداة إنشاء لـ `UrlRequest`.
`abstract URLConnection!`	`openConnection(url: URL!)` تنشئ هذه السمة اتصالاً جديدًا بالمرجع المحدّد بواسطة `URLurl`.
`Unit`	`removeRequestFinishedListener(listener: RequestFinishedInfo.Listener!)` يزيل أداة معالجة طلب مكتمل.
`Unit`	`removeRttListener(listener: NetworkQualityRttListener!)` يزيل مستمعًا لأوقات الرحلة ذهابًا وعودة إذا تم تسجيله سابقًا باستخدام `addRttListener`.
`Unit`	`removeThroughputListener(listener: NetworkQualityThroughputListener!)` تزيل هذه الطريقة أداة معالجة معدل نقل البيانات.
`abstract Unit`	`shutdown()` يوقف `CronetEngine` إذا لم تكن هناك طلبات نشطة، وإلا سيتم طرح استثناء.
`Unit`	`startNetLogToDisk(dirPath: String!, logAll: Boolean, maxSize: Int)` يبدأ تسجيل NetLog في دليل محدّد بحجم محدود.
`abstract Unit`	`startNetLogToFile(fileName: String!, logAll: Boolean)` يبدأ تسجيل NetLog في ملف.
`abstract Unit`	`stopNetLog()` يوقف تسجيل NetLog ويفرغ الملف إلى القرص.

الثوابت

ACTIVE_REQUEST_COUNT_UNKNOWN

const val ACTIVE_REQUEST_COUNT_UNKNOWN = -1: Int

قيمة عدد الطلبات النشطة غير معروفة

CONNECTION_METRIC_UNKNOWN

const val CONNECTION_METRIC_UNKNOWN = -1: Int

قيمة مقياس الاتصال غير معروفة.

EFFECTIVE_CONNECTION_TYPE_2G

const val EFFECTIVE_CONNECTION_TYPE_2G = 3: Int

تقدير نوع الاتصال الفعّال هو الجيل الثاني.

انظر أيضًا
`getEffectiveConnectionType`

EFFECTIVE_CONNECTION_TYPE_3G

const val EFFECTIVE_CONNECTION_TYPE_3G = 4: Int

تقدير نوع الاتصال الفعّال هو 3G.

انظر أيضًا
`getEffectiveConnectionType`

EFFECTIVE_CONNECTION_TYPE_4G

const val EFFECTIVE_CONNECTION_TYPE_4G = 5: Int

تقدير نوع الاتصال الفعّال هو 4G.

انظر أيضًا
`getEffectiveConnectionType`

EFFECTIVE_CONNECTION_TYPE_OFFLINE

const val EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1: Int

الجهاز غير متصل بالإنترنت.

انظر أيضًا
`getEffectiveConnectionType`

EFFECTIVE_CONNECTION_TYPE_SLOW_2G

const val EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2: Int

تقدير نوع الاتصال الفعّال هو شبكة الجيل الثاني البطيئة.

انظر أيضًا
`getEffectiveConnectionType`

EFFECTIVE_CONNECTION_TYPE_UNKNOWN

const val EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0: Int

تقدير نوع الاتصال الفعّال غير معروف.

انظر أيضًا
`getEffectiveConnectionType`

UNBIND_NETWORK_HANDLE

const val UNBIND_NETWORK_HANDLE = -1: Long

القيمة التي سيتم استخدامها للتراجع عن أي ربط سابق بالشبكة

طُرق وضع التصميم العامة

CronetEngine

CronetEngine()

الدوال العامة

addRequestFinishedListener

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

تسجّل هذه السمة معالجًا يتم استدعاؤه بعد انتهاء كل طلب مع معلومات الطلب.

يتم استدعاء المستمع على java.util.concurrent.Executor يوفّره المستمع.

المعلَمات
`listener: RequestFinishedInfo.Listener!`	المستمع للطلبات المكتملة

addRttListener

fun addRttListener(listener: NetworkQualityRttListener!): Unit

تسجِّل هذه الطريقة أداة معالجة يتم استدعاؤها عندما يرصد مقدّر جودة الشبكة وقت نقل البيانات ذهابًا وإيابًا. يجب استدعاء هذه الدالة بعد enableNetworkQualityEstimator، وإلا سيتم طرح استثناء. يمكن تسجيل أوقات الذهاب والعودة في طبقات مختلفة من حزمة الشبكة، بما في ذلك TCP وQUIC وطبقة طلب عنوان URL. يتم استدعاء المستمع على java.util.concurrent.Executor الذي يتم تمريره إلى enableNetworkQualityEstimator.

المعلَمات
`listener: NetworkQualityRttListener!`	متتبِّع أوقات الذهاب والعودة

addThroughputListener

fun addThroughputListener(listener: NetworkQualityThroughputListener!): Unit

تسجّل هذه الطريقة أداة معالجة يتم استدعاؤها عندما يشهد مقدّر جودة الشبكة قياسًا لسرعة معالجة البيانات. يجب استدعاء هذه الدالة بعد enableNetworkQualityEstimator. يتم احتساب ملاحظات معدّل نقل البيانات من خلال قياس عدد البايتات التي تتم قراءتها عبر واجهة الشبكة النشطة في الأوقات التي يتم فيها تلقّي ردّ واحد على الأقل من عنوان URL. يتم استدعاء المستمع على java.util.concurrent.Executor الذي يتم تمريره إلى enableNetworkQualityEstimator.

المعلَمات
`listener: NetworkQualityThroughputListener!`	تمثّل هذه السمة المستمع إلى معدل نقل البيانات.

bindToNetwork

fun bindToNetwork(networkHandle: Long): Unit

يربط المحرّك بمقبض الشبكة المحدّد. ستستخدم جميع الطلبات التي يتم إنشاؤها من خلال محرك البحث هذا الشبكة المرتبطة بهذا الاسم المعرِّف. في حال انقطاع الاتصال بهذه الشبكة، ستتعذّر جميع الطلبات، وسيعتمد الخطأ الدقيق على مرحلة معالجة الطلب عند انقطاع الاتصال بالشبكة. يمكن الحصول على أسماء معرِّفة على الشبكة من خلال Network#getNetworkHandle. تتوفّر هذه الميزة بدءًا من نظام التشغيل Android Marshmallow.

المعلَمات
`networkHandle: Long`	مقبض الشبكة الذي سيتم ربط المحرك به. حدِّد `UNBIND_NETWORK_HANDLE` لإلغاء الربط.

configureNetworkQualityEstimatorForTesting

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

تضبط هذه السمة أداة تقدير جودة الشبكة لأغراض الاختبار. يجب استدعاء هذه الدالة قبل إضافة متتبّعات وقت الاستجابة وسرعة معالجة البيانات، وبعد تفعيل مُقَدِّر جودة الشبكة.

المعلَمات
`useLocalHostRequests: Boolean`	تضمين الطلبات المقدَّمة إلى المضيف المحلي في التقديرات
`useSmallerResponses: Boolean`	تضمين الردود الصغيرة في تقديرات معدل النقل
`disableOfflineCheck: Boolean`	عند ضبطها على "صحيح"، يتم إيقاف عمليات التحقّق من عدم اتصال الجهاز بالإنترنت عند احتساب نوع الاتصال الفعّال أو عند كتابة الإعدادات المفضّلة.

createURLStreamHandlerFactory

abstract fun createURLStreamHandlerFactory(): URLStreamHandlerFactory!

تنشئ هذه السمة URLStreamHandlerFactory للتعامل مع الزيارات الواردة من HTTP وHTTPS. يمكن تثبيت مثيل من هذه الفئة من خلال setURLStreamHandlerFactory، وبالتالي استخدام CronetEngine تلقائيًا لجميع الطلبات التي يتم إنشاؤها من خلال openConnection.

لا تستخدم Cronet ميزات HTTP معيّنة يوفّرها النظام:

ذاكرة تخزين مؤقت HTTP مثبَّتة من خلال HttpResponseCache.install()
طريقة مصادقة HTTP المثبَّتة من خلال setDefault
مساحة تخزين ملفات تعريف ارتباط HTTP المثبَّتة من خلال setDefault

مع أنّ Cronet يتيح الطلبات باستخدام بروتوكول HTTPS ويشجّع على ذلك، لا يتيح Cronet استخدام واجهة برمجة التطبيقات HttpsURLConnection. يشمل عدم التوافق أيضًا عدم استخدام بعض ميزات HTTPS المتوفّرة من خلال النظام:

أداة التحقّق من اسم مضيف HTTPS المثبَّتة من خلال HttpsURLConnection.setDefaultHostnameVerifier()
مصنع مقابس HTTPS المثبَّت من خلال HttpsURLConnection.setDefaultSSLSocketFactory()

المرتجعات
`URLStreamHandlerFactory!`	مثيل `URLStreamHandlerFactory` تم تنفيذه بواسطة CronetEngine هذا

getActiveRequestCount

fun getActiveRequestCount(): Int

تعرِض هذه السمة عدد الطلبات النشطة.

يصبح الطلب "نشطًا" في UrlRequest.start()، على افتراض أنّ هذه الطريقة لا تعرض استثناءً. يصبح غير نشط عندما يتم عرض جميع معاودة الاتصال ولا يمكن بدء أي معاودة اتصال إضافية في المستقبل. يعني ذلك عمليًا أنّ الطلب يصبح غير نشط بعد أن تعرض الدالة onSucceeded/onCanceled/onFailed القيمة، وبعد أن تعرض جميع أدوات معالجة الطلبات المكتملة القيمة. دورة حياة طلبات Cronet لمزيد من المعلومات

getDownstreamThroughputKbps

fun getDownstreamThroughputKbps(): Int

تعرض هذه السمة تقديرًا لمعدّل نقل البيانات من الخادم إلى الجهاز (بالكيلوبت في الثانية) الذي يحسبه مقدّر جودة الشبكة. اضبط القيمة على CONNECTION_METRIC_UNKNOWN إذا كانت غير متاحة. يجب استدعاء هذه الدالة بعد enableNetworkQualityEstimator، وإلا سيحدث استثناء.

المرتجعات
`Int`	تقدير لمعدّل نقل البيانات في اتجاه التنزيل بالكيلوبت في الثانية

getEffectiveConnectionType

fun getEffectiveConnectionType(): Int

تعرض هذه السمة تقديرًا لنوع الاتصال الفعّال الذي تم احتسابه بواسطة أداة تقدير جودة الشبكة. استخدِم الدالة enableNetworkQualityEstimator لبدء احتساب هذه القيمة.

المرتجعات
`Int`	نوع الاتصال المقدَّر القيمة التي يتم إرجاعها هي إحدى القيم `EFFECTIVE_CONNECTION_TYPE_*` .

getGlobalMetricsDeltas

abstract fun getGlobalMetricsDeltas(): ByteArray<Byte>!

getHttpRttMs

fun getHttpRttMs(): Int

تعرض هذه السمة تقديرًا لوقت الاستجابة الكامل لبروتوكول HTTP (بالمللي ثانية) الذي تم احتسابه بواسطة أداة تقدير جودة الشبكة. اضبط القيمة على CONNECTION_METRIC_UNKNOWN إذا كانت غير متاحة. يجب استدعاء هذه الدالة بعد enableNetworkQualityEstimator، وإلا سيحدث استثناء.

المرتجعات
`Int`	تقدير لوقت نقل البيانات ذهابًا وإيابًا عبر HTTP بالملي ثانية

getTransportRttMs

fun getTransportRttMs(): Int

تعرض هذه السمة تقديرًا لوقت الاستجابة الكامل (RTT) لعملية النقل (بالمللي ثانية) الذي تم احتسابه بواسطة أداة تقدير جودة الشبكة. اضبط القيمة على CONNECTION_METRIC_UNKNOWN إذا كانت غير متاحة. يجب استدعاء هذه الدالة بعد enableNetworkQualityEstimator، وإلا سيحدث استثناء.

المرتجعات
`Int`	تقدير لوقت نقل البيانات ذهابًا وإيابًا بالملي ثانية

getVersionString

abstract fun getVersionString(): String!

المرتجعات
`String!`	سلسلة إصدار المحرك يمكن لشخص عادي قراءتها

newUrlRequestBuilder

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

تنشئ هذه الدالة أداة إنشاء لـ UrlRequest. سيتم استدعاء جميع عمليات الرجوع لجميع عناصر UrlRequest التي تم إنشاؤها في سلاسل executor. يجب ألا ينفّذ executor مهامًا على سلسلة المحادثات التي تستدعي execute لمنع حظر عمليات الشبكات والتسبّب في حدوث استثناءات أثناء الإيقاف.

المعلَمات
`url: String!`	عنوان URL للطلبات التي تم إنشاؤها.
`callback: UrlRequest.Callback!`	عنصر معاودة الاتصال الذي يتم استدعاؤه عند وقوع أحداث مختلفة.
`executor: Executor!`	`Executor` الذي سيتم استدعاء جميع عمليات الرجوع إليه.

openConnection

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

تنشئ هذه السمة اتصالاً جديدًا بالمرجع المحدّد بواسطة URLurl.

ملاحظة: يخضع تنفيذ java.net.HttpURLConnection في Cronet لقيود معيّنة، يمكنك الاطّلاع على createURLStreamHandlerFactory لمعرفة التفاصيل.

المعلَمات
`url: URL!`	تمثّل هذه السمة عنوان URL للمورد المطلوب الربط به.

المرتجعات
`URLConnection!`	مثيل `java.net.HttpURLConnection` تم تنفيذه بواسطة CronetEngine هذا

عمليات الطرح
`java.io.IOException`	إذا حدث خطأ أثناء فتح الاتصال

removeRequestFinishedListener

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

يزيل أداة معالجة طلب مكتمل.

المعلَمات
`listener: RequestFinishedInfo.Listener!`	المستمع المطلوب إزالته

removeRttListener

fun removeRttListener(listener: NetworkQualityRttListener!): Unit

يزيل مستمعًا لأوقات الرحلة ذهابًا وعودة إذا تم تسجيله سابقًا باستخدام addRttListener. يجب استدعاء هذا الإجراء بعد إضافة NetworkQualityRttListener من أجل التوقّف عن تلقّي الملاحظات.

المعلَمات
`listener: NetworkQualityRttListener!`	متتبِّع أوقات الذهاب والعودة

removeThroughputListener

fun removeThroughputListener(listener: NetworkQualityThroughputListener!): Unit

تزيل هذه الطريقة أداة معالجة معدل نقل البيانات. يجب استدعاء هذا الإجراء بعد إضافة NetworkQualityThroughputListener باستخدام addThroughputListener لإيقاف تلقّي الملاحظات.

المعلَمات
`listener: NetworkQualityThroughputListener!`	تمثّل هذه السمة المستمع إلى معدل نقل البيانات.

الإيقاف النهائي

abstract fun shutdown(): Unit

يوقف CronetEngine إذا لم تكن هناك طلبات نشطة، وإلا سيتم طرح استثناء.

لا يمكن استدعاؤه في سلسلة محادثات الشبكة، وهي سلسلة المحادثات التي يستدعيها Cronet في Executor (وهي تختلف عن سلسلة المحادثات التي يستدعي فيها Executor عمليات الرجوع). قد يتم الحظر إلى أن يتم تنظيف جميع موارد CronetEngine.

startNetLogToDisk

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

يبدأ تسجيل NetLog في دليل محدّد بحجم محدود. سيحتوي NetLog على الأحداث التي تم إصدارها من جميع CronetEngines النشطة. تكون أداة NetLog مفيدة لتصحيح الأخطاء. بعد إيقاف التسجيل stopNetLog، ستتم كتابة البيانات في ملف netlog.json في dirPath. في حال انقطاع التسجيل، يمكنك دمج الملفات التي تم العثور عليها في الدليل الفرعي ‎ .inprogress يدويًا باستخدام: https://chromium.googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py. يمكن عرض السجلّ باستخدام متصفّح Chrome من خلال الانتقال إلى chrome://net-internals/#import.

المعلَمات
`dirPath: String!`	الدليل الذي سيتم فيه إنشاء ملف netlog.json، ويجب أن يكون dirPath متوفّرًا. يجب ألا تكون ملفات NetLog متوفّرة في الدليل. في حال التسجيل النشط، سيتم تجاهل هذا الإجراء.
`logAll: Boolean`	`true` لتضمين الأحداث الأساسية وملفات تعريف ارتباط المستخدم وبيانات الاعتماد وجميع وحدات البايت المنقولة في السجلّ. يمثّل هذا الخيار خطرًا على الخصوصية، لأنّه يعرّض بيانات اعتماد المستخدم، ويجب استخدامه فقط بموافقة المستخدم وفي الحالات التي لن يكون فيها سجلّ الأنشطة متاحًا للجميع. `false` لتضمين الأحداث الأساسية فقط
`maxSize: Int`	الحد الأقصى لإجمالي مساحة القرص بالبايت التي يجب أن يستخدمها NetLog قد يتجاوز استخدام مساحة القرص الفعلية هذا الحد قليلاً.

startNetLogToFile

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

يبدأ تسجيل NetLog في ملف. سيحتوي NetLog على الأحداث التي تم إصدارها من جميع CronetEngines النشطة. تكون أداة NetLog مفيدة لتصحيح الأخطاء. يمكن عرض الملف باستخدام متصفّح Chrome من خلال الانتقال إلى chrome://net-internals/#import

المعلَمات

المعلَمات
`fileName: String!`	مسار الملف الكامل يجب ألا يكون فارغًا. إذا كان الملف موجودًا، يتم اقتطاعه قبل البدء. في حال التسجيل النشط، سيتم تجاهل هذا الإجراء.
`logAll: Boolean`	`true` لتضمين الأحداث الأساسية وملفات تعريف ارتباط المستخدم وبيانات الاعتماد وجميع وحدات البايت المنقولة في السجلّ. يمثّل هذا الخيار خطرًا على الخصوصية، لأنّه يعرّض بيانات اعتماد المستخدم، ويجب استخدامه فقط بموافقة المستخدم وفي الحالات التي لن يكون فيها سجلّ الأنشطة متاحًا للجميع. `false` لتضمين الأحداث الأساسية فقط

fileName: String!

مسار الملف الكامل يجب ألا يكون فارغًا. إذا كان الملف موجودًا، يتم اقتطاعه قبل البدء. في حال التسجيل النشط، سيتم تجاهل هذا الإجراء.

logAll: Boolean

true لتضمين الأحداث الأساسية وملفات تعريف ارتباط المستخدم وبيانات الاعتماد وجميع وحدات البايت المنقولة في السجلّ. يمثّل هذا الخيار خطرًا على الخصوصية، لأنّه يعرّض بيانات اعتماد المستخدم، ويجب استخدامه فقط بموافقة المستخدم وفي الحالات التي لن يكون فيها سجلّ الأنشطة متاحًا للجميع. false لتضمين الأحداث الأساسية فقط

stopNetLog

abstract fun stopNetLog(): Unit

يوقف تسجيل NetLog ويفرغ الملف إلى القرص. إذا لم تكن هناك جلسة تسجيل بيانات قيد التقدّم، سيتم تجاهل هذا الطلب.