โปรไฟล์อุปกรณ์คู่หู

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

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

ประเภทโปรไฟล์อุปกรณ์ที่ใช้ร่วมกันต่อไปนี้มีอยู่ใน Android 12: COMPANION_DEVICE_WATCH

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

พฤติกรรมอุปกรณ์

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

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

ดูข้อความโต้ตอบโปรไฟล์อุปกรณ์

รูปที่ 1. ไดอะล็อกขอสิทธิ์สำหรับโปรไฟล์อุปกรณ์นาฬิกา

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

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

ความต้องการ

เพื่อให้แอปร่วมเข้าถึง API โปรไฟล์อุปกรณ์ร่วม แอปต้องเป็นไปตามข้อกำหนดต่อไปนี้:

  • มีอุปกรณ์ร่วม (เช่น สมาร์ทวอทช์)
  • มีเหตุผลที่ถูกต้องในการกำหนดให้ต้องมีการอนุญาตที่กำหนดไว้สำหรับโปรไฟล์อุปกรณ์ร่วม

ดูข้อกำหนดโปรไฟล์อุปกรณ์ร่วม

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

สิทธิ์ ข้อกำหนดของแอพคู่หูและอุปกรณ์
การแจ้งเตือน

BIND_NOTIFICATION_LISTENER_SERVICE
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีหน้าจอที่สามารถแสดงการแจ้งเตือนได้ (ไม่รวมอุปกรณ์ที่ใช้ระบบสั่นแทนหน้าจอ)
  • มอบประสบการณ์การแจ้งเตือนที่ผู้ใช้เผชิญ เช่น การแสดงการแจ้งเตือนทางโทรศัพท์บนหน้าจออุปกรณ์ที่ใช้ร่วมกัน
โทรศัพท์

phone
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีไมโครโฟนและลำโพงในตัวที่ช่วยให้สนทนาด้วยเสียงได้
  • มีหน้าจอแสดงข้อมูลผู้โทร
  • ให้ประสบการณ์การโทรผ่านโทรศัพท์กับผู้ใช้ (แอปที่ใช้ร่วมกับการโทรศัพท์)
ข้อความ

sms
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีหน้าจอแสดงข้อความ SMS
  • มอบประสบการณ์ SMS สำหรับผู้ใช้
รายชื่อผู้ติดต่อ

contacts
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีหน้าจอแสดงผล
  • ใช้ข้อมูลติดต่อเป็นส่วนหนึ่งของประสบการณ์การโทรหรือส่งข้อความ
ปฏิทิน

calendar
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีหน้าจอแสดงผล
  • มอบประสบการณ์ปฏิทินที่ผู้ใช้เผชิญบนนาฬิกา
อุปกรณ์ใกล้เคียง

nearby_devices
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีหน้าจอแสดงผล
  • มอบประสบการณ์การจับคู่/การเชื่อมต่อกับผู้ใช้บนนาฬิกา
การจัดเตรียม eSIM

USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีหน้าจอแสดงผล
  • มอบประสบการณ์การเผชิญหน้ากับผู้ใช้ที่จัดการบริการของสมาชิกจากผู้ให้บริการบนนาฬิกา
การจัดการสายที่สนทนาอยู่

MANAGE_ONGOING_CALLS
  • เป็นอุปกรณ์ที่เชื่อมต่อโดยใช้ Bluetooth และ/หรือ Wi-Fi
  • มีไมโครโฟนและลำโพงในตัวที่ช่วยให้สนทนาด้วยเสียงได้
  • มีหน้าจอแสดงข้อมูลผู้โทร
  • ให้ประสบการณ์การโทรผ่านโทรศัพท์กับผู้ใช้ (แอปที่ใช้ร่วมกับการโทรศัพท์)

การเข้าถึง

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

การดำเนินการ

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

  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_COMAPNION_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 เพื่อส่งคำขอเชื่อมโยงไปยังอุปกรณ์ร่วมเครื่องเดียว

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

  1. เรียกเมธอด setDeviceProfile
  2. ส่งผ่านโปรไฟล์ DEVICE_PROFILE_WATCH เมื่อสร้าง AssociationRequest

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

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