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

高德 开发 高德地图车机版 开发指南 C++平台 声音相关

更新时间:2018年08月07日

1. 查询静音状态

AmapApiRetCode AMapMuteStateReq()

  • 函数说明

系统侧查询导航当前的静音状态。

  • 参数说明
  • 相关函数

  AMapMuteStateRcvCbReg

  • 典型应用

AmapApiRetCode AMapMuteStateRcvCbReg(FUNC_MuteStateRcv pFunCb) 

  • 函数说明

系统注册回调接收导航的静音状态。

  • 参数说明

参数

参数说明

是否必填

格式/样例

  pFunCb

 接收静音状态回调函数指针


回调函数定义   typedef int (*FUNC_MuteStateRcv)(EGMuteStateType eType)

参数

参数说明

 EGMuteStateType

E_SOUND_STATE_UNDEFINE = -1,   /**< 未知状态 */

E_SOUND_STATE_MUTE, /**< 声音静音 */

E_SOUND_STATE_CANCEL_MUTE, /**< 取消静音 */

E_SOUND_STATE_TEMP_MUTE,     /**< 临时静音 */

E_SOUND_STATE_TEMP_CANCEL_MUTE,   /**< 临时取消静音 */

  • 相关函数

 AMapMuteStateReq

  • 典型应用

2. 导航请求系统音量级数

AmapApiRetCode AMapNaviQuerySysVolumCbReg(FUNC_NaviQuerySysVolumRcv pFuncb)

  • 函数说明

系统侧注册回调接收导航请求系统音量级数,并将结果反馈给导航。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncb

 接收导航音量级数信息的回调函数指针


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

  • 相关函数

AMapVolumValueNotify

  • 典型应用

AmapApiRetCode AMapVolumValueNotify(unsigned int un32CurLevel, unsigned int un32TotalLevel)

  • 函数说明

系统侧上报当前音量级数及总级数给导航。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 un32CurLevel

 当前音量级数


 un32TotalLevel

 音量总级数


  • 相关函数

AMapNaviQuerySysVolumCbReg

  • 典型应用

3. 系统接收导航当前的音量级数信息

AmapApiRetCode AMapNaviVolumRcvCbReg(FUNC_NaviVolumRcv pFuncb)

  • 函数说明

系统侧注册回调接收导航请当前的音量级数及总级数。

  • 参数说明

参数

参数说明

是否必填

格式/样例

 pFuncb

 接收导航音量级数信息的回调函数指针


回调函数定义    typedef int (*FUNC_NaviVolumRcv)(unsigned int un32Cur, unsigned int un32Total)

参数

参数说明

 un32Cur

 导航当前音量级数

 un32Total

 导航音量总级数

  • 相关函数
  • 典型应用

4. 导航TTS文本透出

AmapApiRetCode AMapNaviTextRcvCbReg(FUNC_NaviTextRcv pFunCb)

  • 函数说明

    使用者可以使用这个接口注册回调,接收导航透出的TTS文本信息,然后进行TTS文本播放。

  • 参数说明

参数

参数说明

 pFunCb

 TTS文本接收回调函数指针

 回调函数类型定义    typedef int (*FUNC_NaviTextRcv)(char* pTxt,int* Id)  

参数

参数说明

pTxt

TTS文本

Id[out]

声音id ,out类型,需要返回给导航 

  • 相关函数        
  • 典型应用

当系统侧期望TTS文本由他们自己播放的时候,可以通过该接口注册回调,获取导航透出的TTS文本,同时返回Id信息给导航,以识别具体是哪个TTS。

5、导航请求系统播放BEEP音

AmapApiRetCode AMapBeepPlayReqCbReg(FUNC_BeepPlayReq pFuncb)

  • 函数说明

    系统注册回调接收导航请求播放BEEP音。

  • 参数说明

参数

参数说明

是否必填

格式样例

 pFuncb

回调函数指针


回调函数说明 typedef int (*FUNC_BeepPlayReq)()

  • 相关函数        
  • 典型应用

6、导航请求系统播放Wav音

AmapApiRetCode AMapWavPlayReqCbReg(FUNC_WavPlayReq pFuncb)

  • 函数说明

    系统注册回调接收导航请求播放wav文件。

  • 参数说明

参数

参数说明

是否必填

格式样例

 pFuncb

 回调函数指针

 是


回调函数说明 typedef int (*FUNC_WavPlayReq)(string &strWavFileName,int* Id)

参数

参数说明

 strWavFileName

wav文件名

Id [out]

声音Id,out类型,需要返回给导航

  • 相关函数        
  • 典型应用

当系统侧期望wav由他们自己播放的时候,可以通过该接口注册回调,获取导航透出的wav音的路径信息,同时返回Id信息给导航,以识别具体是哪个wav,此id值不能和TTS的id相同。

7、系统向导航应答声道状态的执行结果

AmapApiRetCode  AMapNaviChannelStatusResp( bool bAvailable )

  • 函数说明

     系统收到 TTS_Start信号后响应,并应答当前声道的状态。

  • 参数说明

参数

参数说明

是否必填

格式样例

 bAvailable  

声道状态说明


8、系统向导航通知声音播放状态

AmapApiRetCode  AMapSoundStatNotify( EGSoundStateType eType,int idx )

  • 函数说明

     系统开始播放声音后通知当前的状态:播放中,播放完毕(空闲)

  • 参数说明

参数

参数说明

是否必填

格式样例

eType

E_SOUND_STATE_IDLE:播放完毕(空闲)

E_SOUND_STATE_PLAYING:播放中


idx

声音Id


9、导航请求系统停止播放

AmapApiRetCode AMapSoundPlayStopReqCbReg(FUNC_SoundPlayStopReq pFuncb )

  • 函数说明

     系统注册回调接收导航停止声音通知,收到导航停止声音播放。

  • 参数说明

参数

参数说明

是否必填

样例

  pFuncb 

回调函数指针



回调函数类型定义  typedef int (*FUNC_SoundPlayStopReq)(int);

参数

参数说明

Id

声音Id

  • 相关函数        
  • 典型应用

当导航期望播放新的文本时候,可通过该接口停止此前正在播放的声音,其中参数Id为声音播放时通过系统获取得到的。

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