Berinteraksi dengan Pusat Keamanan

Mengalihkan ke Pusat Keamanan

Aplikasi apa pun dapat membuka Pusat Keamanan menggunakan tindakan android.content.Intent.ACTION_SAFETY_CENTER (nilai string android.intent.action.SAFETY_CENTER).

Untuk membuka Pusat Keselamatan, lakukan panggilan dari dalam instance Activity:

Intent openSafetyCenterIntent = new Intent(Intent.ACTION_SAFETY_CENTER);

startActivity(openSafetyCenterIntent);

Catatan: Mencoba membuka Pusat Keamanan saat dinonaktifkan akan mengalihkan pengguna ke halaman Setelan.

Mengalihkan ke masalah tertentu

Anda juga dapat mengalihkan ke kartu peringatan Pusat Keselamatan tertentu menggunakan tambahan intent tertentu. Tambahan ini tidak dimaksudkan untuk digunakan oleh pihak ketiga sehingga bagian dari SafetyCenterManager, yang merupakan bagian dari @SystemApi. Hanya aplikasi sistem yang dapat mengakses tambahan ini.

Tambahan intent yang mengalihkan kartu peringatan tertentu:

• EXTRA_SAFETY_SOURCE_ID
  • Nilai string: android.safetycenter.extra.SAFETY_SOURCE_ID
  • Jenis string: Menentukan ID sumber keselamatan dari kartu peringatan terkait
  • Wajib agar pengalihan ke masalah dapat berfungsi
• EXTRA_SAFETY_SOURCE_ISSUE_ID
  • Nilai string: android.safetycenter.extra.SAFETY_SOURCE_ISSUE_ID
  • Jenis string: Menentukan ID kartu peringatan
  • Wajib agar pengalihan ke masalah dapat berfungsi
• EXTRA_SAFETY_SOURCE_USER_HANDLE
  • Nilai string: android.safetycenter.extra.SAFETY_SOURCE_USER_HANDLE
  • Jenis UserHandle: Menentukan UserHandle untuk kartu peringatan terkait
  • Opsional (default adalah pengguna saat ini)

Cuplikan kode di bawah ini dapat digunakan dari dalam instance Activity untuk membuka layar Pusat Keamanan terkait masalah tertentu:

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);

Catatan: Jika kartu peringatan tidak ditampilkan di layar Pusat Keamanan, intent ini akan membuka UI Pusat Keamanan tanpa men-scroll ke masalah yang relevan.

Mengalihkan ke subhalaman tertentu (Mulai Android 14)

Di Android 14 atau yang lebih baru, halaman Pusat Keamanan dibagi menjadi beberapa subhalaman yang mewakili SafetySourcesGroup yang berbeda (di Android 13, ini ditampilkan sebagai entri yang dapat diciutkan).

Anda dapat mengalihkan ke subhalaman spesifik menggunakan ekstra intent ini:

• EXTRA_SAFETY_SOURCES_GROUP_ID
  • Nilai string: android.safetycenter.extra.SAFETY_SOURCES_GROUP_ID
  • Jenis string: Menentukan ID SafetySourcesGroup
  • Wajib agar pengalihan ke subhalaman berfungsi

Cuplikan kode di bawah dapat digunakan dari dalam instance Activity untuk membuka layar Pusat Keselamatan ke subhalaman tertentu:

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

startActivity(openSafetyCenterIntent);

Menggunakan API sumber Safety Center

API sumber Safety Center tersedia menggunakan SafetyCenterManager (yang merupakan @SystemApi). Kode untuk platform API tersedia di Penelusuran Kode. Kode implementasi API ini tersedia di Code Search.

Izin

API sumber Pusat Keselamatan hanya dapat diakses oleh aplikasi sistem yang diizinkan menggunakan izin yang tercantum di bawah. Untuk informasi tambahan, lihat Pemberian Izin Hak Istimewa.

• READ_SAFETY_CENTER_STATUS
  • signature|privileged
  • Digunakan untuk SafetyCenterManager#isSafetyCenterEnabled() API (tidak diperlukan untuk sumber Pusat Keamanan, sumber hanya memerlukan izin SEND_SAFETY_CENTER_UPDATE)
  • Digunakan oleh aplikasi sistem yang memeriksa apakah Pusat Keamanan diaktifkan
  • Hanya diberikan ke aplikasi sistem yang diizinkan
• SEND_SAFETY_CENTER_UPDATE
  • internal|privileged
  • Digunakan untuk API yang diaktifkan dan Safety Sources API
  • Hanya digunakan oleh sumber keamanan
  • Hanya diberikan ke aplikasi sistem yang diizinkan

Izin ini diberi hak istimewa dan Anda hanya dapat memperolehnya dengan menambahkannya ke file yang relevan, misalnya, file com.android.settings.xml untuk aplikasi Setelan, dan ke file AndroidManifest.xml aplikasi. Lihat protectionLevel untuk mengetahui informasi selengkapnya tentang model izin.

Mendapatkan SafetyCenterManager

SafetyCenterManager adalah class @SystemApi yang dapat diakses dari aplikasi sistem mulai Android 13. Panggilan ini menunjukkan cara mendapatkan 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;
}

Periksa apakah Pusat Keamanan diaktifkan

Panggilan ini memeriksa apakah Pusat Keamanan diaktifkan. Panggilan memerlukan izin READ_SAFETY_CENTER_STATUS atau SEND_SAFETY_CENTER_UPDATE:

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

Memberikan data

Data sumber Safety Center dengan String sourceId yang diberikan disediakan ke Safety Center dengan objek SafetySourceData, yang mewakili entri UI dan daftar masalah (kartu peringatan). Entri UI dan kartu peringatan dapat memiliki tingkat keparahan yang berbeda yang ditentukan dalam class SafetySourceData:

• SEVERITY_LEVEL_UNSPECIFIED
  • Tidak ada tingkat keparahan yang ditentukan
  • Warna: Abu-abu atau transparan (bergantung pada SafetySourcesGroup entri)
  • Digunakan untuk data dinamis yang tampil sebagai entri statis di UI atau untuk menampilkan entri yang tidak ditentukan
  • Tidak boleh digunakan untuk kartu peringatan
• SEVERITY_LEVEL_INFORMATION
  • Informasi dasar atau saran kecil
  • Warna: Hijau
• SEVERITY_LEVEL_RECOMMENDATION
  • Rekomendasi agar pengguna mengambil tindakan atas masalah ini, karena dapat membahayakan mereka
  • Warna: Kuning
• SEVERITY_LEVEL_CRITICAL_WARNING
  • Peringatan penting bahwa pengguna harus mengambil tindakan terhadap masalah ini, karena menimbulkan risiko
  • Warna: Merah

SafetySourceData

Objek SafetySourceData terdiri dari entri UI, kartu peringatan, dan invarian.

• Instance SafetySourceStatus opsional (entri UI)
• Daftar instance SafetySourceIssue (kartu peringatan)
• Tambahan Bundle opsional (Mulai 14)
• Invarian:
  • Daftar SafetySourceIssue harus terdiri dari masalah dengan ID unik.
  • Instance SafetySourceIssue tidak boleh lebih penting daripada SafetySourceStatus jika ada (kecuali jika SafetySourceStatus adalah SEVERITY_LEVEL_UNSPECIFIED, dalam hal ini masalah SEVERITY_LEVEL_INFORMATION diizinkan).
  • Persyaratan tambahan yang diberlakukan oleh konfigurasi API harus dipenuhi, misalnya, jika sumbernya hanya masalah, sumber tersebut tidak boleh menyediakan instance SafetySourceStatus.

SafetySourceStatus

• CharSequence judul wajib diisi
• Ringkasan CharSequence yang diperlukan
• Tingkat keparahan yang diperlukan
• Instance PendingIntent opsional untuk mengalihkan pengguna ke halaman yang tepat (default menggunakan intentAction dari konfigurasi, jika ada)
• IconAction opsional (ditampilkan sebagai ikon samping pada entri) yang terdiri dari:
  • Jenis ikon yang diperlukan, yang harus berupa salah satu jenis berikut:
    • ICON_TYPE_GEAR: Ditampilkan sebagai roda gigi di samping entri UI
    • ICON_TYPE_INFO: Ditampilkan sebagai ikon informasi di samping entri UI
  • Wajib PendingIntent untuk mengalihkan pengguna ke halaman lain
• Nilai enabled boolean opsional yang memungkinkan penandaan entri UI sebagai dinonaktifkan sehingga tidak dapat diklik (defaultnya adalah true)
• Invarian:
  • Instance PendingIntent harus membuka instance Activity.
  • Jika dinonaktifkan, entri harus ditetapkan ke SEVERITY_LEVEL_UNSPECIFIED.
  • Persyaratan tambahan yang diberlakukan oleh konfigurasi API.

SafetySourceIssue

• ID unik String yang diperlukan
• CharSequence judul wajib diisi
• Subjudul CharSequence opsional
• Ringkasan CharSequence yang diperlukan
• Tingkat keparahan yang diperlukan
• Kategori masalah opsional, yang harus berupa salah satu dari:
  • ISSUE_CATEGORY_DEVICE: Masalah memengaruhi perangkat pengguna.
  • ISSUE_CATEGORY_ACCOUNT: Masalah ini memengaruhi akun pengguna.
  • ISSUE_CATEGORY_GENERAL: Masalah ini memengaruhi keselamatan umum pengguna. Ini adalah defaultnya.
  • ISSUE_CATEGORY_DATA (Mulai Android 14): Masalah ini memengaruhi data pengguna.
  • ISSUE_CATEGORY_PASSWORDS (Mulai Android 14): Masalah ini memengaruhi sandi pengguna.
  • ISSUE_CATEGORY_PERSONAL_SAFETY (Mulai Android 14): Masalah ini memengaruhi keselamatan pribadi pengguna.
• Daftar elemen Action yang dapat diambil pengguna untuk masalah ini, setiap instance Action terdiri dari:
  • ID unik String yang diperlukan
  • Label CharSequence wajib diisi
  • Diperlukan PendingIntent untuk mengalihkan pengguna ke halaman lain atau memproses tindakan langsung dari layar Pusat Keselamatan
  • Boolean opsional untuk menentukan apakah masalah ini dapat diselesaikan langsung dari layar Pusat Keamanan (defaultnya adalah false)
  • Pesan berhasil CharSequence opsional, yang akan ditampilkan kepada pengguna saat masalah berhasil diselesaikan langsung dari layar Pusat Keselamatan
• PendingIntent opsional yang dipanggil saat pengguna menutup masalah (defaultnya tidak ada yang dipanggil)
• ID jenis masalah String yang diperlukan; ini mirip dengan ID masalah, tetapi tidak harus unik dan digunakan untuk logging
• String opsional untuk ID penghapusan duplikat, hal ini memungkinkan postingan SafetySourceIssue yang sama dari sumber yang berbeda dan hanya menampilkannya sekali di UI dengan asumsi bahwa keduanya memiliki deduplicationGroup yang sama (Mulai Android 14). Jika tidak ditentukan, masalah tidak akan dihapus duplikatnya
• CharSequence opsional untuk judul atribusi, ini adalah teks yang menunjukkan asal kartu peringatan (Mulai Android 14). Jika tidak ditentukan, gunakan judul SafetySourcesGroup
• Kemampuan tindak lanjut masalah opsional (Mulai Android 14), yang harus berupa salah satu dari:
  • ISSUE_ACTIONABILITY_MANUAL: Pengguna harus menyelesaikan masalah ini secara manual. Ini adalah defaultnya.
  • ISSUE_ACTIONABILITY_TIP: Masalah ini hanyalah tips dan mungkin tidak memerlukan input pengguna.
  • ISSUE_ACTIONABILITY_AUTOMATIC: Masalah ini telah ditindaklanjuti dan mungkin tidak memerlukan input pengguna.
• Perilaku notifikasi opsional (Mulai Android 14), yang harus berupa salah satu dari:
  • NOTIFICATION_BEHAVIOR_UNSPECIFIED: Pusat Keamanan akan menentukan apakah notifikasi diperlukan untuk kartu peringatan. Ini adalah defaultnya.
  • NOTIFICATION_BEHAVIOR_NEVER: Tidak ada notifikasi yang diposting.
  • NOTIFICATION_BEHAVIOR_DELAYED: Notifikasi diposting beberapa saat setelah masalah pertama kali dilaporkan.
  • NOTIFICATION_BEHAVIOR_IMMEDIATELY: Notifikasi akan diposting segera setelah masalah dilaporkan.
• Notification opsional, untuk menampilkan notifikasi kustom dengan kartu peringatan (Mulai Android 14). Jika tidak ditentukan, Notification berasal dari kartu peringatan. Terdiri dari:
  • CharSequence judul wajib diisi
  • Ringkasan CharSequence yang diperlukan
  • Daftar elemen Action yang dapat diambil pengguna untuk notifikasi ini
• Invarian:
  • Daftar instance Action harus terdiri dari tindakan dengan ID unik
  • Daftar instance Action harus berisi satu atau dua elemen Action. Jika kemampuan tindak lanjut bukan ISSUE_ACTIONABILITY_MANUAL, nilai nol Action diizinkan.
  • PendingIntent OnDismiss tidak boleh membuka instance Activity
  • Persyaratan tambahan yang diberlakukan oleh konfigurasi API

Data diberikan setelah peristiwa tertentu ke Safety Center, sehingga Anda perlu menentukan penyebab sumber menyediakan SafetySourceData dengan instance SafetyEvent.

SafetyEvent

• Jenis yang diperlukan, yang harus berupa salah satu dari:
  • SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED: Status sumber telah berubah.
  • SAFETY_EVENT_TYPE_REFRESH_REQUESTED: Merespons sinyal refresh/pemindaian ulang dari Pusat Keamanan; gunakan ini, bukan SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED, agar Pusat Keamanan dapat melacak permintaan refresh/pemindaian ulang.
  • SAFETY_EVENT_TYPE_RESOLVING_ACTION_SUCCEEDED: Kita menyelesaikan SafetySourceIssue.Action langsung dari layar Pusat Keamanan; gunakan ini, bukan SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED, untuk Pusat Keamanan agar dapat melacak SafetySourceIssue.Action yang sedang diselesaikan.
  • SAFETY_EVENT_TYPE_RESOLVING_ACTION_FAILED: Kami mencoba me-resolve SafetySourceIssue.Action langsung dari layar Pusat Keamanan, tetapi gagal melakukannya; gunakan ini, bukan SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED, agar Pusat Keamanan dapat melacak SafetySourceIssue.Action yang gagal.
  • SAFETY_EVENT_TYPE_DEVICE_LOCALE_CHANGED: Bahasa perangkat telah berubah, jadi kami memperbarui teks data yang diberikan; Anda diizinkan untuk menggunakan SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED untuk ini.
  • SAFETY_EVENT_TYPE_DEVICE_REBOOTED: Kami menyediakan data ini sebagai bagian dari booting awal karena data Pusat Keamanan tidak disimpan selama memulai ulang; Anda diizinkan menggunakan SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED untuk hal ini.
• ID String opsional untuk ID siaran refresh.
• ID String opsional untuk instance SafetySourceIssue yang di-resolve.
• ID String opsional untuk instance SafetySourceIssue.Action yang di-resolve.
• Invarian:
  • ID siaran refresh harus diberikan jika jenisnya adalah SAFETY_EVENT_TYPE_REFRESH_REQUESTED
  • ID masalah dan tindakan harus diberikan jika jenisnya adalah SAFETY_EVENT_TYPE_RESOLVING_ACTION_SUCCEEDED atau SAFETY_EVENT_TYPE_RESOLVING_ACTION_FAILED

Berikut adalah contoh cara sumber dapat memberikan data ke Pusat Keselamatan (dalam hal ini, sumber memberikan entri dengan satu kartu peringatan):

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);

Catatan: Anda dapat menyetel SafetySourceData ke null untuk menghapus data yang ada yang dikirim ke Pusat Keamanan. Tindakan ini akan mengembalikan ke status default yang ditentukan dalam file konfigurasi.

Mendapatkan data terakhir yang diberikan

Anda bisa mendapatkan data terakhir yang disediakan ke Pusat Keamanan untuk sumber yang dimiliki oleh aplikasi Anda. Anda dapat menggunakannya untuk menampilkan sesuatu di UI Anda sendiri, memeriksa apakah data perlu diperbarui sebelum melakukan operasi yang mahal, atau untuk memberikan instance SafetySourceData yang sama ke Pusat Keamanan dengan beberapa perubahan atau dengan instance SafetyEvent baru. Hal ini juga berguna untuk pengujian.

Gunakan kode ini untuk mendapatkan data terakhir yang diberikan ke Pusat Keamanan:

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

Catatan: SafetySourceData yang ditampilkan dapat berupa null, yang berarti tidak ada data yang diberikan ke Safety Center sejak booting atau data telah dihapus.

Melaporkan error

Jika tidak dapat mengumpulkan data SafetySourceData, Anda dapat melaporkan error ke Pusat Keamanan, yang akan mengubah entri menjadi abu-abu, menghapus data yang di-cache, dan memberikan pesan seperti Tidak dapat memeriksa setelan. Anda juga dapat melaporkan error jika instance SafetySourceIssue.Action gagal di-resolve. Jika demikian, data dalam cache tidak akan dihapus dan entri UI tidak akan diubah; tetapi pesan akan ditampilkan kepada pengguna untuk memberi tahu mereka bahwa ada yang salah.

Anda dapat memberikan error menggunakan SafetySourceErrorDetails, yang terdiri dari:

• SafetySourceErrorDetails: Instance SafetyEvent yang diperlukan:

// 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);

Merespons permintaan refresh atau pemindaian ulang

Anda bisa mendapatkan sinyal dari Pusat Keamanan untuk memberikan data baru. Merespons permintaan muat ulang atau pemindaian ulang memastikan bahwa pengguna melihat status saat ini saat membuka Pusat Keamanan dan saat mereka mengetuk tombol pindai.

Hal ini dilakukan dengan menerima siaran dengan tindakan berikut:

• ACTION_REFRESH_SAFETY_SOURCES
  • Nilai string: android.safetycenter.action.REFRESH_SAFETY_SOURCES
  • Dipicu saat Pusat Keamanan mengirim permintaan untuk memuat ulang data sumber keamanan untuk aplikasi tertentu
  • Intent yang dilindungi yang hanya dapat dikirim oleh sistem
  • Dikirim ke semua sumber keamanan dalam file konfigurasi sebagai intent eksplisit dan memerlukan izin SEND_SAFETY_CENTER_UPDATE

Tambahan berikut disediakan sebagai bagian dari siaran ini:

• EXTRA_REFRESH_SAFETY_SOURCE_IDS
  • Nilai string: android.safetycenter.extra.REFRESH_SAFETY_SOURCE_IDS
  • Jenis array string (String[]), mewakili ID sumber yang akan dimuat ulang untuk aplikasi tertentu

• EXTRA_REFRESH_SAFETY_SOURCES_REQUEST_TYPE

  • Nilai string: android.safetycenter.extra.REFRESH_SAFETY_SOURCES_REQUEST_TYPE
  • Jenis bilangan bulat, mewakili jenis permintaan @IntDef
  • Harus berupa salah satu dari:
    • EXTRA_REFRESH_REQUEST_TYPE_GET_DATA: Meminta sumber untuk memberikan data dengan relatif cepat, biasanya saat pengguna membuka halaman
    • EXTRA_REFRESH_REQUEST_TYPE_FETCH_FRESH_DATA: Meminta sumber untuk memberikan data yang seaktual mungkin, biasanya saat pengguna menekan tombol pemindaian ulang

• EXTRA_REFRESH_SAFETY_SOURCES_BROADCAST_ID

  • Nilai string: android.safetycenter.extra.REFRESH_SAFETY_SOURCES_BROADCAST_ID
  • Jenis string, mewakili ID unik untuk pembaruan yang diminta

Untuk mendapatkan sinyal dari Pusat Keamanan, terapkan instance BroadcastReceiver. Siaran dikirim dengan BroadcastOptions khusus yang memungkinkan penerima memulai layanan latar depan.

BroadcastReceiver merespons permintaan refresh:

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;
  }
}

Instance BroadcastReceiver yang sama dalam contoh di atas dideklarasikan di 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>

Idealnya, sumber Pusat Keamanan diimplementasikan sedemikian rupa sehingga memanggil SafetyCenterManager saat datanya berubah. Untuk alasan kondisi sistem, sebaiknya hanya tanggapi sinyal pemindaian ulang (saat pengguna mengetuk tombol pindai), dan bukan saat pengguna membuka Pusat Keamanan. Jika fungsi ini diperlukan, kolom refreshOnPageOpenAllowed="true" dalam file konfigurasi harus ditetapkan agar sumber dapat menerima siaran yang dikirimkan dalam kasus ini.

Catatan: Sumber diharapkan selalu merespons sinyal pemindaian ulang. Sinyal refresh juga diharapkan merespons sinyal refresh jika refreshOnPageOpenAllowed adalah true, meskipun melaporkan error. Jika sumber tidak merespons, entri UI akan menjadi abu-abu dan pesan Tidak dapat memuat ulang setelan akan ditampilkan. Jika sumber berbasis didorong sepenuhnya dan tidak perlu dilacak sama sekali saat memuat ulang data, sumber tidak boleh memiliki penerima yang terdaftar untuk tindakan intent ACTION_REFRESH_SAFETY_SOURCES.

Merespons Pusat Keselamatan saat diaktifkan atau dinonaktifkan

Anda dapat merespons saat Pusat Keamanan diaktifkan atau dinonaktifkan menggunakan tindakan intent ini:

• ACTION_SAFETY_CENTER_ENABLED_CHANGED
  • Nilai string: android.safetycenter.action.SAFETY_CENTER_ENABLED_CHANGED
  • Dipicu saat Pusat Keamanan diaktifkan atau dinonaktifkan saat perangkat berjalan
  • Tidak dipanggil saat booting (gunakan ACTION_BOOT_COMPLETED untuk itu)
  • Intent yang dilindungi yang hanya dapat dikirim oleh sistem
  • Dikirim ke semua sumber keamanan dalam file konfigurasi sebagai intent eksplisit, memerlukan izin SEND_SAFETY_CENTER_UPDATE
  • Dikirim sebagai intent implisit yang memerlukan izin READ_SAFETY_CENTER_STATUS

Catatan: Intent ini dikirim tanpa tambahan intent apa pun, seperti yang dijelaskan dalam Merespons permintaan refresh atau pemindaian ulang. Intent ini dikirim sebagai intent eksplisit ke sumber Safety Center dengan daftar yang diizinkan yang sama untuk memulai layanan latar depan (seperti ACTION_REFRESH_SAFETY_SOURCES), tetapi juga dikirim sebagai intent implisit sehingga dapat didengarkan menggunakan penerima yang terdaftar dalam konteks, misalnya, dalam layanan persisten.

Tindakan intent ini berguna untuk mengaktifkan atau menonaktifkan fitur yang terkait dengan Safety Center di perangkat.

Mengimplementasikan tindakan penyelesaian

Tindakan penyelesaian adalah instance SafetySourceIssue.Action yang dapat diselesaikan pengguna langsung dari layar Pusat Keamanan. Pengguna mengetuk tombol tindakan dan instance PendingIntent pada SafetySourceIssue.Action yang dikirim oleh sumber keamanan akan dipicu, yang menyelesaikan masalah di latar belakang dan memberi tahu Pusat Keamanan saat proses ini selesai.

Untuk menerapkan tindakan penyelesaian, sumber Pusat Keselamatan dapat menggunakan layanan jika operasi diperkirakan akan memerlukan waktu beberapa saat (PendingIntent.getService) atau penerima siaran (PendingIntent.getBroadcast).

Gunakan kode ini untuk mengirim masalah penyelesaian ke Pusat Keamanan:

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 me-resolve tindakan:

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).
  }
}

Instance BroadcastReceiver yang sama dalam contoh di atas dideklarasikan di 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>

Merespons penghentian masalah

Anda dapat menentukan instance PendingIntent yang dapat dipicu saat instance SafetySourceIssue ditutup. Pusat Keamanan menangani penghapusan masalah berikut:

• Jika sumber mendorong masalah, pengguna dapat menutupnya di layar Pusat Keselamatan dengan mengetuk tombol tutup (tombol X di kartu peringatan).
• Saat pengguna menutup masalah, masalah tersebut tidak akan muncul lagi di UI.
• Penghentian persisten pada disk tetap ada selama perangkat dimulai ulang.
• Jika sumber Pusat Keamanan berhenti menyediakan masalah, lalu menyediakan masalah lagi di lain waktu, masalah tersebut akan muncul kembali. Hal ini untuk memungkinkan situasi saat pengguna melihat peringatan, menutupnya, lalu mengambil tindakan yang akan meringankan masalah, tetapi kemudian pengguna melakukan sesuatu lagi yang menyebabkan masalah serupa. Pada tahap ini, kartu peringatan akan muncul kembali.
• Kartu peringatan kuning dan merah akan muncul kembali setiap 180 hari, kecuali jika pengguna telah menutupnya beberapa kali.

Perilaku tambahan tidak akan diperlukan oleh sumber kecuali:

• Sumber mencoba menerapkan perilaku ini secara berbeda, misalnya, tidak pernah muncul kembali masalah.
• Sumber mencoba menggunakannya sebagai callback, misalnya, untuk mencatat informasi.

Memberikan data untuk beberapa pengguna/profil

SafetyCenterManager API dapat digunakan di semua pengguna dan profil. Untuk mengetahui informasi selengkapnya, lihat Membuat Aplikasi Multiuser-Aware. Objek Context yang menyediakan SafetyCenterManager dikaitkan dengan instance UserHandle, sehingga instance SafetyCenterManager yang ditampilkan berinteraksi dengan Safety Center untuk instance UserHandle tersebut. Secara default, Context dikaitkan dengan pengguna yang sedang berjalan, tetapi Anda dapat membuat instance untuk pengguna lain jika aplikasi memiliki izin INTERACT_ACROSS_USERS dan INTERACT_ACROSS_USERS_FULL. Contoh ini menunjukkan cara melakukan panggilan pada pengguna/profil:

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

Setiap pengguna di perangkat dapat memiliki beberapa profil terkelola. Pusat Keamanan menyediakan data yang berbeda untuk setiap pengguna, tetapi menggabungkan data dari semua profil yang dikelola yang terkait dengan pengguna tertentu.

Saat profile="all_profiles" ditetapkan untuk sumber dalam file konfigurasi, hal berikut akan terjadi:

• Ada entri UI untuk pengguna (induk profil) dan semua profil terkelola terkait (yang menggunakan instance titleForWork).

• Sinyal refresh atau pemindaian ulang dikirim untuk induk profil dan semua profil terkelola terkait. Penerima terkait dimulai untuk setiap profil dan dapat memberikan data terkait langsung ke SafetyCenterManager tanpa harus melakukan panggilan antar-profil, kecuali penerima atau aplikasi adalah singleUser.

• Sumber diharapkan menyediakan data untuk pengguna dan semua profil terkelolanya. Data untuk setiap entri UI mungkin berbeda bergantung pada profil.

Pengujian

Catatan: Android 13 menyertakan ShadowSafetyCenterManager, Robolectric shadow baru untuk SafetyCenterManager. Lihat Bayangan untuk mengetahui informasi tentang menguji interaksi Anda dengan SafetyCenterManager di JVM.

Anda dapat mengakses ShadowSafetyCenterManager dan menggunakannya dalam uji 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);
}

Anda dapat menulis lebih banyak pengujian menyeluruh (E2E), tetapi hal itu di luar cakupan panduan ini. Untuk informasi selengkapnya tentang cara menulis pengujian E2E ini, lihat Pengujian CTS (CtsSafetyCenterTestCases)

API pengujian dan internal

API internal dan API pengujian ditujukan untuk penggunaan internal sehingga tidak dijelaskan secara mendetail dalam panduan ini. Namun, kami mungkin memperluas beberapa API internal di masa mendatang agar OEM dapat membangun UI-nya sendiri dan kami akan memperbarui panduan ini untuk memberikan panduan cara menggunakannya.

Izin

• MANAGE_SAFETY_CENTER
  • internal|installer|role
  • Digunakan untuk API Safety Center internal
  • Hanya diberikan ke PermissionController dan shell

Aplikasi Setelan

Pengalihan Pusat Keamanan

Secara default, Pusat Keamanan diakses melalui aplikasi Setelan dengan entri Keamanan &privasi baru. Jika menggunakan aplikasi Setelan yang berbeda atau jika telah mengubah aplikasi Setelan, Anda mungkin perlu menyesuaikan cara Pusat Keselamatan diakses.

Jika Pusat Keamanan diaktifkan:

• Entri Privacy lama disembunyikan code
• Entri Security lama adalah code tersembunyi
• Entri Keamanan &privasi baru ditambahkan kode
• Entri Keamanan &privasi baru mengalihkan ke kode Pusat Keamanan
• Tindakan intent android.settings.PRIVACY_SETTINGS dan android.settings.SECURITY_SETTINGS dialihkan ke Pusat Keamanan yang terbuka (kode: keamanan, privasi)

Halaman keamanan dan privasi lanjutan

Aplikasi Setelan berisi setelan tambahan di bagian Setelan keamanan lainnya dan judul Setelan privasi lainnya, yang tersedia dari Pusat Keamanan:

• Kode keamanan lanjutan

  • security_advanced_settings.xml

  • SecurityAdvancedSettings.java

• Kode privasi lanjutan

  • privacy_advanced_settings.xml

  • PrivacyDashboardFragment.java

• Mulai Android 14, halaman setelan keamanan lanjutan dan privasi lanjutan digabungkan dalam satu halaman "Keamanan & Privasi Lainnya" dengan tindakan intent "com.android.settings.MORE_SECURITY_PRIVACY_SETTINGS"

Sumber keamanan

Pusat Keamanan terintegrasi dengan kumpulan sumber keamanan tertentu yang disediakan oleh aplikasi Setelan:

• Sumber keamanan layar kunci memverifikasi bahwa layar kunci disiapkan dengan kode sandi (atau keamanan lainnya), untuk memastikan bahwa informasi pribadi pengguna dijaga keamanannya dari akses eksternal.
• Sumber keamanan biometrik (disembunyikan secara default) muncul untuk berintegrasi dengan sensor sidik jari atau wajah.

Kode sumber untuk sumber Safety Center ini dapat diakses melalui penelusuran kode Android. Jika aplikasi Setelan tidak dimodifikasi (perubahan tidak dilakukan pada nama paket, kode sumber, atau kode sumber yang menangani layar kunci dan biometrik), integrasi ini akan berfungsi secara otomatis. Jika tidak, beberapa modifikasi mungkin diperlukan, seperti mengubah file konfigurasi untuk mengubah nama paket aplikasi Setelan dan sumber yang terintegrasi dengan Pusat Keamanan, serta integrasinya. Untuk mengetahui informasi selengkapnya, lihat Memperbarui file konfigurasi dan setelan integrasi.

Tentang PendingIntent

Jika Anda mengandalkan integrasi Pusat Keamanan aplikasi Setelan yang ada di Android 14 atau yang lebih baru, bug yang dijelaskan di bawah telah diperbaiki. Dalam hal ini, Anda tidak perlu membaca bagian ini.

Penting: Ada masalah di aplikasi Setelan Android 13 yang terjadi di sumber keamanan layar kunci dengan instance PendingIntent yang salah. Hal ini menyebabkan entri layar kunci, ikon roda gigi terkait, dan kartu peringatan potensial, menavigasi secara tidak benar ke UI yang sama.

Perhatian: Solusi diterapkan di SafetyCenterService untuk mengganti instance PendingIntent ini dalam beberapa kondisi. Sebaiknya Anda tidak mengandalkan perilaku ini karena hasilnya mungkin tidak konsisten. Sebagai gantinya, Anda harus memastikan aplikasi Setelan berfungsi dengan benar sejak peluncuran.

Catatan: OEM yang menerapkan sumber keamanan AndroidLockScreen di aplikasi Setelan harus berhati-hati agar tidak menimbulkan masalah PendingIntent ini. Jika Anda mendasarkan penerapan Setelan pada AOSP, tetapi belum menerapkan rilis QPR pertama, pastikan perbaikan bug diterapkan ke penerapan Setelan Android 13. Lihat Solusi PendingIntent.

Jika Anda yakin bahwa bug tidak ada, tetapkan nilai konfigurasi resource boolean XML di aplikasi Setelan config_isSafetyCenterLockScreenPendingIntentFixed ke true untuk menonaktifkan solusi dalam Pusat Keamanan.

Solusi PendingIntent

Bug ini disebabkan oleh Setelan yang menggunakan tambahan instance Intent untuk menentukan fragmen mana yang akan dibuka. Karena Intent#equals tidak memperhitungkan tambahan instance Intent, instance PendingIntent untuk ikon menu roda gigi dan entri dianggap sama dan membuka UI yang sama (meskipun dimaksudkan untuk membuka UI yang berbeda). Masalah ini telah diperbaiki dalam rilis QPR dengan membedakan instance PendingIntent berdasarkan kode permintaan. Atau, ini dapat dibedakan menggunakan Intent#setId.

Sumber keselamatan internal

Beberapa sumber Pusat Keamanan bersifat internal dan diterapkan di aplikasi sistem PermissionController di dalam modul PermissionController. Sumber ini berperilaku seperti sumber Pusat Keamanan reguler dan tidak menerima perlakuan khusus. Kode untuk sumber ini tersedia melalui penelusuran kode Android.

Hal ini utamanya adalah sinyal privasi, misalnya:

• Aksesibilitas
• Cabut otomatis aplikasi yang tidak digunakan
• Akses lokasi
• Pendengar pemberitahuan
• Info kebijakan kerja