建構適用於 Android Automotive OS 的影片應用程式

除了「建構可在車輛停妥時使用的 Android Automotive OS 應用程式」一文所述的規範外,影片應用程式還有一些專屬規定。

將應用程式標示為影片應用程式

如要指出您的應用程式支援影片功能,請在專案的 res/xml/ 目錄中加入名稱為 automotive_app_desc.xml 的 XML 檔案。此檔案應包含下列內容:

<automotiveApp>
  <uses name="video"/>
</automotiveApp>

接著,請在資訊清單的 <application> 元素中加入下列 <meta-data> 元素,以參照 XML 檔案:

<meta-data
  android:name="com.android.automotive"
  android:resource="@xml/automotive_app_desc"/>

開車時支援音訊功能

開車時的音訊功能為 Beta 版功能
只有搶先體驗合作夥伴可以發布支援行車時音訊的應用程式。這項功能目前為 Beta 版,您可以按照本節的說明,為應用程式做好支援準備。

一般來說,當使用者體驗限制生效時,所有影片應用程式都必須暫停播放,如「確保沒有任何分心活動」一文所述。

不過,部分車輛在啟用使用者體驗限制時,可顯示專為駕駛者設計的播放控制項,讓系統繼續播放音訊。

針對支援開車時播放音訊的應用程式,提供最佳化播放控制選項。
圖 1:針對支援行車時聆聽音訊的應用程式,提供最佳化播放控制選項。

聲明應用程式支援行車時的音訊功能

如要指出應用程式支援在行車時播放音訊,請在資訊清單中新增下列 <uses-feature> 元素:

<application ...>
    ...
    <uses-feature android:name="com.android.car.background_audio_while_driving" android:required="false">
    ....
</application>

支援背景播放

由於系統使用者體驗限制會隱藏應用程式的活動,因此應用程式必須支援背景播放功能,才能在行車時繼續播放音訊。如要進一步瞭解如何使用 Media3 程式庫完成這項操作,請參閱「使用 MediaSessionService 在背景播放」。

您的應用程式必須發布包含應用程式 MediaSessionMediaStyle 通知。如果您使用 MediaSessionService,系統會預設為您處理

判斷是否需要支援

如要判斷裝置是否支援行車時的音訊功能,您可以使用 androidx.car.app:app 程式庫中的 CarFeatures 類別。

CarFeatures.isFeatureEnabled(context, CarFeatures.FEATURE_BACKGROUND_AUDIO_WHILE_DRIVING)

您可以根據應用程式執行裝置的功能,利用這項資訊修改應用程式的行為。在未支援行車時播放音訊的裝置上,應用程式仍必須符合 DD-2 規範。

開車時測試音訊

如要測試導入作業,您可以使用支援行車時音訊的模擬器映像檔模擬行車

常見問題

是否支援 Widevine 數位版權管理?

是,Android Automotive OS 支援 Widevine 數位版權管理 L3。