Các thành phần hệ thống và luồng người dùng

Sơ đồ sau minh họa các thành phần tương tác với Media:

Hình 1. Các thành phần hệ thống

Các yếu tố trong hình này được mô tả trong bảng:

Luồng người dùng

Ra mắt ứng dụng truyền thông

Quá trình khởi chạy Media xuất hiện bên dưới.

Hình 2. Khởi chạy ứng dụng đa phương tiện

Phương tiện phải được khởi chạy bằng cách sử dụng CAR_INTENT_ACTION_MEDIA_TEMPLATE ẩn sau đây. Mục đích này có thể có các thông tin bổ sung sau:

• android.car.intent.extra.MEDIA_COMPONENT ( tùy chọn ). Chuỗi bổ sung để thể hiện tên thành phần được làm phẳng của MediaBrowserService trong ứng dụng phương tiện mà Phương tiện sẽ kết nối. Nếu không được cung cấp, Media sẽ hiển thị ứng dụng media hiện được chọn. Mục đích này được sử dụng từ các điểm đầu vào sau:

  • Giao diện người dùng hệ thống. Được sử dụng để quay lại trải nghiệm Media hoặc để bắt đầu sử dụng nó lần đầu tiên. Trong trường hợp này, Intent ở trên sẽ được sử dụng mà không có bất kỳ tính năng bổ sung nào để khiến Media hiển thị ứng dụng media hiện được chọn.

  • Màn hình chính, Trợ lý và Trung tâm thông báo. Người dùng có thể điều hướng đến Media để hiển thị ứng dụng media hiện được chọn. Trong mọi trường hợp, Ý định ngầm định không có phần bổ sung sẽ được kích hoạt.

  • Trình khởi chạy ứng dụng. Khi người dùng chọn một ứng dụng đa phương tiện từ Trình khởi chạy ứng dụng, mục đích trên sẽ bao gồm phần bổ sung CAR_EXTRA_MEDIA_COMPONENT chứa ứng dụng đa phương tiện đã chọn. Phương tiện chỉ định đây là ứng dụng mới được chọn và kết nối với nó. Để biết chi tiết, hãy xem phần bên dưới, Tích hợp Trình khởi chạy ứng dụng với Phương tiện.

Trình khởi chạy ứng dụng để tích hợp phương tiện

Ứng dụng đa phương tiện không được phép cung cấp bất kỳ hoạt động nào được chú thích bằng danh mục android.intent.category.LAUNCHER . Do đó, Trình khởi chạy ứng dụng (hoặc trình khởi chạy ứng dụng tương đương) phải triển khai logic đặc biệt để giải quyết vấn đề tích hợp nguồn phương tiện:

• Trình khởi chạy ứng dụng phải quét hệ thống để tìm các gói triển khai MediaBrowserService.SERVICE_INTERFACE . Đối với các gói này, Trình khởi chạy ứng dụng sẽ tìm nạp biểu tượng dịch vụ tương tự như biểu tượng được sử dụng để tìm nạp các hoạt động khác.

• Sau đó, App Launcher sẽ kết hợp các gói này với các gói triển khai hoạt động android.intent.category.LAUNCHER . Nếu một ứng dụng cung cấp hoạt động triển khai MediaBrowserService và trình khởi chạy thì dịch vụ đó sẽ được ưu tiên.

  Tính đến thời điểm viết bài này, không có ứng dụng nguồn phương tiện nào có thể cung cấp hoạt động của trình khởi chạy.

• Bạn có thể tìm thấy ví dụ về logic này trong mã AOSP tại AppLauncherUtils#getAllLauncherApps() .

Tùy chọn cấu hình và luồng đăng nhập

Ứng dụng đa phương tiện có thể bao gồm hoạt động Cài đặt được tối ưu hóa cho xe. Hoạt động như vậy có thể được sử dụng để triển khai các luồng người dùng không được API Android Media xử lý, ví dụ:

• Đăng nhập
• Đăng xuất
• Chuyển đổi tài khoản
• Hiển thị nơi người dùng hiện đang đăng nhập (nếu có)
• Cấu hình dịch vụ

Hình 3. Luồng đăng nhập

Hoạt động Cài đặt này được ứng dụng đa phương tiện khai báo bằng bộ lọc mục đích sau:

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

Phương tiện truyền thông phải thực hiện logic sau:

• Kiểm tra xem ứng dụng đa phương tiện hiện được chọn có bao gồm hoạt động với Bộ lọc ý định nhất định hay không.

• Nếu vậy, hãy cho phép người dùng điều hướng đến hoạt động.

• Nếu Hạn chế UX trên ô tô có hiệu lực (ví dụ: ô tô đang di chuyển), khả năng chi trả này sẽ bị tắt vì hoạt động Cài đặt không phải là Giao diện người dùng được tối ưu hóa cho người lái.

Xử lý lỗi và yêu cầu đăng nhập

Phương tiện tương tác với các ứng dụng phương tiện thông qua API phiên phương tiện của Android. Là một phần của API này, Media nhận được một đối tượng PlaybackState , đối tượng này truyền đạt trạng thái hiện tại của ứng dụng media.

Quá trình đăng nhập bắt đầu khi ứng dụng đa phương tiện thay đổi PlaybackState thành STATE_ERROR , bao gồm mã lỗi cụ thể (xem chi tiết bên dưới). Khi điều này xảy ra, Phương tiện hiển thị mô tả lỗi và khả năng điều hướng đến hoạt động đăng nhập do ứng dụng phương tiện triển khai.

Ứng dụng có thể sử dụng luồng tương tự này để báo hiệu các tình huống lỗi khác (ví dụ: lỗi kết nối máy chủ).

Hình 4. Xử lý lỗi

Là một phần của quá trình xử lý lỗi PlaybackState thông thường, Phương tiện phải kiểm tra đầu vào sau.

• Mã lỗi PlaybackState bằng PlaybackStateCompat#ERROR_CODE_AUTHENTICATION_EXPIRED . Điều này báo hiệu rằng ứng dụng đa phương tiện yêu cầu đăng nhập để tiếp tục hoạt động. Có thể nhận được các mã lỗi khác, mã này sẽ cho biết các loại tình huống lỗi khác.

• Thông báo lỗi PlaybackState (do ứng dụng đa phương tiện đặt bằng phương thức PlaybackStateCompat.Builder#setErrorMessage ) chứa phần giải thích mà con người có thể đọc được (ví dụ: "Bạn chưa đăng nhập."). Thông báo này phải được hiển thị cho người dùng và nó phải được tối ưu hóa sự phân tâm khi lái xe (DO).

• Theo tùy chọn, PlaybackState có thể bao gồm các tính năng bổ sung sau (do ứng dụng đa phương tiện đặt bằng phương thức PlaybackStateCompat.Builder#setExtras ) bằng các phím sau.

  • android.media.extras.ERROR_RESOLUTION_ACTION_LABEL . Đặt thành một chuỗi chứa thông báo mà con người có thể đọc được để hiển thị trên nút mà người dùng chạm vào để bắt đầu luồng đăng nhập.

  • android.media.extras.ERROR_RESOLUTION_ACTION_INTENT . Đặt với PendingIntent sẽ được kích hoạt khi người dùng nhấp vào nút được đề cập ở trên. PendingIntent này trỏ đến hoạt động đăng nhập tùy chỉnh được triển khai bởi cùng một ứng dụng đa phương tiện.

• Trạng thái PlaybackState bằng STATE_ERROR . Điều này báo hiệu rằng không thể thực hiện thao tác nào khác cho đến khi quá trình đăng nhập hoàn tất.