Tương tác với Trung tâm an toàn

Chuyển hướng đến Trung tâm an toàn

Mọi ứng dụng đều có thể mở Trung tâm an toàn bằng android.content.Intent.ACTION_SAFETY_CENTER hành động (giá trị chuỗi android.intent.action.SAFETY_CENTER).

Để mở Trung tâm an toàn, hãy gọi điện trong thực thể Activity:

Intent openSafetyCenterIntent = new Intent(Intent.ACTION_SAFETY_CENTER);

startActivity(openSafetyCenterIntent);

Chuyển hướng đến một vấn đề cụ thể

Bạn cũng có thể chuyển hướng đến một thẻ cảnh báo cụ thể của Trung tâm an toàn bằng cách sử dụng mã bổ sung ý định cụ thể. Các ứng dụng khác không dành cho bên thứ ba, chúng thuộc SafetyCenterManager, thuộc @SystemApi. Chỉ ứng dụng hệ thống có thể truy cập vào các ứng dụng bổ sung này.

Phần bổ sung ý định chuyển hướng một thẻ cảnh báo cụ thể:

  • EXTRA_SAFETY_SOURCE_ID
    • Giá trị chuỗi: android.safetycenter.extra.SAFETY_SOURCE_ID
    • Loại chuỗi: Chỉ định mã nhận dạng nguồn an toàn của nguồn liên kết thẻ cảnh báo
    • Bắt buộc để chuyển hướng đến vấn đề để hoạt động
  • EXTRA_SAFETY_SOURCE_ISSUE_ID
    • Giá trị chuỗi: android.safetycenter.extra.SAFETY_SOURCE_ISSUE_ID
    • Loại chuỗi: Chỉ định mã thẻ cảnh báo
    • Bắt buộc để chuyển hướng đến vấn đề để hoạt động
  • EXTRA_SAFETY_SOURCE_USER_HANDLE
    • Giá trị chuỗi: android.safetycenter.extra.SAFETY_SOURCE_USER_HANDLE
    • Loại UserHandle: Chỉ định UserHandle cho cảnh báo liên quan thẻ bài
    • Không bắt buộc (mặc định là người dùng hiện tại)

Bạn có thể dùng đoạn mã dưới đây từ trong một thực thể Activity để mở màn hình Trung tâm an toàn đến một vấn đề cụ thể:

UserHandle theUserHandleThisIssueCameFrom = …;

Intent openSafetyCenterIntent = new Intent(Intent.ACTION_SAFETY_CENTER)
.putExtra(SafetyCenterManager.EXTRA_SAFETY_SOURCE_ID, "TheSafetySourceIdThisIssueCameFrom")
.putExtra(SafetyCenterManager.EXTRA_SAFETY_SOURCE_ISSUE_ID, "TheSafetySourceIssueIdToRedirectTo")
.putExtra(SafetyCenterManager.EXTRA_SAFETY_SOURCE_USER_HANDLE, theUserHandleThisIssueCameFrom);

startActivity(openSafetyCenterIntent);

Chuyển hướng đến một trang con cụ thể (Kể từ Android 14)

Trên Android 14 trở lên, trang Trung tâm an toàn sẽ được chia tách thành nhiều trang con đại diện cho SafetySourcesGroup khác nhau (trong Android 13, mục này hiển thị dưới dạng các mục nhập có thể thu gọn).

Bạn có thể chuyển hướng đến một trang con cụ thể bằng cách sử dụng ý định bổ sung sau:

  • EXTRA_SAFETY_SOURCES_GROUP_ID
    • Giá trị chuỗi: android.safetycenter.extra.SAFETY_SOURCES_GROUP_ID
    • Loại chuỗi: Chỉ định mã nhận dạng của SafetySourcesGroup
    • Bắt buộc để chuyển hướng đến trang con để hoạt động

Bạn có thể dùng đoạn mã dưới đây từ trong một thực thể Activity để mở từ màn hình Trung tâm an toàn đến một trang con cụ thể:

Intent openSafetyCenterIntent = new Intent(Intent.ACTION_SAFETY_CENTER)
.putExtra(SafetyCenterManager.EXTRA_SAFETY_SOURCES_GROUP_ID, "TheSafetySourcesGroupId");

startActivity(openSafetyCenterIntent);

Sử dụng API nguồn của Trung tâm an toàn

Các API nguồn của Trung tâm an toàn được cung cấp bằng SafetyCenterManager (là @SystemApi). Mã cho nền tảng API có tại Mã Tìm kiếm. Mã triển khai của các API này có trong Mã Tìm kiếm.

Quyền

Chỉ những ứng dụng hệ thống được cho phép mới có thể truy cập vào các API nguồn của Trung tâm an toàn bằng cách sử dụng các quyền được liệt kê dưới đây. Để biết thêm thông tin, hãy xem phần Đặc quyền Liệt kê quyền cho phép.

  • READ_SAFETY_CENTER_STATUS
    • signature|privileged
    • Dùng cho API SafetyCenterManager#isSafetyCenterEnabled() (không phải cần cho các nguồn Trung tâm an toàn, họ chỉ cần Quyền SEND_SAFETY_CENTER_UPDATE)
    • Dùng trong những ứng dụng hệ thống kiểm tra xem Trung tâm an toàn có được bật hay không
    • Chỉ được cấp cho các ứng dụng hệ thống trong danh sách cho phép
  • SEND_SAFETY_CENTER_UPDATE
    • internal|privileged
    • Dùng cho API đã bật và API Nguồn an toàn
    • Chỉ những nguồn an toàn mới được dùng
    • Chỉ được cấp cho các ứng dụng hệ thống trong danh sách cho phép

Những quyền này là đặc quyền và bạn chỉ có thể nhận được bằng cách thêm chúng vào tệp có liên quan, ví dụ: com.android.settings.xml cho ứng dụng Cài đặt và cho tệp AndroidManifest.xml của ứng dụng. Xem protectionLevel để biết thêm thông tin về mô hình quản lý quyền.

Tải SafetyCenterManager

SafetyCenterManager là một lớp @SystemApi có thể truy cập được từ ứng dụng hệ thống kể từ Android 13. Lệnh gọi này minh hoạ cách nhận SafetyCenterManager:

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
  // Must be on T or above to interact with Safety Center.
  return;
}
SafetyCenterManager safetyCenterManager = context.getSystemService(SafetyCenterManager.class);
if (safetyCenterManager == null) {
  // Should not be null on T.
  return;
}

Kiểm tra xem Trung tâm an toàn đã được bật chưa

Cuộc gọi này kiểm tra xem Trung tâm an toàn đã được bật hay chưa. Cuộc gọi yêu cầu Quyền READ_SAFETY_CENTER_STATUS hoặc SEND_SAFETY_CENTER_UPDATE:

boolean isSafetyCenterEnabled = safetyCenterManager.isSafetyCenterEnabled();
if (isSafetyCenterEnabled) {
  // …
} else {
  // …
}

Cung cấp dữ liệu

Dữ liệu nguồn của Trung tâm an toàn có String sourceId cụ thể sẽ được cung cấp cho trang An toàn Căn giữa bằng đối tượng SafetySourceData, đại diện cho một mục nhập trên giao diện người dùng và một đối tượng danh sách vấn đề (thẻ cảnh báo). Mục nhập giao diện người dùng và các thẻ cảnh báo có thể có các mức độ nghiêm trọng khác nhau được chỉ định trong lớp SafetySourceData:

  • SEVERITY_LEVEL_UNSPECIFIED
    • Chưa chỉ định mức độ nghiêm trọng nào
    • Màu: Xám hoặc trong suốt (tuỳ thuộc vào SafetySourcesGroup của mục nhập)
    • Dùng cho dữ liệu động đặt dưới dạng mục nhập tĩnh trong giao diện người dùng hoặc để hiển thị mục nhập không xác định
    • Không được dùng cho thẻ cảnh báo
  • SEVERITY_LEVEL_INFORMATION
    • Thông tin cơ bản hoặc đề xuất nhỏ
    • Màu: Xanh lục
  • SEVERITY_LEVEL_RECOMMENDATION
    • Đề xuất rằng người dùng nên thực hiện hành động đối với vấn đề này, vì nó có thể khiến họ gặp rủi ro
    • Màu: Vàng
  • SEVERITY_LEVEL_CRITICAL_WARNING
    • Cảnh báo nghiêm trọng rằng người dùng phải xử lý vấn đề này tiềm ẩn rủi ro
    • Màu: Đỏ

SafetySourceData

Đối tượng SafetySourceData bao gồm một mục nhập trên giao diện người dùng, thẻ cảnh báo và bất biến.

  • Phiên bản SafetySourceStatus không bắt buộc (mục nhập giao diện người dùng)
  • Danh sách SafetySourceIssue thực thể (thẻ cảnh báo)
  • Gói bổ sung Bundle không bắt buộc (Kể từ phiên bản 14)
  • Bất biến:
    • Danh sách SafetySourceIssue phải bao gồm các vấn đề duy nhất giá trị nhận dạng.
    • Thực thể SafetySourceIssue không được có tầm quan trọng lớn hơn SafetySourceStatus nếu có (trừ trường hợp SafetySourceStatusSEVERITY_LEVEL_UNSPECIFIED, trong trường hợp đó là SEVERITY_LEVEL_INFORMATION lỗi được cho phép).
    • Ứng dụng phải đáp ứng các yêu cầu bổ sung do cấu hình API đặt ra, Ví dụ: nếu nguồn chỉ là vấn đề, thì nguồn đó không được cung cấp Thực thể SafetySourceStatus.

SafetySourceStatus

  • Tiêu đề CharSequence bắt buộc
  • Thông tin tóm tắt bắt buộc về CharSequence
  • Mức độ nghiêm trọng bắt buộc
  • Không bắt buộc PendingIntent thực thể để chuyển hướng người dùng đến đúng trang (mặc định sử dụng intentAction từ cấu hình, nếu có)
  • IconAction không bắt buộc (hiển thị dưới dạng biểu tượng bên trên mục nhập) bao gồm:
    • Loại biểu tượng bắt buộc, phải là một trong các loại sau:
      • ICON_TYPE_GEAR: Hiển thị dưới dạng bánh răng bên cạnh mục nhập giao diện người dùng
      • ICON_TYPE_INFO: Được hiển thị dưới dạng biểu tượng thông tin bên cạnh mục nhập giao diện người dùng
    • Bắt buộc PendingIntent để chuyển hướng người dùng đến một trang khác
  • Giá trị boolean enabled không bắt buộc cho phép đánh dấu mục nhập trên giao diện người dùng là bị tắt nên không nhấp vào được (mặc định là true)
  • Bất biến:
    • Các thực thể PendingIntent phải mở một thực thể Activity.
    • Nếu mục nhập bị vô hiệu hoá, bạn phải chỉ định mục nhập đó SEVERITY_LEVEL_UNSPECIFIED.
    • Các yêu cầu bổ sung do cấu hình API đặt ra.

SafetySourceIssue

  • Giá trị nhận dạng String duy nhất bắt buộc
  • Tiêu đề CharSequence bắt buộc
  • Phụ đề CharSequence không bắt buộc
  • Thông tin tóm tắt bắt buộc về CharSequence
  • Mức độ nghiêm trọng bắt buộc
  • Danh mục vấn đề không bắt buộc, phải là một trong:
    • ISSUE_CATEGORY_DEVICE: Vấn đề ảnh hưởng đến thiết bị của người dùng.
    • ISSUE_CATEGORY_ACCOUNT: Vấn đề này ảnh hưởng đến các tài khoản của người dùng.
    • ISSUE_CATEGORY_GENERAL: Sự cố này ảnh hưởng đến sự an toàn chung của người dùng. Đây là tuỳ chọn mặc định.
    • ISSUE_CATEGORY_DATA (Kể từ Android 14): Vấn đề này ảnh hưởng đến dữ liệu của người dùng.
    • ISSUE_CATEGORY_PASSWORDS (Đang khởi động thiết bị Android 14): Vấn đề này ảnh hưởng đến mật khẩu.
    • ISSUE_CATEGORY_PERSONAL_SAFETY (Đang khởi động thiết bị Android 14): Vấn đề ảnh hưởng đến thông tin cá nhân của người dùng sự an toàn.
  • Danh sách các phần tử Action mà người dùng có thể thực hiện để khắc phục vấn đề này, mỗi phần tử Thực thể Action bao gồm:
    • Giá trị nhận dạng String duy nhất bắt buộc
    • Nhãn CharSequence bắt buộc
    • Bắt buộc PendingIntent để chuyển hướng người dùng đến một trang khác hoặc xử lý hành động trực tiếp từ màn hình Trung tâm an toàn
    • Giá trị boolean không bắt buộc để chỉ định xem vấn đề này có thể được giải quyết trực tiếp qua hay không màn hình Trung tâm an toàn (mặc định là false)
    • Thông báo thành công (không bắt buộc) của CharSequence sẽ hiển thị cho người dùng khi vấn đề được giải quyết thành công ngay trong Trung tâm an toàn màn hình
  • Không bắt buộc PendingIntent được gọi khi người dùng đóng vấn đề (mặc định là không có gì là gọi)
  • Giá trị nhận dạng loại vấn đề String bắt buộc; điều này tương tự như vấn đề nhưng không nhất thiết phải là giá trị duy nhất và được dùng để ghi nhật ký
  • String không bắt buộc cho mã loại bỏ trùng lặp, điều này cho phép đăng cùng một mã SafetySourceIssue từ nhiều nguồn và chỉ hiển thị quảng cáo này một lần trong Giao diện người dùng giả định chúng có cùng một deduplicationGroup (Bắt đầu từ Android 14). Nếu không được chỉ định, vấn đề này sẽ không bao giờ đã loại bỏ trùng lặp
  • CharSequence không bắt buộc cho tiêu đề ghi công, đây là văn bản hiển thị nơi thẻ cảnh báo bắt nguồn (Kể từ Android 14). Nếu không được chỉ định, thì hãy sử dụng tiêu đề của SafetySourcesGroup
  • Khả năng xử lý sự cố không bắt buộc (Kể từ Android 14), giá trị này phải là một trong:
    • ISSUE_ACTIONABILITY_MANUAL: Người dùng cần giải quyết vấn đề này theo cách thủ công. Đây là tuỳ chọn mặc định.
    • ISSUE_ACTIONABILITY_TIP: Vấn đề này chỉ là lưu ý và có thể không cần thiết bất kỳ hoạt động đầu vào nào của người dùng.
    • ISSUE_ACTIONABILITY_AUTOMATIC: Vấn đề này đã được xử lý và không thể yêu cầu bất kỳ hoạt động đầu vào nào của người dùng.
  • Hành vi thông báo không bắt buộc (Khởi động Android 14), phải là một trong các trường hợp sau:
    • NOTIFICATION_BEHAVIOR_UNSPECIFIED: Trung tâm an toàn sẽ quyết định liệu một thì cần có thông báo cho thẻ cảnh báo. Đây là tuỳ chọn mặc định.
    • NOTIFICATION_BEHAVIOR_NEVER: Chưa đăng thông báo nào.
    • NOTIFICATION_BEHAVIOR_DELAYED: Một thông báo sẽ được đăng vào khoảng thời gian nào đó sau khi vấn đề được báo cáo lần đầu tiên.
    • NOTIFICATION_BEHAVIOR_IMMEDIATELY: Một thông báo sẽ được đăng ngay khi báo cáo sự cố.
  • Notification (không bắt buộc) để hiển thị thông báo tuỳ chỉnh cùng với thẻ cảnh báo (Kể từ Android 14). Nếu không được chỉ định, Notification được lấy từ thẻ cảnh báo. Bao gồm:
    • Tiêu đề CharSequence bắt buộc
    • Thông tin tóm tắt bắt buộc về CharSequence
    • Danh sách phần tử Action mà người dùng có thể thực hiện cho thông báo này
  • Bất biến:
    • Danh sách các thực thể Action phải bao gồm các hành động có duy nhất một giá trị nhận dạng
    • Danh sách thực thể Action phải chứa một hoặc hai Action phần tử. Nếu khả năng xử lý không phải là ISSUE_ACTIONABILITY_MANUAL, không được phép có Action.
    • PendingIntent OnDismiss không được mở một thực thể Activity
    • Các yêu cầu bổ sung do cấu hình API đặt ra

Dữ liệu được cung cấp cho Trung tâm an toàn dựa trên một số sự kiện nhất định, vì vậy cần phải chỉ định điều gì khiến nguồn cung cấp SafetySourceData với Thực thể SafetyEvent.

SafetyEvent

  • Loại bắt buộc, phải là một trong:
    • SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED: Trạng thái của nguồn đã đã thay đổi.
    • SAFETY_EVENT_TYPE_REFRESH_REQUESTED: Phản hồi quá trình làm mới/quét lại tín hiệu từ Trung tâm an toàn; hãy sử dụng cái này thay vì SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED để Trung tâm an toàn có thể theo dõi yêu cầu làm mới/quét lại.
    • SAFETY_EVENT_TYPE_RESOLVING_ACTION_SUCCEEDED: Chúng tôi đã giải quyết SafetySourceIssue.Action trực tiếp từ màn hình Trung tâm an toàn; sử dụng tuỳ chọn này thay vì SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED cho mục An toàn Center để có thể theo dõi SafetySourceIssue.Action đang được giải quyết.
    • SAFETY_EVENT_TYPE_RESOLVING_ACTION_FAILED: Chúng tôi đã cố gắng giải quyết SafetySourceIssue.Action ngay từ màn hình Trung tâm an toàn, nhưng không thực hiện được; hãy sử dụng cái này thay vì SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED để Trung tâm an toàn có thể bản nhạc SafetySourceIssue.Action không thành công.
    • SAFETY_EVENT_TYPE_DEVICE_LOCALE_CHANGED: Ngôn ngữ của thiết bị đã thay đổi, vì vậy chúng tôi đang cập nhật văn bản của dữ liệu được cung cấp; đó là được phép sử dụng SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED cho mục đích này.
    • SAFETY_EVENT_TYPE_DEVICE_REBOOTED: Chúng tôi cung cấp dữ liệu này dưới dạng một phần lần khởi động ban đầu vì dữ liệu Trung tâm an toàn không được duy trì trên khởi động lại; được phép sử dụng SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED cho việc này.
  • Giá trị nhận dạng String (không bắt buộc) cho mã thông báo truyền tin làm mới.
  • Giá trị nhận dạng String không bắt buộc cho thực thể SafetySourceIssue đang nhận đã giải quyết.
  • Giá trị nhận dạng String không bắt buộc cho thực thể SafetySourceIssue.Action đang được giải quyết.
  • Bất biến:
    • Bạn phải cung cấp mã nhận dạng truyền tin làm mới nếu loại là SAFETY_EVENT_TYPE_REFRESH_REQUESTED
    • Bạn phải cung cấp mã vấn đề và mã thao tác nếu thuộc một trong hai loại sau SAFETY_EVENT_TYPE_RESOLVING_ACTION_SUCCEEDED hoặc SAFETY_EVENT_TYPE_RESOLVING_ACTION_FAILED

Dưới đây là ví dụ về cách một nguồn có thể cung cấp dữ liệu cho Trung tâm an toàn (trong trong trường hợp nó cung cấp mục nhập một thẻ cảnh báo):

PendingIntent redirectToMyScreen =
    PendingIntent.getActivity(
        context, requestCode, redirectToMyScreenIntent, PendingIntent.FLAG_IMMUTABLE);
SafetySourceData safetySourceData =
    new SafetySourceData.Builder()
        .setStatus(
            new SafetySourceStatus.Builder(
                    "title", "summary", SafetySourceData.SEVERITY_LEVEL_RECOMMENDATION)
                .setPendingIntent(redirectToMyScreen)
                .build())
        .addIssue(
            new SafetySourceIssue.Builder(
                    "MyIssueId",
                    "title",
                    "summary",
                    SafetySourceData.SEVERITY_LEVEL_RECOMMENDATION,
                    "MyIssueTypeId")
                .setSubtitle("subtitle")
                .setIssueCategory(SafetySourceIssue.ISSUE_CATEGORY_DEVICE)
                .addAction(
                    new SafetySourceIssue.Action.Builder(
                            "MyIssueActionId", "label", redirectToMyScreen)
                        .build())
                .build())
        .build();
SafetyEvent safetyEvent = new SafetyEvent.Builder(SafetyEvent.SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED).build();
safetyCenterManager.setSafetySourceData("MySourceId", safetySourceData, safetyEvent);

Nhận dữ liệu đã cung cấp gần đây nhất

Bạn có thể tải dữ liệu gần đây nhất được cung cấp tới Trung tâm an toàn cho nguồn do bạn sở hữu . Bạn có thể sử dụng tính năng này để hiển thị nội dung nào đó trong giao diện người dùng của riêng mình, để kiểm tra xem dữ liệu cần được cập nhật trước khi thực hiện một thao tác tốn kém hoặc để cung cấp cùng một phiên bản SafetySourceData với Trung tâm an toàn với một số thay đổi hoặc với một thực thể SafetyEvent mới. Việc này cũng hữu ích khi kiểm thử.

Sử dụng mã này để tải dữ liệu được cung cấp gần đây nhất cho Trung tâm an toàn:

SafetySourceData lastDataProvided = safetyCenterManager.getSafetySourceData("MySourceId");

Báo cáo lỗi

Nếu không thu thập được dữ liệu về SafetySourceData, bạn có thể báo cáo lỗi cho nhóm An toàn Center, nơi chuyển mục nhập sang màu xám, xoá dữ liệu được lưu trong bộ nhớ đệm và cung cấp thông báo nội dung như Không thể kiểm tra chế độ cài đặt. Bạn cũng có thể báo cáo lỗi nếu không phân giải được thực thể của SafetySourceIssue.Action. Trong trường hợp đó, dữ liệu đã lưu vào bộ nhớ đệm không bị xoá và mục nhập giao diện người dùng không thay đổi; nhưng một tin nhắn lại hiển thị cho người dùng để cho họ biết rằng đã xảy ra sự cố.

Bạn có thể báo cáo lỗi này bằng cách sử dụng SafetySourceErrorDetails bao gồm trong số:

  • SafetySourceErrorDetails: Bản sao bắt buộc SafetyEvent:
// An error has occurred in the background, need to clear the Safety Center data to avoid showing data that may not be valid anymore
SafetyEvent safetyEvent = new SafetyEvent.Builder(SafetyEvent.SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED).build();
SafetySourceErrorDetails safetySourceErrorDetails = new SafetySourceErrorDetails(safetyEvent);
safetyCenterManager.reportSafetySourceError("MySourceId", safetySourceErrorDetails);

Phản hồi yêu cầu làm mới hoặc quét lại

Bạn có thể nhận tín hiệu từ Trung tâm an toàn để cung cấp dữ liệu mới. Phản hồi một yêu cầu làm mới hoặc quét lại đảm bảo rằng người dùng xem trạng thái hiện tại khi mở Trung tâm an toàn và khi họ nhấn vào nút quét.

Bạn có thể thực hiện việc này bằng cách nhận thông báo truyền tin với thao tác sau:

  • ACTION_REFRESH_SAFETY_SOURCES
    • Giá trị chuỗi: android.safetycenter.action.REFRESH_SAFETY_SOURCES
    • Được kích hoạt khi Trung tâm an toàn gửi yêu cầu làm mới dữ liệu của nguồn an toàn của một ứng dụng nhất định
    • Ý định được bảo vệ mà chỉ hệ thống mới có thể gửi
    • Gửi đến tất cả các nguồn an toàn trong tệp cấu hình dưới dạng tệp ý định và yêu cầu quyền SEND_SAFETY_CENTER_UPDATE

Các thông tin bổ sung sau đây được cung cấp trong chương trình phát sóng này:

  • EXTRA_REFRESH_SAFETY_SOURCE_IDS
    • Giá trị chuỗi: android.safetycenter.extra.REFRESH_SAFETY_SOURCE_IDS
    • Loại mảng chuỗi (String[]), đại diện cho mã nguồn cần làm mới ứng dụng đã cho
  • EXTRA_REFRESH_SAFETY_SOURCES_REQUEST_TYPE

    • Giá trị chuỗi: android.safetycenter.extra.REFRESH_SAFETY_SOURCES_REQUEST_TYPE
    • Loại số nguyên, đại diện cho loại yêu cầu @IntDef
    • Phải là một trong:
      • EXTRA_REFRESH_REQUEST_TYPE_GET_DATA: Yêu cầu nguồn tới cung cấp dữ liệu tương đối nhanh, thường là khi người dùng mở trang
      • EXTRA_REFRESH_REQUEST_TYPE_FETCH_FRESH_DATA: Yêu cầu nguồn để cung cấp dữ liệu mới nhất có thể, thường là khi người dùng nhấn nút quét lại
  • EXTRA_REFRESH_SAFETY_SOURCES_BROADCAST_ID

    • Giá trị chuỗi: android.safetycenter.extra.REFRESH_SAFETY_SOURCES_BROADCAST_ID
    • Loại chuỗi đại diện cho giá trị nhận dạng duy nhất của yêu cầu làm mới

Để nhận tín hiệu từ Trung tâm an toàn, hãy triển khai một BroadcastReceiver thực thể. Thông báo truyền tin được gửi bằng BroadcastOptions đặc biệt cho phép receiver để bắt đầu dịch vụ trên nền trước.

BroadcastReceiver phản hồi yêu cầu làm mới:

public final class SafetySourceReceiver extends BroadcastReceiver {
  // All the safety sources owned by this application.
  private static final String[] ALL_SAFETY_SOURCES = new String[] {"MySourceId1", "…"};
  @Override
  public void onReceive(Context context, Intent intent) {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
      // Must be on T or above to interact with Safety Center.
      return;
    }
    String action = intent.getAction();
    if (!SafetyCenterManager.ACTION_REFRESH_SAFETY_SOURCES.equals(action)) {
      return;
    }
    String refreshBroadcastId =
        intent.getStringExtra(SafetyCenterManager.EXTRA_REFRESH_SAFETY_SOURCES_BROADCAST_ID);
    if (refreshBroadcastId == null) {
      // Should always be provided.
      return;
    }
    String[] sourceIds =
        intent.getStringArrayExtra(SafetyCenterManager.EXTRA_REFRESH_SAFETY_SOURCE_IDS);
    if (sourceIds == null) {
      sourceIds = ALL_SAFETY_SOURCES;
    }
    int requestType =
        intent.getIntExtra(
            SafetyCenterManager.EXTRA_REFRESH_SAFETY_SOURCES_REQUEST_TYPE,
            SafetyCenterManager.EXTRA_REFRESH_REQUEST_TYPE_GET_DATA);
    SafetyCenterManager safetyCenterManager = context.getSystemService(SafetyCenterManager.class);
    if (safetyCenterManager == null) {
      // Should not be null on T.
      return;
    }
    if (!safetyCenterManager.isSafetyCenterEnabled()) {
      // Preferably, no Safety Source code should be run if Safety Center is disabled.
      return;
    }
    SafetyEvent refreshSafetyEvent =
        new SafetyEvent.Builder(SafetyEvent.SAFETY_EVENT_TYPE_REFRESH_REQUESTED)
            .setRefreshBroadcastId(refreshBroadcastId)
            .build();
    for (String sourceId : sourceIds) {
      SafetySourceData safetySourceData = getSafetySourceDataFor(sourceId, requestType);
      // Set the data (or report an error with reportSafetySourceError, if something went wrong).
      safetyCenterManager.setSafetySourceData(sourceId, safetySourceData, refreshSafetyEvent);
    }
  }
  private SafetySourceData getSafetySourceDataFor(String sourceId, int requestType) {
    switch (requestType) {
      case SafetyCenterManager.EXTRA_REFRESH_REQUEST_TYPE_GET_DATA:
        return getRefreshSafetySourceDataFor(sourceId);
      case SafetyCenterManager.EXTRA_REFRESH_REQUEST_TYPE_FETCH_FRESH_DATA:
        return getRescanSafetySourceDataFor(sourceId);
      default:
    }
    return getRefreshSafetySourceDataFor(sourceId);
  }
  // Data to provide when the user opens the page or on specific events.
  private SafetySourceData getRefreshSafetySourceDataFor(String sourceId) {
    // Get data for the source, if it's a fast operation it could potentially be executed in the
    // receiver directly.
    // Otherwise, it must start some kind of foreground service or expedited job.
    return null;
  }
  // Data to provide when the user pressed the rescan button.
  private SafetySourceData getRescanSafetySourceDataFor(String sourceId) {
    // Could be implemented the same way as getRefreshSafetySourceDataFor, depending on the source's
    // need.
    // Otherwise, could potentially perform a longer task.
    // In which case, it must start some kind of foreground service or expedited job.
    return null;
  }
}

Thực thể tương tự của BroadcastReceiver trong ví dụ ở trên được khai báo trong AndroidManifest.xml:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="…">
    <application>
    <!-- … -->
        <receiver android:name=".SafetySourceReceiver"
            android:exported="false">
            <intent-filter>
                <action android:name="android.safetycenter.action.REFRESH_SAFETY_SOURCES"/>
            </intent-filter>
        </receiver>
    <!-- … -->
    </application>
</manifest>

Tốt nhất là nguồn Trung tâm an toàn được triển khai theo cách mà nguồn này gọi SafetyCenterManager khi dữ liệu thay đổi. Vì lý do tình trạng hệ thống, chúng tôi người dùng chỉ nên phản hồi với tín hiệu quét lại (khi người dùng nhấn vào tính năng quét) chứ không phải khi người dùng mở Trung tâm an toàn. Nếu chức năng này là bắt buộc, trường refreshOnPageOpenAllowed="true" trong tệp cấu hình phải được đặt cho nguồn để nhận nội dung truyền tin được phân phối trong những trường hợp này.

Phản hồi Trung tâm an toàn khi bật hoặc tắt

Bạn có thể phản hồi khi Trung tâm an toàn được bật hoặc tắt bằng cách sử dụng tính năng này thao tác theo ý định:

  • ACTION_SAFETY_CENTER_ENABLED_CHANGED
    • Giá trị chuỗi: android.safetycenter.action.SAFETY_CENTER_ENABLED_CHANGED
    • Được kích hoạt khi Trung tâm an toàn được bật hoặc tắt trong khi thiết bị đang chạy
    • Không được gọi khi khởi động (sử dụng ACTION_BOOT_COMPLETED cho mục đó)
    • Ý định được bảo vệ mà chỉ hệ thống mới có thể gửi
    • Gửi đến tất cả các nguồn an toàn trong tệp cấu hình dưới dạng tệp ý định, cần có quyền SEND_SAFETY_CENTER_UPDATE
    • Được gửi dưới dạng ý định ngầm ẩn yêu cầu READ_SAFETY_CENTER_STATUS quyền

Thao tác theo ý định này rất hữu ích khi bật hoặc tắt các tính năng liên quan đến Trung tâm an toàn trên thiết bị.

Triển khai thao tác giải quyết

Hành động giải quyết là một thực thể SafetySourceIssue.Action mà người dùng có thể giải quyết ngay trên màn hình Trung tâm an toàn. Người dùng nhấn vào một nút hành động và thực thể PendingIntent trên SafetySourceIssue.Action do nguồn an toàn được kích hoạt, việc này sẽ giải quyết vấn đề ở chế độ nền và thông báo cho Trung tâm an toàn khi quá trình này hoàn tất.

Để triển khai hành động giải quyết, nguồn Trung tâm an toàn có thể sử dụng một dịch vụ nếu thao tác dự kiến sẽ mất một khoảng thời gian (PendingIntent.getService) hoặc broadcast receiver (PendingIntent.getBroadcast).

Sử dụng mã này để gửi sự cố đang được giải quyết tới Trung tâm an toàn:

Intent resolveIssueBroadcastIntent =
    new Intent("my.package.name.MY_RESOLVING_ACTION").setClass(ResolveActionReceiver.class);
PendingIntent resolveIssue =
    PendingIntent.getBroadcast(
        context, requestCode, resolveIssueBroadcastIntent, PendingIntent.FLAG_IMMUTABLE);
SafetySourceData safetySourceData =
    new SafetySourceData.Builder()
        .setStatus(
            new SafetySourceStatus.Builder(
                    "title", "summary", SafetySourceData.SEVERITY_LEVEL_RECOMMENDATION)
                .setPendingIntent(redirectToMyScreen)
                .build())
        .addIssue(
            new SafetySourceIssue.Builder(
                    "MyIssueId",
                    "title",
                    "summary",
                    SafetySourceData.SEVERITY_LEVEL_RECOMMENDATION,
                    "MyIssueTypeId")
                .setIssueCategory(SafetySourceIssue.ISSUE_CATEGORY_DEVICE)
                .addAction(
                    new SafetySourceIssue.Action.Builder(
                            "MyIssueActionId", "label", resolveIssue)
                        .setWillResolve(true)
                        .build())
                .build())
        .build();
SafetyEvent safetyEvent = new SafetyEvent.Builder(SafetyEvent.SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED).build();
safetyCenterManager.setSafetySourceData("MySourceId", safetySourceData, safetyEvent);

BroadcastReceiver sẽ giải quyết hành động:

public final class ResolveActionReceiver extends BroadcastReceiver {
  private static final String MY_RESOLVING_ACTION = "my.package.name.MY_RESOLVING_ACTION";
  @Override
  public void onReceive(Context context, Intent intent) {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
      // Must be on T or above to interact with Safety Center.
      return;
    }
    String action = intent.getAction();
    if (!MY_RESOLVING_ACTION.equals(action)) {
      return;
    }
    SafetyCenterManager safetyCenterManager = context.getSystemService(SafetyCenterManager.class);
    if (safetyCenterManager == null) {
      // Should not be null on T.
      return;
    }
    if (!safetyCenterManager.isSafetyCenterEnabled()) {
      // Preferably, no Safety Source code should be run if Safety Center is disabled.
      return;
    }
    resolveTheIssue();
    SafetyEvent resolveActionSafetyEvent =
        new SafetyEvent.Builder(SafetyEvent.SAFETY_EVENT_TYPE_RESOLVING_ACTION_SUCCEEDED)
            .setSafetySourceIssueId("MyIssueId")
            .setSafetySourceIssueActionId("MyIssueActionId")
            .build();
    SafetySourceData dataWithoutTheIssue = …;
    // Set the data (or report an error with reportSafetySourceError and
    // SAFETY_EVENT_TYPE_RESOLVING_ACTION_FAILED, if something went wrong).
    safetyCenterManager.setSafetySourceData("MySourceId", dataWithoutTheIssue, resolveActionSafetyEvent);
  }

  private void resolveTheIssue() {
    // Resolves the issue for the user. Given this a BroadcastReceiver, this should be a fast action.
    // Otherwise, a foreground service and PendingIntent.getService should be used instead (or a job
    // could be scheduled here, too).
  }
}

Thực thể tương tự của BroadcastReceiver trong ví dụ ở trên được khai báo trong AndroidManifest.xml:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="…">
    <application>
    <!-- … -->
        <receiver android:name=".ResolveActionReceiver"
            android:exported="false">
            <intent-filter>
                <action android:name="my.package.name.MY_RESOLVING_ACTION"/>
            </intent-filter>
        </receiver>
    <!-- … -->
    </application>
</manifest>

Phản hồi các trường hợp loại bỏ vấn đề

Bạn có thể chỉ định một thực thể PendingIntent. Phiên bản này có thể được kích hoạt khi một thực thể Thực thể SafetySourceIssue bị loại bỏ. Trung tâm an toàn xử lý các vấn đề sau loại bỏ:

  • Nếu một nguồn gây ra một vấn đề, người dùng có thể đóng vấn đề đó trong Trung tâm an toàn màn hình bằng cách nhấn vào nút đóng (nút X trên thẻ cảnh báo).
  • Khi người dùng loại bỏ một vấn đề, nếu vấn đề đó vẫn tiếp diễn, vấn đề đó sẽ không xuất hiện trong giao diện người dùng.
  • Các chế độ đóng liên tục trên ổ đĩa vẫn còn trong quá trình khởi động lại thiết bị.
  • Nếu nguồn Trung tâm an toàn ngừng cung cấp vấn đề rồi cung cấp sau đó gặp lại vấn đề này. Điều này cho phép trong trường hợp người dùng thấy một cảnh báo, hãy loại bỏ cảnh báo đó rồi thực hiện hành động sẽ giảm nhẹ vấn đề, nhưng sau đó người dùng lại làm lại điều gì đó gây ra vấn đề tương tự. Lúc này, thẻ cảnh báo sẽ xuất hiện lại.
  • Thẻ cảnh báo màu vàng và màu đỏ xuất hiện lại mỗi 180 ngày trừ phi người dùng loại bỏ chúng nhiều lần.

Nguồn không cần phải có hành vi bổ sung trừ phi:

  • Nguồn cố gắng triển khai hành vi này theo cách khác, ví dụ: không bao giờ báo lại vấn đề.
  • Ví dụ: nguồn cố gắng sử dụng lệnh này làm lệnh gọi lại để ghi nhật ký của bạn.

Cung cấp dữ liệu cho nhiều người dùng/hồ sơ

API SafetyCenterManager có thể được dùng trên nhiều người dùng và hồ sơ. Để biết thêm thông tin, xem phần Xây dựng nhận thức nhiều người dùng Ứng dụng. Context đối tượng cung cấp SafetyCenterManager được liên kết với một UserHandle nên thực thể SafetyCenterManager được trả về sẽ tương tác với Trung tâm an toàn cho thực thể UserHandle đó. Theo mặc định, Context là được liên kết với người dùng đang chạy, nhưng bạn có thể tạo phiên bản cho một người dùng khác nếu ứng dụng có INTERACT_ACROSS_USERS và Quyền INTERACT_ACROSS_USERS_FULL. Ví dụ này minh hoạ việc gọi điện trên nhiều người dùng/hồ sơ:

Context userContext = context.createContextAsUser(userHandle, 0);
SafetyCenterManager userSafetyCenterManager = userContext.getSystemService(SafetyCenterManager.class);
if (userSafetyCenterManager == null) {
  // Should not be null on T.
  return;
}
// Calls to userSafetyCenterManager will provide data for the given userHandle

Mỗi người dùng trên thiết bị có thể có nhiều hồ sơ được quản lý. Trung tâm an toàn cung cấp dữ liệu khác nhau cho từng người dùng, nhưng hợp nhất dữ liệu của tất cả được liên kết với một người dùng cụ thể.

Khi bạn đặt profile="all_profiles" cho nguồn trong tệp cấu hình, những điều sau đây sẽ xảy ra:

  • Có một mục nhập UIentry cho người dùng (hồ sơ gốc) và tất cả mục nhập được liên kết hồ sơ được quản lý (sử dụng các phiên bản titleForWork).
  • Tín hiệu làm mới hoặc quét lại được gửi đến hồ sơ gốc và tất cả hồ sơ được quản lý đã liên kết. Trình nhận liên kết được khởi động cho mỗi và có thể cung cấp dữ liệu được liên kết trực tiếp cho SafetyCenterManager mà không phải thực hiện cuộc gọi giữa nhiều hồ sơ trừ khi hoặc ứng dụng đang singleUser.

  • Nguồn này dự kiến sẽ cung cấp dữ liệu cho người dùng và tất cả dữ liệu được quản lý hồ sơ. Dữ liệu cho mỗi mục nhập giao diện người dùng có thể khác nhau, tuỳ thuộc vào hồ sơ.

Thử nghiệm

bạn có thể truy cập vào ShadowSafetyCenterManager và sử dụng công cụ này trong chương trình kiểm thử Robolectric.

private static final String MY_SOURCE_ID = "MySourceId";

private final MyClass myClass = …;
private final SafetyCenterManager safetyCenterManager = getApplicationContext().getSystemService(SafetyCenterManager.class);

@Test
public void whenRefreshingData_providesDataToSafetyCenterForMySourceId() {
    shadowOf(safetyCenterManager).setSafetyCenterEnabled(true);
    setupDataForMyClass(…);

    myClass.refreshData();

    SafetySourceData expectedSafetySourceData = …;
    assertThat(safetyCenterManager.getSafetySourceData(MY_SOURCE_ID)).isEqualTo(expectedSafetySourceData);
    SafetyEvent expectedSafetyEvent = …;
    assertThat(shadowOf(safetyCenterManager).getLastSafetyEvent(MY_SOURCE_ID)).isEqualTo(expectedSafetyEvent);
}

Bạn có thể viết thêm các chương trình kiểm thử toàn diện (E2E), nhưng việc đó nằm ngoài phạm vi của công cụ này của chúng tôi. Để biết thêm thông tin về cách viết các chương trình kiểm thử E2E này, hãy xem phần Kiểm thử CTS (CtsSafetyCenterTestCases)

API kiểm thử và API nội bộ

API nội bộ và API kiểm thử là để sử dụng nội bộ nên chúng không được mô tả trong thông tin chi tiết trong hướng dẫn này. Tuy nhiên, chúng tôi có thể mở rộng một số API nội bộ trong tương lai cho phép OEM tạo giao diện người dùng của riêng họ. Chúng tôi sẽ cập nhật hướng dẫn này nhằm cung cấp hướng dẫn về cách sử dụng chúng.

Quyền

  • MANAGE_SAFETY_CENTER
    • internal|installer|role
    • Dùng cho các API Trung tâm an toàn nội bộ
    • Chỉ được cấp choPermissionsController và shell

Ứng dụng Cài đặt

Chuyển hướng Trung tâm an toàn

Theo mặc định, người dùng sẽ truy cập Trung tâm an toàn thông qua ứng dụng Cài đặt bằng Bảo mật và quyền riêng tư. Nếu bạn dùng một ứng dụng Cài đặt khác hoặc nếu bạn đã sửa đổi ứng dụng Cài đặt, bạn có thể cần tuỳ chỉnh cách Trung tâm an toàn không được truy cập.

Khi Trung tâm an toàn được bật:

  • Mục nhập Quyền riêng tư cũ bị ẩn
  • Mục nhập Bảo mật cũ bị ẩn
  • Bảo mật và mục nhập quyền riêng tư đã được thêm
  • Bảo mật và mục nhập quyền riêng tư chuyển hướng đến Trung tâm an toàn
  • android.settings.PRIVACY_SETTINGSandroid.settings.SECURITY_SETTINGS thao tác theo ý định được chuyển hướng để mở Trung tâm an toàn (mã: bảo mật, quyền riêng tư)

Các trang bảo mật và quyền riêng tư nâng cao

Ứng dụng Cài đặt chứa các chế độ cài đặt bổ sung trong phần Chế độ cài đặt bảo mật khác và các tiêu đề Chế độ cài đặt quyền riêng tư khác có trong Trung tâm an toàn:

Nguồn an toàn

Trung tâm an toàn tích hợp với một nhóm nguồn an toàn cụ thể do Ứng dụng Cài đặt:

  • Nguồn an toàn trên màn hình khoá xác minh rằng màn hình khoá được thiết lập bằng mật mã (hoặc bảo mật khác), để đảm bảo rằng thông tin riêng tư của người dùng được bảo vệ khỏi hoạt động truy cập từ bên ngoài.
  • Một nguồn an toàn về sinh trắc học (ẩn theo mặc định) sẽ xuất hiện để tích hợp với một cảm biến vân tay hoặc khuôn mặt.

Bạn có thể truy cập mã nguồn cho các nguồn này trong Trung tâm an toàn thông qua Android mã tìm kiếm. Nếu ứng dụng Cài đặt chưa được sửa đổi (tên gói không được thay đổi, mã nguồn hoặc mã nguồn liên quan đến màn hình khoá và hệ thống nhận dạng sinh trắc học), thì việc tích hợp này sẽ thành công. Nếu không, một số nội dung sửa đổi có thể được yêu cầu như thay đổi tệp cấu hình để thay đổi gói tên của ứng dụng Cài đặt và các nguồn tích hợp với Trung tâm an toàn, như cũng như quá trình tích hợp. Để biết thêm thông tin, hãy xem phần Cập nhật cấu hình tích hợp cài đặt.

Giới thiệu về PendingIntent

Nếu bạn dựa vào tính năng tích hợp hiện có của ứng dụng Cài đặt Trung tâm an toàn trong Android Phiên bản 14 trở lên, chúng tôi đã khắc phục lỗi được mô tả bên dưới. Trong trường hợp này, bạn không cần đọc phần này.

Khi bạn chắc chắn rằng lỗi không tồn tại, hãy đặt tài nguyên boolean XML giá trị cấu hình trong ứng dụng Cài đặt config_isSafetyCenterLockScreenPendingIntentFixed đến true để tắt trong Trung tâm an toàn.

Giải pháp về PendingIntent

Lỗi này là do chế độ Cài đặt sử dụng mã bổ sung thực thể Intent để xác định mảnh để mở. Vì Intent#equals không lấy thực thể Intent các dữ liệu bổ sung mà bạn có thể xem xét, phiên bản PendingIntent cho biểu tượng trình đơn bánh răng và được coi là ngang bằng và điều hướng đến cùng một giao diện người dùng (mặc dù chúng để điều hướng đến một giao diện người dùng khác). Sự cố này được khắc phục trong bản phát hành QPR bằng cách phân biệt các thực thể PendingIntent theo mã yêu cầu. Ngoài ra, Bạn có thể phân biệt giá trị này bằng cách sử dụng Intent#setId.

Nguồn an toàn nội bộ

Một số nguồn Trung tâm an toàn là nội bộ và được triển khai trong Ứng dụng hệ thống LicenseController bên trong mô-đun PermissionsController. Các các nguồn này hoạt động giống như các nguồn Trung tâm an toàn thông thường và không nhận được xử lý. Mã cho các nguồn này có sẵn thông qua Mã Android tìm kiếm.

Đây chủ yếu là các tín hiệu về quyền riêng tư, ví dụ:

  • Hỗ trợ tiếp cận
  • Tự động thu hồi ứng dụng không dùng đến
  • Quyền truy cập thông tin vị trí
  • Trình xử lý thông báo
  • Thông tin về chính sách cơ quan