自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
ScreenshotOnFailureCollector
public
class
ScreenshotOnFailureCollector
extends BaseDeviceMetricCollector
在測試案例失敗時，會擷取並記錄螢幕截圖的收集器。
摘要
公用建構函式
ScreenshotOnFailureCollector
public ScreenshotOnFailureCollector ()
公用方法
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-27 (世界標準時間)。"],[],[],null,["# ScreenshotOnFailureCollector\n============================\n\n\n`\npublic\n\n\nclass\nScreenshotOnFailureCollector\n`\n\n\n`\n\n\n`\n\n`\n\nextends `[BaseDeviceMetricCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/BaseDeviceMetricCollector.html)`\n\n\n`\n\n`\n\n\n`\n\n|---|---|-----------------------------------------------------------------|\n| java.lang.Object |||\n| ↳ | [com.android.tradefed.device.metric.BaseDeviceMetricCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/BaseDeviceMetricCollector.html) ||\n| | ↳ | com.android.tradefed.device.metric.ScreenshotOnFailureCollector |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nCollector that will capture and log a screenshot when a test case fails.\n\nSummary\n-------\n\n| ### Public constructors ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[ScreenshotOnFailureCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/ScreenshotOnFailureCollector.html#ScreenshotOnFailureCollector())`() ` |\n\n| ### Public methods ||\n|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` void` | ` `[onTestFail](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/ScreenshotOnFailureCollector.html#onTestFail(com.android.tradefed.device.metric.DeviceMetricData,%20com.android.tradefed.result.TestDescription))`(`[DeviceMetricData](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/DeviceMetricData.html)` testData, `[TestDescription](../../../../../../../reference/tradefed/com/android/tradefed/result/TestDescription.html)` test) ` Callback when a test case fails. |\n| ` void` | ` `[onTestRunStart](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/ScreenshotOnFailureCollector.html#onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData))`(`[DeviceMetricData](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/DeviceMetricData.html)` runData) ` Callback when a test run is started. |\n\nPublic constructors\n-------------------\n\n### ScreenshotOnFailureCollector\n\n```\npublic ScreenshotOnFailureCollector ()\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nPublic methods\n--------------\n\n### onTestFail\n\n```\npublic void onTestFail (DeviceMetricData testData, \n TestDescription test)\n```\n\nCallback when a test case fails.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `testData` | `DeviceMetricData`: the [DeviceMetricData](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/DeviceMetricData.html) holding the data for the test case. \u003cbr /\u003e |\n| `test` | `TestDescription`: the [TestDescription](../../../../../../../reference/tradefed/com/android/tradefed/result/TestDescription.html) of the test case in progress. \u003cbr /\u003e |\n\n| Throws ||\n|-------------------------------------------------------------------------------------------------------------------------------------|---|\n| [DeviceNotAvailableException](../../../../../../../reference/tradefed/com/android/tradefed/device/DeviceNotAvailableException.html) | |\n\n### onTestRunStart\n\n```\npublic void onTestRunStart (DeviceMetricData runData)\n```\n\nCallback when a test run is started.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `runData` | `DeviceMetricData`: the [DeviceMetricData](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/DeviceMetricData.html) holding the data for the run. \u003cbr /\u003e |"]]
