DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

Ứng dụng khách đưa ra các 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(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Lấy một lượt di chuyển.
abstract DpcMigrationAttempt	getMigrationAttemptAwait(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) Lấy một lượt di chuyển.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>	listMigrationAttempts() Trả về danh sách tất cả các lần di chuyển.
abstract @NonNull List<@NonNull DpcMigrationAttempt>	listMigrationAttemptsAwait() Trả về danh sách tất cả các lần di chuyển.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Di chuyển thiết bị này để được quản lý bằng Android Management API.
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) Di chuyển thiết bị này để đượ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
)

Lấy một lượt 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ị hoặc Chủ sở hữu hồ sơ trước đó đã di 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>

Một ListenableFuture bao bọc kết quả. Thông tin này có thể là Một future thành công bao bọc DpcMigrationAttempt, trong trường hợp thành công. Một giá trị rỗng bao bọc thành công trong tương lai, trong trường hợp không tìm thấy DpcMigrationAttempt. Một thất bại trong tương lai bao bọc một SecurityException, trong trường hợp người gọi không phải là Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ, hoặc Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ trước đây đã di chuyển sang Android Management API. Một lệnh gọi không thành công trong tương lai DpcMigrationException Nếu lệnh gọi liên quan đến quá trình di chuyển dpc không thành công. Thông báo và kiểu phụ của ngoại lệ chứa thêm thông tin chi tiết về lỗi.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

Lấy một lượt 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ị hoặc Chủ sở hữu hồ sơ trước đó đã di chuyển sang Android Management API mới có thể gọi phương thức này.

Giá trị trả về
DpcMigrationAttempt	DpcMigrationAttempt được yêu cầu hoặc giá trị rỗng nếu không tìm thấy

Gửi
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ơ, hoặc Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ trước đó đã di chuyển sang Android Management API.
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à kiểu phụ của ngoại lệ chứa 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 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ị hoặc Chủ sở hữu hồ sơ trước đó đã di 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 cũ hơn sẽ tự động bị xoá và không được trả lại.

Giá trị trả về

@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

Một ListenableFuture bao bọc kết quả. Thông tin này có thể là Một tương lai thành công bao bọc danh sách DpcMigrationAttempt, trong trường hợp thành công. Một thất bại trong tương lai bao bọc một SecurityException, trong trường hợp người gọi không phải là Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ, hoặc Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ trước đây đã di chuyển sang Android Management API. Một lệnh gọi không thành công trong tương lai DpcMigrationException Nếu lệnh gọi liên quan đến quá trình di chuyển dpc không thành công. Thông báo và kiểu phụ của ngoại lệ chứa thêm thông tin chi tiết về lỗi.

listMigrationAttemptsAwait

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

Trả về danh sách tất cả các lần 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ị hoặc Chủ sở hữu hồ sơ trước đó đã di 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 cũ hơn sẽ tự động bị xoá và không được trả lại.

Giá trị trả về
@NonNull List<@NonNull DpcMigrationAttempt>	Danh sách DpcMigrationAttempt

Gửi
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ơ, hoặc Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ trước đó đã di chuyển sang Android Management API.
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à kiểu phụ của ngoại lệ chứa 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
)

Di chuyển thiết bị này để đượ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 điện sẽ mất đặ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 sẽ được chuyển sang Android Device Policy.

Cảnh báo: Bạn không thể huỷ thao tác này sau khi thực hiện! 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 các quy trình 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ẽ bao bọc một Exception.

Chỉ có 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 phương thức 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ơ phải truyền các mạng Wi-Fi đã định cấu hình trong DpcMigrationRequest (ngoại trừ trên Android 12) trên thiết bị thuộc sở hữu cá nhân nếu thiết bị đó đã định cấu hình bất kỳ mạng Wi-Fi nào. Bạn không được truyền các thông tin này trên thiết bị do công ty sở hữu. Xin lưu ý rằng những mạng Wi-Fi này sẽ bị xoá ngay trước khi hoạt động quản lý thiết bị được di chuyển sang Chính sách thiết bị Android. Trong trường hợp không xoá được mạng, quá trình di chuyển cũng sẽ không thành công và vì việc xoá mạng không phải là một thao tác 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 hoạt động quản lý thiết bị được di chuyển sang Android Device Policy, bất kể mạng Wi-Fi nào được truyền trong migrationRequest.

Thông số
@NonNull ComponentName notificationServiceComponentName	ComponentName của dịch vụ mở rộng NotificationReceiverService. Đây phải là một thành phần hợp lệ thuộc về ứng dụng gọi điện và được xuất trong tệp kê khai, nếu không, IllegalArgumentException sẽ bị loại bỏ.
@NonNull ComponentName adminComponentName	ComponentName của DeviceAdminReceiver quản trị viên của DPC gọi.
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest chứa mã thông báo di chuyển và các mạng Wi-Fi đã định cấu hình. Bạn chỉ cần cung cấp thông tin sau nếu người gọi là Chủ sở hữu hồ sơ trên thiết bị thuộc sở hữu cá nhân và đã định cấu hình mạng.

Giá trị trả về

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

Một ListenableFuture bao bọc kết quả. Thông tin này có thể là Một future thành công bao bọc DpcMigrationAttempt, trong trường hợp thành công. Một thất bại trong tương lai bao bọc một SecurityException, nếu người gọi không phải là Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ. Một thất bại trong tương lai bao bọc IllegalArgumentException, nếu mã thông báo di chuyển trống hoặc nếu notificationServiceComponentName không đề cập đến một thành phần hợp lệ mở rộng NotificationReceiverService được xuất trong tệp kê khai, hoặc nếu adminComponentName không phải là một quản trị viên đang hoạt động thuộc gói hiện tại. Một future không thành công bao bọc một DpcMigrationException, nếu lệnh gọi liên quan đến quá trình di chuyển dpc không thành công. Thông báo và kiểu phụ của ngoại lệ chứa thêm thông tin chi tiết về lỗi.

migrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

Di chuyển thiết bị này để đượ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 điện sẽ mất đặ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 sẽ được chuyển sang Android Device Policy.

Cảnh báo: Bạn không thể huỷ thao tác này sau khi thực hiện! Hàm tạm ngưng này sẽ trả về khi Android Device Policy nhận được yêu cầu và hoàn tất các quy trình 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 một Exception.

Chỉ có 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 phương thức 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ơ phải truyền các mạng Wi-Fi đã định cấu hình trong DpcMigrationRequest (ngoại trừ trên Android 12) trên thiết bị thuộc sở hữu cá nhân nếu thiết bị đó đã định cấu hình bất kỳ mạng Wi-Fi nào. Bạn không được truyền các thông tin này trên thiết bị do công ty sở hữu. Xin lưu ý rằng những mạng Wi-Fi này sẽ bị xoá ngay trước khi hoạt động quản lý thiết bị được di chuyển sang Chính sách thiết bị Android. Trong trường hợp không xoá được mạng, quá trình di chuyển cũng sẽ không thành công và vì việc xoá mạng không phải là một thao tác 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 hoạt động quản lý thiết bị được di chuyển sang Android Device Policy, bất kể mạng Wi-Fi nào được truyền trong migrationRequest.

Thông số
@NonNull ComponentName notificationServiceComponentName	ComponentName của dịch vụ mở rộng NotificationReceiverService. Đây phải là một thành phần hợp lệ thuộc về ứng dụng gọi điện và được xuất trong tệp kê khai, nếu không, IllegalArgumentException sẽ bị loại bỏ.
@NonNull ComponentName adminComponentName	ComponentName của DeviceAdminReceiver quản trị viên của DPC gọi.
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest chứa mã thông báo di chuyển và các mạng Wi-Fi đã định cấu hình. Bạn chỉ cần cung cấp thông tin sau nếu người gọi là Chủ sở hữu hồ sơ trên thiết bị thuộc sở hữu cá nhân và đã định cấu hình mạng.

Giá trị trả về
@NonNull DpcMigrationAttempt	DpcMigrationException với trạng thái hiện tại của quá trình di chuyển trong trường hợp thành công.

Gửi
SecurityException	Nếu người gọi không phải là Chủ sở hữu thiết bị hoặc Chủ sở hữu hồ sơ.
IllegalArgumentException	Nếu mã thông báo di chuyển trống hoặc nếu notificationServiceComponentName không đề cập đến một thành phần hợp lệ mở rộng NotificationReceiverService được xuất trong tệp kê khai, hoặc nếu adminComponentName không phải là một quản trị viên đang hoạt động thuộc gói hiện tại.
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à kiểu phụ của ngoại lệ chứa thêm thông tin chi tiết về lỗi.