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

อุปกรณ์ทดสอบ

public class TestDevice
extends NativeDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice

คลาสย่อยโดยตรงที่รู้จัก

ManagedRemoteDevice , NestedRemoteDevice , อุปกรณ์ Android ระยะไกล

ManagedRemoteDevice	อุปกรณ์ที่ทำงานภายในเครื่องเสมือนที่เราจัดการจากระยะไกลผ่านอินสแตนซ์ Tradefed ภายใน VM
NestedRemoteDevice	การเป็นตัวแทนของอุปกรณ์ที่ทำงานภายใน Cuttlefish VM ระยะไกล
อุปกรณ์ Android ระยะไกล	การใช้งาน `ITestDevice` สำหรับอุปกรณ์ Android เต็มรูปแบบที่เชื่อมต่อผ่านการเชื่อมต่อ adb

รู้จักคลาสย่อยทางอ้อม

LocalAndroidVirtualDevice , RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	คลาสสำหรับอุปกรณ์เสมือนในเครื่องที่ทำงานบนโฮสต์ TradeFed
RemoteAndroid VirtualDevice	ขยายพฤติกรรม `RemoteAndroidDevice` สำหรับอุปกรณ์ Android เต็มรูปแบบที่ทำงานใน Google Compute Engine (Gce)

การใช้งาน ITestDevice สำหรับอุปกรณ์ Android เต็มรูปแบบ

สรุป

คลาสที่ซ้อนกัน
`class`	`TestDevice.MicrodroidBuilder` เครื่องมือสร้างที่ใช้ในการสร้าง Microdroid TestDevice

เขตข้อมูล
`public static final String`	`DISMISS_KEYGUARD_CMD` คำสั่งที่สามารถใช้เพื่อยกเลิกคีย์การ์ด

ผู้สร้างสาธารณะ
`TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)`

วิธีการสาธารณะ
`boolean`	`canSwitchToHeadlessSystemUser ()` ส่งคืนว่าอนุญาตให้เปลี่ยนเป็นผู้ใช้ SYSTEM ที่ไม่มีหัวหรือไม่
`boolean`	`clearErrorDialogs ()` พยายามปิดกล่องโต้ตอบแสดงข้อผิดพลาดที่แสดงอยู่บน UI ของอุปกรณ์ในปัจจุบัน
`int`	`createUser (String name)` สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
`int`	`createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)` สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา
`int`	`createUser (String name, boolean guest, boolean ephemeral)` สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา
`int`	`createUserNoThrow (String name)` สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
`void`	`disableKeyguard ()` พยายามปิดใช้งานคีย์การ์ด
`boolean`	`doesFileExist (String deviceFilePath)` วิธีการช่วยเหลือเพื่อตรวจสอบว่ามีไฟล์บนอุปกรณ์อยู่หรือไม่
`boolean`	`doesFileExist (String deviceFilePath, int userId)` วิธีการช่วยเหลือเพื่อตรวจสอบว่ามีไฟล์บนอุปกรณ์สำหรับผู้ใช้ที่กำหนดหรือไม่
`File`	`dumpHeap (String process, String devicePath)` พยายามดัมพ์ฮีปจาก system_server
	`getActiveApexes ()` ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานบนอุปกรณ์
	`getAllSettings (String namespace)` คืนค่าคีย์คู่ของเนมสเปซที่ร้องขอ
`String`	`getAndroidId (int userId)` ค้นหาและส่งคืน android-id ที่เชื่อมโยงกับ userId หากไม่พบจะเป็น null
	`getAndroidIds ()` สร้างแผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน
`PackageInfo`	`getAppPackageInfo (String packageName)` ดึงข้อมูลเกี่ยวกับแพ็คเกจที่ติดตั้งบนอุปกรณ์
	`getAppPackageInfos ()` ดึงข้อมูลแพ็คเกจที่ติดตั้งบนอุปกรณ์
`InputStreamSource`	`getBugreport ()` ดึงรายงานข้อผิดพลาดจากอุปกรณ์
`InputStreamSource`	`getBugreportz ()` ดึงข้อมูลรายงานข้อผิดพลาดจากอุปกรณ์
`DeviceFoldableState`	`getCurrentFoldableState ()` คืนค่าสถานะพับได้ปัจจุบันของอุปกรณ์หรือค่า null หากเกิดปัญหาบางอย่างขึ้น
`int`	`getCurrentUser ()` ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่
	`getFoldableStates ()` ส่งกลับรายการสถานะการพับบนอุปกรณ์
	`getInstalledPackageNames ()` ดึงชื่อแพ็คเกจแอปพลิเคชันที่มีอยู่ในอุปกรณ์
`KeyguardControllerState`	`getKeyguardState ()` ส่งคืนวัตถุเพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือค่าว่างหากไม่รองรับ
`Integer`	`getMainUserId ()` ส่งคืนรหัสผู้ใช้หลัก
	`getMainlineModuleInfo ()` รับข้อมูลเกี่ยวกับโมดูล mainline ที่ติดตั้งบนอุปกรณ์
`int`	`getMaxNumberOfRunningUsersSupported ()` รับจำนวนสูงสุดที่รองรับผู้ใช้ที่รันพร้อมกัน
`int`	`getMaxNumberOfUsersSupported ()` รับจำนวนผู้ใช้ที่รองรับสูงสุด
`Integer`	`getPrimaryUserId ()` ส่งคืนรหัสผู้ใช้หลัก
`InputStreamSource`	`getScreenshot ()` จับภาพหน้าจอจากอุปกรณ์
`InputStreamSource`	`getScreenshot (String format, boolean rescale)` จับภาพหน้าจอจากอุปกรณ์
`InputStreamSource`	`getScreenshot (String format)` จับภาพหน้าจอจากอุปกรณ์
`InputStreamSource`	`getScreenshot (long displayId)` จับภาพหน้าจอจากอุปกรณ์ที่ระบุ ID ที่แสดง
`String`	`getSetting (String namespace, String key)` ดู `getSetting(int, String, String)` และดำเนินการกับผู้ใช้ระบบ
`String`	`getSetting (int userId, String namespace, String key)` ส่งกลับค่าของการตั้งค่าที่ร้องขอ
	`getUninstallablePackageNames ()` เรียกค้นชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้
`int`	`getUserFlags (int userId)` ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด
	`getUserInfos ()` รับแผนที่ของ useId ไปยัง `UserInfo` บนอุปกรณ์
`int`	`getUserSerialNumber (int userId)` ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ
`boolean`	`hasFeature (String feature)` ตรวจดูว่ามีคุณลักษณะใดในอุปกรณ์หรือไม่
`String`	`installPackage (File packageFile, boolean reinstall, String... extraArgs)` ติดตั้งแพ็คเกจ Android บนอุปกรณ์
`String`	`installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` ติดตั้งแพ็คเกจ Android บนอุปกรณ์
`String`	`installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs)` ติดตั้งแพ็คเกจ Android บนอุปกรณ์
`String`	`installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` ติดตั้งแพ็คเกจ Android บนอุปกรณ์สำหรับผู้ใช้ที่ระบุ
`String`	`installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)` ติดตั้งแพ็คเกจ Android บนอุปกรณ์สำหรับผู้ใช้ที่ระบุ
`String`	`installPackages ( packageFiles, boolean reinstall, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, String... extraArgs)`
`String`	`installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)` `installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)`
`String`	`installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)` `installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`boolean`	`isAppEnumerationSupported ()` ตรวจสอบว่าแพลตฟอร์มบนอุปกรณ์รองรับการแจงนับแอปหรือไม่
`boolean`	`isHeadlessSystemUserMode ()` ส่งคืนว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบหัวขาดหรือไม่
`boolean`	`isMainUserPermanentAdmin ()` ส่งคืนว่าผู้ใช้หลักเป็นผู้ดูแลระบบถาวรและไม่สามารถลบหรือลดระดับเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบ
`boolean`	`isMultiUserSupported ()` กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่
`boolean`	`isPackageInstalled (String packageName)` สอบถามอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดเพื่อตรวจสอบว่าติดตั้งอยู่หรือไม่
`boolean`	`isPackageInstalled (String packageName, String userId)` ค้นหาอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดและรหัสผู้ใช้ที่กำหนดเพื่อตรวจสอบว่าติดตั้งอยู่หรือไม่สำหรับผู้ใช้รายนั้น
`boolean`	`isUserRunning (int userId)` ตรวจสอบว่าผู้ใช้ที่กำหนดกำลังทำงานอยู่หรือไม่
`boolean`	`isUserSecondary (int userId)` ส่งคืนว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองตามแฟล็กหรือไม่
`boolean`	`isUserVisible (int userId)` ตรวจสอบว่ามองเห็นผู้ใช้ที่ระบุหรือไม่
`boolean`	`isUserVisibleOnDisplay (int userId, int displayId)` ตรวจสอบว่ามองเห็นผู้ใช้ที่ระบุในจอแสดงผลที่กำหนดหรือไม่
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported ()` ส่งคืนว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มต้นมองเห็นได้ในพื้นหลังหรือไม่ใน `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`
`boolean`	`isVisibleBackgroundUsersSupported ()` ส่งคืนว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มต้นมองเห็นได้ในพื้นหลังหรือไม่
	`listDisplayIds ()` รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"
	`listDisplayIdsForStartingVisibleBackgroundUsers ()` รับรายการจอแสดงผลที่สามารถใช้เพื่อ `start a user visible in the background`
	`listUsers ()` รับรายชื่อผู้ใช้บนอุปกรณ์
`boolean`	`logBugreport (String dataName, ITestLogger listener)` วิธีการช่วยเหลือในการรายงานข้อผิดพลาดและบันทึกไปยังนักข่าว
`void`	`postInvocationTearDown (Throwable exception)` ขั้นตอนเพิ่มเติมสำหรับการล้างข้อมูลที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการหลังจากการเรียกใช้เสร็จสิ้น
`boolean`	`removeAdmin (String componentName, int userId)` ลบผู้ดูแลระบบอุปกรณ์ที่กำหนดในผู้ใช้ที่กำหนดและคืน `true` หากสำเร็จ หากเป็น `false` ฉะนั้น
`void`	`removeOwners ()` ลบเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดด้วยความพยายามที่ดีที่สุด
`boolean`	`removeUser (int userId)` ลบผู้ใช้ที่ระบุออกจากอุปกรณ์
`boolean`	`setDeviceOwner (String componentName, int userId)` ตั้งค่าองค์ประกอบผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ในผู้ใช้ที่กำหนด
`void`	`setSetting (String namespace, String key, String value)` ดู `setSetting(int, String, String, String)` และดำเนินการกับผู้ใช้ระบบ
`void`	`setSetting (int userId, String namespace, String key, String value)` เพิ่มการตั้งค่าให้กับเนมสเปซของผู้ใช้ที่กำหนด
`void`	`shutdownMicrodroid ( ITestDevice microdroidDevice)` ปิดอุปกรณ์ microdroid หากมีอยู่
`boolean`	`startUser (int userId)` เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังหากหยุดอยู่ในขณะนี้
`boolean`	`startUser (int userId, boolean waitFlag)` เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังหากหยุดอยู่ในขณะนี้
`boolean`	`startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)` เริ่มผู้ใช้ที่กำหนดในพื้นหลัง มองเห็นได้ในจอแสดงผลที่กำหนด (เช่น อนุญาตให้ผู้ใช้เริ่มกิจกรรมในจอแสดงผลนั้น)
`boolean`	`stopUser (int userId, boolean waitFlag, boolean forceFlag)` หยุดผู้ใช้ที่กำหนด
`boolean`	`stopUser (int userId)` หยุดผู้ใช้ที่กำหนด
`boolean`	`supportsMicrodroid ()` ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid
`boolean`	`supportsMicrodroid (boolean protectedVm)` ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid
`boolean`	`switchUser (int userId)` เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยหมดเวลาเริ่มต้น
`boolean`	`switchUser (int userId, long timeout)` เปลี่ยนไปใช้ userId อื่นโดยหมดเวลาที่กำหนดให้เป็นเส้นตาย
`Bugreport`	`takeBugreport ()` รับรายงานจุดบกพร่องและส่งคืนภายในวัตถุรายงานจุด `Bugreport` เพื่อจัดการ
`String`	`uninstallPackage (String packageName)` ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์
`String`	`uninstallPackageForUser (String packageName, int userId)` ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์สำหรับผู้ใช้ที่ระบุ

วิธีการป้องกัน
`AaptParser`	`createParser (File appFile)`
`void`	`doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)` ทำการรีบูต adb
`InputStreamSource`	`getBugreportInternal ()`
`File`	`getBugreportzInternal ()` เมธอด Internal Helper เพื่อรับไฟล์ zip bugreportz เป็น `ERROR(/File)`
`long`	`getCheckNewUserSleep ()` เปิดเผยสำหรับการทดสอบ
`long`	`getHostCurrentTime ()` เปิดเผยสำหรับการทดสอบ
`void`	`prePostBootSetup ()` อนุญาตให้อุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) แทนที่วิธีนี้สำหรับการตั้งค่าหลังการบู๊ตเฉพาะ

เขตข้อมูล

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

คำสั่งที่สามารถใช้เพื่อยกเลิกคีย์การ์ด

ผู้สร้างสาธารณะ

อุปกรณ์ทดสอบ

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

วิธีการสาธารณะ

สามารถสลับเป็น HeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

ส่งคืนว่าอนุญาตให้เปลี่ยนเป็นผู้ใช้ SYSTEM ที่ไม่มีหัวหรือไม่

ส่งคืน
`boolean`

พ่น
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

พยายามปิดกล่องโต้ตอบแสดงข้อผิดพลาดที่แสดงอยู่บน UI ของอุปกรณ์ในปัจจุบัน

ส่งคืน
`boolean`	`true` ถ้าไม่มีไดอะล็อกหรือไดอะล็อกถูกล้างสำเร็จ `false` อย่างอื่น

พ่น
`DeviceNotAvailableException`

สร้างผู้ใช้

public int createUser (String name)

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0

พารามิเตอร์
`name`	`String` : ของผู้ใช้ที่จะสร้างบนอุปกรณ์

ส่งคืน
`int`	จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น

พ่น
`DeviceNotAvailableException`

สร้างผู้ใช้

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา

พารามิเตอร์
`name`	`String` : ของผู้ใช้ที่จะสร้างบนอุปกรณ์
`guest`	`boolean` : เปิดใช้งานแฟล็กผู้ใช้ --guest ระหว่างการสร้าง
`ephemeral`	`boolean` : เปิดใช้งานแฟล็กผู้ใช้ -- ชั่วคราวระหว่างการสร้าง
`forTesting`	`boolean` : เปิดใช้งานแฟล็กทดสอบ --for-testing ระหว่างการสร้าง

ส่งคืน
`int`	รหัสของผู้ใช้ที่สร้างขึ้น

พ่น
`DeviceNotAvailableException`

สร้างผู้ใช้

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา

พารามิเตอร์
`name`	`String` : ของผู้ใช้ที่จะสร้างบนอุปกรณ์
`guest`	`boolean` : เปิดใช้งานแฟล็กผู้ใช้ --guest ระหว่างการสร้าง
`ephemeral`	`boolean` : เปิดใช้งานแฟล็กผู้ใช้ -- ชั่วคราวระหว่างการสร้าง

ส่งคืน
`int`	รหัสของผู้ใช้ที่สร้างขึ้น

พ่น
`DeviceNotAvailableException`

สร้าง UserNoThrow

public int createUserNoThrow (String name)

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0

พารามิเตอร์
`name`	`String` : ของผู้ใช้ที่จะสร้างบนอุปกรณ์

ส่งคืน
`int`	จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้นหรือ -1 สำหรับข้อผิดพลาด

พ่น
`DeviceNotAvailableException`

ปิดการใช้งานKeyguard

public void disableKeyguard ()

พยายามปิดใช้งานคีย์การ์ด

ขั้นแรกให้รอการป้อนข้อมูลให้พร้อม ซึ่งจะเกิดขึ้นในช่วงเวลาเดียวกับที่อุปกรณ์รายงานว่า BOOT_COMPLETE เห็นได้ชัดว่าเป็นแบบอะซิงโครนัส เนื่องจากการใช้เฟรมเวิร์กในปัจจุบันมีสภาวะการแย่งชิงเป็นครั้งคราว จากนั้นคำสั่งจะถูกส่งไปปิดคีย์การ์ด (ใช้ได้กับอันที่ไม่ปลอดภัยเท่านั้น)

พ่น
`DeviceNotAvailableException`

มีไฟล์อยู่

public boolean doesFileExist (String deviceFilePath)

วิธีการช่วยเหลือเพื่อตรวจสอบว่ามีไฟล์บนอุปกรณ์อยู่หรือไม่

พารามิเตอร์
`deviceFilePath`	`String` : เส้นทางที่แน่นอนของไฟล์บนอุปกรณ์ที่จะตรวจสอบ

ส่งคืน
`boolean`	`true` ถ้ามีไฟล์อยู่ มิฉะนั้นจะ `false`

พ่น
`DeviceNotAvailableException`

มีไฟล์อยู่

public boolean doesFileExist (String deviceFilePath, 
                int userId)

วิธีการช่วยเหลือเพื่อตรวจสอบว่ามีไฟล์บนอุปกรณ์สำหรับผู้ใช้ที่กำหนดหรือไม่

พารามิเตอร์
`deviceFilePath`	`String` : เส้นทางที่แน่นอนของไฟล์บนอุปกรณ์ที่จะตรวจสอบ
`userId`	`int` : รหัสผู้ใช้ที่ใช้ตรวจสอบการมีอยู่ของไฟล์

ส่งคืน
`boolean`	`true` ถ้ามีไฟล์อยู่ มิฉะนั้นจะ `false`

พ่น
`DeviceNotAvailableException`

กองขยะ

public File dumpHeap (String process, 
                String devicePath)

พยายามดัมพ์ฮีปจาก system_server เป็นความรับผิดชอบของผู้โทรในการล้างไฟล์ที่ทิ้ง

พารามิเตอร์
`process`	`String` : ชื่อของกระบวนการอุปกรณ์ที่จะถ่ายโอนข้อมูลบน
`devicePath`	`String` : เส้นทางบนอุปกรณ์ที่จะวางการถ่ายโอนข้อมูล นี่จะต้องเป็นตำแหน่งที่ได้รับอนุญาต

ส่งคืน
`File`	`ERROR(/File)` ที่มีรายงาน เป็นโมฆะหากมีบางอย่างล้มเหลว

พ่น
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานบนอุปกรณ์

ส่งคืน
	`ERROR(/Set)` ของ `ApexInfo` ที่เปิดใช้งานบนอุปกรณ์ในปัจจุบัน

พ่น
`DeviceNotAvailableException`

รับการตั้งค่าทั้งหมด

public  getAllSettings (String namespace)

คืนค่าคีย์คู่ของเนมสเปซที่ร้องขอ

พารามิเตอร์
`namespace`	`String` : ต้องเป็นหนึ่งใน {"system", "secure", "global"}

ส่งคืน
	แผนที่ของคู่ค่าคีย์ เป็นโมฆะหากไม่รองรับเนมสเปซ

พ่น
`DeviceNotAvailableException`

รับรหัส Android

public String getAndroidId (int userId)

ค้นหาและส่งคืน android-id ที่เชื่อมโยงกับ userId หากไม่พบจะเป็น null

พารามิเตอร์
`userId`	`int`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

รับรหัส Android

public  getAndroidIds ()

สร้างแผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน ไม่มีการประกันว่ารหัสผู้ใช้แต่ละรหัสจะพบรหัส Android ที่เชื่อมโยงในฟังก์ชันนี้ ดังนั้นรหัสผู้ใช้บางรายการอาจตรงกับค่าว่าง

ส่งคืน
	แผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน

พ่น
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

ดึงข้อมูลเกี่ยวกับแพ็คเกจที่ติดตั้งบนอุปกรณ์

พารามิเตอร์
`packageName`	`String`

ส่งคืน
`PackageInfo`	`PackageInfo` หรือ `null` หากไม่สามารถดึงข้อมูลได้

พ่น
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

ดึงข้อมูลแพ็คเกจที่ติดตั้งบนอุปกรณ์

ส่งคืน
	`ERROR(/List)` ของ `PackageInfo` ที่ติดตั้งบนอุปกรณ์

พ่น
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

ดึงรายงานข้อผิดพลาดจากอุปกรณ์

การดำเนินการนี้รับประกันได้ว่าจะทำงานต่อไปบนอุปกรณ์ที่ไม่มี sdcard (หรือเมื่อยังไม่ได้ติดตั้ง sdcard)

ส่งคืน
`InputStreamSource`	`InputStreamSource` ซึ่งจะสร้างเนื้อหารายงานข้อผิดพลาดตามความต้องการ ในกรณีที่ล้มเหลว `InputStreamSource` จะสร้าง `ERROR(/InputStream)` ที่ว่างเปล่า

getBugreportz

public InputStreamSource getBugreportz ()

ดึงข้อมูลรายงานข้อผิดพลาดจากอุปกรณ์ รายงานข้อบกพร่องรูปแบบ Zip ประกอบด้วยรายงานข้อบกพร่องหลักและไฟล์บันทึกอื่นๆ ที่มีประโยชน์สำหรับการดีบัก

รองรับเฉพาะ 'adb version' > 1.0.36

ส่งคืน
`InputStreamSource`	`InputStreamSource` ของไฟล์ zip ที่มี bugreportz ส่งคืน null ในกรณีที่เกิดข้อผิดพลาด

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

คืนค่าสถานะพับได้ปัจจุบันของอุปกรณ์หรือค่า null หากเกิดปัญหาบางอย่างขึ้น

ส่งคืน
`DeviceFoldableState`

พ่น
`DeviceNotAvailableException`

รับผู้ใช้ปัจจุบัน

public int getCurrentUser ()

ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่ ในกรณีที่เกิดข้อผิดพลาด ให้ส่งคืน -10,000

ส่งคืน
`int`

พ่น
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

ส่งกลับรายการสถานะการพับบนอุปกรณ์ สามารถรับได้ด้วย "cmd device_state print-state"

ส่งคืน

พ่น
`DeviceNotAvailableException`

รับติดตั้งชื่อแพ็คเกจ

public  getInstalledPackageNames ()

ดึงชื่อแพ็คเกจแอปพลิเคชันที่มีอยู่ในอุปกรณ์

ส่งคืน
	`ERROR(/Set)` ของชื่อแพ็คเกจ `String` ที่ติดตั้งบนอุปกรณ์ในปัจจุบัน

พ่น
`DeviceNotAvailableException`

รับ KeyguardState

public KeyguardControllerState getKeyguardState ()

ส่งคืนวัตถุเพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือค่าว่างหากไม่รองรับ

ส่งคืน
`KeyguardControllerState`	`KeyguardControllerState` ที่มีสแน็ปช็อตของสถานะของคีย์การ์ดและส่งคืนค่า Null หากไม่รองรับเคียวรี Keyguard

พ่น
`DeviceNotAvailableException`

รับรหัสผู้ใช้หลัก

public Integer getMainUserId ()

ส่งคืนรหัสผู้ใช้หลัก

ส่งคืน
`Integer`	userId ของผู้ใช้หลักถ้ามี และ null หากไม่มีผู้ใช้หลัก

พ่น
`DeviceNotAvailableException`

รับMainlineModuleInfo

public  getMainlineModuleInfo ()

รับข้อมูลเกี่ยวกับโมดูล mainline ที่ติดตั้งบนอุปกรณ์

ส่งคืน
	`ERROR(/Set)` ของโมดูลการฉีดสาย `String` ที่ติดตั้งอยู่ในอุปกรณ์ในปัจจุบัน

พ่น
`DeviceNotAvailableException`

getMaxNumberOfRunningUsers รองรับ

public int getMaxNumberOfRunningUsersSupported ()

รับจำนวนสูงสุดที่รองรับผู้ใช้ที่รันพร้อมกัน ค่าเริ่มต้นเป็น 0

ส่งคืน
`int`	จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รันพร้อมกัน

พ่น
`DeviceNotAvailableException`

รับจำนวนผู้ใช้สูงสุดที่สนับสนุน

public int getMaxNumberOfUsersSupported ()

รับจำนวนผู้ใช้ที่รองรับสูงสุด ค่าเริ่มต้นเป็น 0

ส่งคืน
`int`	จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับ

พ่น
`DeviceNotAvailableException`

รับรหัสผู้ใช้หลัก

public Integer getPrimaryUserId ()

ส่งคืนรหัสผู้ใช้หลัก

ส่งคืน
`Integer`	userId ของผู้ใช้หลักถ้ามี และ null หากไม่มีผู้ใช้หลัก

พ่น
`DeviceNotAvailableException`

รับสกรีนช็อต

public InputStreamSource getScreenshot ()

จับภาพหน้าจอจากอุปกรณ์

ส่งคืน
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ png หรือ `null` หากภาพหน้าจอไม่สำเร็จ

พ่น
`DeviceNotAvailableException`

รับสกรีนช็อต

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

จับภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(String) แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กลง

พารามิเตอร์
`format`	`String` : รองรับ PNG, JPEG
`rescale`	`boolean` : ถ้าภาพหน้าจอควรปรับขนาดใหม่เพื่อลดขนาดของภาพที่ได้

ส่งคืน
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ หรือ `null` ถ้าภาพหน้าจอไม่สำเร็จ

พ่น
`DeviceNotAvailableException`

รับสกรีนช็อต

public InputStreamSource getScreenshot (String format)

จับภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(รูปแบบ) แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กลง

พารามิเตอร์
`format`	`String` : รองรับ PNG, JPEG

ส่งคืน
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ หรือ `null` ถ้าภาพหน้าจอไม่สำเร็จ

พ่น
`DeviceNotAvailableException`

รับสกรีนช็อต

public InputStreamSource getScreenshot (long displayId)

จับภาพหน้าจอจากอุปกรณ์ที่ระบุ ID ที่แสดง รูปแบบคือ PNG

สิ่งที่ต้องทำ: ขยายการใช้งานด้านบนเพื่อรองรับ 'รูปแบบ' และ 'ปรับขนาด'

พารามิเตอร์
`displayId`	`long` : รหัสการแสดงผลของหน้าจอที่จะรับภาพหน้าจอ

ส่งคืน
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ หรือ `null` ถ้าภาพหน้าจอไม่สำเร็จ

พ่น
`DeviceNotAvailableException`

รับการตั้งค่า

public String getSetting (String namespace, 
                String key)

ดู getSetting(int, String, String) และดำเนินการกับผู้ใช้ระบบ

พารามิเตอร์
`namespace`	`String`
`key`	`String`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

รับการตั้งค่า

public String getSetting (int userId, 
                String namespace, 
                String key)

ส่งกลับค่าของการตั้งค่าที่ร้องขอ เนมสเปซต้องเป็นหนึ่งใน: {"system", "secure", "global"}

พารามิเตอร์
`userId`	`int`
`namespace`	`String`
`key`	`String`

ส่งคืน
`String`	ค่าที่เกี่ยวข้องกับ namespace:key ของผู้ใช้ เป็นโมฆะหากไม่พบ

พ่น
`DeviceNotAvailableException`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

เรียกค้นชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ ปัจจุบันนี้ถูกกำหนดเป็นแพ็คเกจที่ไม่ใช่ระบบและแพ็คเกจระบบที่อัปเดต

ส่งคืน
	`ERROR(/Set)` ของชื่อแพ็คเกจ `String` ที่ถอนการติดตั้งได้ซึ่งติดตั้งอยู่ในอุปกรณ์ในปัจจุบัน

พ่น
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด ค่าสถานะถูกกำหนดในคลาส "android.content.pm.UserInfo" ใน Android Open Source Project

พารามิเตอร์
`userId`	`int`

ส่งคืน
`int`	แฟล็กที่เกี่ยวข้องกับ userId ที่ระบุหากพบ -10,000 ในกรณีอื่นๆ

พ่น
`DeviceNotAvailableException`

รับข้อมูลผู้ใช้

public  getUserInfos ()

รับแผนที่ของ useId ไปยัง UserInfo บนอุปกรณ์ จะโยน DeviceRuntimeException หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้

ส่งคืน
	รายการวัตถุ UserInfo

พ่น
`DeviceNotAvailableException`

รับ UserSerialNumber

public int getUserSerialNumber (int userId)

ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ

พารามิเตอร์
`userId`	`int`

ส่งคืน
`int`

พ่น
`DeviceNotAvailableException`

มีคุณสมบัติ

public boolean hasFeature (String feature)

ตรวจดูว่ามีคุณลักษณะใดในอุปกรณ์หรือไม่

พารามิเตอร์
`feature`	`String` : รูปแบบใดควรเป็น "feature: " หรือ " " โดยตรง.

ส่งคืน
`boolean`	เป็นจริงหากพบคุณสมบัติ มิฉะนั้นจะเป็นเท็จ

พ่น
`DeviceNotAvailableException`

ติดตั้งแพ็คเกจ

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

ติดตั้งแพ็คเกจ Android บนอุปกรณ์

พารามิเตอร์
`packageFile`	`File` : ไฟล์ apk ที่จะติดตั้ง
`reinstall`	`boolean` : `true` หากควรทำการติดตั้งใหม่
`extraArgs`	`String` : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

ส่งคืน
`String`	`String` ที่มีรหัสข้อผิดพลาดหรือ `null` หากสำเร็จ

พ่น
`DeviceNotAvailableException`

ติดตั้งแพ็คเกจ

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

ติดตั้งแพ็คเกจ Android บนอุปกรณ์

หมายเหตุ: เฉพาะกรณีการใช้งานที่ต้องการการควบคุมที่ชัดเจนในการให้สิทธิ์รันไทม์ ณ เวลาติดตั้งเท่านั้นที่ควรเรียกใช้ฟังก์ชันนี้

พารามิเตอร์
`packageFile`	`File` : ไฟล์ apk ที่จะติดตั้ง
`reinstall`	`boolean` : `true` หากควรทำการติดตั้งใหม่
`grantPermissions`	`boolean` : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง
`extraArgs`	`String` : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

ส่งคืน
`String`	`String` ที่มีรหัสข้อผิดพลาดหรือ `null` หากสำเร็จ

พ่น
`DeviceNotAvailableException`

ติดตั้งแพ็คเกจ

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                String... extraArgs)

ติดตั้งแพ็คเกจ Android บนอุปกรณ์

พารามิเตอร์
`packageFile`	`File` : ไฟล์ apk ที่จะติดตั้ง
`certFile`	`File` : `true` หากควรทำการติดตั้งใหม่
`reinstall`	`boolean` : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง
`extraArgs`	`String` : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

ส่งคืน
`String`	`String` ที่มีรหัสข้อผิดพลาดหรือ `null` หากสำเร็จ

พ่น
`DeviceNotAvailableException`

ติดตั้ง PackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

ติดตั้งแพ็คเกจ Android บนอุปกรณ์สำหรับผู้ใช้ที่กำหนด

พารามิเตอร์
`packageFile`	`File` : ไฟล์ apk ที่จะติดตั้ง
`reinstall`	`boolean` : `true` หากควรทำการติดตั้งใหม่
`grantPermissions`	`boolean` : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง
`userId`	`int` : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง
`extraArgs`	`String` : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

ส่งคืน
`String`	`String` ที่มีรหัสข้อผิดพลาดหรือ `null` หากสำเร็จ

พ่น
`DeviceNotAvailableException`

ติดตั้ง PackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

ติดตั้งแพ็คเกจ Android บนอุปกรณ์สำหรับผู้ใช้ที่กำหนด

พารามิเตอร์
`packageFile`	`File` : ไฟล์ apk ที่จะติดตั้ง
`reinstall`	`boolean` : `true` หากควรทำการติดตั้งใหม่
`userId`	`int` : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง
`extraArgs`	`String` : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

ส่งคืน
`String`	`String` ที่มีรหัสข้อผิดพลาดหรือ `null` หากสำเร็จ

พ่น
`DeviceNotAvailableException`

ติดตั้งแพ็คเกจ

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

พารามิเตอร์
`packageFiles`
`reinstall`	`boolean`
`extraArgs`	`String`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

ติดตั้งแพ็คเกจ

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

พารามิเตอร์
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

พารามิเตอร์
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

พารามิเตอร์
`packageFiles`
`reinstall`	`boolean`
`userId`	`int`
`extraArgs`	`String`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

ติดตั้งแพ็คเกจระยะไกล

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

พารามิเตอร์
`remoteApkPaths`
`reinstall`	`boolean`
`extraArgs`	`String`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

ติดตั้งแพ็คเกจระยะไกล

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

พารามิเตอร์
`remoteApkPaths`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

ส่งคืน
`String`

พ่น
`DeviceNotAvailableException`

isAppEnumeration รองรับ

public boolean isAppEnumerationSupported ()

ตรวจสอบว่าแพลตฟอร์มบนอุปกรณ์รองรับการแจงนับแอปหรือไม่

ส่งคืน
`boolean`	เป็นจริงหากรองรับการแจงนับแอป มิฉะนั้นจะเป็นเท็จ

พ่น
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

ส่งคืนว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบหัวขาดหรือไม่

ส่งคืน
`boolean`

พ่น
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

ส่งคืนว่าผู้ใช้หลักเป็นผู้ดูแลระบบถาวรและไม่สามารถลบหรือลดระดับเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบ

ส่งคืน
`boolean`

พ่น
`DeviceNotAvailableException`

รองรับ MultiUser

public boolean isMultiUserSupported ()

กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่

ส่งคืน
`boolean`	จริงหากรองรับผู้ใช้หลายคน มิฉะนั้นจะเป็นเท็จ

พ่น
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

สอบถามอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดเพื่อตรวจสอบว่าติดตั้งอยู่หรือไม่

พารามิเตอร์
`packageName`	`String`

ส่งคืน
`boolean`	จริงหากมีการรายงานแพ็คเกจว่าติดตั้งแล้ว เป็นอย่างอื่น

พ่น
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

พารามิเตอร์
`packageName`	`String` : แพ็คเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งหรือไม่
`userId`	`String` : รหัสผู้ใช้ที่เรากำลังตรวจสอบการติดตั้งแพ็คเกจ หากเป็นโมฆะ ระบบจะใช้ศูนย์ผู้ใช้หลัก

ส่งคืน
`boolean`	จริงหากมีการรายงานแพ็คเกจว่าติดตั้งแล้ว เป็นอย่างอื่น

พ่น
`DeviceNotAvailableException`

isUserRunning

public boolean isUserRunning (int userId)

ตรวจสอบว่าผู้ใช้ที่กำหนดกำลังทำงานอยู่หรือไม่

พารามิเตอร์
`userId`	`int`

ส่งคืน
`boolean`	จริงถ้าผู้ใช้กำลังเรียกใช้ เท็จในทุกกรณี

พ่น
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

ส่งคืนว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองตามแฟล็กหรือไม่

พารามิเตอร์
`userId`	`int`

ส่งคืน
`boolean`	จริงถ้าผู้ใช้เป็นผู้ใช้รอง มิฉะนั้นจะเป็นเท็จ

พ่น
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

ตรวจสอบว่ามองเห็นผู้ใช้ที่ระบุหรือไม่

ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่โต้ตอบกับผู้ใช้ "มนุษย์" และด้วยเหตุนี้จึงสามารถเริ่มกิจกรรมการเปิดใช้งานได้ (โดยทั่วไปในการแสดงผลเริ่มต้น)

พารามิเตอร์
`userId`	`int`

ส่งคืน
`boolean`

พ่น
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

ตรวจสอบว่ามองเห็นผู้ใช้ที่ระบุในจอแสดงผลที่กำหนดหรือไม่

ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่โต้ตอบกับผู้ใช้ "มนุษย์" และด้วยเหตุนี้จึงสามารถเริ่มกิจกรรมการเปิดใช้งานในจอแสดงผลนั้นได้

พารามิเตอร์
`userId`	`int`
`displayId`	`int`

ส่งคืน
`boolean`

พ่น
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

ส่งคืนว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มต้นมองเห็นได้ในพื้นหลังหรือไม่ใน ERROR(/java.android.view.Display#DEFAULT_DISPLAY)

ถ้าเป็นเช่นนั้น คุณสามารถเรียก startVisibleBackgroundUser(int, int, boolean) ส่งผ่านการแสดงผลที่ส่งคืนโดย listDisplayIdsForStartingVisibleBackgroundUsers() (ซึ่งควรมี ERROR(/java.android.view.Display#DEFAULT_DISPLAY) )

ส่งคืน
`boolean`

พ่น
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

ส่งคืนว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มต้นมองเห็นได้ในพื้นหลังหรือไม่

หากเป็นเช่นนั้น คุณสามารถเรียก startVisibleBackgroundUser(int, int, boolean) ส่งผ่านการแสดงผลที่ส่งคืนโดย listDisplayIdsForStartingVisibleBackgroundUsers()

ส่งคืน
`boolean`

พ่น
`DeviceNotAvailableException`

รายการรหัสที่แสดง

public  listDisplayIds ()

รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"

ส่งคืน
	รายการของจอแสดงผล ค่าเริ่มต้นจะคืนค่าการแสดงผลเริ่มต้นเป็น 0 เสมอ

พ่น
`DeviceNotAvailableException`

listDisplayIdsFor StartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

รับรายการจอแสดงผลที่สามารถใช้เพื่อ start a user visible in the background

ส่งคืน

พ่น
`DeviceNotAvailableException`

รายการผู้ใช้

public  listUsers ()

รับรายชื่อผู้ใช้บนอุปกรณ์ จะโยน DeviceRuntimeException หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้

ส่งคืน
	รายการรหัสผู้ใช้

พ่น
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

วิธีการช่วยเหลือในการรายงานข้อผิดพลาดและบันทึกไปยังนักข่าว

พารามิเตอร์
`dataName`	`String` : ชื่อที่จะรายงานข้อบกพร่อง
`listener`	`ITestLogger` : `ITestLogger` เพื่อบันทึกรายงานข้อผิดพลาด

ส่งคืน
`boolean`	เป็นจริงหากการบันทึกสำเร็จ มิฉะนั้นจะเป็นเท็จ

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

ขั้นตอนเพิ่มเติมสำหรับการล้างข้อมูลที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการหลังจากการเรียกใช้เสร็จสิ้น

พารามิเตอร์
`exception`	`Throwable` : ถ้ามี ข้อยกเว้นขั้นสุดท้ายที่เกิดจากการเรียกใช้ล้มเหลว

ลบผู้ดูแลระบบ

public boolean removeAdmin (String componentName, 
                int userId)

ลบผู้ดูแลระบบอุปกรณ์ที่กำหนดในผู้ใช้ที่กำหนดและคืน true หากสำเร็จ หากเป็น false ฉะนั้น

พารามิเตอร์
`componentName`	`String` : ของผู้ดูแลระบบอุปกรณ์ที่จะถูกลบ
`userId`	`int` : ของผู้ใช้ที่ผู้ดูแลระบบอุปกรณ์อาศัยอยู่

ส่งคืน
`boolean`	เป็นจริงหากสำเร็จ มิฉะนั้นจะเป็นเท็จ

พ่น
`DeviceNotAvailableException`

ลบเจ้าของ

public void removeOwners ()

ลบเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดด้วยความพยายามที่ดีที่สุด

พ่น
`DeviceNotAvailableException`

ลบผู้ใช้

public boolean removeUser (int userId)

ลบผู้ใช้ที่ระบุออกจากอุปกรณ์

พารามิเตอร์
`userId`	`int` : ของผู้ใช้ที่จะลบ

ส่งคืน
`boolean`	จริงหากเราลบผู้ใช้ได้สำเร็จ มิฉะนั้นจะเป็นเท็จ

พ่น
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

ตั้งค่าองค์ประกอบผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ในผู้ใช้ที่กำหนด

พารามิเตอร์
`componentName`	`String` : ของผู้ดูแลระบบอุปกรณ์ที่จะเป็นเจ้าของอุปกรณ์
`userId`	`int` : ของผู้ใช้ที่เจ้าของอุปกรณ์อาศัยอยู่

ส่งคืน
`boolean`	เป็นจริงหากสำเร็จ มิฉะนั้นจะเป็นเท็จ

พ่น
`DeviceNotAvailableException`

การตั้งค่า

public void setSetting (String namespace, 
                String key, 
                String value)

ดู setSetting(int, String, String, String) และดำเนินการกับผู้ใช้ระบบ

พารามิเตอร์
`namespace`	`String`
`key`	`String`
`value`	`String`

พ่น
`DeviceNotAvailableException`

การตั้งค่า

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

เพิ่มการตั้งค่าให้กับเนมสเปซของผู้ใช้ที่กำหนด การตั้งค่าบางอย่างจะใช้ได้หลังจากรีบูตเท่านั้น เนมสเปซต้องเป็นหนึ่งใน: {"system", "secure", "global"}

พารามิเตอร์
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

พ่น
`DeviceNotAvailableException`

ปิดไมโครดรอยด์

public void shutdownMicrodroid (ITestDevice microdroidDevice)

ปิดอุปกรณ์ microdroid หากมีอยู่

พารามิเตอร์
`microdroidDevice`	`ITestDevice`

พ่น
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ผู้ใช้เริ่มต้น

public boolean startUser (int userId)

เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังหากหยุดอยู่ในขณะนี้ หากผู้ใช้ทำงานในพื้นหลังแล้ว วิธีนี้เป็น NOOP

พารามิเตอร์
`userId`	`int` : ของผู้ใช้ที่จะเริ่มต้นในพื้นหลัง

ส่งคืน
`boolean`	จริงถ้าผู้ใช้เริ่มต้นได้สำเร็จในเบื้องหลัง

พ่น
`DeviceNotAvailableException`

ผู้ใช้เริ่มต้น

public boolean startUser (int userId, 
                boolean waitFlag)

เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังหากหยุดอยู่ในขณะนี้ หากผู้ใช้ทำงานในพื้นหลังแล้ว วิธีนี้เป็น NOOP สามารถตั้งค่าสถานะพิเศษเพื่อรอให้การดำเนินการมีผล

พารามิเตอร์
`userId`	`int` : ของผู้ใช้ที่จะเริ่มต้นในพื้นหลัง
`waitFlag`	`boolean` : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มต้นและปลดล็อค

ส่งคืน
`boolean`	จริงถ้าผู้ใช้เริ่มต้นได้สำเร็จในพื้นหลัง

พ่น
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

เริ่มผู้ใช้ที่กำหนดในพื้นหลัง มองเห็นได้ในจอแสดงผลที่กำหนด (เช่น อนุญาตให้ผู้ใช้เริ่มกิจกรรมในจอแสดงผลนั้น)

หมายเหตุ: คำสั่งนี้ไม่ได้ตรวจสอบว่ามีผู้ใช้อยู่หรือไม่, จอแสดงผลพร้อมใช้งาน, device supports such feature ฯลฯ

พารามิเตอร์
`userId`	`int` : ของผู้ใช้ที่จะเริ่มต้นในพื้นหลัง
`displayId`	`int` : แสดงเพื่อเริ่มให้ผู้ใช้มองเห็นได้
`waitFlag`	`boolean` : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มต้นและปลดล็อค

ส่งคืน
`boolean`	`true` ถ้าผู้ใช้เริ่มต้นได้สำเร็จโดยมองเห็นได้ในเบื้องหลัง

พ่น
`DeviceNotAvailableException`

หยุดผู้ใช้

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

หยุดผู้ใช้ที่กำหนด สามารถตั้งค่าสถานะเพิ่มเติมเพื่อรอให้การดำเนินการมีผล และบังคับยุติผู้ใช้ ไม่สามารถหยุดผู้ใช้ปัจจุบันและระบบ

พารามิเตอร์
`userId`	`int` : ของผู้ใช้ที่จะหยุด
`waitFlag`	`boolean` : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุดทำงาน
`forceFlag`	`boolean` : จะบังคับให้หยุดผู้ใช้

ส่งคืน
`boolean`	จริงถ้าหยุดผู้ใช้ได้สำเร็จ

พ่น
`DeviceNotAvailableException`

หยุดผู้ใช้

public boolean stopUser (int userId)

หยุดผู้ใช้ที่กำหนด หากผู้ใช้หยุดทำงานแล้ว วิธีนี้ถือเป็น NOOP ไม่สามารถหยุดผู้ใช้ปัจจุบันและระบบ

พารามิเตอร์
`userId`	`int` : ของผู้ใช้ที่จะหยุด

ส่งคืน
`boolean`	จริงถ้าหยุดผู้ใช้ได้สำเร็จ

พ่น
`DeviceNotAvailableException`

รองรับMicrodroid

public boolean supportsMicrodroid ()

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid

ส่งคืน
`boolean`	ส่งคืนค่าจริงหากเงื่อนไขเบื้องต้นตรงตามเงื่อนไข มิฉะนั้นจะเป็นเท็จ

รองรับMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid

พารามิเตอร์
`protectedVm`	`boolean` : จริงถ้า microdroid ตั้งใจให้ทำงานบน VM ที่ได้รับการป้องกัน

ส่งคืน
`boolean`	ส่งคืนค่าจริงหากเงื่อนไขเบื้องต้นตรงตามเงื่อนไข มิฉะนั้นจะเป็นเท็จ

เปลี่ยนผู้ใช้

public boolean switchUser (int userId)

เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยหมดเวลาเริ่มต้น switchUser(int, long)

พารามิเตอร์
`userId`	`int`

ส่งคืน
`boolean`	เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นอย่างอื่น

พ่น
`DeviceNotAvailableException`

เปลี่ยนผู้ใช้

public boolean switchUser (int userId, 
                long timeout)

เปลี่ยนไปใช้ userId อื่นโดยหมดเวลาที่กำหนดให้เป็นเส้นตาย พยายามปิดใช้งานคีย์การ์ดหลังจากเปลี่ยนผู้ใช้สำเร็จ

พารามิเตอร์
`userId`	`int`
`timeout`	`long` : เพื่อรอก่อนที่จะส่งคืนค่าเท็จสำหรับผู้ใช้สวิตช์ที่ล้มเหลว

ส่งคืน
`boolean`	เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นอย่างอื่น

พ่น
`DeviceNotAvailableException`

TakeBugreport

public Bugreport takeBugreport ()

รับรายงานจุดบกพร่องและส่งคืนภายในวัตถุรายงานจุด Bugreport เพื่อจัดการ คืนค่า null ในกรณีที่มีปัญหา ไฟล์ที่อ้างอิงในวัตถุ Bugreport จะต้องถูกล้างผ่าน Bugreport.close()

ส่งคืน
`Bugreport`

ถอนการติดตั้งแพ็คเกจ

public String uninstallPackage (String packageName)

ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์

พารามิเตอร์
`packageName`	`String` : แพ็คเกจ Android ที่จะถอนการติดตั้ง

ส่งคืน
`String`	`String` ที่มีรหัสข้อผิดพลาดหรือ `null` หากสำเร็จ

พ่น
`DeviceNotAvailableException`

ถอนการติดตั้ง PackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์สำหรับผู้ใช้ที่ระบุ

พารามิเตอร์
`packageName`	`String` : แพ็คเกจ Android ที่จะถอนการติดตั้ง
`userId`	`int` : รหัสผู้ใช้จำนวนเต็มที่จะถอนการติดตั้ง

ส่งคืน
`String`	`String` ที่มีรหัสข้อผิดพลาดหรือ `null` หากสำเร็จ

พ่น
`DeviceNotAvailableException`

วิธีการป้องกัน

สร้าง Parser

protected AaptParser createParser (File appFile)

พารามิเตอร์
`appFile`	`File`

ส่งคืน
`AaptParser`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

ทำการรีบูต adb

พารามิเตอร์
`rebootMode`	`NativeDevice.RebootMode` : โหมดของการรีบูตนี้
`reason`	`String` : สำหรับการรีบูตครั้งนี้

พ่น
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

ส่งคืน
`InputStreamSource`

getBugreportzInternal

protected File getBugreportzInternal ()

เมธอด Internal Helper เพื่อรับไฟล์ zip bugreportz เป็น ERROR(/File)

ส่งคืน
`File`

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

เปิดเผยสำหรับการทดสอบ

ส่งคืน
`long`

getHostCurrentTime

protected long getHostCurrentTime ()

เปิดเผยสำหรับการทดสอบ

ส่งคืน
`long`

prePostBootSetup

protected void prePostBootSetup ()

อนุญาตให้อุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) แทนที่วิธีนี้สำหรับการตั้งค่าหลังการบู๊ตเฉพาะ

พ่น
`DeviceNotAvailableException`

อุปกรณ์ทดสอบ

สรุป

คลาสที่ซ้อนกัน

เขตข้อมูล

ผู้สร้างสาธารณะ

วิธีการสาธารณะ

วิธีการป้องกัน

เขตข้อมูล

DISMISS_KEYGUARD_CMD

ผู้สร้างสาธารณะ

อุปกรณ์ทดสอบ

วิธีการสาธารณะ

สามารถสลับเป็น HeadlessSystemUser

clearErrorDialogs

สร้างผู้ใช้

สร้างผู้ใช้

สร้างผู้ใช้

สร้าง UserNoThrow

ปิดการใช้งานKeyguard

มีไฟล์อยู่

มีไฟล์อยู่

กองขยะ

getActiveApexes

รับการตั้งค่าทั้งหมด

รับรหัส Android

รับรหัส Android

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

รับผู้ใช้ปัจจุบัน

getFoldableStates

รับติดตั้งชื่อแพ็คเกจ

รับ KeyguardState

รับรหัสผู้ใช้หลัก

รับMainlineModuleInfo

getMaxNumberOfRunningUsers รองรับ

รับจำนวนผู้ใช้สูงสุดที่สนับสนุน

รับรหัสผู้ใช้หลัก

รับสกรีนช็อต

รับสกรีนช็อต

รับสกรีนช็อต

รับสกรีนช็อต

รับการตั้งค่า

รับการตั้งค่า

getUninstallablePackageNames

getUserFlags

รับข้อมูลผู้ใช้

รับ UserSerialNumber

มีคุณสมบัติ

ติดตั้งแพ็คเกจ

ติดตั้งแพ็คเกจ

ติดตั้งแพ็คเกจ

ติดตั้ง PackageForUser

ติดตั้ง PackageForUser

ติดตั้งแพ็คเกจ

ติดตั้งแพ็คเกจ

installPackagesForUser

installPackagesForUser

ติดตั้งแพ็คเกจระยะไกล

ติดตั้งแพ็คเกจระยะไกล

isAppEnumeration รองรับ

isHeadlessSystemUserMode

isMainUserPermanentAdmin

รองรับ MultiUser

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

รายการรหัสที่แสดง

listDisplayIdsFor StartingVisibleBackgroundUsers

รายการผู้ใช้

logBugreport

postInvocationTearDown

ลบผู้ดูแลระบบ