ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

IDeviceActionReceiver

public interface IDeviceActionReceiver

com.android.tradefed.device.IDeviceActionReceiver

คลาสย่อยโดยอ้อมที่ทราบ

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector และอื่นๆ 13 รายการ

AtraceCollector	`IMetricCollector` ที่เรียกใช้การติดตามระหว่างการทดสอบและรวบรวมผลลัพธ์และบันทึกลงในการเรียกใช้
AtraceRunMetricCollector	รวบรวมการติดตามจากไดเรกทอรีทดสอบทั้งหมดในไดเรกทอรีที่ระบุจากอุปกรณ์ทดสอบ บันทึกไดเรกทอรีทดสอบ และประมวลผลไฟล์การติดตามในไดเรกทอรีทดสอบในภายหลัง รวมถึงรวบรวมเมตริก
BaseDeviceMetricCollector	การใช้งานพื้นฐานของ `IMetricCollector` ที่อนุญาตให้เริ่มและหยุดการเก็บรวบรวมใน `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` และ `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`
BluetoothConnectionLatencyCollector	ตัวรวบรวมจะพุชการกําหนดค่าเมตริกระยะเวลา statsd ที่กําหนดไว้ล่วงหน้าไปยังอุปกรณ์และรวบรวมระยะเวลาการเชื่อมต่อบลูทูธสําหรับแต่ละโปรไฟล์
BluetoothConnectionStateCollector	เครื่องมือรวบรวมนี้จะรวบรวมเมตริก BluetoothConnectionStateChanged และบันทึกจํานวนสถานะการเชื่อมต่อสําหรับแต่ละโปรไฟล์
BluetoothHciSnoopLogCollector	ตัวรวบรวมเพื่อเปิดใช้การบันทึกสอดแนมบลูทูธ HCI ใน DUT และรวบรวมบันทึกสําหรับการทดสอบแต่ละครั้ง
BugreportzOnFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อเฟรมทดสอบไม่ผ่าน
BugreportzOnTestCaseFailureCollector	รวบรวมรายงานข้อบกพร่องเมื่อเทสเคสในการเรียกใช้ไม่สําเร็จ
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Clang จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
CodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Java และแบบเนทีฟออกจากอุปกรณ์และบันทึกเป็นรายการทดสอบ
CountTestCasesCollector	นับและรายงานจํานวนกรณีทดสอบสําหรับ `IRemoteTest` ที่ระบุ
DebugHostLogOnFailureCollector	ตัวรวบรวมที่จะรวบรวมและบันทึกบันทึกฝั่งโฮสต์เมื่อเกิดข้อผิดพลาดในชุดทดสอบ
DeviceTraceCollector	เครื่องมือรวบรวมข้อมูลที่จะเริ่มการติดตามด้วย Perfetto เมื่อการทดสอบเริ่มขึ้นและบันทึกไฟล์การติดตามเมื่อสิ้นสุด
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` ที่คอยฟังคีย์เมตริกที่มาจากอุปกรณ์และดึงข้อมูลเหล่านั้นเป็นไฟล์จากอุปกรณ์
FilePullerLogCollector	โปรแกรมบันทึกไฟล์ที่รายงานโดยอุปกรณ์
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุม gcov จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมเคอร์เนล gcov ออกจาก debugfs และออกจากอุปกรณ์ จากนั้นบันทึกเป็นอาร์ติแฟกต์การทดสอบ
HostStatsdMetricCollector	`IMetricCollector` ที่รวบรวมเมตริก statsd จากฝั่งโฮสต์โดยใช้คําสั่งยูทิลิตี statsd
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` ที่จะดึงการวัดการครอบคลุมของ Java จากอุปกรณ์และบันทึกเป็นรายการทดสอบ
LogcatOnFailureCollector	ตัวรวบรวมที่จะบันทึกและบันทึก Logcat เมื่อเฟรมทดสอบไม่ผ่าน
LogcatTimingMetricCollector	ตัวรวบรวมเมตริกที่รวบรวมข้อมูลการกําหนดเวลา (เช่น เวลาสลับของผู้ใช้) จาก logcat ระหว่างการทดสอบซ้ำ 1 ครั้งหรือหลายครั้งโดยใช้รูปแบบนิพจน์ทั่วไปที่ระบุเพื่อแยกวิเคราะห์สัญญาณเริ่มต้นและสิ้นสุดของเหตุการณ์จากบรรทัด logcat
ModuleLogcatCollector	เวอร์ชันของเครื่องมือรวบรวม Logcat สำหรับโมดูล
PerfettoPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Perfetto จากอุปกรณ์และรวบรวมเมตริกจากไฟล์
RebootReasonCollector	เครื่องมือรวบรวมข้อมูลที่รวบรวมการรีบูตอุปกรณ์ระหว่างการทดสอบและรายงานตามเหตุผลและจำนวน
RuntimeRestartCollector	เครื่องมือรวบรวมข้อมูลที่รวบรวมการประทับเวลาของการเริ่มทํางานอีกครั้ง (เซิร์ฟเวอร์ระบบขัดข้อง) ระหว่างการทดสอบ หากมี
ScreenshotOnFailureCollector	ตัวรวบรวมที่จะจับภาพและบันทึกภาพหน้าจอเมื่อกรอบการทดสอบไม่ผ่าน
ShowmapPullerMetricCollector	การติดตั้งใช้งานพื้นฐานของ `FilePullerDeviceMetricCollector` ที่อนุญาตให้ดึงไฟล์ Showmap จากอุปกรณ์และรวบรวมเมตริกจากไฟล์
TraceCmdCollector	`IMetricCollector` ที่รวบรวมร่องรอยระหว่างการทดสอบโดยใช้ trace-cmd และบันทึกร่องรอยเหล่านั้นลงในการเรียกใช้

มี API ในการรับเหตุการณ์ของอุปกรณ์

หมายเหตุ: ปัจจุบันฟีเจอร์นี้รองรับเครื่องมือรวบรวมเมตริกเท่านั้น

สรุป

เมธอดสาธารณะ
`default boolean`	`isDisabledReceiver()` `IDeviceActionReceiver` ปิดอยู่หรือไม่
`abstract void`	`rebootEnded(ITestDevice device)` รับการแจ้งเตือนเมื่อการรีบูตในอุปกรณ์สิ้นสุดลง
`abstract void`	`rebootStarted(ITestDevice device)` รับการแจ้งเตือนเมื่ออุปกรณ์เริ่มรีบูต
`abstract void`	`setDisableReceiver(boolean isDisabled)` ตั้งค่าว่าควรปิดใช้ `IDeviceActionReceiver` หรือไม่

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

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver ปิดอยู่หรือไม่

คิกรีเทิร์น
`boolean`	แสดงผลเป็น "จริง" หากปิดใช้ หรือแสดงผลเป็น "เท็จ" หากเปิดใช้

rebootEnded

public abstract void rebootEnded (ITestDevice device)

รับการแจ้งเตือนเมื่อการรีบูตในอุปกรณ์สิ้นสุดลง

หมายเหตุ: ผู้รับควรหลีกเลี่ยงการรีบูตระหว่างการติดต่อกลับนี้ ระบบจะไม่สนใจการพยายามรีบูต

พารามิเตอร์
`device`	`ITestDevice`: `ITestDevice` ซึ่งเป็นจุดสิ้นสุดของการรีบูต

โยน
`DeviceNotAvailableException`

rebootStarted

public abstract void rebootStarted (ITestDevice device)

รับการแจ้งเตือนเมื่ออุปกรณ์เริ่มรีบูต

พารามิเตอร์
`device`	`ITestDevice`: `ITestDevice` ที่เริ่มรีบูต

โยน
`DeviceNotAvailableException`

setDisableReceiver

public abstract void setDisableReceiver (boolean isDisabled)

ตั้งค่าว่าควรปิดใช้ IDeviceActionReceiver หรือไม่ การปิดใช้หมายความว่าเหตุการณ์จะไม่ได้รับการลงทะเบียนในอุปกรณ์เพื่อรับเหตุการณ์การดำเนินการของอุปกรณ์

พารามิเตอร์
`isDisabled`	`boolean`