โปรไฟล์อุปกรณ์ที่ใช้ร่วมกัน

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

หากต้องการใช้โปรไฟล์อุปกรณ์ที่ใช้ร่วมกัน แอปที่ใช้ร่วมกันต้องเป็นไปตามข้อกำหนดต่อไปนี้ ข้อกำหนด

• จัดการอุปกรณ์ที่ใช้ร่วมกัน (เช่น สมาร์ทวอทช์)
• มีฟีเจอร์ของแอปหรือเรียกใช้ Android API ที่ต้องใช้ สิทธิ์ที่กำหนดไว้สำหรับโปรไฟล์อุปกรณ์ที่ใช้ร่วมกัน

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับอุปกรณ์ที่ใช้ร่วมกันได้ที่ การจับคู่อุปกรณ์ที่ใช้ร่วมกัน

ลักษณะการทำงานของอุปกรณ์

ส่วนนี้จะอธิบายถึงลักษณะการทำงานของอุปกรณ์เมื่อมีการใช้โปรไฟล์อุปกรณ์ที่ใช้ร่วมกัน

เมื่อผู้ใช้ยอมรับคำขอของแอปเพื่อสร้างการเชื่อมโยงกับโฆษณาที่แสดงร่วม CompanionDeviceManager (CDM) จะมอบหมายบทบาทโปรไฟล์อุปกรณ์ (เช่น นาฬิกา) ให้กับส่วน แอปที่ใช้ร่วมกัน โดยให้สิทธิ์ทั้งหมดที่กำหนดไว้สำหรับบทบาทของโปรไฟล์ที่ระบุ รูปที่ 1 แสดงตัวอย่างแอปขอสิทธิ์สำหรับ COMPANION_DEVICE_WATCH โปรไฟล์อุปกรณ์

รูปที่ 1 กล่องโต้ตอบขอสิทธิ์สำหรับโปรไฟล์อุปกรณ์นาฬิกา

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

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

โปรไฟล์อุปกรณ์ที่ใช้ร่วมกันสำหรับแอปของบุคคลที่สาม

ดูโปรไฟล์

โปรไฟล์นาฬิกาเปิดตัวใน Android 12

ตารางต่อไปนี้อธิบายสิทธิ์ที่กำหนดไว้สำหรับ COMPANION_DEVICE_WATCH โปรไฟล์ของอุปกรณ์และข้อกำหนดในการใช้งาน

สิทธิ์	ข้อกำหนดของแอปที่ใช้ร่วมกันและอุปกรณ์
การแจ้งเตือน BIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS (added in Android 15)	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอที่สามารถแสดงการแจ้งเตือน (อุปกรณ์ที่ใช้ ไม่รวมการโต้ตอบการสัมผัสแทนหน้าจอ) นำเสนอประสบการณ์การแจ้งเตือนที่แสดงต่อผู้ใช้ ตัวอย่างเช่น การแสดง การแจ้งเตือนทางโทรศัพท์บนหน้าจออุปกรณ์ที่ใช้ร่วมกัน โพสต์การแจ้งเตือนทางโทรศัพท์สำหรับการจัดการอุปกรณ์ เช่น เมื่อนาฬิกาเชื่อมต่ออยู่หรือมีการเปิดใช้ฟีเจอร์บางอย่าง
Phone	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีไมโครโฟนและลำโพงในตัวที่เปิดใช้การสนทนาด้วยเสียง มีหน้าจอที่แสดงข้อมูลผู้โทร มอบประสบการณ์การโทรที่ผู้ใช้เห็น (แอปที่ใช้ร่วมกัน) หยุดการโทร)
SMS	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอที่แสดงข้อความ SMS มอบประสบการณ์ทาง SMS ที่แสดงต่อผู้ใช้
Contacts	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอแสดงผล ใช้ข้อมูลติดต่อเป็นส่วนหนึ่งของการโทรหรือการรับส่งข้อความ
Calendar	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอแสดงผล มอบประสบการณ์การใช้งานปฏิทินที่แสดงต่อผู้ใช้บนนาฬิกา
Nearby devices	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอแสดงผล มอบประสบการณ์การจับคู่/การเชื่อมต่อที่แสดงต่อผู้ใช้บนนาฬิกา
eSIM provisioning	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอแสดงผล มอบประสบการณ์ที่แสดงต่อผู้ใช้ซึ่งจัดการบริการของสมาชิก จากผู้ให้บริการบนนาฬิกา
Managing ongoing calls	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีไมโครโฟนและลำโพงในตัวที่เปิดใช้การสนทนาด้วยเสียง มีหน้าจอที่แสดงข้อมูลผู้โทร มอบประสบการณ์การโทรที่ผู้ใช้เห็น (แอปที่ใช้ร่วมกัน) หยุดการโทร)

โปรไฟล์แว่นตา

โปรไฟล์ Glasses เปิดตัวใน Android 14

ตารางต่อไปนี้อธิบายสิทธิ์ที่กำหนดไว้สำหรับ COMPANION_DEVICE_GLASSES โปรไฟล์ของอุปกรณ์และข้อกำหนดในการใช้งาน

สิทธิ์	ข้อกำหนดของแอปที่ใช้ร่วมกันและอุปกรณ์
การแจ้งเตือน BIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอที่สามารถแสดงการแจ้งเตือน (อุปกรณ์ที่ใช้ ไม่รวมการโต้ตอบการสัมผัสแทนหน้าจอ) นำเสนอประสบการณ์การแจ้งเตือนที่แสดงต่อผู้ใช้ ตัวอย่างเช่น การแสดง การแจ้งเตือนทางโทรศัพท์บนหน้าจออุปกรณ์ที่ใช้ร่วมกัน โพสต์การแจ้งเตือนทางโทรศัพท์สำหรับการจัดการอุปกรณ์ เช่น เมื่อมีการเชื่อมต่ออุปกรณ์แว่นตา หรือเมื่อเปิดใช้ฟีเจอร์ที่เฉพาะเจาะจง
Phone	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีไมโครโฟนและลำโพงในตัวที่เปิดใช้การสนทนาด้วยเสียง มีหน้าจอที่แสดงข้อมูลผู้โทร มอบประสบการณ์การโทรที่ผู้ใช้เห็น (แอปที่ใช้ร่วมกัน) หยุดการโทร)
SMS	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอที่แสดงข้อความ SMS มอบประสบการณ์ทาง SMS ที่แสดงต่อผู้ใช้
Contacts	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอแสดงผล ใช้ข้อมูลติดต่อเป็นส่วนหนึ่งของการโทรหรือการรับส่งข้อความ
Microphone	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอแสดงผล มอบประสบการณ์การใช้งานไมโครโฟนที่แสดงต่อผู้ใช้บนแว่นตา
Nearby devices	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีหน้าจอแสดงผล มอบประสบการณ์ในการจับคู่/การเชื่อมต่อแว่นตาแก่ผู้ใช้
Managing ongoing calls	เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้บลูทูธและ/หรือ Wi-Fi มีไมโครโฟนและลำโพงในตัวที่เปิดใช้การสนทนาด้วยเสียง มีหน้าจอที่แสดงข้อมูลผู้โทร มอบประสบการณ์การโทรที่ผู้ใช้เห็น (แอปที่ใช้ร่วมกัน) หยุดการโทร)

การใช้งาน

สำหรับนักพัฒนาซอฟต์แวร์บุคคลที่สามที่ติดตั้งแอปที่ใช้ร่วมกันซึ่งขอ DEVICE_PROFILE_WATCH ให้ทำดังนี้

1. เรียกใช้ setDeviceProfile

2. ส่งในโปรไฟล์ (เช่น DEVICE_PROFILE_WATCH เมื่อสร้าง AssociationRequest

ผู้ผลิตอุปกรณ์ที่จะข้ามการแสดงกล่องโต้ตอบความยินยอมของผู้ใช้

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

1. เรียกข้อมูลใบรับรองโดยใช้คำสั่งต่อไปนี้

   keytool  -printcert -jarfile PATH/TO/APK
   

2. เปลี่ยนชื่อแพ็กเกจและใบรับรองตามที่แสดงใน ตัวอย่างอินพุตในไฟล์การกำหนดค่า

   <!-- A list of packages managing companion device(s) by the same manufacturers as the main device.
   It will not create the association without prompting if the association has been called multiple
   times in a short period. Note that config_companionDeviceManagerPackage and config_companionDeviceCerts
   are parallel arrays. -->
   
   <string-array name="config_companionDevicePackages" translatable="false">
       <item>YOUR_COMPANION_APP_PACKAGE_NAME</item>
   </string-array>
   
   <!-- A list of SHA256 Certificates managing companion device(s) by the same manufacturers as the
   main device. It will fall back to showing a prompt if the association has been called multiple
   times in a short period. Note that config_companionDeviceCerts and config_companionDeviceManagerPackage
   are parallel arrays.
   Example: "1A:2B:3C:4D" -->
   
   <string-array name="config_companionDeviceCerts" translatable="false">
       <item>YOUR_COMPANION_APP_CERTIFICATE</item>
   </string-array>
   

3. ใช้ AssociationRequest ส่งคำขอการเชื่อมโยงไปยังอุปกรณ์เดียว

การตรวจสอบความถูกต้อง

หากต้องการทดสอบลักษณะการทำงานของฟีเจอร์โปรไฟล์อุปกรณ์ที่ใช้ร่วมกัน ให้ใช้ CTS การทดสอบใน cts/tests/tests/companion/