MTC 响铃接口函数。更多

宏定义
#define	MTC_RING_FOREVER 0
	持续播放铃声宏。

#define	MTC_RING_DTMF_LEN 200
	以毫秒为单位播放 DTMF 时间长度宏。

#define	MTC_RING_ALERT_LEN 500
	以毫秒为单位播放提示事件时间长度宏。

#define	MTC_RING_TERM_LEN 2000
	以毫秒为单位播放终止时间时间长度宏。

#define	MTC_RING_ASSET_MASK 0x80000000
	安卓品太用户资源掩码。

类型定义
typedef enum EN_MTC_RING_TYPE	EN_MTC_RING_TYPE
	MTC 铃声类型

枚举
enum	EN_MTC_RING_TYPE { EN_MTC_RING_TONE_0, EN_MTC_RING_TONE_1, EN_MTC_RING_TONE_2, EN_MTC_RING_TONE_3, EN_MTC_RING_TONE_4, EN_MTC_RING_TONE_5, EN_MTC_RING_TONE_6, EN_MTC_RING_TONE_7, EN_MTC_RING_TONE_8, EN_MTC_RING_TONE_9, EN_MTC_RING_TONE_STAR, EN_MTC_RING_TONE_POUND, EN_MTC_RING_RING, EN_MTC_RING_RING_BACK, EN_MTC_RING_CALL_FAILED, EN_MTC_RING_BUSY, EN_MTC_RING_CALL_WAIT, EN_MTC_RING_FORWARD, EN_MTC_RING_TERM, EN_MTC_RING_HELD, EN_MTC_RING_MSG_RECV, EN_MTC_RING_SIZE }
	MTC 铃声类型更多

函数
ZFUNC ZINT	Mtc_RingPlay (ZUINT iType, ZUINT iMilliSeconds)
	播放铃声，铃声类型见 EN_MTC_RING_TYPE。更多

ZFUNC ZINT	Mtc_RingPlayNoLoop (ZUINT iType)
	不循环播放铃声，铃声类型见 EN_MTC_RING_TYPE。更多

ZFUNC ZINT	Mtc_RingPlayX (ZCONST ZCHAR *pcFileName, ZUINT iMilliSeconds)
	播放铃声文件。更多

ZFUNC ZVOID	Mtc_RingStop (ZUINT iType)
	音频停止重播。更多

ZFUNC ZBOOL	Mtc_RingIsPlay (ZFUNC_VOID)
	音频正在播放。更多

ZFUNC ZBOOL	Mtc_RingGetMute (ZFUNC_VOID)
	获取静音状态。更多

ZFUNC ZINT	Mtc_RingSetMute (ZBOOL bMute)
	设置静音状态。更多

ZFUNC ZBOOL	Mtc_RingGetMuteType (ZUINT iType)
	获取特定类型的静音状态。更多

ZFUNC ZINT	Mtc_RingSetMuteType (ZUINT iType, ZBOOL bMute)
	设置特定类型的静音状态。更多

ZFUNC ZCHAR *	Mtc_RingGetName (ZUINT iType)
	通过类型获取铃声名称。更多

ZFUNC ZCHAR *	Mtc_RingGetDesc (ZUINT iType)
	通过类型获取铃声描述。更多

ZFUNC ZINT	Mtc_RingGetType (ZCHAR *pcName)
	通过名称获取铃声类型。更多

ZFUNC ZCHAR *	Mtc_RingGetCtmName (ZUINT iType)
	通过类型获取用户铃声文件名称。更多

ZFUNC ZINT	Mtc_RingSetCtmName (ZUINT iType, ZCONST ZCHAR *pcName)
	设置用户铃声文件名称。更多

ZFUNC ZCHAR *	Mtc_RingGetDir (ZFUNC_VOID)
	获取默认铃声文件的目录。更多

ZFUNC ZVOID	Mtc_RingSetDir (ZCHAR *pcName, ZUSHORT wLen)
	设置默认铃声文件的目录。更多

详细描述

MTC 响铃接口函数。

枚举类型说明

enum EN_MTC_RING_TYPE

MTC 铃声类型

枚举值
EN_MTC_RING_TONE_0	音调 0
EN_MTC_RING_TONE_1	音调 1
EN_MTC_RING_TONE_2	音调 2
EN_MTC_RING_TONE_3	音调 3
EN_MTC_RING_TONE_4	音调 4
EN_MTC_RING_TONE_5	音调 5
EN_MTC_RING_TONE_6	音调 6
EN_MTC_RING_TONE_7	音调 7
EN_MTC_RING_TONE_8	音调 8
EN_MTC_RING_TONE_9	音调 9
EN_MTC_RING_TONE_STAR	音调 *
EN_MTC_RING_TONE_POUND	音调 #
EN_MTC_RING_RING	响铃
EN_MTC_RING_RING_BACK	回复
EN_MTC_RING_CALL_FAILED	呼叫失败
EN_MTC_RING_BUSY	正忙
EN_MTC_RING_CALL_WAIT	呼叫等待
EN_MTC_RING_FORWARD	前转
EN_MTC_RING_TERM	呼叫终止
EN_MTC_RING_HELD	呼叫保持
EN_MTC_RING_MSG_RECV	消息接收
EN_MTC_RING_SIZE	铃声大小

函数说明

ZFUNC ZCHAR* Mtc_RingGetCtmName (ZUINT iType)

通过类型获取用户铃声文件名称。

参数

[in] iType 铃声类型，见 EN_MTC_RING_TYPE。

返回: 铃声用户铃声文件名称，若找到，否则返回空字符串。

参见: Mtc_RingSetCtmName

ZFUNC ZCHAR* Mtc_RingGetDesc (ZUINT iType)

通过类型获取铃声描述。

参数

[in] iType 铃声类型，见 EN_MTC_RING_TYPE。

返回: 铃声描述，若找到，否则返回空字符串。

参见: Mtc_RingGetType

ZFUNC ZCHAR* Mtc_RingGetDir (ZFUNC_VOID )

获取默认铃声文件的目录。

参见: Mtc_RingSetDir

ZFUNC ZBOOL Mtc_RingGetMute (ZFUNC_VOID )

获取静音状态。

返回值

ZTRUE	静音
ZFALSE	不静音。

参见: Mtc_RingSetMute

ZFUNC ZBOOL Mtc_RingGetMuteType (ZUINT iType)

获取特定类型的静音状态。

参数

[in] iType 铃声类型， EN_MTC_RING_TYPE。

返回值

ZTRUE	静音。
ZFALSE	不静音。

参见: Mtc_RingSetMuteType

ZFUNC ZCHAR* Mtc_RingGetName (ZUINT iType)

通过类型获取铃声名称。

参数

[in] iType 铃声类型，见 EN_MTC_RING_TYPE。

返回: 铃声名称，若找到，否则返回空字符串。

参见: Mtc_RingGetType

ZFUNC ZINT Mtc_RingGetType (ZCHAR * pcName)

通过名称获取铃声类型。

参数

[in] pcName 铃声名称字符串。

返回: 铃声类型，若找到。否则返回-1.

参见: Mtc_RingGetName

ZFUNC ZBOOL Mtc_RingIsPlay (ZFUNC_VOID )

音频正在播放。

返回值

ZTRUE	音频正在播放。
ZFALSE	音频没有播放。

参见: Mtc_RingPlay

ZFUNC ZINT Mtc_RingPlay (ZUINT iType, ZUINT iMilliSeconds )

播放铃声，铃声类型见 EN_MTC_RING_TYPE。

若能找到，将播放用户设置的文件。否则将播放默认铃声文件默认铃声文件路劲由 .wav 扩展名设置的目录形成。

参数

[in]	iType	铃声类型，见 EN_MTC_RING_TYPE.
[in]	iMilliSeconds	以毫秒为单位的播放时长， 0 为永远。

返回值

ZOK	音频播放铃声成功。
ZFAILED	音频播放铃声失败。

参见: Mtc_RingPlayX Mtc_RingStop

ZFUNC ZINT Mtc_RingPlayNoLoop (ZUINT iType)

不循环播放铃声，铃声类型见 EN_MTC_RING_TYPE。

若能找到，将播放用户设置的文件。否则将播放默认铃声文件默认铃声文件路劲由 .wav 扩展名设置的目录形成。

参数

[in] iType 铃声类型，见 EN_MTC_RING_TYPE.

返回值

ZOK	音频播放铃声成功。
ZFAILED	音频播放铃声失败。

参见: Mtc_RingPlay

ZFUNC ZINT Mtc_RingPlayX (ZCONST ZCHAR * pcFileName, ZUINT iMilliSeconds )

播放铃声文件。

铃声名称以及 ".wav" 为扩展名。

参数

[in]	pcFileName	铃声文件的文件名称。
[in]	iMilliSeconds	以毫秒为单位播放时长， 0 为永远。

返回值

ZOK	音频播放铃声成功。
ZFAILED	音频播放铃声失败。

参见: Mtc_RingPlay Mtc_RingStop

ZFUNC ZINT Mtc_RingSetCtmName (ZUINT iType, ZCONST ZCHAR * pcName )

设置用户铃声文件名称。

参数

[in]	iType	铃声类型，见 EN_MTC_RING_TYPE。
[in]	pcName	铃声文件名称。

返回值

ZOK	设置用户铃声文件名称成功。
ZFAILED	设置用户铃声文件名称失败。

参见: Mtc_RingGetCtmName

ZFUNC ZVOID Mtc_RingSetDir (ZCHAR * pcName, ZUSHORT wLen )

设置默认铃声文件的目录。

参数

[in]	pcName	目录名称。
[in]	wLen	目录名称的字符串长度。

返回值

ZOK	设置默认铃声文件的目录成功。
ZFAILED	设置默认铃声文件的目录失败。

参见: Mtc_RingGetDir

ZFUNC ZINT Mtc_RingSetMute (ZBOOL bMute)

设置静音状态。

参数

[in] bMute ZTRUE 铃声静音， ZFALSE 铃声不静音。

返回值

ZOK	设置静音状态成功。
ZFAILED	设置静音状态失败。

参见: Mtc_RingGetMute

ZFUNC ZINT Mtc_RingSetMuteType (ZUINT iType, ZBOOL bMute )

设置特定类型的静音状态。

参数

[in]	iType	铃声类型， EN_MTC_RING_TYPE。
[in]	bMute	ZTRUE 铃声静音， ZFALSE 铃声不静音。

返回值

ZOK	设置静音状态成功。
ZFAILED	设置静音状态失败。

参见: Mtc_RingGetMuteType

ZFUNC ZVOID Mtc_RingStop (ZUINT iType)

音频停止重播。

参数

[in] iType 铃声类型，见 EN_MTC_RING_TYPE. ZMAXUINT 停止铃声播放。

参见: Mtc_RingPlay Mtc_RingPlayX

rcs ios

mtc_ring.h 文件参考

宏定义

类型定义

枚举

函数

详细描述

枚举类型说明

enum EN_MTC_RING_TYPE

函数说明

ZFUNC ZCHAR* Mtc_RingGetCtmName (ZUINT iType)

ZFUNC ZCHAR* Mtc_RingGetDesc (ZUINT iType)

ZFUNC ZCHAR* Mtc_RingGetDir (ZFUNC_VOID )

ZFUNC ZBOOL Mtc_RingGetMute (ZFUNC_VOID )

ZFUNC ZBOOL Mtc_RingGetMuteType (ZUINT iType)

ZFUNC ZCHAR* Mtc_RingGetName (ZUINT iType)

ZFUNC ZINT Mtc_RingGetType (ZCHAR * pcName)

ZFUNC ZBOOL Mtc_RingIsPlay (ZFUNC_VOID )

ZFUNC ZINT Mtc_RingPlay (ZUINT iType, ZUINT iMilliSeconds )

ZFUNC ZINT Mtc_RingPlayNoLoop (ZUINT iType)

ZFUNC ZINT Mtc_RingPlayX (ZCONST ZCHAR * pcFileName, ZUINT iMilliSeconds )

ZFUNC ZINT Mtc_RingSetCtmName (ZUINT iType, ZCONST ZCHAR * pcName )

ZFUNC ZVOID Mtc_RingSetDir (ZCHAR * pcName, ZUSHORT wLen )

ZFUNC ZINT Mtc_RingSetMute (ZBOOL bMute)

ZFUNC ZINT Mtc_RingSetMuteType (ZUINT iType, ZBOOL bMute )

ZFUNC ZVOID Mtc_RingStop (ZUINT iType)