DpcMigrationClient
public interface DpcMigrationClient
Ứng dụng khách đưa ra yêu cầu liên quan đến việc di chuyển dpc.
Tóm tắt
Phương thức công khai |
|
|---|---|
abstract @NonNull ListenableFuture<DpcMigrationAttempt> |
getMigrationAttempt(Tìm cách di chuyển. |
abstract DpcMigrationAttempt |
getMigrationAttemptAwait(Tìm cách di chuyển. |
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> |
Trả về danh sách tất cả các lần thử di chuyển. |
abstract @NonNull List<@NonNull DpcMigrationAttempt> |
Trả về danh sách tất cả các lần thử di chuyển. |
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> |
migrateDeviceManagementToAndroidManagementApi(Chuyển thiết bị này sang trạng thái được quản lý bằng Android Management API. |
abstract @NonNull DpcMigrationAttempt |
migrateDeviceManagementToAndroidManagementApiAwait(Chuyển thiết bị này sang trạng thái được quản lý bằng Android Management API. |
Phương thức công khai
getMigrationAttempt
abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
@NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)
Tìm cách di chuyển.
Nếu không có tên nào được chỉ định trong GetDpcMigrationAttemptRequest, thì DpcMigrationAttempt gần đây nhất sẽ được trả về.
Chỉ Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ, hoặc Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ trước đây đã chuyển sang Android Management API mới có thể gọi phương thức này.
| Giá trị trả về | |
|---|---|
@NonNull ListenableFuture<DpcMigrationAttempt> |
|
getMigrationAttemptAwait
abstract DpcMigrationAttempt getMigrationAttemptAwait(
@NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)
Tìm cách di chuyển.
Nếu không có tên nào được chỉ định trong GetDpcMigrationAttemptRequest, thì DpcMigrationAttempt gần đây nhất sẽ được trả về.
Chỉ Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ, hoặc Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ trước đây đã chuyển sang Android Management API mới có thể gọi phương thức này.
| Giá trị trả về | |
|---|---|
DpcMigrationAttempt |
|
| Gửi | |
|---|---|
java.lang.SecurityException |
Nếu phương thức gọi không phải là Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ, hoặc không phải là Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ trước đây đã chuyển sang Android Management API. |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
Nếu lệnh gọi liên quan đến việc di chuyển dpc không thành công. Thông báo và loại phụ của ngoại lệ sẽ có thêm thông tin chi tiết về lỗi. |
listMigrationAttempts
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()
Trả về danh sách tất cả các lần thử di chuyển.
Chỉ Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ, hoặc Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ trước đây đã chuyển sang Android Management API mới có thể gọi phương thức này. Lưu ý: các lần di chuyển trước đó sẽ tự động bị xoá và không được trả về.
| Giá trị trả về | |
|---|---|
@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> |
|
listMigrationAttemptsAwait
abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()
Trả về danh sách tất cả các lần thử di chuyển.
Chỉ Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ, hoặc Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ trước đây đã chuyển sang Android Management API mới có thể gọi phương thức này. Lưu ý: các lần di chuyển trước đó sẽ tự động bị xoá và không được trả về.
| Giá trị trả về | |
|---|---|
@NonNull List<@NonNull DpcMigrationAttempt> |
Danh sách |
| Gửi | |
|---|---|
java.lang.SecurityException |
Nếu phương thức gọi không phải là Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ, hoặc không phải là Chủ sở hữu thiết bị/Chủ sở hữu hồ sơ trước đây đã chuyển sang Android Management API. |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
Nếu lệnh gọi liên quan đến việc di chuyển dpc không thành công. Thông báo và loại phụ của ngoại lệ sẽ có thêm thông tin chi tiết về lỗi. |
migrateDeviceManagementToAndroidManagementApi
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
@NonNull ComponentName notificationServiceComponentName,
@NonNull ComponentName adminComponentName,
@NonNull DpcMigrationRequest migrationRequest
)
Chuyển thiết bị này sang trạng thái được quản lý bằng Android Management API.
Sau khi quá trình di chuyển hoàn tất, ứng dụng gọi sẽ mất các đặc quyền của Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ vì những đặc quyền này được chuyển sang Android Device Policy.
Cảnh báo: Bạn không thể huỷ thao tác này! ListenableFuture được trả về sẽ hoàn tất khi Android Device Policy nhận được yêu cầu và hoàn tất bước kiểm tra sơ bộ đối với mã thông báo di chuyển. Trong trường hợp không thành công, ListenableFuture sẽ gói một Exception.
Chỉ Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ mới có thể gọi phương thức này. Trên Android 10 trở xuống, bạn không được gọi lệnh này trên thiết bị có cả Chủ sở hữu thiết bị và Chủ sở hữu hồ sơ.
Chủ sở hữu hồ sơ (ngoại trừ trên Android 12) cần chuyển mạng Wi-Fi đã định cấu hình vào DpcMigrationRequest trên thiết bị thuộc sở hữu của cá nhân nếu đã định cấu hình mạng Wi-Fi bất kỳ. Bạn không được truyền những dữ liệu này trên thiết bị thuộc sở hữu của công ty. Xin lưu ý rằng các mạng Wi-Fi này sẽ bị xoá ngay trước khi chế độ quản lý thiết bị di chuyển sang Android Device Policy. Trong trường hợp không xoá được một mạng, quá trình di chuyển cũng sẽ không thành công. Vì việc xoá mạng không phải là một hoạt động nguyên tử, nên một số mạng có thể đã bị xoá.
Trên các thiết bị thuộc sở hữu cá nhân có hồ sơ công việc chạy Android 12, tất cả mạng Wi-Fi do DPC gọi định cấu hình sẽ bị xoá ngay trước khi chế độ quản lý thiết bị được di chuyển sang Android Device Policy, bất kể mạng Wi-Fi nào được chuyển vào migrationRequest.
| Tham số | |
|---|---|
@NonNull ComponentName notificationServiceComponentName |
|
@NonNull ComponentName adminComponentName |
|
@NonNull DpcMigrationRequest migrationRequest |
|
| Giá trị trả về | |
|---|---|
@NonNull ListenableFuture<@NonNull DpcMigrationAttempt> |
|
migrateDeviceManagementToAndroidManagementApiAwait
abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
@NonNull ComponentName notificationServiceComponentName,
@NonNull ComponentName adminComponentName,
@NonNull DpcMigrationRequest migrationRequest
)
Chuyển thiết bị này sang trạng thái được quản lý bằng Android Management API.
Sau khi quá trình di chuyển hoàn tất, ứng dụng gọi sẽ mất các đặc quyền của Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ vì những đặc quyền này được chuyển sang Android Device Policy.
Cảnh báo: Bạn không thể huỷ thao tác này! Thao tác tạm ngưng này sẽ quay trở lại khi Android Device Policy nhận được yêu cầu và hoàn tất bước kiểm tra sơ bộ đối với mã thông báo di chuyển. Trong trường hợp không thành công, hệ thống sẽ gửi Exception.
Chỉ Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ mới có thể gọi phương thức này. Trên Android 10 trở xuống, bạn không được gọi lệnh này trên thiết bị có cả Chủ sở hữu thiết bị và Chủ sở hữu hồ sơ.
Chủ sở hữu hồ sơ (ngoại trừ trên Android 12) cần chuyển mạng Wi-Fi đã định cấu hình vào DpcMigrationRequest trên thiết bị thuộc sở hữu của cá nhân nếu đã định cấu hình mạng Wi-Fi bất kỳ. Bạn không được truyền những dữ liệu này trên thiết bị thuộc sở hữu của công ty. Xin lưu ý rằng các mạng Wi-Fi này sẽ bị xoá ngay trước khi chế độ quản lý thiết bị di chuyển sang Android Device Policy. Trong trường hợp không xoá được một mạng, quá trình di chuyển cũng sẽ không thành công. Vì việc xoá mạng không phải là một hoạt động nguyên tử, nên một số mạng có thể đã bị xoá.
Trên các thiết bị thuộc sở hữu cá nhân có hồ sơ công việc chạy Android 12, tất cả mạng Wi-Fi do DPC gọi định cấu hình sẽ bị xoá ngay trước khi chế độ quản lý thiết bị được di chuyển sang Android Device Policy, bất kể mạng Wi-Fi nào được chuyển vào migrationRequest.
| Tham số | |
|---|---|
@NonNull ComponentName notificationServiceComponentName |
|
@NonNull ComponentName adminComponentName |
|
@NonNull DpcMigrationRequest migrationRequest |
|
| Giá trị trả về | |
|---|---|
@NonNull DpcMigrationAttempt |
|
| Gửi | |
|---|---|
java.lang.SecurityException |
Nếu phương thức gọi không phải là Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ. |
java.lang.IllegalArgumentException |
Nếu mã di chuyển trống hoặc nếu |
com.google.android.managementapi.dpcmigration.DpcMigrationException |
Nếu lệnh gọi liên quan đến việc di chuyển dpc không thành công. Thông báo và loại phụ của ngoại lệ sẽ có thêm thông tin chi tiết về lỗi. |