Медиаприложения, использующие шаблоны библиотеки автомобильных приложений, могут настраивать просмотр и воспроизведение мультимедиа, гарантируя при этом оптимизацию для экранов автомобиля и сводя к минимуму отвлекающие факторы во время вождения.
В этом руководстве предполагается, что у вас уже есть медиа-приложение, воспроизводящее аудио на телефоне, и что ваше медиа-приложение соответствует архитектуре медиа-приложений Android . Библиотека автомобильных приложений дает вам возможность заменить интерфейс приложения шаблонами, а не теми, которые созданы с использованием структуры данных MediaBrowser Build media apps for cars . Вам по-прежнему необходимо предоставить MediaSession для управления воспроизведением и MediaBrowserService , который используется для рекомендаций и других интеллектуальных интерфейсов.
Настройте манифест вашего приложения
В дополнение к шагам, описанным в разделе Использование библиотеки приложений Android for Cars , для шаблонных медиа-приложений требуется следующее:
Укажите поддержку категории в вашем манифесте
Вашему приложению необходимо объявить категорию автомобильного приложения androidx.car.app.category.MEDIA в фильтре намерений CarAppService .
<application>
...
<service
...
android:name=".MyCarAppService"
android:exported="true">
<intent-filter>
<action android:name="androidx.car.app.CarAppService" />
<category android:name="androidx.car.app.category.MEDIA"/>
</intent-filter>
</service>
...
<application>
Чтобы получить доступ к MediaPlaybackTemplate , вашему приложению также необходимо объявить разрешение androidx.car.app.MEDIA_TEMPLATES в своем файле манифеста:
<manifest ...>
...
<uses-permission android:name="androidx.car.app.MEDIA_TEMPLATES"/>
...
</manifest>
Установите минимальный уровень API автомобильного приложения
Медиаприложения, использующие MediaPlaybackTemplate , поддерживаются только в CAL API 8. Убедитесь, что минимальный Car App API level установлен на 8.
<application ...>
...
<meta-data
android:name="androidx.car.app.minCarApiLevel"
android:value="8"/>
...
</application>
Объявить о поддержке Android Auto
Убедитесь, что в манифест вашего приложения включено следующее:
<application>
...
<meta-data android:name="com.google.android.gms.car.application"
android:resource="@xml/automotive_app_desc"/>
...
</application>
Затем добавьте объявление шаблона в automotive_app_desc.xml в ваших xml-ресурсах. Это должно выглядеть следующим образом:
<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
<uses name="media"/>
<uses name="template"/>
</automotiveApp>
Укажите значок атрибуции
Обязательно добавьте значок атрибуции для медиаприложений, созданных с использованием библиотеки автомобильных приложений.
Поддержка голосовых команд
Включите голосовое управление в своем приложении, чтобы пользователи могли выполнять общие действия без помощи рук. Более подробные инструкции по внедрению см. в разделе Поддержка голосовых действий для мультимедиа . При использовании шаблонного мультимедийного приложения, если вы получаете голосовую команду, вам не нужно обновлять MediaBrowserService результатами поиска. Вместо этого рассмотрите возможность добавления действия в шаблон воспроизведения мультимедиа, чтобы позволить пользователю находить больше контента на основе этого воспроизведения или поискового запроса. Поддержка голосовых команд необходима для соответствия рекомендациям по качеству VC-1 .
Создайте свой шаблон воспроизведения
MediaPlaybackTemplate отображает информацию о воспроизведении мультимедиа в вашем медиа-приложении Car App Library. Этот шаблон позволяет задать заголовок с названием и настраиваемыми действиями, в то время как информация о мультимедиа и элементы управления воспроизведением заполняются хостом на основе состояния MediaSession вашего приложения.
Рисунок 1: MediaPlaybackTemplate с действием заголовка для открытия очереди вверху.
В этом примере кода показано, как создать пример шаблона воспроизведения, который задает действие заголовка, позволяющее пользователю перейти на экран с очередью песен.
val playbackTemplate = MediaPlaybackTemplate.Builder()
.setHeader(
Header.Builder()
.setStartHeaderAction(Action.BACK)
.addEndHeaderAction(
Action.Builder()
.setTitle(model.context.getString(R.string.queue_button_title))
.setIcon(
CarIcon.Builder(
IconCompat.createWithResource(
model.context,
R.drawable.gs_queue_music_vd_theme_24,
))
.build())
.setOnClickListener(showQueueScreen())
.build())
.setTitle(model.context.getString(R.string.media_playback_view_title))
.build())
.build()
При использовании MediaPlaybackTemplate зарегистрируйте токен MediaSession с помощью MediaPlaybackManager в вашем CarAppService . Если этого не сделать, при отправке MediaPlaybackTemplate на хост будет отображена ошибка.
import androidx.car.app.media.MediaPlaybackManager
…
override fun onCreateSession(sessionInfo: SessionInfo): Session {
return object : Session() {
…
init {
lifecycle.addObserver(
LifecycleEventObserver { _, event ->
if (event == ON_CREATE) {
val token = ... // MediaSessionCompat.Token
(carContext.getCarService(CarContext.MEDIA_PLAYBACK_SERVICE) as MediaPlaybackManager)
.registerMediaPlaybackToken(token)
}
...
}
)
}
}
}
.registerMediaPlaybackToken необходим для предоставления информации о воспроизведении мультимедиа и элементов управления для Android Auto. Это также важно для хоста, чтобы создавать уведомления, специфичные для мультимедиа.
Организуйте медиа с помощью шаблонов
Чтобы организовать просмотр медиафайлов, таких как песни или альбомы, мы рекомендуем использовать SectionedItemTemplate , который позволяет использовать GridSection и RowSection вместе для создания макетов, которые сочетают списки изображений и текстовых элементов.
Рисунок 2: SectionedItemTemplate содержащий RowSection , за которым следует GridSection
Использование SectionedItemTemplate внутри TabTemplate
Одним из удобных способов категоризации медиафайлов в вашем приложении является использование SectionedItemTemplate внутри TabTemplate .
val template =
SectionedItemTemplate.Builder()...build();
val tabTemplate =
TabTemplate.Builder(tabCallback)
.setTabContents(TabContents.Builder(template).build)
.setHeaderAction(Action.APP_ICON)
…
.build();
Более подробную информацию о том, как разработать пользовательский интерфейс вашего медиа-приложения с использованием этих шаблонов, см. в разделе Медиа-приложения .
Переход к элементам управления воспроизведением
При просмотре медиа важно, чтобы пользователь мог быстро перейти к MediaPlaybackTemplate с минимальным отвлечением. Чтобы соответствовать требованиям качества MFT-1 , ваше приложение должно иметь возможность доступа к MediaPlaybackTemplate со всех экранов просмотра медиа.
Если вы используете SectionedItemTemplate , вы можете добиться этого, добавив плавающую кнопку действия, которая перенаправляет вас на экран воспроизведения мультимедиа. Для других шаблонов действие заголовка — это еще один способ добиться этого.