ตั้งแต่วันที่ 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

ตัวรวบรวมเพื่อเปิดใช้การบันทึกสอดแนมบลูทูธ HCI ใน DUT และรวบรวมบันทึกสําหรับการทดสอบแต่ละครั้ง ตัวรวบรวมจะกําหนดค่าและเปิดใช้การบันทึก Snoop สําหรับการทดสอบ แล้วเปลี่ยนการตั้งค่ากลับหลังจากการทดสอบ

สรุป

ช่อง
`public static final String`	`SNOOP_LOG_MODE_PROPERTY`

ตัวสร้างแบบสาธารณะ
`BluetoothHciSnoopLogCollector()`

เมธอดสาธารณะ
`String`	`getReportingDir()` เรียกข้อมูลไดเรกทอรีที่จะรายงานบันทึก HCI Snoop
`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)` เรียกใช้คำสั่งเชลล์ในอุปกรณ์

ช่อง

SNOOP_LOG_MODE_PROPERTY

public static final String SNOOP_LOG_MODE_PROPERTY

ตัวสร้างแบบสาธารณะ

BluetoothHciSnoopLogCollector

public BluetoothHciSnoopLogCollector ()

เมธอดสาธารณะ

getReportingDir

public String getReportingDir ()

เรียกข้อมูลไดเรกทอรีที่จะรายงานบันทึก HCI Snoop

คิกรีเทิร์น
`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)

เรียกใช้คำสั่งเชลล์ในอุปกรณ์ หากการเรียกใช้ไม่สำเร็จ (รหัสออกไม่ใช่ 0) ให้แสดงข้อผิดพลาด DeviceRuntimeException

พารามิเตอร์
`device`	`ITestDevice`
`command`	`String`

การโยน
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`