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

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

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

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

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

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

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

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

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

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

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

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

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

โปรไฟล์นาฬิกา

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

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

สิทธิ์	ข้อกำหนดของแอปและอุปกรณ์ที่ใช้ร่วมกัน
การแจ้งเตือน 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 มีไมโครโฟนและลำโพงในตัวที่ช่วยให้สนทนาด้วยเสียงได้ มีหน้าจอที่แสดงข้อมูลผู้โทร มอบประสบการณ์การโทรทางโทรศัพท์ที่แสดงต่อผู้ใช้ (แอปที่ใช้ร่วมกันทำหน้าที่เป็นบริดจ์การโทร)

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

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

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

สิทธิ์	ข้อกำหนดของแอปและอุปกรณ์ที่ใช้ร่วมกัน
การแจ้งเตือน 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/