车载音视频App框架设计

简介

统一播放器提供媒体播放一致性的交互和视觉体验，减少各个媒体应用和场景独自开发的重复工作量，实现媒体播放链路的一致性，减少碎片化的Bug。本文面向应用开发者介绍如何快速接入媒体播放器。

主要功能：

1. 新设计的统一播放UI组件，视频支持的手势操作，包括左右滑拖动进度、左上下滑调节亮度、右上下滑调节音量、双击暂停/播放，同时对外暴露了长按手势接口应用可以实现类似快进快退功能；
2. 支持方控、Mini播放器、PSD的播控和状态显示，应用只需要申请媒体中心权限的license即可，支持媒体中心的状态保持和语音控制通道，需要APP中接入对应的接口；
3. 支持视频行车娱乐限制，非P档播放视频会暂停播放弹框提示；
4. 使用原生的的media3 1.3.0版本，支持原生的androidx 和framework media session；
5. 支持音频焦点自管理，包括电话状态的播控也基于音频焦点统一处理；

整体架构图如下

1. 应用通过配置UI，然后创建MediaController播放媒体；
2. controler端接入了行车娱乐限制的检测和提示；
3. service端实现了google原生的media3 session service；
4. 媒体中心通过mediasession和播放器连接；
5. 底层使用media3 exoplayer播放和音频焦点管理；

接入流程

1、配置依赖

implementation 'com.max.mediaplayer:uniteplayer:1.x.x

备注：uniteplayer中包含了视频控制UI组件，当只需要修复控制UI组件的bug时，可以更新整体uniteplayer播放器组件，也可以只增加UI组件的依赖，比如：implementation (‘com.max.media:media-video:1.2.0’)。

2、初始化

建议在application创建的时候调用初始化接口：

init(context: Context, isVideo: Boolean, enableMediaCenter: Boolean = false)

参数	说明
context	应用context
isVideo	是否视频应用，视频会初始化车机相关的adapterapi，音乐目前不会初始化
enableMediaCenter	需要远程方控、语音控制、mini播放器控制这些能力时设置为true，否则为false，默认为false

3、接入 UI 组件 （视频应用）

这里的UI组件只针对视频应用，音频应用的UI组件在媒体组件库中，参考媒体视频组件。

1）配置PlayerView

在布局中增加FlexPlayerView，视频内容显示和播控UI都在此view中，一般默认配置如下即可：

<com.max.uniteplayer.ui.FlexPlayerView
    android:id="@+id/player_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

其中播控UI是可单独接入的，若需定制，接入见视频组件接入文档。

2）配置视频渲染view

一般情况下不需要特别配置，支持的定制视频显示view参数如下：

比如在上面FlexPlayerView xml中用app:surface_type=“surface_view”

surface_type：surface类型，取值如下，默认是surface_view类型：

<attr name="surface_type" format="enum"> 
     <enum name="none" value="0"/>   
     <enum name="surface_view" value="1"/>  
     <enum name="texture_view" value="2"/>  
     <enum name="spherical_gl_surface_view" value="3"/>  
     <enum name="video_decoder_gl_surface_view" value="4"/>
 </attr>

resize_mode，取值如下，默认fit模式：

  <attr name="resize_mode" format="enum">  
    <enum name="fit" value&