自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 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

Collector，在 DUT 上啟用藍牙 HCI 窺探記錄，並收集各項測試的記錄。收集器會為測試執行設定並啟用 snoop 記錄，並在測試執行後還原設定。

摘要

常數
`String`	`SNOOP_LOG_MODE_PROPERTY`

公用建構函式
`BluetoothHciSnoopLogCollector()`

公用方法
`String`	`getReportingDir()` 擷取要將 HCI 窺探記錄回報至其中的目錄。
`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)` 在裝置上執行殼層指令。

public static final String SNOOP_LOG_MODE_PROPERTY

常數值： "persist.bluetooth.btsnooplogmode"

public BluetoothHciSnoopLogCollector ()

public String getReportingDir ()

擷取要回報 HCI 窺探記錄的目錄。

傳回
`String`

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`

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

測試作業結束時的回呼。這時應該要進行清理。

參數
`runData`	`DeviceMetricData`：保存執行資料的 `DeviceMetricData`。與 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 期間的物件相同。
`currentRunMetrics`	：傳遞至 `ERROR(/#testRunEnded(long,Map))` 的指標目前對應。

擲回
`DeviceNotAvailableException`

public void onTestRunStart (DeviceMetricData runData)

測試執行開始時的回呼。

參數
`runData`	`DeviceMetricData`：`DeviceMetricData`，其中包含執行作業的資料。

擲回
`DeviceNotAvailableException`

public void onTestStart (DeviceMetricData testData)

測試案例啟動時的回呼。

參數
`testData`	`DeviceMetricData`：保存測試案例資料的 `DeviceMetricData`。

擲回
`DeviceNotAvailableException`

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

方法實作項目應允許記錄目錄，並剖析目錄以取得指標，然後將指標放入 DeviceMetricData。

參數
`key`	`String`：與所提取目錄相關聯的選項鍵。
`metricDirectory`	`File`：從與選項鍵相符的裝置中擷取的 `ERROR(/File)`。
`runData`	`DeviceMetricData`：可儲存指標的 `DeviceMetricData`。

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

方法實作項目應允許記錄檔案、剖析檔案以取得要放入 DeviceMetricData 的指標。

參數
`key`	`String`：與提取的檔案相關聯的選項鍵。
`metricFile`	`File`：從與選項鍵相符的裝置中擷取的 `ERROR(/File)`。
`runData`	`DeviceMetricData`：可儲存指標的 `DeviceMetricData`。

protected void executeShellCommand (ITestDevice device, 
                String command)

在裝置上執行殼層指令。如果執行失敗 (非零的結束代碼)，請擲回 DeviceRuntimeException。

參數
`device`	`ITestDevice`
`command`	`String`

擲回
	com.android.tradefed.device.DeviceRuntimeException
`DeviceNotAvailableException`