高德 开发 高德地图车机版 开发指南 C++平台 显示相关
更新时间：2018年05月18日
1. 系统请求导航切换前后台
AmapApiRetCode AMapNaviForeBackSwithReq(EGNaviForceStat eStatus)
- 函数说明
系统请求导航进行前后台切换。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
eStatus | G_STATUS_UNKNOW = -1, /**< 未知操作类型 */ G_STATUS_BACK = 0, /**< 后台 */ G_STATUS_FRONT, /**< 前台 */ | 是 |
- 相关函数
AMapiForeGroundStatusRcvCbReg
- 典型应用
AmapApiRetCode AMapNaviForeGroundStatusRcvCbReg(FUNC_NaviForeGroundStatusRcv pFuncCb)
- 函数说明
系统注册回调接收导航前后台切换的结果。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
pFuncCb | 前后台切换结果回调函数指针 | 是 |
回调函数定义 typedef int (*FUNC_NaviForeGroundStatusRcv)(EGNaviForceStat estate,int n32Ret)
参数 | 参数说明 |
|---|---|
estate | G_STATUS_BACK = 0, /**< 后台 */ G_STATUS_FRONT, /**< 前台 */ |
n32Ret | 0 - 切换成功 1 - 切换失败 |
- 相关函数
AMapNaviForeBackSwithReq
- 典型应用
2. 导航主动请求前后台切换
AmapApiRetCode AMapNaviForeGroundResponseCbReg(FUNC_NaviForeGroundResponse pFuncCb)
- 函数说明
系统注册回调接收导航前后台切换的请求。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
pFuncCb | 接收导航前后台切换回调函数指针 | 是 |
回调函数定义 typedef int (*FUNC_NaviForeGroundResponse)(EGNaviForceStat eState)
参数 | 参数说明 |
|---|---|
eState | G_STATUS_BACK = 0, /**< 后台 */ G_STATUS_FRONT, /**< 前台 */ |
- 相关函数
- 典型应用
3. 系统请求导航改变窗口的位置/大小
AmapApiRetCode AMapResolutionChangeReq(STSreenInfo *pScreenInfo)
- 函数说明
系统请求改变导航窗口的位置和大小。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
pScreenInfo | int n32Left;/**< 导航窗口的左顶点x，单位:像素 */ int n32Top;/**< 导航窗口的左顶点y，单位:像素 */ int n32Width;/**< 导航窗口的宽度，单位:像素 */ int n32Height;/**< 导航窗口的高度，单位:像素 */ | 是 |
- 相关函数
AMapResolutionChangeRcvCbReg
- 典型应用
导航窗口的全半屏切换。
AmapApiRetCode AMapResolutionChangeRcvCbReg(FUNC_ResolutionChangeRcv pFuncCb)
- 函数说明
系统注册回调接收导航窗口切换执行结果。
- 参数说明
回调函数定义 typedef int (* FUNC_ResolutionChangeRcv)(bool bRet, STSreenInfo *pScreenInfo)
参数 | 参数说明 |
|---|---|
bRet | false - 失败 true - 成功 |
pScreenInfo | 当bRet为false时候，不用关心这个值。当bRet为true的时候，这个值才可以被使用，表示导航分辨率切换后的窗口位置/大小信息。 |
- 相关函数
AMapResolutionChangeReq
- 典型应用
4. 仪表盘大小屏切换
AmapApiRetCode AMapExScreenShowModeNotify(EClusterModel eMode)
- 函数说明
仪表盘的显示一般分为两种模式，一是全屏的地图显示，其二是只显示TBT信息。系统侧可以对仪表盘的显示模式进行控制。
时序说明：
1、大小屏切换的时候通知。
2、系统收到导航开始运行的状态通知后上报。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
eMode | eDIMViewMode, /**< 仪表模式(只显示TBT信息) */ eFullMapMode, /**< 全屏地图模式*/ | 是 |
- 相关函数
- 典型应用
系统通过中控或者方向盘快捷按键对仪表盘的显示模式进行切换。
5. 扩展屏比例尺设置
AmapApiRetCode AMapExScreenScaleSetNotify(EClusterType eType, unsigned int un32Scale)
- 函数说明
我们将主屏之外的屏幕统称为扩展屏，目前最多支持4个扩展屏，将扩展屏分为仪表盘、后枕屏1、后枕屏2、抬头屏。系统侧可以对扩展屏相应的比例尺进行控制。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
eType | E_CLUSTER, /**< 仪表盘 */ E_BACK_SCREEN_1, /**< 后枕屏1*/ E_BACK_SCREEN_2, /**< 后枕屏2 */ E_OVERHEAD, /**< 投影屏 */ | 是 | |
un32Scale | 比例尺等级，详见“主图业务” - “地图缩放”中的比例尺等级和真实地图比例的对应关系 |
- 相关函数
- 典型应用
系统通过中控或者语音对扩展屏的地图比例尺进行控制。
6. 扩展屏视图模式设置
AmapApiRetCode AMapExScreenViewModeSetNotify(EClusterType eType, EGMapViewStatus eStatus)
- 函数说明
我们将主屏之外的屏幕统称为扩展屏，目前最多支持4个扩展屏，将扩展屏分为仪表盘、后枕屏1、后枕屏2、抬头屏。系统侧可以对扩展屏相应的地图视图模式进行控制。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
eType | E_CLUSTER, /**< 仪表盘 */ E_BACK_SCREEN_1, /**< 后枕屏1*/ E_BACK_SCREEN_2, /**< 后枕屏2 */ E_OVERHEAD, /**< 投影屏 */ | 是 | |
eStatus | GMAPVIEW_NORTH, /**< 2D北首 */ GMAPVIEW_CAR, /**< 2D车首 */ GMAPVIEW_3D, /**< 3D车首 */ GMAPVIEW_CHANGE_WITH_NAVI, /**< 和主图的视图模式同步*/ | 是 |
- 相关函数
- 典型应用
系统通过中控或者语音对扩展屏的地图的视图模式进行控制。
7. 扩展屏车标位置设置
AmapApiRetCode AMapExScreenCarPosSetNotify(EClusterType eType, ECarPosInCluster ePos)
- 函数说明
我们将主屏之外的屏幕统称为扩展屏，目前最多支持4个扩展屏，将扩展屏分为仪表盘、后枕屏1、后枕屏2、抬头屏。系统侧可以对扩展屏相应的地图车标位置进行控制。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
eType | E_CLUSTER, /**< 仪表盘 */ E_BACK_SCREEN_1, /**< 后枕屏1*/ E_BACK_SCREEN_2, /**< 后枕屏2 */ E_OVERHEAD, /**< 投影屏 */ | 是 | |
ePos | E_POS_LEFT,/**< 车标位于仪表盘左边*/ E_POS_MIDDLE,/**< 车标位于仪表盘中间*/ E_POS_RIGHT,/**< 车标位于仪表盘右边*/ | 是 |
- 相关函数
- 典型应用
系统通过中控或者语音对扩展屏的地图的车标位置进行控制。
8. 导航窗口的刷新控制
AmapApiRetCode AMapWindowRenderCtrlNotify(EWindowType eWndType, bool bRender)
- 函数说明
该功能是为了方便系统侧根据不同的场景能够动态的控制导航多窗口的刷新，以节省CPU及内存占用，达到性能最优的目的。
- 参数说明
参数 | 参数说明 | 是否必填 | 格式/样例 |
|---|---|---|---|
eWndType | E_WINDOW_UNKNOW = -1, E_WINDOW_MAIN_L = 1 << 0,/**< 主屏幕: 大屏(全屏) */ E_WINDOW_EXNAVI = 1 << 1,/**< 兼容旧版导航仪表盘(auto2.5使用)*/ E_WINDOW_DASHBOARD_S = 1 << 2,/**< 仪表盘小屏 */ E_WINDOW_WIDGET = 1 << 3, /**< 主屏幕widget */ E_WINDOW_DASHBOARD_L = 1 << 4,/**< 仪表盘全屏 */ E_WINDOW_HUD = 1 << 5, /**< HUD */ E_WINDOW_EXTERNAL_1 = 1 << 6,/**< 后枕屏1 */ E_WINDOW_EXTERNAL_2 = 1 << 7,/**< 后枕屏2 */ E_WINDOW_EXTERNAL_3 = 1 << 8,/**< 后枕屏3 */ E_WINDOW_MAIN_S = 1 << 9,/**< 主屏幕：小屏*/ | 是 | |
bRender | true - 刷新 false - 不刷新 | 是 |
- 相关函数
- 典型应用
