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

本頁面由 Cloud Translation API 翻譯而成。

HostStatsdMetricCollector

public class HostStatsdMetricCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.HostStatsdMetricCollector

已知的直接子類別

BluetoothConnectionLatencyCollector 收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線時間。

已知間接子類別

BluetoothConnectionStateCollector 這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄每個設定檔的連線狀態編號。

IMetricCollector 會使用 StatsD 公用程式指令，從主機端收集 StatsD 指標。它提供基本推送指標和傾印報表功能。子類別可擴充此類別，根據需求處理 statsd 指標報表。

摘要

公用建構函式
`HostStatsdMetricCollector()`

公用方法
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 測試案例結束時的回呼。
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 測試案例失敗時的回呼。
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 測試結束時的回呼。
`void`	`onTestRunStart(DeviceMetricData runData)` 開始執行測試時的回呼。
`void`	`onTestStart(DeviceMetricData testData)` 測試案例啟動時的回呼。

受保護的方法
`void`	`processStatsReport(ITestDevice device, InputStreamSource dataStream, DeviceMetricData runData)` 子類別可在必要時實作方法，以便處理 Statsd 指標報表。

public HostStatsdMetricCollector ()

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

測試案例結束時的回呼。這時應該要清理了。

參數
`testData`	`DeviceMetricData`：保留測試案例資料的 `DeviceMetricData`。會與 `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` 期間相同的物件。
`currentTestCaseMetrics`	：傳遞至 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的目前指標對應項目。

擲回
`DeviceNotAvailableException`

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

測試案例失敗時的回呼。

參數
`testData`	`DeviceMetricData`：保留測試案例資料的 `DeviceMetricData`。
`test`	`TestDescription`：進行中的測試案例 `TestDescription`。

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`

protected void processStatsReport (ITestDevice device, 
                InputStreamSource dataStream, 
                DeviceMetricData runData)

子類別可在必要時實作方法，以便處理 Statsd 指標報表。會針對特定裝置的評估指標報表呼叫

參數
`device`	`ITestDevice`：測試 statsd 回報來源的裝置
`dataStream`	`InputStreamSource`：統計資料報告做為輸入串流
`runData`	`DeviceMetricData`：要儲存經過處理的指標的目的