โต้ตอบกับศูนย์ความปลอดภัย

เปลี่ยนเส้นทางไปยังศูนย์ความปลอดภัย

ทุกแอปสามารถเปิดศูนย์ความปลอดภัยโดยใช้การดำเนินการ android.content.Intent.ACTION_SAFETY_CENTER (ค่าสตริง android.intent.action.SAFETY_CENTER)

หากต้องการเปิดศูนย์ความปลอดภัย ให้โทรจากภายในอินสแตนซ์ Activity โดยทำดังนี้

Intent openSafetyCenterIntent = new Intent(Intent.ACTION_SAFETY_CENTER);

startActivity(openSafetyCenterIntent);

เปลี่ยนเส้นทางไปยังปัญหาที่เฉพาะเจาะจง

นอกจากนี้ยังเปลี่ยนเส้นทางไปยังการ์ดคำเตือนของศูนย์ความปลอดภัยที่เฉพาะเจาะจงได้ด้วย Intent เพิ่มเติมที่เฉพาะเจาะจง ฟีเจอร์เพิ่มเติมเหล่านี้ไม่ได้มีไว้ให้บุคคลที่สามใช้ ดังนั้นจึงเป็นส่วนหนึ่งของ SafetyCenterManager ซึ่งเป็นส่วนหนึ่งของ @SystemApi มีเพียงแอประบบเท่านั้นที่เข้าถึงส่วนเสริมเหล่านี้ได้

ข้อมูลเพิ่มเติมของ Intent ที่เปลี่ยนเส้นทางการ์ดคำเตือนที่เฉพาะเจาะจง

  • EXTRA_SAFETY_SOURCE_ID
    • ค่าสตริง: android.safetycenter.extra.SAFETY_SOURCE_ID
    • ประเภทสตริง: ระบุรหัสของแหล่งที่มาของความปลอดภัยของการ์ดคำเตือนที่เกี่ยวข้อง
    • ต้องระบุเพื่อให้การเปลี่ยนเส้นทางไปยังปัญหาทำงานได้
  • EXTRA_SAFETY_SOURCE_ISSUE_ID
    • ค่าสตริง: android.safetycenter.extra.SAFETY_SOURCE_ISSUE_ID
    • ประเภทสตริง: ระบุรหัสการ์ดคําเตือน
    • ต้องระบุเพื่อให้การเปลี่ยนเส้นทางไปยังปัญหาทำงานได้
  • EXTRA_SAFETY_SOURCE_USER_HANDLE
    • ค่าสตริง: android.safetycenter.extra.SAFETY_SOURCE_USER_HANDLE
    • ประเภท UserHandle: ระบุ UserHandle สำหรับการ์ดคำเตือนที่เกี่ยวข้อง
    • ไม่บังคับ (ค่าเริ่มต้นคือผู้ใช้ปัจจุบัน)

ข้อมูลโค้ดด้านล่างนี้สามารถใช้จากภายในอินสแตนซ์ Activity เพื่อเปิดหน้าจอศูนย์ความปลอดภัยไปยังปัญหาที่เฉพาะเจาะจงได้

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

เปลี่ยนเส้นทางไปยังหน้าย่อยที่เจาะจง (ตั้งแต่ Android 14 เป็นต้นไป)

ใน Android 14 ขึ้นไป หน้าศูนย์ความปลอดภัยจะแบ่งออกเป็นหน้าย่อยหลายหน้าซึ่งแสดงSafetySourcesGroup ต่างๆ (ใน Android 13 หน้านี้จะแสดงเป็นรายการแบบยุบได้)

คุณเปลี่ยนเส้นทางไปยังหน้าย่อยที่เฉพาะเจาะจงได้โดยใช้ Intent Extra นี้

  • EXTRA_SAFETY_SOURCES_GROUP_ID
    • ค่าสตริง: android.safetycenter.extra.SAFETY_SOURCES_GROUP_ID
    • ประเภทสตริง: ระบุรหัสของ SafetySourcesGroup
    • ต้องระบุเพื่อให้การเปลี่ยนเส้นทางไปยังหน้าย่อยทำงานได้

ข้อมูลโค้ดด้านล่างสามารถใช้ได้จากภายในอินสแตนซ์ Activity เพื่อเปิดหน้าจอศูนย์ความปลอดภัยไปยังหน้าย่อยที่เฉพาะเจาะจง

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

startActivity(openSafetyCenterIntent);

ใช้ API ของแหล่งที่มาของศูนย์ความปลอดภัย

API แหล่งที่มาของศูนย์ความปลอดภัยพร้อมให้ใช้งานโดยใช้ SafetyCenterManager (ซึ่งเป็น @SystemApi) โค้ดสำหรับแพลตฟอร์ม API พร้อมให้ใช้งานใน Code Search โค้ดการใช้งานของ API อยู่ใน Code Search

สิทธิ์

มีเพียงแอประบบในรายการที่อนุญาตซึ่งใช้สิทธิ์ที่ระบุไว้ด้านล่างเท่านั้นที่เข้าถึงได้ API ของศูนย์ความปลอดภัย ดูข้อมูลเพิ่มเติมได้ที่รายการที่อนุญาตพิเศษสำหรับสิทธิ์

  • READ_SAFETY_CENTER_STATUS
    • signature|privileged
    • ใช้สำหรับ SafetyCenterManager#isSafetyCenterEnabled() API (ไม่จำเป็นสำหรับแหล่งที่มาของศูนย์ความปลอดภัย แหล่งที่มาดังกล่าวต้องมีสิทธิ์ SEND_SAFETY_CENTER_UPDATE เท่านั้น)
    • แอประบบใช้เพื่อตรวจสอบว่าศูนย์ความปลอดภัยเปิดใช้อยู่หรือไม่
    • มอบสิทธิ์ให้กับแอประบบในรายการที่อนุญาตเท่านั้น
  • SEND_SAFETY_CENTER_UPDATE
    • internal|privileged
    • ใช้สำหรับ API ที่เปิดใช้และ Safety Sources API
    • ใช้โดยแหล่งที่มาด้านความปลอดภัยเท่านั้น
    • อนุญาตเฉพาะแอประบบในรายการที่อนุญาตเท่านั้น

สิทธิ์เหล่านี้เป็นสิทธิ์พิเศษและคุณจะได้รับสิทธิ์เหล่านี้โดยการเพิ่มลงในไฟล์ที่เกี่ยวข้องเท่านั้น เช่น ไฟล์ com.android.settings.xml สำหรับแอปการตั้งค่า และไฟล์ AndroidManifest.xml ของแอป ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบสิทธิ์ได้ที่ protectionLevel

รับ SafetyCenterManager

SafetyCenterManager เป็นคลาส @SystemApi ที่เข้าถึงได้จากแอประบบตั้งแต่ Android 13 เป็นต้นไป การพูดคุยนี้จะสาธิตวิธีการ รับ 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;
}

ตรวจสอบว่าศูนย์ความปลอดภัยเปิดอยู่หรือไม่

การโทรนี้จะตรวจสอบว่าได้เปิดใช้ศูนย์ความปลอดภัยอยู่หรือไม่ การเรียกใช้ต้องใช้สิทธิ์ READ_SAFETY_CENTER_STATUS หรือ SEND_SAFETY_CENTER_UPDATE

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

ให้ข้อมูล

ข้อมูลต้นทางของศูนย์ความปลอดภัยที่มี String sourceId หนึ่งๆ จะส่งไปยังศูนย์ความปลอดภัยด้วยออบเจ็กต์ SafetySourceData ซึ่งแสดงรายการปัญหา (การ์ดคำเตือน) และรายการใน UI รายการ UI และการ์ดคําเตือนอาจมีระดับความรุนแรงที่แตกต่างกันซึ่งระบุไว้ในคลาส SafetySourceData ดังนี้

  • SEVERITY_LEVEL_UNSPECIFIED
    • ไม่ได้ระบุความรุนแรง
    • สี: เทาหรือโปร่งใส (ขึ้นอยู่กับ SafetySourcesGroup ของรายการ)
    • ใช้สำหรับข้อมูลแบบไดนามิกที่แสดงเป็นรายการแบบคงที่ใน UI หรือเพื่อแสดงรายการที่ไม่ระบุ
    • ต้องไม่ใช้สำหรับการ์ดคำเตือน
  • SEVERITY_LEVEL_INFORMATION
    • ข้อมูลพื้นฐานหรือคำแนะนำเล็กน้อย
    • สี: เขียว
  • SEVERITY_LEVEL_RECOMMENDATION
    • คำแนะนำที่ผู้ใช้ควรดำเนินการกับปัญหานี้เพราะอาจทำให้ผู้ใช้ตกอยู่ในความเสี่ยง
    • สี: เหลือง
  • SEVERITY_LEVEL_CRITICAL_WARNING
    • คำเตือนร้ายแรงที่ผู้ใช้ต้องดำเนินการกับปัญหานี้เนื่องจากมีความเสี่ยง
    • สี: แดง

SafetySourceData

ออบเจ็กต์ SafetySourceData ประกอบด้วยรายการ UI, การ์ดคําเตือน และค่าคงที่

  • อินสแตนซ์ SafetySourceStatus (รายการ UI) ไม่บังคับ
  • รายการอินสแตนซ์ SafetySourceIssue (การ์ดคำเตือน)
  • Bundle ข้อมูลเพิ่มเติมที่ไม่บังคับ (เริ่มที่ 14)
  • อินตัวแปร:
    • รายการ SafetySourceIssue ต้องประกอบด้วยปัญหาเกี่ยวกับตัวระบุที่ไม่ซ้ำกัน
    • อินสแตนซ์ SafetySourceIssue ต้องไม่มีความสำคัญมากกว่า SafetySourceStatus หากมี (เว้นแต่ SafetySourceStatus จะเท่ากับ SEVERITY_LEVEL_UNSPECIFIED ซึ่งในกรณีนี้ SEVERITY_LEVEL_INFORMATION อนุญาตให้มีประเด็น)
    • แหล่งที่มาต้องเป็นไปตามข้อกำหนดเพิ่มเติมที่กำหนดโดยการกำหนดค่า API เช่น หากแหล่งที่มาเป็นปัญหาเท่านั้น แหล่งที่มาต้องไม่มีอินสแตนซ์ SafetySourceStatus

SafetySourceStatus

  • ต้องระบุชื่อ CharSequence
  • สรุป CharSequence ที่ต้องระบุ
  • ระดับความรุนแรงที่กำหนด
  • อินสแตนซ์ PendingIntent ไม่บังคับเพื่อเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าที่เหมาะสม (ค่าเริ่มต้นใช้ intentAction จากการกำหนดค่า หากมี)
  • IconAction (ไม่บังคับ) (แสดงเป็นไอคอนด้านข้างของรายการ) ประกอบด้วยส่วนต่างๆ ดังนี้
    • ประเภทไอคอนที่ต้องระบุ ซึ่งต้องเป็นประเภทใดประเภทหนึ่งต่อไปนี้
      • ICON_TYPE_GEAR: แสดงเป็นรูปเฟืองถัดจากรายการ UI
      • ICON_TYPE_INFO: แสดงเป็นไอคอนข้อมูลข้างรายการ UI
    • ต้องระบุ PendingIntent เพื่อเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าอื่น
  • ค่า enabled บูลีนที่ไม่บังคับซึ่งอนุญาตให้ทำเครื่องหมายรายการ UI เป็นปิดใช้ ทำให้คลิกไม่ได้ (ค่าเริ่มต้นคือ true)
  • อินตัวแปร:
    • อินสแตนซ์ PendingIntent ต้องเปิดอินสแตนซ์ Activity
    • หากปิดใช้รายการ คุณต้องกำหนดรายการนั้นว่าเป็น SEVERITY_LEVEL_UNSPECIFIED
    • ข้อกำหนดเพิ่มเติมที่กำหนดโดยการกำหนดค่า API

SafetySourceIssue

  • ตัวระบุ String ที่ไม่ซ้ำกัน (ต้องระบุ)
  • ต้องระบุชื่อCharSequence
  • คำบรรยายภาษาCharSequence (ไม่บังคับ)
  • สรุป CharSequence ที่ต้องระบุ
  • ระดับความรุนแรงที่กำหนด
  • หมวดหมู่ปัญหาแบบไม่บังคับ ซึ่งต้องอยู่ในหมวดหมู่ใดหมวดหมู่หนึ่งต่อไปนี้
    • ISSUE_CATEGORY_DEVICE: ปัญหานี้ส่งผลต่ออุปกรณ์ของผู้ใช้
    • ISSUE_CATEGORY_ACCOUNT: ปัญหานี้ส่งผลต่อบัญชีของผู้ใช้
    • ISSUE_CATEGORY_GENERAL: ปัญหานี้ส่งผลต่อความปลอดภัยทั่วไปของผู้ใช้ ซึ่งเป็นค่าเริ่มต้น
    • ISSUE_CATEGORY_DATA (Android 14): ปัญหามีผลต่อข้อมูลของผู้ใช้
    • ISSUE_CATEGORY_PASSWORDS (ตั้งแต่ Android 14 เป็นต้นไป): ปัญหาส่งผลต่อรหัสผ่านของผู้ใช้
    • ISSUE_CATEGORY_PERSONAL_SAFETY (ตั้งแต่ Android 14 เป็นต้นไป): ปัญหาส่งผลกระทบต่อความปลอดภัยส่วนบุคคลของผู้ใช้
  • รายการองค์ประกอบ Action ที่ผู้ใช้สามารถใช้แก้ปัญหานี้ได้ โดยแต่ละActionอินสแตนซ์ประกอบด้วยข้อมูลต่อไปนี้
    • ตัวระบุ String ที่ไม่ซ้ำกัน (ต้องระบุ)
    • ต้องติดป้ายกำกับ CharSequence
    • ต้องระบุ PendingIntent เพื่อเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าอื่นหรือประมวลผลการดำเนินการจากหน้าจอศูนย์ความปลอดภัยโดยตรง
    • บูลีนที่ไม่บังคับเพื่อระบุว่าปัญหานี้แก้ไขได้โดยตรงจากหน้าจอศูนย์ความปลอดภัย (ค่าเริ่มต้นคือ false)
    • CharSequence ข้อความแสดงความสำเร็จที่ไม่บังคับ ซึ่งจะแสดงต่อผู้ใช้เมื่อแก้ปัญหาสำเร็จจากหน้าจอศูนย์ความปลอดภัยโดยตรง
  • PendingIntent ที่ไม่บังคับซึ่งระบบจะเรียกใช้เมื่อผู้ใช้ปิดปัญหา (ค่าเริ่มต้นคือไม่มีการเรียกใช้)
  • String ตัวระบุประเภทปัญหา (ต้องระบุ) ซึ่งคล้ายกับตัวระบุปัญหา แต่ไม่จําเป็นต้องไม่ซ้ำกันและใช้สําหรับการบันทึก
  • String ไม่บังคับสำหรับรหัสการกรองข้อมูลที่ซ้ำกันออก ซึ่งจะช่วยให้โพสต์SafetySourceIssueเดียวกันจากแหล่งที่มาต่างๆ ได้และแสดงใน UI เพียงครั้งเดียวโดยสมมติว่าdeduplicationGroupเหมือนกัน (ตั้งแต่ Android 14 เป็นต้นไป) หากไม่ได้ระบุ ระบบจะไม่กรองรายการที่ซ้ำกันออก
  • CharSequence (ไม่บังคับ) สำหรับชื่อการระบุแหล่งที่มา ข้อความนี้คือข้อความแสดงที่มาของการ์ดคำเตือน (ตั้งแต่ Android 14 เป็นต้นไป) หากไม่ได้ระบุ ระบบจะใช้ชื่อของ SafetySourcesGroup
  • ความสามารถในการดำเนินการกับปัญหา (ไม่บังคับ) (ตั้งแต่ Android 14 เป็นต้นไป) ซึ่งต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
    • ISSUE_ACTIONABILITY_MANUAL: ผู้ใช้ต้องแก้ไขปัญหานี้ด้วยตนเอง ซึ่งเป็นค่าเริ่มต้น
    • ISSUE_ACTIONABILITY_TIP: ปัญหานี้เป็นเพียงเคล็ดลับและอาจไม่จําเป็นต้องป้อนข้อมูลใดๆ ของผู้ใช้
    • ISSUE_ACTIONABILITY_AUTOMATIC: มีการแก้ไขปัญหานี้แล้ว และผู้ใช้อาจไม่ต้องการข้อมูลใดๆ เพิ่มเติม
  • ลักษณะการทำงานของการแจ้งเตือนที่ไม่บังคับ (ตั้งแต่ Android 14 เป็นต้นไป) ซึ่งต้องมีลักษณะอย่างใดอย่างหนึ่งต่อไปนี้
    • NOTIFICATION_BEHAVIOR_UNSPECIFIED: ศูนย์ความปลอดภัยจะตัดสินใจว่าจะต้องมีการแจ้งเตือนสำหรับการ์ดคำเตือนหรือไม่ โดยตัวเลือกนี้คือค่าเริ่มต้น
    • NOTIFICATION_BEHAVIOR_NEVER: ไม่มีการโพสต์การแจ้งเตือน
    • NOTIFICATION_BEHAVIOR_DELAYED: การแจ้งเตือนจะโพสต์ขึ้นหลังจากมีการรายงานปัญหาเป็นครั้งแรก
    • NOTIFICATION_BEHAVIOR_IMMEDIATELY: ระบบจะโพสต์การแจ้งเตือนทันทีที่รายงานปัญหา
  • ไม่บังคับ Notification เพื่อแสดงการแจ้งเตือนที่กำหนดเองพร้อมการ์ดคำเตือน (ตั้งแต่ Android 14 เป็นต้นไป) หากไม่ระบุ ระบบจะดึงข้อมูล Notification มาจากการ์ดคำเตือน ประกอบด้วย
    • ชื่อ CharSequence ต้องระบุ
    • ต้องมีข้อมูลสรุป CharSequence
    • รายการองค์ประกอบ Action ที่ผู้ใช้ดำเนินการกับการแจ้งเตือนนี้ได้
  • ตัวแปร:
    • รายการอินสแตนซ์ Action ต้องประกอบด้วยการดำเนินการที่มีตัวระบุที่ไม่ซ้ำกัน
    • รายการอินสแตนซ์ Action ต้องมีองค์ประกอบ Action 1 หรือ 2 รายการ หากความสามารถในการดำเนินการไม่ใช่ ISSUE_ACTIONABILITY_MANUAL ระบบจะอนุญาตให้มี Action เป็น 0 ได้
    • OnOff PendingIntent ต้องไม่เปิดอินสแตนซ์ Activity
    • ข้อกำหนดเพิ่มเติมที่กำหนดโดยการกำหนดค่า API

ข้อมูลจะได้รับมาจากเหตุการณ์บางอย่างในศูนย์ความปลอดภัย คุณจึงจำเป็นต้องระบุสาเหตุที่ทำให้ต้นทางมอบอินสแตนซ์ SafetyEvent ให้กับ SafetySourceData

SafetyEvent

  • ประเภทที่จำเป็น ซึ่งต้องเป็นประเภทอย่างใดอย่างหนึ่งต่อไปนี้
    • SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED: สถานะของแหล่งที่มามีการเปลี่ยนแปลง
    • SAFETY_EVENT_TYPE_REFRESH_REQUESTED: การตอบสนองต่อสัญญาณรีเฟรช/สแกนอีกครั้งจากศูนย์ความปลอดภัย ให้ใช้คำสั่งนี้แทน SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED เพื่อให้ศูนย์ความปลอดภัยติดตามคำขอรีเฟรช/สแกนอีกครั้งได้
    • SAFETY_EVENT_TYPE_RESOLVING_ACTION_SUCCEEDED: เราแก้ปัญหา SafetySourceIssue.Action โดยตรงจากหน้าจอศูนย์ความปลอดภัยแล้ว ให้ใช้การแก้ไขนี้แทน SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED เพื่อให้ศูนย์ความปลอดภัยติดตาม SafetySourceIssue.Action ที่กำลังได้รับการแก้ไขได้
    • SAFETY_EVENT_TYPE_RESOLVING_ACTION_FAILED: เราพยายามแก้ไข SafetySourceIssue.Action โดยตรงจากหน้าจอศูนย์ความปลอดภัย แต่ไม่สำเร็จ ให้ใช้ข้อมูลนี้แทน SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED เพื่อให้ศูนย์ความปลอดภัยติดตาม SafetySourceIssue.Action ที่ล้มเหลวได้
    • SAFETY_EVENT_TYPE_DEVICE_LOCALE_CHANGED: ภาษาของอุปกรณ์เปลี่ยนไป เราจึงอัปเดตข้อความของข้อมูลที่ให้ไว้ โดยอนุญาตให้ใช้ SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED กับข้อมูลนี้
    • SAFETY_EVENT_TYPE_DEVICE_REBOOTED: เราให้ข้อมูลนี้เป็นส่วนหนึ่งของการเปิดเครื่องครั้งแรก เนื่องจากระบบไม่ได้เก็บข้อมูลศูนย์ความปลอดภัยไว้ในการรีบูตอุปกรณ์ แต่ได้รับอนุญาตให้ใช้ SAFETY_EVENT_TYPE_SOURCE_STATE_CHANGED สำหรับกรณีนี้
  • ตัวระบุ String ที่ไม่บังคับสำหรับรหัสการออกอากาศการรีเฟรช
  • ตัวระบุ String ที่ไม่บังคับสำหรับอินสแตนซ์ SafetySourceIssue ได้รับการแก้ไขแล้ว
  • ตัวระบุ String ที่ไม่บังคับสำหรับอินสแตนซ์ SafetySourceIssue.Action ที่ได้รับการแก้ไข
  • อินตัวแปร:
    • ต้องระบุรหัสการออกอากาศการรีเฟรชหากประเภทคือ SAFETY_EVENT_TYPE_REFRESH_REQUESTED
    • ต้องระบุปัญหาและรหัสการดำเนินการหากประเภทเป็น SAFETY_EVENT_TYPE_RESOLVING_ACTION_SUCCEEDED หรือ SAFETY_EVENT_TYPE_RESOLVING_ACTION_FAILED

ด้านล่างคือตัวอย่างวิธีที่แหล่งข้อมูลอาจส่งข้อมูลให้ศูนย์ความปลอดภัย (ในกรณีนี้ แหล่งที่มาจะให้รายการพร้อมการ์ดคำเตือนใบเดียว)

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

รับข้อมูลสุดท้ายที่ให้ไว้

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

ใช้รหัสนี้เพื่อรับข้อมูลล่าสุดที่ส่งไปยังศูนย์ความปลอดภัย

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

รายงานข้อผิดพลาด

หากรวบรวมข้อมูล SafetySourceData ไม่ได้ ให้รายงานข้อผิดพลาดไปที่ศูนย์ความปลอดภัยซึ่งเปลี่ยนรายการให้เป็นสีเทา ล้างข้อมูลที่แคชไว้ และแสดงข้อความอย่างเช่นตรวจสอบการตั้งค่าไม่ได้ นอกจากนี้ คุณยังรายงานข้อผิดพลาดหากแก้ไขอินสแตนซ์ของ SafetySourceIssue.Action ไม่สำเร็จ ซึ่งในกรณีนี้ระบบไม่ได้ล้างข้อมูลที่แคชไว้และรายการ UI ไม่เปลี่ยนแปลง แต่ข้อความจะแสดงให้ผู้ใช้เห็นเพื่อแจ้งให้ทราบว่าเกิดข้อผิดพลาด

คุณระบุข้อผิดพลาดได้โดยใช้ SafetySourceErrorDetails ซึ่งประกอบด้วย

  • SafetySourceErrorDetails: อินสแตนซ์ 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);

ตอบกลับคำขอรีเฟรชหรือสแกนอีกครั้ง

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

ซึ่งทำได้โดยการรับการออกอากาศที่มีการดำเนินการต่อไปนี้

  • ACTION_REFRESH_SAFETY_SOURCES
    • ค่าสตริง: android.safetycenter.action.REFRESH_SAFETY_SOURCES
    • ทริกเกอร์เมื่อศูนย์ความปลอดภัยส่งคำขอรีเฟรชข้อมูลของแหล่งที่มาของความปลอดภัยสำหรับแอปหนึ่งๆ
    • เจตนาที่ได้รับการปกป้องที่สามารถส่งได้โดยระบบเท่านั้น
    • ส่งไปยังแหล่งที่มาของความปลอดภัยทั้งหมดในไฟล์การกําหนดค่าเป็นเจตนาที่ชัดเจนและต้องใช้สิทธิ์ SEND_SAFETY_CENTER_UPDATE

ฟีเจอร์พิเศษต่อไปนี้มีให้ใช้งานในรายการนี้

  • EXTRA_REFRESH_SAFETY_SOURCE_IDS
    • ค่าสตริง: android.safetycenter.extra.REFRESH_SAFETY_SOURCE_IDS
    • ประเภทอาร์เรย์สตริง (String[]) แสดงถึงรหัสแหล่งที่มาที่จะรีเฟรชสำหรับแอปที่ระบุ

  • EXTRA_REFRESH_SAFETY_SOURCES_REQUEST_TYPE

    • ค่าสตริง: android.safetycenter.extra.REFRESH_SAFETY_SOURCES_REQUEST_TYPE
    • ประเภทจำนวนเต็ม แสดงประเภทคำขอ @IntDef
    • ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
      • EXTRA_REFRESH_REQUEST_TYPE_GET_DATA: ขอให้แหล่งที่มาแสดงข้อมูลอย่างรวดเร็ว โดยปกติแล้วเมื่อผู้ใช้เปิดหน้าเว็บ
      • EXTRA_REFRESH_REQUEST_TYPE_FETCH_FRESH_DATA: ขอให้แหล่งที่มาระบุข้อมูลล่าสุดที่สุด โดยปกติแล้วเมื่อผู้ใช้กดปุ่ม "สแกนอีกครั้ง"

  • EXTRA_REFRESH_SAFETY_SOURCES_BROADCAST_ID

    • ค่าสตริง: android.safetycenter.extra.REFRESH_SAFETY_SOURCES_BROADCAST_ID
    • ประเภทสตริง แสดงตัวระบุที่ไม่ซ้ำกันสำหรับการรีเฟรชที่ขอ

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

BroadcastReceiver ตอบสนองต่อคำขอรีเฟรช

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

อินสแตนซ์ BroadcastReceiver เดียวกันในตัวอย่างด้านบนจะประกาศใน 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>

วิธีที่ดีที่สุดคือติดตั้งใช้งานแหล่งข้อมูลของศูนย์ความปลอดภัยในลักษณะที่จะเรียกใช้ SafetyCenterManager เมื่อข้อมูลมีการเปลี่ยนแปลง เพื่อรักษาประสิทธิภาพของระบบ เราขอแนะนำให้ตอบสนองต่อสัญญาณการสแกนอีกครั้งเท่านั้น (เมื่อผู้ใช้แตะปุ่มสแกน) และไม่ใช่เมื่อผู้ใช้เปิดศูนย์ความปลอดภัย หากต้องมีฟังก์ชันการทำงานนี้ คุณจะต้องตั้งค่าช่อง refreshOnPageOpenAllowed="true" ในไฟล์การกำหนดค่าเพื่อให้แหล่งที่มาได้รับการออกอากาศที่นำส่งในกรณีเหล่านี้

ตอบสนองต่อศูนย์ความปลอดภัยเมื่อเปิดหรือปิดใช้งาน

คุณสามารถตอบสนองเมื่อศูนย์ความปลอดภัยเปิดหรือปิดใช้อยู่ได้โดยใช้การดำเนินการตามเจตนานี้

  • ACTION_SAFETY_CENTER_ENABLED_CHANGED
    • ค่าสตริง: android.safetycenter.action.SAFETY_CENTER_ENABLED_CHANGED
    • เรียกให้แสดงเมื่อเปิดหรือปิดใช้ศูนย์ความปลอดภัยขณะที่อุปกรณ์ทำงานอยู่
    • ไม่ได้เรียกใช้เมื่อบูต (ใช้ ACTION_BOOT_COMPLETED แทน)
    • เจตนาที่ได้รับการปกป้องที่สามารถส่งได้โดยระบบเท่านั้น
    • ส่งไปยังแหล่งที่มาของความปลอดภัยทั้งหมดในไฟล์การกําหนดค่าเป็นเจตนาที่ชัดเจน ต้องมีสิทธิ์ SEND_SAFETY_CENTER_UPDATE
    • ส่งเป็น Intent ที่ไม่ชัดแจ้งซึ่งต้องใช้สิทธิ์ READ_SAFETY_CENTER_STATUS

การดำเนินการผ่าน Intent นี้มีประโยชน์ในการเปิดหรือปิดใช้ฟีเจอร์ที่เกี่ยวข้องกับศูนย์ความปลอดภัยในอุปกรณ์

ใช้การดำเนินการแก้ไข

การดําเนินการแก้ไขคืออินสแตนซ์ SafetySourceIssue.Action ที่ผู้ใช้สามารถแก้ไขได้โดยตรงจากหน้าจอศูนย์ความปลอดภัย ผู้ใช้แตะปุ่มการดำเนินการ และระบบจะทริกเกอร์อินสแตนซ์ PendingIntent ใน SafetySourceIssue.Action ที่ส่งโดยแหล่งที่มาของความปลอดภัย ซึ่งจะแก้ปัญหาในเบื้องหลังและแจ้งให้ศูนย์ความปลอดภัยทราบเมื่อดำเนินการเสร็จสิ้น

หากต้องการใช้การดำเนินการแก้ปัญหา แหล่งที่มาของศูนย์ความปลอดภัยจะใช้บริการได้ หากการดำเนินการดังกล่าวคาดว่าจะใช้เวลาสักระยะหนึ่ง (PendingIntent.getService) หรือใช้ Broadcast Receiver (PendingIntent.getBroadcast)

ใช้รหัสนี้เพื่อแก้ปัญหาไปยังศูนย์ความปลอดภัย

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 จะแก้ไขการดำเนินการนี้

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

อินสแตนซ์เดียวกันของ BroadcastReceiver ในตัวอย่างด้านบนมีการประกาศใน 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>

ตอบสนองต่อการระงับปัญหา

คุณสามารถระบุอินสแตนซ์ PendingIntent ที่ทริกเกอร์ได้เมื่อมีการปิดอินสแตนซ์ SafetySourceIssue ศูนย์ความปลอดภัยจะจัดการ การปิดปัญหาเหล่านี้

  • หากแหล่งที่มาผลักดันปัญหา ผู้ใช้สามารถปิดปัญหาได้ในหน้าจอศูนย์ความปลอดภัยโดยแตะปุ่มปิด (ปุ่ม X บนการ์ดคำเตือน)
  • เมื่อผู้ใช้ปิดปัญหาหนึ่งๆ ปัญหานั้นจะไม่แสดงใน UI อีกต่อไป หากปัญหายังคงอยู่
  • การปิดถาวรในดิสก์จะยังคงอยู่เมื่ออุปกรณ์รีบูต
  • หากแหล่งที่มาของศูนย์ความปลอดภัยหยุดแสดงปัญหาแล้วแสดงปัญหาอีกครั้งในภายหลัง แสดงว่าปัญหากลับมาอีกครั้ง ทั้งนี้ก็เพื่ออนุญาตสถานการณ์ที่ผู้ใช้เห็นคำเตือน ปิดคำเตือน แล้วดำเนินการเพื่อลดปัญหา แต่ผู้ใช้ก็ดำเนินการอีกครั้งซึ่งทำให้เกิดปัญหาคล้ายๆ กัน เมื่อถึงจุดนี้ การ์ดคำเตือนควรปรากฏขึ้นอีกครั้ง
  • การ์ดคำเตือนสีเหลืองและสีแดงจะแสดงทุก 180 วัน เว้นแต่ผู้ใช้จะปิดการ์ดหลายครั้ง

แหล่งที่มาไม่จำเป็นต้องมีลักษณะการทำงานเพิ่มเติม เว้นแต่ในกรณีต่อไปนี้

  • แหล่งที่มาพยายามใช้ลักษณะการทํางานนี้ในลักษณะอื่น เช่น ไม่แสดงปัญหานี้ขึ้นมาอีก
  • แหล่งที่มาพยายามใช้ข้อมูลนี้เป็นการเรียกกลับ เช่น เพื่อบันทึกข้อมูล

ระบุข้อมูลสำหรับผู้ใช้/โปรไฟล์หลายรายการ

SafetyCenterManager API สามารถใช้กับผู้ใช้และโปรไฟล์ต่างๆ ได้ ดูข้อมูลเพิ่มเติมได้ที่การสร้างแอปแบบ Context-Aware สำหรับผู้ใช้หลายคน ออบเจ็กต์ Context ที่ระบุ SafetyCenterManager จะเชื่อมโยงกับอินสแตนซ์ UserHandle ดังนั้นอินสแตนซ์ SafetyCenterManager ที่แสดงผลจะโต้ตอบกับศูนย์ความปลอดภัยสำหรับอินสแตนซ์ UserHandle นั้น โดยค่าเริ่มต้น Context จะเชื่อมโยงกับผู้ใช้ที่ใช้งานอยู่ แต่คุณจะสร้างอินสแตนซ์สำหรับผู้ใช้รายอื่นได้ถ้าแอปถือสิทธิ์ INTERACT_ACROSS_USERS และ INTERACT_ACROSS_USERS_FULL ตัวอย่างนี้แสดงการโทรจากผู้ใช้/โปรไฟล์ต่างๆ

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

ผู้ใช้แต่ละคนในอุปกรณ์จะมีโปรไฟล์ที่จัดการได้หลายโปรไฟล์ ศูนย์ความปลอดภัยจะแสดงข้อมูลที่แตกต่างกันสำหรับผู้ใช้แต่ละราย แต่จะรวมข้อมูลของโปรไฟล์ที่มีการจัดการทั้งหมดที่เกี่ยวข้องกับผู้ใช้ที่ระบุ

เมื่อตั้งค่า profile="all_profiles" สำหรับแหล่งที่มาในไฟล์การกำหนดค่าแล้ว สิ่งต่อไปนี้จะเกิดขึ้น

  • มีรายการ UI สำหรับผู้ใช้ (ระดับบนสุดของโปรไฟล์) และโปรไฟล์ที่มีการจัดการทั้งหมดที่เกี่ยวข้อง (ซึ่งใช้อินสแตนซ์ titleForWork)

  • ระบบจะส่งสัญญาณรีเฟรชหรือสแกนอีกครั้งสำหรับโปรไฟล์หลักและโปรไฟล์ที่จัดการทั้งหมดที่เกี่ยวข้อง ตัวรับที่เกี่ยวข้องจะเริ่มต้นสำหรับแต่ละโปรไฟล์และสามารถให้ข้อมูลที่เกี่ยวข้องแก่ SafetyCenterManager ได้โดยตรงโดยไม่ต้องเรียกใช้ข้ามโปรไฟล์ เว้นแต่ตัวรับหรือแอปจะเป็น singleUser

  • แหล่งที่มาควรให้ข้อมูลของผู้ใช้และโปรไฟล์ทั้งหมดที่มีการจัดการ ข้อมูลของรายการ UI แต่ละรายการอาจแตกต่างกันไปโดยขึ้นอยู่กับโปรไฟล์

การทดสอบ

คุณจะเข้าถึง ShadowSafetyCenterManager และใช้ในการทดสอบ 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);
}

คุณเขียนการทดสอบจากต้นทางถึงปลายทาง (E2E) เพิ่มเติมได้ แต่ก็อยู่นอกขอบเขตของคู่มือนี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการเขียนการทดสอบ E2E เหล่านี้ได้ที่การทดสอบ CtsSafetyCenterTestCases)

API การทดสอบและ API ภายใน

API ภายในและ API การทดสอบมีไว้เพื่อการใช้งานภายใน จึงจะไม่ได้อธิบายรายละเอียดในคู่มือนี้ อย่างไรก็ตาม เราอาจขยาย API ภายในบางรายการในอนาคตเพื่ออนุญาตให้ OEM สร้าง UI ของตนเองจาก API ดังกล่าว และเราจะอัปเดตคู่มือนี้เพื่อแนะนำวิธีใช้

สิทธิ์

  • MANAGE_SAFETY_CENTER
    • internal|installer|role
    • ใช้สำหรับ API ของศูนย์ความปลอดภัยภายใน
    • ให้สิทธิ์แก่ PermissionsController และ Shell เท่านั้น

แอปการตั้งค่า

การเปลี่ยนเส้นทางศูนย์ความปลอดภัย

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

เมื่อเปิดใช้ศูนย์ความปลอดภัย

  • รหัสรายการความเป็นส่วนตัวเดิมที่ซ่อนอยู่
  • รายการความปลอดภัยเดิมที่ซ่อนอยู่ code
  • เพิ่มรายการความปลอดภัยและความเป็นส่วนตัวใหม่ code
  • รายการความปลอดภัยและความเป็นส่วนตัวใหม่จะเปลี่ยนเส้นทางไปยังรหัสศูนย์ความปลอดภัย
  • ระบบจะเปลี่ยนเส้นทางการดำเนินการของ android.settings.PRIVACY_SETTINGS และ android.settings.SECURITY_SETTINGS เพื่อเปิดศูนย์ความปลอดภัย (รหัส: security, privacy)

หน้าความปลอดภัยและความเป็นส่วนตัวขั้นสูง

แอปการตั้งค่าจะมีการตั้งค่าเพิ่มเติมในส่วนการตั้งค่าความปลอดภัยเพิ่มเติมและชื่อของการตั้งค่าความเป็นส่วนตัวเพิ่มเติม ซึ่งมีให้จากศูนย์ความปลอดภัยดังนี้

  • รหัสความปลอดภัยขั้นสูง

  • รหัสความเป็นส่วนตัวขั้นสูง

  • ตั้งแต่ Android 14 เป็นต้นไป หน้าการตั้งค่าความปลอดภัยขั้นสูงและความเป็นส่วนตัวขั้นสูงจะรวมอยู่ในหน้า "ความปลอดภัยและความเป็นส่วนตัวเพิ่มเติม" หน้าเดียวที่มีการดำเนินการผ่าน Intent "com.android.settings.MORE_SECURITY_PRIVACY_SETTINGS"

แหล่งที่มาของความปลอดภัย

ศูนย์ความปลอดภัยจะทำงานร่วมกับชุดแหล่งข้อมูลด้านความปลอดภัยที่เฉพาะเจาะจงจากแอปการตั้งค่า ดังนี้

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

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

เกี่ยวกับ PendingIntent

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

เมื่อแน่ใจว่าไม่มีข้อบกพร่องแล้ว ให้ตั้งค่าการกำหนดค่าทรัพยากรบูลีน XML ในแอปการตั้งค่า config_isSafetyCenterLockScreenPendingIntentFixed เป็น true เพื่อปิดวิธีแก้ปัญหาภายในศูนย์ความปลอดภัย

วิธีแก้ปัญหา PendingIntent

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

แหล่งที่มาของความปลอดภัยภายใน

แหล่งที่มาของศูนย์ความปลอดภัยบางแห่งเป็นข้อมูลภายในและติดตั้งใช้งานในแอประบบ PermissionController ภายในโมดูล PermissionController แหล่งที่มาเหล่านี้จะทำงานเหมือนกับแหล่งที่มาของศูนย์ความปลอดภัยทั่วไปและจะไม่ได้รับการดำเนินการพิเศษ โค้ดสำหรับแหล่งที่มาเหล่านี้มีอยู่ในการค้นหาโค้ด Android

โดยส่วนใหญ่จะเป็นสัญญาณความเป็นส่วนตัว เช่น

  • การช่วยเหลือพิเศษ
  • เพิกถอนสิทธิ์ของแอปที่ไม่ได้ใช้โดยอัตโนมัติ
  • การเข้าถึงตำแหน่ง
  • ตัวฟังการแจ้งเตือน
  • ข้อมูลนโยบายงาน