文档管理中心

数据交互

交互说明

HiCar为车机与手机侧的HiCar App间的数据交互约定了一系列的接口,用于在车机与HiCar App之间进行车辆控制、车辆属性传输等。根据接口传递数据的不同,区分为:

  • 非基于JSON格式的数据接口:主要用于在SDK初始化时,车机上报一些固定信息,例如驾驶位置、车机类型等。
  • 基于JSON格式的数据接口:主要用于在车机和HiCar App间通过请求/响应的方式传输可变的信息,例如车辆速度、车辆行驶状态等。不同的数据交互接口,在接收和发送时通过Data Type字段进行区分。

交互流程

图1 车机与HiCar App数据交互流程

Android车机可以通过HiCar SDK提供的接口与HiCar App进行数据交互:

  • 车机接收HiCar App发送的数据(相关接口/方法:CarListener::onDataReceive(String deviceId, int dataType, byte[] data)
  • 车机向HiCar App发送数据(相关接口/方法:HiCarAdapter::sendCarData(int dataType, byte[] data)

Linux车机可以通过HiCar SDK提供的接口与HiCar App进行数据交互:

  • 车机接收HiCar App发送的数据(相关接口/方法:DataReceive(const char *deviceId, uint32_t idLen, int dataType, char *data, uint32_t dataLen)
  • 车机向HiCar App发送数据(相关接口/方法:HiCarSendData(HICAR_HANDLE handle, CarDataType dataType, uint8_t* data, uint32_t size)

支持的数据交互类型

目前在车机与HiCar App间交互的数据类型,以及该数据类型支持的HiCar App及系统版本如表1所示。

表1 DATA TYPE定义
展开

序号

DATA TYPE

类型值

类型含义

支持的HiCar App起始版本

支持的手机系统起始版本

1

DATA_TYPE_HOTWORD

2

车机侧唤醒HiCar语音交互

10.1.0.710

EMUI 10.1

2

DATA_TYPE_VEHICLE_CONTROL

500

车辆空调、车窗、天窗控制

10.1.0.710

EMUI 10.1

3

DATA_TYPE_DAY_NIGHT_MODE

501

深浅模式

10.1.0.710

EMUI 10.1

4

DATA_TYPE_BRAND_ICON_DATA

502

车辆品牌名称及图标

10.1.0.710

EMUI 10.1

5

DATA_TYPE_NAV_FOCUS

503

导航焦点

11.0.1.350

EMUI 10.1

6

DATA_TYPE_CALL_STATE_FOCUS

504

通话状态

11.0.1.350

EMUI 10.1

7

DATA_TYPE_VOICE_STATE

505

语音状态

11.0.1.350

EMUI 10.1

8

DATA_TYPE_DRIVING_MODE

506

行驶状态

11.0.1.350

EMUI 10.1

9

DATA_TYPE_CAR_STATE

507

低油低电低压状态

11.0.1.350

EMUI 10.1

10

DATA_TYPE_SERVICE_CHANNEL

508

车服务通道

11.0.1.350

EMUI 11.0

11

DATA_TYPE_KEYCODE

509

车机物理快捷键

11.0.1.350

EMUI 10.1

12

DATA_TYPE_SENSOR_DATA

510

车辆传感器数据

12.2.0.320

EMUI 11.0

13

DATA_TYPE_NET_SERVICE

511

共享上网

11.1.0.330

EMUI 11.0

14

DATA_TYPE_META_DATA_ABILITY

514

元数据能力

13.2.0.390

HarmonyOS 2.0

15

DATA_TYPE_MEDIA_META_DATA

515

音频元数据

13.2.0.390

HarmonyOS 2.0

16

DATA_TYPE_CALL_META_DATA

516

通话元数据

13.2.0.390

HarmonyOS 3.0

17

DATA_TYPE_NAV_META_DATA

517

导航元数据(暂不支持)

13.2.0.390

HarmonyOS 2.0

18

DATA_TYPE_USERACTIVEDISCONNECT

518

主动断开车机连接通知

11.2.0.360

EMUI 10.1

19

DATA_TYPE_VOICE_PROMPT

519

语音提示音播报通知

11.2.0.360

EMUI 10.1

20

DATA_TYPE_OPERATE_SCREEN

521

车机屏幕息屏/亮屏

11.2.0.360

EMUI 10.1

21

DATA_TYPE_TAKE_PICTURE

522

车辆摄像头拍照

11.2.0.360

EMUI 10.1

22-26

预留它用。

27

DATA_TYPE_AA_APPS

528

融合桌面应用列表

14.2.0.150

HarmonyOS 3.1

28

DATA_TYPE_AA_APP_OPERATION

529

融合桌面应用操作

14.2.0.150

HarmonyOS 3.1

29

DATA_TYPE_SCENE_META_DATA

530

场景元数据,包括天气、日历、情景智能等数据

14.2.0.150

HarmonyOS 2.0

30

DATA_TYPE_MESSAGE_META_DATA

531

消息元数据

14.2.0.150

HarmonyOS 2.0

31

DATA_TYPE_SCREEN_CAST_AUTHORIZED

532

融合桌面HiCar前后台切换

14.2.0.150

HarmonyOS 3.1

32

DATA_TYPE_FOREGROUND_APP

533

HiCar当前的前台应用

13.1.0.510

HarmonyOS 3.1

33

DATA_TYPE_CODEC_ABILITY

535

车机视频流解码能力

14.2.0.150

HarmonyOS 4.0

在 指南 中进行搜索
请输入您想要搜索的关键词