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

收集器，可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集每項測試的記錄。收集器會為測試執行作業設定並啟用窺探記錄，並在測試執行作業結束後還原設定。

摘要

欄位
`public static final 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

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`