开发简介

当前车机平台的现状

目前快应用平台与车机提供商合作适配的设备，有以下几个特点：

1. 设备屏幕采用横屏展示，不支持横竖屏旋转；
2. 设备屏幕长宽比为：16:6，如：分辨率为：1920X720；
3. 应用渲染时，并非以全屏宽的方式展现；即：应用的可渲染区域只有其中的部分屏幕宽，比如：以上屏幕分辨率下，某款车机上快应用的可视区域为：1536X720；

屏幕的适配

围绕车机设备的屏幕的适配开发，开发者可能需要考虑以下几个方面：

1. 横屏设置

开发者可以使用orientation属性设置 应用级别 或者 页面级别 的屏幕朝向，应用级别定义在display属性中，页面级别定义在具体的每个页面中；

详情请参考官方文档：manifest.json中的orientation属性

2. 使用dp方式的单位

由于车机中的快应用，属于非全屏渲染的方式，不适合采用以往同等比例缩放的px单位的效果，因此此处推荐开发者使用dp方式开发；

关于dp的布局方式，请参考上一份文档：非等比例的屏幕适配，作为临时的解决方案，设置 device-width时并在代码中使用px暂时替代dp，来达到同等效果；

3. 当前车机中常见屏幕尺寸的类型

优先适配的屏幕分辨率列表如下：

其中，可用宽度与可用高度是快应用可以使用的最大尺寸。因为系统常驻导航栏会占用部分屏幕空间，可用宽度与可用高度会分别小于或等于屏幕的宽度与高度。

4. 自适应布局

车机的分辨率变化很大，为了获得最佳的显示效果，应用的页面布局需要能够自适应。

栅格化是前端开发中比较常见的一种布局方式，它提供了一套友好美观的CSS预定义配置；

在没有设计师定稿的情况下，能够有效的帮助开发者编写得体简单的页面形态；

栅格化的主要特点有两个：1) 每行定义固定的列数值；2) 定义常见几种不同的屏幕尺寸类型；

提示：栅格化不是页面自适应的唯一方式，开发者也可以自由定义，此处提供一个示例代码。

语音控制

由于车机的特殊性，语音是车机上一个非常强的需求。快应用在车机上新增了语音能力，可以通过语音使用快应用的各种功能。

快应用提供了语音接口，支持可见即可说和NLP两种语音能力：

• 可见即可说指的是，快应用在页面元素上配置好语音标签（vtags和vindex），用户的语音只要命中了页面元素的语音标签，就可以完成操作;
• NLP指的是，开发者可以自由的使用语音表达意图，语音引擎理解意图和关键信息后，转给快应用处理并返回响应。

详情见语音交互和语音开发。

车机按键

车机上会有专门的物理按键来快速完成任务，快应用在可以支持的时候，必须适配这些物理按键。

车机上的物理按键包括：

1. KEYCODE_MEDIA_PREVIOUS（88） 上一个
2. KEYCODE_MEDIA_NEXT（87） 下一个
3. KEYCODE_MEDIA_PLAY（126） 播放
4. KEYCODE_MEDIA_PAUSE（127） 暂停
5. KEYCODE_MEDIA_PLAY_PAUSE（85） 播放/暂停

快应用可以在组件或页面的onKey事件中响应这些按键。如果快应用未响应按键，框架会将按键事件转为为音视频播放接口和组件的事件。

对于音频播放，快应用必须支持play、pause、stop、previous、next这几个事件。对于视频播放，快应用必须支持start、pause这几个事件。在快应用未响应播放控制按键时，快应用框架会默认触发这些事件，实现对多媒体按键的支持。

除此之外，视频播放如果支持切换剧集，还必须支持KEYCODE_MEDIA_PREVIOUS和KEYCODE_MEDIA_NEXT两个按键，来实现上一集和下一集的切换。

兼容性

车机与手机的生态有很大不同，因此很多第三方服务接口不能使用，比如各种支付接口。不支持的接口，会在本文档的标题上标记【车机不支持】。如果要在车机应用中实现支付，需要快应用显示二维码，由用户用手机扫码支付。

上线审核

车机与手机相比有很多不同的地方，快应用必须进行妥善适配，才能提供好的用户体验，才能通过上线审核。

车机快应用必须适配的功能包括：

1. 支持横屏展示，并满足横屏交互规范；
2. 对于音视频应用，必须能够使用语音控制播放，并且能使用多功能按键进行操作。

因为车机和手机的不同，大部分快应用都需要分别开发车机版和手机版两个版本，这两个版本必须使用不同的包名。建议在车机版的包名上增加.auto后缀来进行区别。