اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

BluetoothHciSnoopLogCollector

public class BluetoothHciSnoopLogCollector
extends FilePullerDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector
		↳	com.android.tradefed.device.metric.BluetoothHciSnoopLogCollector

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

ملخّص

الثوابت
`String`	`SNOOP_LOG_MODE_PROPERTY`

الإنشاءات العامة
`BluetoothHciSnoopLogCollector()`

الطُرق العامة
`String`	`getReportingDir()` استرداد الدليل الذي سيتم إرسال سجلّات التتبّع لواجهة تحكّم مضيف البلوتوث إليه
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` يتم تنفيذ هذا الإجراء عند انتهاء حالة الاختبار.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار.
`void`	`onTestRunStart(DeviceMetricData runData)` دالة ردّ الاتصال عند بدء تشغيل اختبار.
`void`	`onTestStart(DeviceMetricData testData)` يتم تنفيذ هذا الإجراء عند بدء حالة اختبار.
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` يجب أن يسمح تنفيذ الطريقة بتسجيل الدليل وتحليله للحصول على مقاييس يتم وضعها في `DeviceMetricData`.
`final void`	`processMetricFile(String key, File metricFile, DeviceMetricData runData)` يجب أن يسمح تنفيذ الطريقة بتسجيل الملف وتحليله للحصول على المقاييس التي سيتم وضعها في `DeviceMetricData`.

الطُرق المحمية
`void`	`executeShellCommand(ITestDevice device, String command)` تنفيذ أمر shell على الجهاز

الثوابت

SNOOP_LOG_MODE_PROPERTY

public static final String SNOOP_LOG_MODE_PROPERTY

Constant Value: "persist.bluetooth.btsnooplogmode"

الإنشاءات العامة

BluetoothHciSnoopLogCollector

public BluetoothHciSnoopLogCollector ()

الطُرق العامة

getReportingDir

public String getReportingDir ()

استرداد الدليل الذي سيتم إرسال سجلّات التتبّع لواجهة تحكّم مضيف البلوتوث إليه

المرتجعات
`String`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

يتم تنفيذ هذا الإجراء عند انتهاء حالة الاختبار. يجب أن يكون هذا هو وقت التنظيف.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`
`test`	‫`TestDescription`: `TestDescription` لإطار الاختبار قيد التقدّم

الرميات
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار. يجب أن يكون هذا هو وقت التنظيف.

المعلمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على البيانات الخاصة بعملية التشغيل سيكون الكائن نفسه كما كان خلال `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ERROR(/#testRunEnded(long,Map))`

الرميات
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

دالة ردّ الاتصال عند بدء تشغيل اختبار.

المعلمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على البيانات الخاصة بعملية التشغيل

الرميات
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

يتم تنفيذ هذا الإجراء عند بدء حالة اختبار.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار

الرميات
`DeviceNotAvailableException`

processMetricDirectory

public void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData runData)

يجب أن يسمح تنفيذ الطريقة بتسجيل الدليل وتحليله للحصول على مقاييس يتم وضعها في DeviceMetricData.

المعلمات
`key`	`String`: مفتاح الخيار المرتبط بالدليل الذي تم استرداده.
`metricDirectory`	`File`: هي `ERROR(/File)` التي تم استردادها من الجهاز الذي يتطابق مع مفتاح الخيار.
`runData`	`DeviceMetricData`: `DeviceMetricData` حيث يمكن تخزين المقاييس

processMetricFile

public final void processMetricFile (String key, 
                File metricFile, 
                DeviceMetricData runData)

يجب أن يسمح تنفيذ الطريقة بتسجيل الملف وتحليله للحصول على المقاييس التي سيتم وضعها في DeviceMetricData.

المعلمات
`key`	`String`: مفتاح الخيار المرتبط بالملف الذي تم استرداده.
`metricFile`	`File`: هي `ERROR(/File)` التي تم استردادها من الجهاز الذي يتطابق مع مفتاح الخيار.
`runData`	`DeviceMetricData`: `DeviceMetricData` حيث يمكن تخزين المقاييس

الطُرق المحمية

executeShellCommand

protected void executeShellCommand (ITestDevice device, 
                String command)

تنفيذ أمر shell على الجهاز إذا تعذّر التنفيذ (رمز الخروج غير صفري)، سيتم عرض DeviceRuntimeException.

المعلمات
`device`	`ITestDevice`
`command`	`String`

الرميات
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`