คอมโพเนนต์ของระบบและการไหลของผู้ใช้

แผนภาพต่อไปนี้แสดงคอมโพเนนต์ที่โต้ตอบกับสื่อ

รูปที่ 1 ส่วนประกอบของระบบ

องค์ประกอบในรูปนี้มีคำอธิบายในตาราง:

การไหลเวียนของผู้ใช้

การเปิดตัวแอปสื่อ

กระบวนการที่เปิดสื่อจะปรากฏอยู่ด้านล่าง

รูปที่ 2 การเปิดตัวแอปสื่อ

ต้องเปิดตัวสื่อโดยใช้โดยนัยต่อไปนี้ CAR_INTENT_ACTION_MEDIA_TEMPLATE Intent นี้อาจมีข้อมูลต่อไปนี้เป็นข้อมูลเพิ่มเติม

• android.car.intent.extra.MEDIA_COMPONENT (ไม่บังคับ) สตริงส่วนเกิน เพื่อแทนชื่อคอมโพเนนต์ที่แยกเป็นหลายรายการของ MediaBrowserService ในแอปสื่อที่สื่อจะเชื่อมต่อ หากไม่ระบุ สื่อจะแสดง แอปสื่อที่เลือกอยู่ Intent นี้ใช้จากรายการต่อไปนี้ จุดแรกเข้า:

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

  • หน้าจอหลัก ผู้ช่วย และศูนย์การแจ้งเตือน ผู้ใช้สามารถ ให้ไปที่ "สื่อ" เพื่อแสดงแอปสื่อที่เลือกอยู่ในปัจจุบัน ในทุกกรณี ระบบจะเรียกใช้ Intent แบบไม่เจาะจงปลายทางที่ไม่มีส่วนเสริม

  • เครื่องเรียกใช้งานแอป เมื่อผู้ใช้เลือกแอปสื่อจาก เครื่องเรียกใช้งานแอป Intent ด้านบนจะรวม CAR_EXTRA_MEDIA_COMPONENT พิเศษ ซึ่งมีแอปสื่อที่เลือกไว้ สื่อกำหนดให้เป็น แอปที่เลือกและเชื่อมต่อกับแอปนั้นๆ โปรดดูรายละเอียดที่ส่วนด้านล่าง การผสานรวม Launcher กับสื่อ

ตัวเปิดแอปกับการผสานรวมสื่อ

แอปสื่อไม่ได้รับอนุญาตให้แสดงกิจกรรมที่มีคำอธิบายประกอบ หมวดหมู่ android.intent.category.LAUNCHER ด้วยเหตุนี้ เครื่องเรียกใช้งานแอป (หรือ เทียบเท่า) ต้องใช้ตรรกะพิเศษเพื่อระบุการผสานรวมแหล่งที่มาของสื่อ ดังนี้

• เครื่องเรียกใช้งานแอปต้องสแกนระบบเพื่อดูแพ็กเกจที่ใช้งาน MediaBrowserService.SERVICE_INTERFACE สำหรับแพ็กเกจเหล่านี้ เครื่องเรียกใช้งานแอปจะดึงข้อมูลไอคอนบริการที่คล้ายกับที่ใช้ในการดึงข้อมูลอื่นๆ กิจกรรม

• จากนั้นเครื่องเรียกใช้งานแอปจะรวมแพ็กเกจเหล่านี้กับแพ็กเกจที่ใช้งาน android.intent.category.LAUNCHER กิจกรรม หากแอปมี การใช้งาน MediaBrowserService และกิจกรรม Launcher บริการนี้ใช้เวลา ลำดับความสำคัญ

  ในระหว่างที่เขียนนี้ แอปแหล่งที่มาของสื่อไม่มีกิจกรรม Launcher เลย

• ตัวอย่างของตรรกะนี้จะอยู่ในโค้ด AOSP ที่ AppLauncherUtils#getAllLauncherApps()

ขั้นตอนการลงชื่อเข้าใช้และตัวเลือกการกำหนดค่า

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

• ลงชื่อเข้าใช้
• ออกจากระบบ
• การสลับบัญชี
• แสดงข้อมูลที่ผู้ใช้กำลังเข้าสู่ระบบอยู่ (หากมี)
• การกำหนดค่าบริการ

รูปที่ 3 ขั้นตอนการลงชื่อเข้าใช้

แอปสื่อประกาศกิจกรรมการตั้งค่านี้ด้วยตัวกรอง Intent ต่อไปนี้

<activity android:name=".AppSettingsActivity"
          android:exported="true
          android:theme="@style/SettingsActivity"
           android:label="@string/app_settings_activity_title">
   <intent-filter>
       <action android:name="android.intent.action.APPLICATION_PREFERENCES"/>
   </intent-filter>
</activity>

สื่อต้องใช้ตรรกะต่อไปนี้

• ตรวจสอบว่าแอปสื่อที่เลือกในปัจจุบันมีกิจกรรมที่มี ตัวกรองความตั้งใจ

• หากใช่ โปรดอนุญาตให้ผู้ใช้ไปยังกิจกรรม

• หากข้อจำกัด UX ของรถยนต์มีผลบังคับใช้ (เช่น รถกำลังเคลื่อนที่) ราคานี้ควร ปิดใช้ได้ เนื่องจากกิจกรรมการตั้งค่าไม่ใช่ UI ที่เพิ่มประสิทธิภาพไดรเวอร์

การจัดการข้อผิดพลาดและการลงชื่อเข้าใช้ที่จำเป็น

สื่อจะโต้ตอบกับแอปสื่อผ่านทาง Android Media Session API ส่วนหนึ่งของการเปลี่ยนแปลงนี้ API สื่อจะได้รับ PlaybackState ซึ่งจะสื่อสารสถานะปัจจุบันของแอปสื่อ

ขั้นตอนการลงชื่อเข้าใช้จะเริ่มต้นเมื่อแอปสื่อมีการเปลี่ยนแปลง PlaybackState ถึง STATE_ERROR, รวมถึงรหัสข้อผิดพลาดที่เฉพาะเจาะจง (ดูรายละเอียดด้านล่าง) เมื่อใด เกิดขึ้น สื่อจะแสดงคำอธิบายข้อผิดพลาดและโอกาสในการนำทางไปยังกิจกรรมการลงชื่อเข้าใช้ ที่พัฒนาโดยแอปสื่อ

แอปสามารถใช้ขั้นตอนเดียวกันนี้เพื่อส่งสัญญาณแจ้งสถานการณ์ข้อผิดพลาดอื่นๆ (เช่น ข้อผิดพลาดในการเชื่อมต่อเซิร์ฟเวอร์)

รูปที่ 4 การจัดการข้อผิดพลาด

สื่อต้องตรวจสอบอินพุตต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการจัดการข้อผิดพลาด PlaybackState ตามปกติ

• รหัสข้อผิดพลาด PlaybackState รายการเท่ากับ PlaybackStateCompat#ERROR_CODE_AUTHENTICATION_EXPIRED สัญญาณนี้ กำหนดให้แอปสื่อต้องลงชื่อเข้าใช้เพื่อดำเนินการต่อ รหัสข้อผิดพลาดอื่นๆ อาจมีลักษณะดังนี้ ที่ได้รับ ซึ่งจะบ่งบอกถึงสถานการณ์ข้อผิดพลาดประเภทอื่นๆ

• PlaybackState ข้อความแสดงข้อผิดพลาด (ตั้งค่าโดยแอปสื่อโดยใช้ วันที่ PlaybackStateCompat.Builder#setErrorMessage ) มีแอตทริบิวต์ คำอธิบายที่มนุษย์อ่านได้ (เช่น "คุณไม่ได้ลงชื่อเข้าใช้") ข้อความนี้ต้องแสดงต่อ และผู้ใช้จะต้องเพิ่มประสิทธิภาพสิ่งรบกวนสมาธิ (DO)

• PlaybackState สามารถรวมบริการเสริมต่อไปนี้ (ตั้งค่าตามสื่อ) ได้ แอปที่มี PlaybackStateCompat.Builder#setExtras ) ด้วยคีย์ต่อไปนี้

  • android.media.extras.ERROR_RESOLUTION_ACTION_LABEL ตั้งค่าเป็นสตริงที่ มีข้อความที่มนุษย์อ่านได้ซึ่งจะแสดงบนปุ่มที่ผู้ใช้แตะเพื่อเริ่มต้น ขั้นตอนการลงชื่อเข้าใช้

  • android.media.extras.ERROR_RESOLUTION_ACTION_INTENT ตั้งค่าด้วย PendingIntent เป็น แสดงขึ้นเมื่อผู้ใช้คลิกปุ่มที่กล่าวไว้ด้านบน ช่วงเวลานี้ PendingIntent ชี้ไปที่กิจกรรมการลงชื่อเข้าใช้ที่กำหนดเองซึ่งใช้งานโดยแอปสื่อเดียวกัน

• สถานะ PlaybackState เท่ากับ STATE_ERROR ซึ่งสัญญาณนี้จะบ่งบอกว่าคุณไม่สามารถดำเนินการอื่นๆ ได้จนกว่าการลงชื่อเข้าใช้จะเสร็จสมบูรณ์