示例中心
功能在线体验
控制台

高德 开发 高德地图车机版 开发指南 C++平台 系统交互

更新时间:2018年05月28日

1. U盘状态通知

  AmapApiRetCode AMapUDiskInfoNotify(STGGDevInfo *pStDevInfo) 

  • 函数说明

 系统侧上报U盘的插拔状态、容量信息给导航。

 时序说明:

  1. 插/拔的时候通知导航。

  2、系统收到导航开始运行的状态通知后上报。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pStDevInfo

U盘状态信息结构体指针,具体成员如下:

bool bMount; /**<  U盘的挂载状态,false - 未挂载, true - 挂载*/

EGDiskType eDiskType; /**< 存储类型:外置/内置,一般设置为外置的即可,U盘会用于离线数据更新 */

char acMountPath[256];/**< U盘的挂载路径*/

unsigned int un32TotalSize;/**< 总空间的大小,单位是兆*/

unsigned int un32FreeSize;/**< 剩余可用空间的大小,单位是兆*/


  • 相关函数
  • 典型应用

  离线地图升级、语音包升级。

2. 系统上报UUID

AmapApiRetCode AMapUUIDNotify(char* pUUID)

  • 函数说明

 系统侧上报用来唯一标识车机的ID给导航。长度范围:16-32个字符,字符组成只能包含数字和大写字母。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pUUID 

车辆的唯一标识


  • 相关函数
  • 典型应用

  UUID在导航中的应用很多,主要涉及激活、后台请求等关键场景。

3. 导航请求UUID

AmapApiRetCode AMapUUIDReqCbReg(FUNC_UUIDReqResponse pFuncCb)

  • 函数说明

 系统侧注册回调接收导航侧UUID的请求,并将结果反馈给导航。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncCb

接收导航请求UUID的回调函数指针


 回调函数定义     typedef int (*FUNC_UUIDReqResponse)()

  • 相关函数

 AMapUUIDNotify

  • 典型应用

4. 硬按键消息通知

 AmapApiRetCode AMapHardKeyPub(EHardKeyId key, EHardKeyState state) 

  • 函数说明

 系统侧上报车机硬按键的状态给导航。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 key

E_HK_ID_BACK, /**< BACK */

E_HK_ID_ENTER, /**< ENTER */

E_HK_ID_LEFT, /**< 左 */

E_HK_ID_UPPER_LEFT, /**< 左上 */

E_HK_ID_UP, /**< 上 */

E_HK_ID_UPPER_RIGHT, /**< 右上 */

E_HK_ID_RIGHT, /**< 右 */

E_HK_ID_LOWER_RIGHT, /**< 右下 */

E_HK_ID_DOWN, /**< 下 */

E_HK_ID_LOWER_LEFT, /**< 左下 */

E_HK_ID_PREV, /**< 左旋 */

E_HK_ID_NEXT, /**< 右旋 */

E_HK_ID_MAP, /**< MAP硬按钮*/

E_HK_ID_MENU, /**< 主菜单硬按钮 */

E_HK_ID_AUDIO, /**< 音频硬按钮 */

E_HK_ID_CAMERA, /**< 摄像头硬按钮 */

E_HK_ID_DAYNIGHT, /**< 白天/黑夜硬按钮 */

E_HK_ID_FROWARD, /**< 快进 硬按钮*/

E_HK_ID_BACKWARD, /**< 快退 硬按钮*/

E_HK_ID_POWER, /**< POWER 硬按钮*/


 state

E_HK_STATE_RELEASE, /**< 弹起 */

E_HK_STATE_PRESS, /**< 按下 */

E_HK_STATE_LONG_PRESS, /**< 长按 */


  • 相关函数
  • 典型应用

  车机旋钮、方向键功能。

5. 时间同步

AmapApiRetCode AMapGpsTimeReq()

  • 函数说明

 系统侧向导航请求GPS时间来同步系统时间。

  • 参数说明
  • 相关函数

  AMapGPSTimeRcvCbReg

  • 典型应用

  车机时间不准确的时候,可以请求导航的GPS时间进行同步。


AmapApiRetCode AMapGPSTimeRcvCbReg(FUNC_GPSTimeSyncRcv pFunc)

  • 函数说明

  系统侧注册回调接收导航侧返回的GPS时间。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFunc

接收GPS时间回调函数指针


 回调函数定义       typedef int (*FUNC_GPSTimeSyncRcv)(bool bValid, STGGpsTime* pTime)

参数

参数说明

 bValid

true - gps定位

false - gps未定位

 pTime

只有当GPS定位的时候,这个时间才是有效的,具体成员如下:

short n16Year;         /**< 年 */

char n8Month;          /**< 月 */

char n8Day;            /**< 日 */

char n8Hour;           /**< 时 */

char n8Minute;         /**< 分 */

char n8Second;         /**< 秒 */

  • 相关函数

  AMapGpsTimeReq

  • 典型应用

6. 多语言切换

 AMAPAPI_DLL_EXPORT AmapApiRetCode AMapLanguageChange(ELanguageType eType)

  • 函数说明

 切换导航的语言风格。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 eType

GAL_LANG_INVALID = -1, /**< 无效 */

GAL_LANG_AR, /**< 阿拉伯语 */

GAL_LANG_BA, /**< 保加利亚 */

GAL_LANG_CA, /**< 嘉泰罗尼亚 */

GAL_LANG_CS, /**< 捷克 */

GAL_LANG_DA, /**< 丹麦语 */

GAL_LANG_DE, /**< 德国 */

GAL_LANG_EL, /**< 希腊 */

GAL_LANG_EU, /**< 巴斯克语 */

GAL_LANG_EN_AU, /**< 英语-澳洲 */

GAL_LANG_EN_CA, /**< 英语-加拿大 */

GAL_LANG_EN_GB, /**< 英语-英国 */

GAL_LANG_EN_US, /**< 英语-美国 */

GAL_LANG_ES, /**< 西班牙 */

GAL_LANG_ET, /**< 爱沙尼亚 */

GAL_LANG_FA, /**< 波斯语 */

GAL_LANG_FI, /**< 芬兰语 */

GAL_LANG_FR, /**< 法语 */

GAL_LANG_GL, /**< 加利西亚 */

GAL_LANG_HY, /**< 亚美尼亚 */

GAL_LANG_HE, /**< 希伯来语 */

GAL_LANG_HI, /**< 北印度语 */

GAL_LANG_HU, /**< 匈牙利语 */

GAL_LANG_HR, /**< 克罗埃西亚 */

GAL_LANG_IS, /**< 冰岛语 */

GAL_LANG_ID, /**< 印尼 */

GAL_LANG_IT, /**< 意大利 */

GAL_LANG_JA, /**< 日本 */

GAL_LANG_KA, /**< 格鲁吉亚洲 */

GAL_LANG_KN, /**< 卡纳达语 */

GAL_LANG_KO, /**< 韩国 */

GAL_LANG_LV, /**< 拉托维亚 */

GAL_LANG_LT, /**< 立陶宛 */

GAL_LANG_MK, /**< 马其顿 */

GAL_LANG_MS, /**< 马来语-马来西亚 */

GAL_LANG_MR, /**< 马拉地语 */

GAL_LANG_MN, /**< 蒙古语 */

GAL_LANG_NL, /**< 荷兰 */

GAL_LANG_NO, /**< 挪威 */

GAL_LANG_PL, /**< 波兰 */

GAL_LANG_PT, /**< 葡萄牙语 */

GAL_LANG_RO, /**< 罗马尼亚语 */

GAL_LANG_RU, /**< 俄语 */

GAL_LANG_SA, /**< 印度梵文 */

GAL_LANG_SG, /**< 阿尔巴尼亚 */

GAL_LANG_SR, /**< 塞尔维亚 */

GAL_LANG_SK, /**< 斯洛伐克 */

GAL_LANG_SV, /**< 瑞典 */

GAL_LANG_TA, /**< 坦米尔 */

GAL_LANG_TH, /**< 泰国 */

GAL_LANG_TR, /**< 土耳其 */

GAL_LANG_UK, /**< 乌克兰 */

GAL_LANG_VI, /**< 越南 */

GAL_LANG_ZH_CN, /**< 中国大陆 */

GAL_LANG_ZH_HK, /**< 中国香港 */

GAL_LANG_ZH_MO, /**< 中国澳门 */

GAL_LANG_ZH_TW, /**< 中国台湾 */

GAL_LANG_MAX /**< 标识最大的语言类别值 */



  • 相关函数
  • 典型应用

  导航多语言切换。

7. 跳转到导航的UI界面

AmapApiRetCode AMapShowNaviUiSnd(EGNaviUiType eType)

  • 函数说明

 跳转到指定类型的导航UI界面。

  • 参数说明

参数

参数说明

是否必填

格式样例

 eType

E_NAVI_UI_SEARCH, /**< 搜索界面*/

E_NAVI_UI_FAVORITE, /**< 收藏夹界面 */

E_NAVI_UI_MAPUPDATE,/**< 地图数据升级界面 */

E_NAVI_UI_VERSONINFO, /**< 地图版本信息界面 */

E_NAVI_UI_RESET, /**< 恢复出厂设置界面 */

E_NAVI_UI_GPSINFO, /**< 搜星界面 */

E_NAVI_UI_CARNUMBER, /**< 车牌设置界面 */

E_NAVI_UI_HOME_COMPANY_SETTING, /**< 家/公司设置界面 */


  • 相关函数

AMapShowNaviUicbReg

  • 典型应用

  VR回家/公司的情景,当家/公司未设置时,要求跳转到导航内部的家/公司设置界面。

AmapApiRetCode AMapShowNaviUicbReg(FUNC_ShowNaviUiRcv pFuncCb)

  • 函数说明

  系统侧注册回调接收导航侧执行UI界面显示的结果通知

  • 参数说明

 参数

参数说明

是否必填

格式样例

 pFuncCb

回调函数指针


 回调函数定义       typedef int (*FUNC_ShowNaviUiRcv)(EGNaviUiType eType, bool bSucess)

参数

参数说明

 eType

UI界面的类型

 bSucess

打开UI界面的执行结果。true - 成功 false - 失败

  • 相关函数

  AMapShowNaviUiSnd

  • 典型应用

8. 设备安装角通知

AmapApiRetCode AMapGroyAngleNotify(STGDeviceAngleInfo *pAngleInfo)

  • 函数说明

  系统侧将车机设备的安装角通知导航。

  时序说明:当系统接收到导航开始运行的消息之后发出。

  • 参数说明

参数

参数说明

是否必填

格式样例

 pAngleInfo

int n32HasMountAngle;/**< 安装角是否有效 0 - 无效 1 - 有效 */

double f64YawMountAngle; /**< 偏航角 -- z*/

double f64PitchMountAngle; /**< 俯仰角 -- x*/

double f64RollMountAngle; /**< 翻滚角  -- y*/


  • 相关函数
  • 典型应用

9. 屏幕触摸控制权归属通知

AmapApiRetCode AMapTouchOwnerSnd(EGTouchOwner wOwner)

  • 函数说明

  系统侧通知导航当前的屏幕触控权归属于谁。当归属权属于系统的时候,导航内部的触摸控制要全部释放给系统;反之,系统要将触摸控制权释放给导航。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 wOwner

E_TOUCH_OWNER_UNKNOW = -1, /**< 未知类型 */

E_TOUCH_OWNER_NAVI, /**< 导航拥有触摸的控制权 */

E_TOUCH_OWNER_SYSTEM, /**< 系统拥有触摸的控制权 */


  • 相关函数
  • 典型应用

10. 系统同步时间制式给导航

AMapTimeFormateNotify(STTimeFormat eTmFormate)

  • 函数说明

  系统侧同步当前的时间制式(12小时制/24小时制)给导航,导航根据新的时间制式进行转换显示。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 eTmFormate

eTimeFormat12,  /**< 12小时制 */

eTimeFormat24   /**< 24小时制 */


  • 相关函数
  • 典型应用

 系统设置界面,选择新的时间制式,同步给导航。



示例中心 功能
在线体验
常见问题