MTC Call Interface Functions. 更多

宏定义
#define	MTC_CALL_REC_FILE_PCM "pcm"
	MTC 呼叫记录文件类型更多

#define	MTC_CALL_REC_FILE_WAV "wav"
	wav 内容

#define	MTC_CALL_ERR_NO (MTC_EBASE_CALL + 0)
	MTC call status code(error no or terminated code). 更多

#define	MTC_CALL_ERR_AUTH_FAILED (MTC_EBASE_CALL + 1)
	授权失败，无效用户或密码。

#define	MTC_CALL_ERR_SESS_TMR (MTC_EBASE_CALL + 2)
	呼叫更新错误。

#define	MTC_CALL_ERR_FORBIDDEN (MTC_EBASE_CALL + 3)
	呼叫禁止。

#define	MTC_CALL_ERR_NOT_FOUND (MTC_EBASE_CALL + 4)
	呼叫成员未找到。

#define	MTC_CALL_ERR_NOT_ACPTED (MTC_EBASE_CALL + 5)
	呼叫不被接受。

#define	MTC_CALL_ERR_TEMP_UNAVAIL (MTC_EBASE_CALL + 6)
	呼叫成员临时不可用。

#define	MTC_CALL_ERR_REQ_TERMED (MTC_EBASE_CALL + 7)
	呼叫请求终止。

#define	MTC_CALL_ERR_INTERNAL_ERR (MTC_EBASE_CALL + 8)
	服务器内部错误。

#define	MTC_CALL_ERR_SRV_UNAVAIL (MTC_EBASE_CALL + 9)
	业务不可用

#define	MTC_CALL_ERR_NOT_EXIST (MTC_EBASE_CALL + 10)
	不存在

#define	MTC_CALL_ERR_USER_NOTREG (MTC_EBASE_CALL + 11)
	呼叫成员未注册。

#define	MTC_CALL_ERR_NOT_FRIEND (MTC_EBASE_CALL + 12)
	呼叫成员不是好友。

#define	MTC_CALL_ERR_IN_BACK_LST (MTC_EBASE_CALL + 13)
	呼叫成员在黑名单内。

#define	MTC_CALL_ERR_TRANS_FAIL (MTC_EBASE_CALL + 14)
	呼叫传输错误。

#define	MTC_CALL_TERM_BYE (MTC_EBASE_CALL + 21)
	挂断终止。

#define	MTC_CALL_TERM_CANCEL (MTC_EBASE_CALL + 22)
	取消终止。

#define	MTC_CALL_TERM_TIMEOUT (MTC_EBASE_CALL + 23)
	超时终止。

#define	MTC_CALL_TERM_BUSY (MTC_EBASE_CALL + 24)
	正忙终止。

#define	MTC_CALL_TERM_DECLINE (MTC_EBASE_CALL + 25)
	拒绝终止。

#define	MTC_CALL_TERM_TRSFED (MTC_EBASE_CALL + 26)
	转移终止。

#define	MTC_CALL_TERM_REDIRECT (MTC_EBASE_CALL + 27)
	转向终止。

#define	MTC_CALL_TERM_REPLACE (MTC_EBASE_CALL + 28)
	取代终止。

#define	MTC_CALL_ALERT_RING (MTC_EBASE_CALL + 41)
	由180提醒。

#define	MTC_CALL_ALERT_QUEUED (MTC_EBASE_CALL + 42)
	由182提醒。

#define	MTC_CALL_ALERT_PROGRESS (MTC_EBASE_CALL + 43)
	由183提醒。

#define	MTC_CALL_ALERT_OTHER (MTC_EBASE_CALL + 44)
	由其他类型通知。

#define	MTC_CALL_ERR_OTHER (MTC_EBASE_CALL + 200)
	其他错误

类型定义
typedef enum EN_MTC_CALL_DTMF_TYPE	EN_MTC_CALL_DTMF_TYPE
	MTC 呼叫 dtmf 类型

typedef enum EN_MTC_CALL_ALERT_INFO_TYPE	EN_MTC_CALL_ALERT_INFO_TYPE
	MTC 呼叫提醒信息类型

typedef enum EN_MTC_CALL_EM_STATUS_TYPE	EN_MTC_CALL_EM_STATUS_TYPE
	MTC 呼叫早期媒体方向

typedef enum EN_MTC_CALL_TERM_REASON_TYPE	EN_MTC_CALL_TERM_REASON_TYPE
	MTC 呼叫终止原因类型

typedef enum EN_MTC_CALL_REC_MODE_TYPE	EN_MTC_CALL_REC_MODE_TYPE
	MTC 呼叫记录模式类型

typedef enum EN_MTC_CALL_TRANSMISSION_STATE	EN_MTC_CALL_TRANSMISSION_STATE
	MTC 呼叫传输状态类型

typedef enum EN_MTC_ORIENTATION_TYPE	EN_MTC_ORIENTATION_TYPE
	设备方向类型。

typedef enum EN_MTC_NET_STATUS_TYPE	EN_MTC_NET_STATUS_TYPE
	MTC 网络状态类型。

typedef enum EN_MTC_SESSION_STATE_TYPE	EN_MTC_SESSION_STATE_TYPE

typedef ZULONG	ZVIDEOHANDLE

枚举
enum	EN_MTC_CALL_DTMF_TYPE { EN_MTC_CALL_DTMF_0, EN_MTC_CALL_DTMF_1, EN_MTC_CALL_DTMF_2, EN_MTC_CALL_DTMF_3, EN_MTC_CALL_DTMF_4, EN_MTC_CALL_DTMF_5, EN_MTC_CALL_DTMF_6, EN_MTC_CALL_DTMF_7, EN_MTC_CALL_DTMF_8, EN_MTC_CALL_DTMF_9, EN_MTC_CALL_DTMF_STAR, EN_MTC_CALL_DTMF_POUND, EN_MTC_CALL_DTMF_A, EN_MTC_CALL_DTMF_B, EN_MTC_CALL_DTMF_C, EN_MTC_CALL_DTMF_D }
	MTC 呼叫 dtmf 类型更多

enum	EN_MTC_CALL_ALERT_INFO_TYPE { EN_MTC_CALL_ALERT_INFO_NULL, EN_MTC_CALL_ALERT_INFO_DR0, EN_MTC_CALL_ALERT_INFO_DR1, EN_MTC_CALL_ALERT_INFO_DR2, EN_MTC_CALL_ALERT_INFO_DR3, EN_MTC_CALL_ALERT_INFO_DR4, EN_MTC_CALL_ALERT_INFO_DR5 }
	MTC 呼叫提醒信息类型更多

enum	EN_MTC_CALL_EM_STATUS_TYPE { EN_MTC_CALL_EM_STATUS_INACTIVE, EN_MTC_CALL_EM_STATUS_SENDONLY, EN_MTC_CALL_EM_STATUS_RECVONLY, EN_MTC_CALL_EM_STATUS_SENDRECV }
	MTC 呼叫早期媒体方向更多

enum	EN_MTC_CALL_TERM_REASON_TYPE { EN_MTC_CALL_TERM_REASON_NORMAL, EN_MTC_CALL_TERM_REASON_BUSY, EN_MTC_CALL_TERM_REASON_DECLINE, EN_MTC_CALL_TERM_REASON_NOT_AVAILABLE }
	MTC 呼叫终止原因类型更多

enum	EN_MTC_CALL_REC_MODE_TYPE { EN_MTC_CALL_REC_MODE_ALL, EN_MTC_CALL_REC_MODE_PLAY, EN_MTC_CALL_REC_MODE_MIC }
	MTC 呼叫记录模式类型更多

enum	EN_MTC_CALL_TRANSMISSION_STATE { EN_MTC_CALL_TRANSMISSION_NORMAL = 0x6E726D6C, EN_MTC_CALL_TRANSMISSION_CAMOFF = 0x636F6666, EN_MTC_CALL_TRANSMISSION_PAUSE = 0x70617364, EN_MTC_CALL_TRANSMISSION_PAUSE4QOS = 0x70716F73 }
	MTC 呼叫传输状态类型更多

enum	EN_MTC_ORIENTATION_TYPE { EN_MTC_ORIENTATION_PORTRAIT, EN_MTC_ORIENTATION_LANDSCAPE_RIGHT, EN_MTC_ORIENTATION_PORTRAIT_UPSIDEDOWN, EN_MTC_ORIENTATION_LANDSCAPE_LEFT }
	设备方向类型。更多

enum	EN_MTC_NET_STATUS_TYPE { EN_MTC_NET_STATUS_DISCONNECTED = -3, EN_MTC_NET_STATUS_VERY_BAD = -2, EN_MTC_NET_STATUS_BAD = -1, EN_MTC_NET_STATUS_NORMAL = 0, EN_MTC_NET_STATUS_GOOD = 1, EN_MTC_NET_STATUS_VERY_GOOD = 2, EN_MTC_NET_STATUS_BAD = -1, EN_MTC_NET_STATUS_NORMAL = 0 }
	Type of MTC network status. 更多

enum	EN_MTC_SESSION_STATE_TYPE { EN_MTC_SESSION_STATE_IDLE, EN_MTC_SESSION_STATE_OUTGOING, EN_MTC_SESSION_STATE_INCOMING, EN_MTC_SESSION_STATE_ALERTED, EN_MTC_SESSION_STATE_CONNECTING, EN_MTC_SESSION_STATE_TALKING, EN_MTC_SESSION_STATE_ENDED, EN_MTC_SESSION_STATE_DIDEND }

函数
ZFUNC ZULONG	Mtc_SessCall (ZCHAR *pcUri, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo)
	MTC 呼叫，建立带有视频或音频的会话呼叫。更多

ZFUNC ZULONG	Mtc_SessCallX (ZCHAR *pcUri, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo, ZBOOL bSend, ZBOOL bRecv)
	MTC 呼叫，建立有视频或音频的会话呼叫。更多

ZFUNC ZINT	Mtc_SessAlert (ZULONG dwSessId, ZCOOKIE zCookie, ZULONG dwType, ZBOOL bReliable)
	MTC 会话提醒呼入会话。更多

ZFUNC ZINT	Mtc_SessAnswer (ZULONG dwSessId, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo)
	MTC 会话应答由 Mtc_CallCbSetIncoming 所设回调通知的呼入会话呼叫。更多

ZFUNC ZINT	Mtc_SessTerm (ZULONG dwSessId, ZULONG dwReason)
	MTC 会话终止。更多

ZFUNC ZINT	Mtc_SessHold (ZULONG dwSessId)
	MTC 会话保持。更多

ZFUNC ZINT	Mtc_SessUnhold (ZULONG dwSessId)
	MTC 会话取消保持。更多

ZFUNC ZINT	Mtc_SessUTrsf (ZULONG dwSessId, ZCHAR *pcUri)
	MTC 会话无人转发。更多

ZFUNC ZINT	Mtc_SessATrsf (ZULONG dwSessId, ZULONG dwTrsfSessId)
	MTC 会话参与转发。更多

ZFUNC ZINT	Mtc_SessDiv (ZULONG dwSessId, ZCHAR *pcUri)
	MTC 会话将转换由 Mtc_CallCbSetIncoming 所设的回调通知的呼入会话呼叫。更多

ZFUNC ZINT	Mtc_SessUpdate (ZULONG dwSessId, ZBOOL bAudio, ZBOOL bVideo)
	MTC 会话发送一个多媒体更新请求给对方。此函数内的更新说明打开一个新媒体流或关闭已存在的媒体流。更多

ZFUNC ZINT	Mtc_SessUpdateRsp (ZULONG dwSessId, ZBOOL bAudio, ZBOOL bVideo)
	MTC 会话应答对方发出的媒体更新请求。此函数中的更新说明打开一个新的媒体流或关闭一个已存在的媒体流。更多

ZFUNC ZULONG	Mtc_SessPickUp (ZCHAR pcUri, ZCHAR pcReplaceInfo, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo)
	MTC PickUp, 通过取代特定会话建立带有视频或音频的会话呼叫。更多

ZFUNC ZINT	Mtc_SessPickUpX (ZULONG dwSessId)
	MTC 会话 PickUp, 通过取代特定的呼叫建立带有视频或音频的会话呼叫。更多

ZFUNC ZINT	Mtc_SessDtmf (ZULONG dwSessId, ZULONG dwDtmfType)
	MTC 会话发送 DTMF 信息。更多

ZFUNC ZINT	Mtc_SessInfo (ZULONG dwSessId, ZCHAR *pcInfo)
	MTC 会话发送带有文本的 INFO。更多

ZFUNC ZINT	Mtc_SessPreviewSetArea (ZULONG dwSessId, ZVIDEOHANDLE dwHandle, ZSHORT wX, ZSHORT wY, ZUSHORT wWidth, ZUSHORT wHeight)
	MTC 会话设置预览区域。更多

ZFUNC ZINT	Mtc_SessPreviewShow (ZULONG dwSessId, ZBOOL bShow)
	MTC 会话显示或隐藏预览图片。更多

ZFUNC ZINT	Mtc_SessCameraAttach (ZULONG dwSessId)
	MTC 会话附带摄像头。更多

ZFUNC ZINT	Mtc_SessCameraDetach (ZULONG dwSessId)
	MTC 会话没有摄像头。更多

ZFUNC ZINT	Mtc_SessRenderReset (ZULONG dwSessId)
	MTC 会话充塞远程图片的渲染区域设置。更多

ZFUNC ZINT	Mtc_SessRenderAdd (ZULONG dwSessId, ZVIDEOHANDLE dwHandle, ZSHORT wX, ZSHORT wY, ZUSHORT wWidth, ZUSHORT wHeight)
	MTC 会话设置远程图片的渲染区域。更多

ZFUNC ZINT	Mtc_SessRenderBuild (ZULONG dwSessId)
	MTC 会话建立渲染显示图片。更多

ZFUNC ZINT	Mtc_SessRenderRelease (ZULONG dwSessId)
	MTC 会话释放渲染显示图片。更多

ZFUNC ZINT	Mtc_SessVideoStart (ZULONG dwSessId)
	MTC 会话开始视频传输。更多

ZFUNC ZINT	Mtc_SessVideoStop (ZULONG dwSessId)
	MTC 会话停止视频传输。更多

ZFUNC ZINT	Mtc_SessVideoPause (ZULONG dwSessId)
	MTC 会话暂停发送视频。更多

ZFUNC ZINT	Mtc_SessVideoResume (ZULONG dwSessId)
	MTC 会话续传视频。更多

ZFUNC ZINT	Mtc_SessPartpGetIds (ZULONG dwSessId, ZUINT piPartpIds, ZUINT piPartpCnt)
	获取所有成员 ID。更多

ZFUNC ZINT	Mtc_SessPartpGetRtpInfo (ZULONG dwSessId, ZUINT iPartpId, ZUINT piSsrc, ZUINT piIp, ZUSHORT *pwPort)
	获取特定成员 ID 的 RTP。更多

ZFUNC ZINT	Mtc_SessPartpGetRenderArea (ZULONG dwSessId, ZUINT piPartpIds, ZUINT iPartpCnt, ZUINT piAreaIndexs)
	为每一位成员获取渲染区域索引。更多

ZFUNC ZINT	Mtc_SessPartpSetRenderArea (ZULONG dwSessId, ZUINT piPartpIds, ZUINT iPartpCnt, ZUINT piAreaIndexs)
	设置每一位用户的渲染区域索引。更多

ZFUNC ZINT	Mtc_SessGetVideoSize (ZULONG dwSessId, ZULONG pdwWidth, ZULONG pdwHeight)
	MTC 会话获取视频大小。更多

ZFUNC ZINT	Mtc_SessGetVideoRemoteSize (ZULONG dwSessId, ZULONG pdwWidth, ZULONG pdwHeight)
	MTC 会话获取远程视频大小。更多

ZFUNC ZINT	Mtc_SessGetVideoLocalSize (ZULONG dwSessId, ZULONG pdwWidth, ZULONG pdwHeight)
	MTC 会话获取本地视频大小。更多

ZFUNC ZBOOL	Mtc_SessHasVideo (ZULONG dwSessId)
	MTC 会话检查是否有活跃视频流。更多

ZFUNC ZBOOL	Mtc_SessHasAudio (ZULONG dwSessId)
	MTC 会话检查是否有活跃音频流。更多

ZFUNC ZBOOL	Mtc_SessHasTalk (ZULONG dwSessId)
	MTC 检查会话已经进入对话状态。更多

ZFUNC ZBOOL	Mtc_SessHasHold (ZULONG dwSessId)
	MTC 检查会话已经进入保持状态。更多

ZFUNC ZBOOL	Mtc_SessHasHeld (ZULONG dwSessId)
	MTC 检查会话已经进入被保持状态。更多

ZFUNC ZUINT	Mtc_SessAudioLostRatio (ZULONG dwSessId)
	MTC 获取音频流中的百分比丢失率。更多

ZFUNC ZUINT	Mtc_SessVideoLostRatio (ZULONG dwSessId)
	MTC 获取视频流中的百分比丢失率。更多

ZFUNC ZUINT	Mtc_SessAudioLostCount (ZULONG dwSessId)
	MTC 获取音频流的丢失数量。更多

ZFUNC ZUINT	Mtc_SessVideoLostCount (ZULONG dwSessId)
	MTC 获取视频流的丢失数量。更多

ZFUNC ZUINT	Mtc_SessAudioRtt (ZULONG dwSessId)
	MTC 获取音频流往返一次时间。更多

ZFUNC ZUINT	Mtc_SessVideoRtt (ZULONG dwSessId)
	MTC 获取视频流往返一次时间。更多

ZFUNC ZUINT	Mtc_SessAudioJitter (ZULONG dwSessId)
	MTC 获取音频流震动。更多

ZFUNC ZUINT	Mtc_SessVideoJitter (ZULONG dwSessId)
	MTC 获取视频流震动。更多

ZFUNC ZBOOL	Mtc_SessPeerOfferVideo (ZULONG dwSessId)
	MTC 会话检查对方是否提供视频流。更多

ZFUNC ZBOOL	Mtc_SessPeerOfferAudio (ZULONG dwSessId)
	MTC 会话检查对方是否提供音频流。更多

ZFUNC ZBOOL	Mtc_SessGetMicMute (ZULONG dwSessId)
	MTC 会话获取麦克风静音状态。更多

ZFUNC ZINT	Mtc_SessSetMicMute (ZULONG dwSessId, ZBOOL bMute)
	MTC 会话设置麦克风静音状态。更多

ZFUNC ZFLOAT	Mtc_SessGetMicScale (ZULONG dwSessId)
	MTC 会话获取麦克风范围。更多

ZFUNC ZINT	Mtc_SessSetMicScale (ZULONG dwSessId, ZFLOAT fScale)
	MTC 会话设置麦克风范围。更多

ZFUNC ZBOOL	Mtc_SessGetSpkMute (ZULONG dwSessId)
	MTC 会话获取扬声器静音状态。更多

ZFUNC ZINT	Mtc_SessSetSpkMute (ZULONG dwSessId, ZBOOL bMute)
	MTC 会话设置扬声器静音状态。更多

ZFUNC ZFLOAT	Mtc_SessGetSpkScale (ZULONG dwSessId)
	MTC 会话获取扬声器范围。更多

ZFUNC ZINT	Mtc_SessSetSpkScale (ZULONG dwSessId, ZFLOAT fScale)
	MTC 会话设置扬声器范围。更多

ZFUNC ZUINT	Mtc_SessGetSpkVol (ZULONG dwSessId)
	MTC 会话获取扬声器音量。更多

ZFUNC ZINT	Mtc_SessSetSpkVol (ZULONG dwSessId, ZUINT iVol)
	MTC 会话设置扬声器音量。更多

ZFUNC ZBOOL	Mtc_SessGetMixVoice (ZULONG dwSessId)
	MTC 会话获取混音状态。更多

ZFUNC ZINT	Mtc_SessSetMixVoice (ZULONG dwSessId, ZBOOL bEnable)
	MTC 会话设置混音状态。更多

ZFUNC ZINT	Mtc_SessRotateRemote (ZULONG dwSessId, ZUINT iOrientation)
	MTC 会话旋转远程图片方向。更多

ZFUNC ZINT	Mtc_SessRotateLocal (ZULONG dwSessId, ZUINT iOrientation)
	MTC 会话旋转本地图片方向。更多

ZFUNC ZCOOKIE	Mtc_SessGetCookie (ZULONG dwSessId)
	MTC 会话获取 cookie 值。更多

ZFUNC ZINT	Mtc_SessSetCookie (ZULONG dwSessId, ZCOOKIE zCookie)
	MTC 会话设置 cookie 值。更多

ZFUNC ZINT	Mtc_SessGetCallId (ZULONG dwSessId, ZCHAR **ppcCallId)
	MTC 会话获取呼叫-ID 字符串。更多

ZFUNC ZINT	Mtc_SessGetPeerUri (ZULONG dwSessId, ZCHAR ppcDispName, ZCHAR ppcUri)
	MTC 会话获取对方 URI 及显示名称。更多

ZFUNC ZINT	Mtc_SessGetPeerId (ZULONG dwSessId, ZCHAR ppcDispName, ZCHAR ppcUri)
	MTC 会话获取对方 ID，基于规则。更多

ZFUNC ZBOOL	Mtc_SessPeerIsFocus (ZULONG dwSessId)
	MTC 会话检查对方是否包含焦点参数。更多

ZFUNC ZBOOL	Mtc_SessHasOfferAnswer (ZULONG dwSessId)
	MTC 会话检查提供/应答交换是否完成。更多

ZFUNC ZULONG	Mtc_SessGetAlertInfo (ZULONG dwSessId)
	MTC 会话获取提醒信息类型。更多

ZFUNC ZULONG	Mtc_SessGetEarlyMediaStatus (ZULONG dwSessId, ZBOOL bVideo)
	MTC 会话获取早期媒体状态。更多

ZFUNC ZINT	Mtc_SessRecMicStart (ZCONST ZCHAR *pcFileName, ZUCHAR ucFileType)
	录制麦克风开始。更多

ZFUNC ZINT	Mtc_SessRecMicStop (ZFUNC_VOID)
	录制音频停止。更多

ZFUNC ZINT	Mtc_SessRecPlayStart (ZULONG dwSessId, ZCONST ZCHAR *pcFileName, ZUCHAR ucFileType)
	MTC 会话录音播放。更多

ZFUNC ZINT	Mtc_SessRecPlayStop (ZULONG dwSessId)
	MTC 会话停止录制播放。更多

ZFUNC ZINT	Mtc_SessRecCallStart (ZCONST ZCHAR *pcFileName, ZUCHAR ucFileType)
	录制呼叫开始。更多

ZFUNC ZINT	Mtc_SessRecCallStop (ZFUNC_VOID)
	录音停止。更多

ZFUNC ZINT	Mtc_SessRecSndStart (ZULONG dwSessId, ZCONST ZCHAR *pcFileName, ZUCHAR ucFileType, ZULONG dwRecMode)
	Mtc 会话开始录制声音。更多

ZFUNC ZINT	Mtc_SessRecSndStop (ZULONG dwSessId)
	Mtc 会话停止录制声音。更多

ZFUNC ZCONST ZCHAR *	Mtc_SessGetAudioStat (ZULONG dwSessId)
	Mtc 会话获取语音统计。更多

ZFUNC ZCONST ZCHAR *	Mtc_SessGetVideoStat (ZULONG dwSessId)
	Mtc 会话获取视频统计。更多

ZFUNC ZINT	Mtc_SessSetRxAgcEnable (ZULONG dwSessId, ZBOOL bEnable)
	MTC 会话设置接收侧 AGC 状态。更多

ZFUNC ZINT	Mtc_SessGetRxAgcEnable (ZULONG dwSessId, ZBOOL *pbEnable)
	MTC 会话获取接收侧 AGC 状态。更多

ZFUNC ZINT	Mtc_SessSetRxAgcMode (ZULONG dwSessId, ZUCHAR ucMode)
	MTC 会话获取接收侧 AGC 模式。更多

ZFUNC ZINT	Mtc_SessGetRxAgcMode (ZULONG dwSessId, ZUCHAR *pucMode)
	MTC 会话获取接收侧 AGC 模式。更多

ZFUNC ZINT	Mtc_SessSetRxAgcTarget (ZULONG dwSessId, ZUSHORT wTargetDb)
	MTC 会话设置接收侧 AGC 目标 dBOV。更多

ZFUNC ZINT	Mtc_SessGetRxAgcTarget (ZULONG dwSessId, ZUSHORT *pwTargetDb)
	MTC 会话获取接收侧 AGC 目标 dBOV。更多

ZFUNC ZINT	Mtc_SessSetRxAnrEnable (ZULONG dwSessId, ZBOOL bEnable)
	MTC 会话设置接收侧 ANR 状态。更多

ZFUNC ZINT	Mtc_SessGetRxAnrEnable (ZULONG dwSessId, ZBOOL *pbEnable)
	MTC 会话获取接收侧 ANR 状态。更多

ZFUNC ZINT	Mtc_SessSetRxAnrMode (ZULONG dwSessId, ZUCHAR ucMode)
	MTC 会话获取接收侧 ANR 模式。更多

ZFUNC ZINT	Mtc_SessGetRxAnrMode (ZULONG dwSessId, ZUCHAR *pucMode)
	MTC 会话获取接收侧 ANR 模式。更多

ZFUNC ZINT	Mtc_SessSetVadEnable (ZULONG dwSessId, ZBOOL bEnable)
	MTC 会话设置 VAD 状态。更多

ZFUNC ZINT	Mtc_SessGetVadEnable (ZULONG dwSessId, ZBOOL *pbEnable)
	MTC 会话获取 VAD 状态。更多

ZFUNC ZINT	Mtc_SessSetVadMode (ZULONG dwSessId, ZUCHAR ucMode)
	MTC 会话设置 VAD 模式。更多

ZFUNC ZINT	Mtc_SessGetVadMode (ZULONG dwSessId, ZUCHAR *pucMode)
	MTC 会话获取 VAD 模式。更多

ZFUNC ZINT	Mtc_SessEnhanceColor (ZULONG dwSessId, ZBOOL bEnable)
	MTC 会话可用/不可用色彩增强。更多

ZFUNC ZINT	Mtc_SessArsEnableCpuCtrl (ZULONG dwSessId, ZBOOL bEnable)
	MTC 会话可用/不可用 CPU 加载控制。更多

ZFUNC ZINT	Mtc_SessArsSetCupCtrlTgt (ZULONG dwSessId, ZUINT iLoad)
	MTC 会话设置 CPU 加载控制目标使用百分比。更多

ZFUNC ZINT	Mtc_SessArsEnableBem (ZULONG dwSessId, ZBOOL bEnable)
	MTC 会话可用/不可用带宽有效模式。更多

ZFUNC ZINT	Mtc_SessRecRecvVideoStart (ZULONG dwSessId, ZCONST ZCHAR *pcFileName, ZUCHAR ucFileType, ZUINT iWidth, ZUINT iHeight, ZBOOL bWithAudio)
	MTC 会话开始录制呼入视频。更多

ZFUNC ZINT	Mtc_SessRecRecvVideoStop (ZULONG dwSessId)
	MTC 会话停止录制呼入视频。更多

ZFUNC ZINT	Mtc_SessRecSendVideoStart (ZULONG dwSessId, ZCONST ZCHAR *pcFileName, ZUCHAR ucFileType, ZUINT iWidth, ZUINT iHeight, ZBOOL bWithAudio)
	MTC 会话开始录制发送视频。更多

ZFUNC ZINT	Mtc_SessRecSendVideoStop (ZULONG dwSessId)
	MTC 会话停止录制正在发送的视频。更多

ZFUNC ZINT	Mtc_SessRenderSnapshot (ZULONG dwSessId, ZCONST ZCHAR *pcFileName)
	抓拍显示渲染。更多

ZFUNC ZINT	Mtc_SessCaptureSnapshot (ZULONG dwSessId, ZCONST ZCHAR *pcFileName)
	截图抓拍。更多

ZFUNC ZCHAR *	Mtc_SessGetStatDesc (ZULONG dwStatCode)
	MTC 会话获取终止原因描述。更多

详细描述

MTC 呼叫接口函数。

该文件包括呼叫接口函数。这些函数用于管理呼叫。

宏定义说明

#define MTC_CALL_ERR_NO (MTC_EBASE_CALL + 0)

MTC 呼叫状态代码（错误无或终止代码）。

没有错误。

#define MTC_CALL_REC_FILE_PCM "pcm"

MTC 呼叫记录文件类型

pcm 内容

枚举类型说明

enum EN_MTC_CALL_ALERT_INFO_TYPE

MTC 呼叫提醒信息类型

枚举值
EN_MTC_CALL_ALERT_INFO_NULL	没有提醒信息
EN_MTC_CALL_ALERT_INFO_DR0	bellcore_dr0
EN_MTC_CALL_ALERT_INFO_DR1	bellcore_dr1
EN_MTC_CALL_ALERT_INFO_DR2	bellcore_dr2
EN_MTC_CALL_ALERT_INFO_DR3	bellcore_dr3
EN_MTC_CALL_ALERT_INFO_DR4	bellcore_dr4
EN_MTC_CALL_ALERT_INFO_DR5	bellcore_dr5

enum EN_MTC_CALL_DTMF_TYPE

MTC 呼叫 dtmf 类型

枚举值
EN_MTC_CALL_DTMF_0	DTMF 信号 0.
EN_MTC_CALL_DTMF_1	DTMF 信号 1.
EN_MTC_CALL_DTMF_2	DTMF 信号 2.
EN_MTC_CALL_DTMF_3	DTMF 信号 3.
EN_MTC_CALL_DTMF_4	DTMF 信号 4.
EN_MTC_CALL_DTMF_5	DTMF 信号 5.
EN_MTC_CALL_DTMF_6	DTMF 信号 6.
EN_MTC_CALL_DTMF_7	DTMF 信号 7.
EN_MTC_CALL_DTMF_8	DTMF 信号 8.
EN_MTC_CALL_DTMF_9	DTMF 信号 9.
EN_MTC_CALL_DTMF_STAR	DTMF 信号 *.
EN_MTC_CALL_DTMF_POUND	DTMF 信号 #.
EN_MTC_CALL_DTMF_A	DTMF 信号 A.
EN_MTC_CALL_DTMF_B	DTMF 信号 B.
EN_MTC_CALL_DTMF_C	DTMF 信号 C.
EN_MTC_CALL_DTMF_D	DTMF 信号 D.

enum EN_MTC_CALL_EM_STATUS_TYPE

MTC 呼叫早期媒体方向

枚举值
EN_MTC_CALL_EM_STATUS_INACTIVE	不活跃
EN_MTC_CALL_EM_STATUS_SENDONLY	仅发送
EN_MTC_CALL_EM_STATUS_RECVONLY	仅接收
EN_MTC_CALL_EM_STATUS_SENDRECV	兼有

enum EN_MTC_CALL_REC_MODE_TYPE

MTC 呼叫记录模式类型

枚举值
EN_MTC_CALL_REC_MODE_ALL	录制所有数据
EN_MTC_CALL_REC_MODE_PLAY	录制正在播放数据
EN_MTC_CALL_REC_MODE_MIC	录制麦克风数据

enum EN_MTC_CALL_TERM_REASON_TYPE

MTC 呼叫终止原因类型

枚举值
EN_MTC_CALL_TERM_REASON_NORMAL	一般会话终止，挂断或取消
EN_MTC_CALL_TERM_REASON_BUSY	会话被拒绝
EN_MTC_CALL_TERM_REASON_DECLINE	拒绝会话
EN_MTC_CALL_TERM_REASON_NOT_AVAILABLE	用户不可用

enum EN_MTC_CALL_TRANSMISSION_STATE

MTC 呼叫传输状态类型

枚举值
EN_MTC_CALL_TRANSMISSION_NORMAL	传输正常， 'nrml'.
EN_MTC_CALL_TRANSMISSION_CAMOFF	传输中断，因为摄像头关闭， 'coff'.
EN_MTC_CALL_TRANSMISSION_PAUSE	传输中断， 'pasd'.
EN_MTC_CALL_TRANSMISSION_PAUSE4QOS	传输中断因为 QoS 原因， 'pqos'.

enum EN_MTC_NET_STATUS_TYPE

MTC 网络状态类型。

枚举值
EN_MTC_NET_STATUS_DISCONNECTED	从网络断开连接。
EN_MTC_NET_STATUS_VERY_BAD	网络状态很差。
EN_MTC_NET_STATUS_BAD	网络状态差。
EN_MTC_NET_STATUS_NORMAL	网络状态正常。
EN_MTC_NET_STATUS_GOOD	网络状态好。
EN_MTC_NET_STATUS_VERY_GOOD	网络状态非常好。
EN_MTC_NET_STATUS_BAD	网络状态不佳。
EN_MTC_NET_STATUS_NORMAL	网络状态正常。

enum EN_MTC_ORIENTATION_TYPE

设备方向类型。

枚举值
EN_MTC_ORIENTATION_PORTRAIT	在底部显示如头像、返回键。
EN_MTC_ORIENTATION_LANDSCAPE_RIGHT	在右侧显示如风景、返回键。
EN_MTC_ORIENTATION_PORTRAIT_UPSIDEDOWN	在顶部显示如头像、返回键。
EN_MTC_ORIENTATION_LANDSCAPE_LEFT	在右侧显示如风景、返回键。

enum EN_MTC_SESSION_STATE_TYPE

枚举值
EN_MTC_SESSION_STATE_IDLE	会话状态为闲置。
EN_MTC_SESSION_STATE_OUTGOING	会话状态为呼出。
EN_MTC_SESSION_STATE_INCOMING	会话状态为呼入。
EN_MTC_SESSION_STATE_ALERTED	会话状态为提示。
EN_MTC_SESSION_STATE_CONNECTING	会话状态为正在连接。
EN_MTC_SESSION_STATE_TALKING	会话状态为正在通话。
EN_MTC_SESSION_STATE_ENDED	会话状态结束。
EN_MTC_SESSION_STATE_DIDEND	回话状态拒绝。

函数说明

ZFUNC ZINT Mtc_SessAlert (ZULONG dwSessId, ZCOOKIE zCookie, ZULONG dwType, ZBOOL bReliable )

MTC 会话提醒呼入会话。

参数

[in]	dwSessId	你想要应答的呼入会话的 ID。
[in]	zCookie	与 UI 资源相符。 The cookie 值可在会话中的任何时间由 Rse_SessGetCookie 获取或由 Rse_SessSetCookie 重设。
[in]	dwType	提醒类型，EN_MTF_ALERT_TYPE。
[in]	bReliable	若为 ZTRUE，消息将作为可靠的临时回应被发送。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessCall, Mtc_SessGetCookie, Mtc_SessSetCookie

ZFUNC ZINT Mtc_SessAnswer (ZULONG dwSessId, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo )

MTC 会话应答由 Mtc_CallCbSetIncoming 所设回调通知的呼入会话呼叫。

参数

[in]	dwSessId	你想要应答的呼入会话的 ID。
[in]	zCookie	与 UI 资源相符。cookie 值可在会话中任意时间由 Mtc_SessGetCookie 获取或由 Mtc_SessSetCookie 重设。
[in]	bAudio	指该呼叫是否有音频流
[in]	bVideo	指该呼叫是否有视频流。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessCall, Mtc_CallCbSetIncoming, Mtc_SessGetCookie, Mtc_SessSetCookie

ZFUNC ZINT Mtc_SessArsEnableBem (ZULONG dwSessId, ZBOOL bEnable )

MTC 会话可用/不可用带宽有效模式。

参数

[in]	dwSessId	会话 ID。
[in]	bEnable	ZTRUE 可用带宽有效模式。 ZFALSE 不可用带宽有效模式。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessArsEnableCpuCtrl (ZULONG dwSessId, ZBOOL bEnable )

MTC 会话可用/不可用 CPU 加载控制。

参数

[in]	dwSessId	会话 ID。
[in]	bEnable	ZTRUE 可用 CPU 加载控制。 ZFALSE 不可用 CPU 加载控制。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessArsSetCupCtrlTgt (ZULONG dwSessId, ZUINT iLoad )

MTC 会话设置 CPU 加载控制目标使用百分比。

参数

[in]	dwSessId	会话 ID。
[in]	iLoad	CPU 加载控制目标使用百分比，应为0到100.

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessATrsf (ZULONG dwSessId, ZULONG dwTrsfSessId )

MTC 会话参与转发。

若参与转发成功，GUI 将由 Mtc_CallCbSetTrsfAcpt 所设置的回调通知。

若参与转发失败，GUI 将由 Mtc_CallCbSetTrsfFailed, Mtc_CallCbSetTrsfTerm 所设置的回调通知。

当接收参与转发，GUI 将由 Mtc_CallCbSetRefered 所设置的回调通知。

参数

[in]	dwSessId	你想要参与转发的会话的 ID。
[in]	dwTrsfSessId	你想要转发此会话的目标会话。

返回值

ZOK	若成功。
ZFAILED	若失败。

若你与用户 A 同在一个会话（由 dwSessId 说明）且与用户 B 同在一个会话（由 dwTrsfSessId 说明），参与转发的结果为 A 将与 B 同在一个会话，且你所在的所有会话将终止。

参见: Mtc_SessUTrsf

ZFUNC ZUINT Mtc_SessAudioJitter (ZULONG dwSessId)

MTC 获取音频流震动。

参数

[in] dwSessId 会话 ID。

返回: 以毫秒为单位震动。

参见: Mtc_SessVideoJitter

ZFUNC ZUINT Mtc_SessAudioLostCount (ZULONG dwSessId)

MTC 获取音频流的丢失数量。

参数

[in] dwSessId 会话 ID。

返回: 总丢失数量。

参见: Mtc_SessVideoLostRatio

ZFUNC ZUINT Mtc_SessAudioLostRatio (ZULONG dwSessId)

MTC 获取音频流中的百分比丢失率。

参数

[in] dwSessId 会话 ID。

返回: 百分比丢失率（0-1000）。

参见: Mtc_SessVideoLostRatio

ZFUNC ZUINT Mtc_SessAudioRtt (ZULONG dwSessId)

MTC 获取音频流往返一次时间。

参数

[in] dwSessId 会话 ID。

返回: 以毫秒为单位往返一次时间。

参见: Mtc_SessVideoRtt

ZFUNC ZULONG Mtc_SessCall (ZCHAR * pcUri, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo )

MTC 呼叫，建立带有视频或音频的会话呼叫。

若发送一个新的呼叫，并且并且被呼叫方应答，GUI 将由 Mtc_CallCbSetAlerted, Mtc_CallCbSetTalking 所设置的回调通知。

若发送一个新的呼叫，并且被呼叫方中心定向，GUI 将由 Mtc_CallCbSetOutgoing, Mtc_CallCbSetAlerted, Mtc_CallCbSetTalking 所设置的回调通知。

若发送一个新的呼叫，并且被呼叫方没有应答（超时，正忙等），GUI 将由 Mtc_CallCbSetAlerted, Mtc_CallCbSetTermed 所设置的回调通知。

当接收呼叫请求，GUI 将由 Mtc_CallCbSetIncoming 所设置的回调通知。

当接收呼叫请求，并且会话存在，GUI 将由 Mtc_CallCbSetReplaced 所设置的回调通知。

参数

[in]	pcUri	你想要拨打会话呼叫的目标 URI。
[in]	zCookie	与 UI 资源复合。 cookie 值可在会话中的任何时间由 Mtc_SessGetCookie 获取，或由 Mtc_SessSetCookie 重设。
[in]	bAudio	指该呼叫是否有音频流。
[in]	bVideo	指该呼叫是否有视频流。

返回: 这一新建会话的 ID，若成功，否则返回 ZMAXULONG。

参见: Mtc_SessAnswer, Mtc_SessGetCookie, Mtc_SessSetCookie

ZFUNC ZULONG Mtc_SessCallX (ZCHAR * pcUri, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo, ZBOOL bSend, ZBOOL bRecv )

MTC 呼叫，建立有视频或音频的会话呼叫。

若发送一个新的呼叫，并且被呼叫方应答，GUI 将由 Mtc_CallCbSetAlerted, Mtc_CallCbSetTalking 所设置的回调通知。

若发送一个新的呼叫，并且被呼叫方重新定向，GUI 将由 Mtc_CallCbSetOutgoing, Mtc_CallCbSetAlerted, Mtc_CallCbSetTalking 所设置的回调通知。

若发送一个新的呼叫，并且被呼叫方没有应答（超时、正忙等），GUI 将由 Mtc_CallCbSetAlerted, Mtc_CallCbSetTermed 所设置的回调通知。

当接收呼叫请求，GUI 将由 Mtc_CallCbSetIncoming 所设置的回调通知。

当接收呼叫邀请且会话存在，GUI 将由 Mtc_CallCbSetReplaced 所设置的回调通知。

参数

[in]	pcUri	你想要拨打会话呼叫的目标 URI。
[in]	zCookie	与 UI 资源相符。cookie 值可在会话中任意时间由 Mtc_SessGetCookie 获取或由 Mtc_SessSetCookie 重设。
[in]	bAudio	指该呼叫是否有音频流。
[in]	bVideo	指该呼叫是否有视频流。
[in]	bSend	指该通话是否在建立完成后开始发送。
[in]	bRecv	指该通话是否在建立完成后开始接收。

返回: 新建会话 ID，若成功，否则返回 ZMAXULONG。

参见: Mtc_SessAnswer, Mtc_SessGetCookie, Mtc_SessSetCookie

ZFUNC ZINT Mtc_SessCameraAttach (ZULONG dwSessId)

MTC 会话附带摄像头。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessCameraDetach (ZULONG dwSessId)

MTC 会话没有摄像头。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessCaptureSnapshot (ZULONG dwSessId, ZCONST ZCHAR * pcFileName )

截图抓拍。

参数

[in]	dwSessId	会话 ID。
[in]	pcFileName	存储照片的文件名称。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessRenderSnapshot

ZFUNC ZINT Mtc_SessDiv (ZULONG dwSessId, ZCHAR * pcUri )

MTC 会话将转换由 Mtc_CallCbSetIncoming 所设的回调通知的呼入会话呼叫。

当接收前转，GUI 将由 Mtc_CallCbSetRedirected 所设置的回调通知。

参数

[in]	dwSessId	你想要转换的会话的 ID。
[in]	pcUri	转换目标 URI。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_CallCbSetIncoming

ZFUNC ZINT Mtc_SessDtmf (ZULONG dwSessId, ZULONG dwDtmfType )

MTC 会话发送 DTMF 信息。

参数

[in]	dwSessId	你想要发送 DTMF 信息的会话 ID。
[in]	dwDtmfType	将被发送的 DTMF 类型，见 EN_MTC_CALL_DTMF_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessEnhanceColor (ZULONG dwSessId, ZBOOL bEnable )

MTC 会话可用/不可用色彩增强。

参数

[in]	dwSessId	会话 ID。
[in]	bEnable	ZTRUE 可用色彩增强， ZFALSE 不可用色彩增强。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZULONG Mtc_SessGetAlertInfo (ZULONG dwSessId)

MTC 会话获取提醒信息类型。

参数

[in] dwSessId 你想要获取的会话的 ID。

返回值

ref EN_MTC_CALL_ALERT_INFO_TYPE。

此函数获取的信息事实上来自 SIP 消息中的提醒-信息头域。

ZFUNC ZCONST ZCHAR* Mtc_SessGetAudioStat (ZULONG dwSessId)

Mtc 会话获取语音统计。

参数

[in] dwSessId 会话 ID。

返回值

音频统计字符串。

ZFUNC ZINT Mtc_SessGetCallId (ZULONG dwSessId, ZCHAR ** ppcCallId )

MTC 会话获取呼叫-ID 字符串。

参数

[in]	dwSessId	你想要获取的会话的 ID。
[out]	ppcCallId	呼叫-ID 字符串。

调用方必须先复制参数，再使用。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZCOOKIE Mtc_SessGetCookie (ZULONG dwSessId)

MTC 会话获取 cookie 值。

参数

[in] dwSessId 你想要获取 cookie 值的会话的 ID。

返回: 会话 cookie。

cookie 值可由 Mtc_SessCall, Mtc_SessAnswer 或 Mtc_SessSetCookie 提前设置。

参见: Mtc_SessCall, Mtc_SessAnswer, Mtc_SessSetCookie

ZFUNC ZULONG Mtc_SessGetEarlyMediaStatus (ZULONG dwSessId, ZBOOL bVideo )

MTC 会话获取早期媒体状态。

参数

[in]	dwSessId	你想要获取其早期媒体状态的会话的 ID。
[in]	bVideo	若为 ZTRUE，获取视频状态，否则获取音频状态。

返回值

ref EN_MTC_CALL_EM_STATUS_TYPE.

参见: Mtc_SessHasOfferAnswer

ZFUNC ZBOOL Mtc_SessGetMicMute (ZULONG dwSessId)

MTC 会话获取麦克风静音状态。

参数

[in] dwSessId 你想要获取的会话的 ID。

返回值

ZTRUE	若静音。
ZFALSE	若不静音。

参见: Mtc_SessSetMicMute

ZFUNC ZFLOAT Mtc_SessGetMicScale (ZULONG dwSessId)

MTC 会话获取麦克风范围。

参数

[in] dwSessId 你想要获取的会话的 ID。

返回: 范围值，从 0.0 到 10.0， 1.0 表示没有缩放。

参见: Mtc_SessSetMicScale

ZFUNC ZBOOL Mtc_SessGetMixVoice (ZULONG dwSessId)

MTC 会话获取混音状态。

参数

[in] dwSessId 你想要获取的会话的 ID。

返回: 混音状态。

ZFUNC ZINT Mtc_SessGetPeerId (ZULONG dwSessId, ZCHAR ** ppcDispName, ZCHAR ** ppcUri )

MTC 会话获取对方 ID，基于规则。

参数

[in]	dwSessId	你想要获取的会话的 ID。
[out]	ppcDispName	与你同在一个会话的对方用户的显示名称。
[out]	ppcUri	与你同在一个会话的对方用户 URI。

调用方必须先复制参数，再使用。

返回值

ZOK	若成功。
ZFAILED	若失败。

注意该函数结果可能与 Mtc_SessGetPeerUri 不同，因为规则应用。如 OIP, OIR, TIP, TIR, 和私人。

参见: Mtc_SessGetPeerUri

ZFUNC ZINT Mtc_SessGetPeerUri (ZULONG dwSessId, ZCHAR ** ppcDispName, ZCHAR ** ppcUri )

MTC 会话获取对方 URI 及显示名称。

参数

[in]	dwSessId	你想要获取的会话的 ID。
[out]	ppcDispName	对方用户显示名称。
[out]	ppcUri	对方用户 URI。

调用方必须先复制参数，再使用。

返回值

ZOK	若成功。
ZFAILED	若失败。

有此函数获取的对方信息事实上来自 FROM/TO SIP 消息中的头域。所以对方用户的真实身份不是由服务器提醒的。

参见: Mtc_SessGetPeerId

ZFUNC ZINT Mtc_SessGetRxAgcEnable (ZULONG dwSessId, ZBOOL * pbEnable )

MTC 会话获取接收侧 AGC 状态。

参数

[in]	dwSessId	会话 ID。
[out]	*pbEnable	当前 Rx-AGC 状态。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessSetRxAgcEnable

ZFUNC ZINT Mtc_SessGetRxAgcMode (ZULONG dwSessId, ZUCHAR * pucMode )

MTC 会话获取接收侧 AGC 模式。

参数

[in]	dwSessId	会话 ID。
[out]	*pucMode	Rx-AGC 模式，EN_MTC_RX_GC_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessSetRxAgcMode

ZFUNC ZINT Mtc_SessGetRxAgcTarget (ZULONG dwSessId, ZUSHORT * pwTargetDb )

MTC 会话获取接收侧 AGC 目标 dBOV。

参数

[in]	dwSessId	会话 ID。
[out]	*pwTargetDb	Rx-AGC 目标 dBOV。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessSetRxAgcTarget

ZFUNC ZINT Mtc_SessGetRxAnrEnable (ZULONG dwSessId, ZBOOL * pbEnable )

MTC 会话获取接收侧 ANR 状态。

参数

[in]	dwSessId	会话 ID。
[out]	*pbEnable	Rx-ANR 当前状态。.

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessSetRxAnrEnable

ZFUNC ZINT Mtc_SessGetRxAnrMode (ZULONG dwSessId, ZUCHAR * pucMode )

MTC 会话获取接收侧 ANR 模式。

参数

[in]	dwSessId	会话 ID。
[out]	*pucMode	Rx-ANR 模式，EN_MTC_NS_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessSetRxAnrMode

ZFUNC ZBOOL Mtc_SessGetSpkMute (ZULONG dwSessId)

MTC 会话获取扬声器静音状态。

参数

[in] dwSessId 你想要获取的会话的 ID。

返回值

ZTRUE	若静音。
ZFALSE	若不静音。

参见: Mtc_SessSetSpkMute

ZFUNC ZFLOAT Mtc_SessGetSpkScale (ZULONG dwSessId)

MTC 会话获取扬声器范围。

参数

[in] dwSessId 你想要获取的会话的 ID。

返回: 范围值，从 0.0 到 10.0， 1.0 表示没有缩放。

参见: Mtc_SessSetSpkScale

ZFUNC ZUINT Mtc_SessGetSpkVol (ZULONG dwSessId)

MTC 会话获取扬声器音量。

参数

[in] dwSessId 你想要获取的会话的 ID。

返回: 音量值，从 0 到 20。

参见: Mtc_SessSetSpkVol

ZFUNC ZCHAR* Mtc_SessGetStatDesc (ZULONG dwStatCode)

MTC 会话获取终止原因描述。

参数

[in] dwStatCode 状态代码。

返回: 状态代码描述，若成功，否则返回 "未知"。

ZFUNC ZINT Mtc_SessGetVadEnable (ZULONG dwSessId, ZBOOL * pbEnable )

MTC 会话获取 VAD 状态。

参数

[in]	dwSessId	会话 ID。
[out]	*pbEnable	当前 VAD 状态。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessSetVadEnable

ZFUNC ZINT Mtc_SessGetVadMode (ZULONG dwSessId, ZUCHAR * pucMode )

MTC 会话获取 VAD 模式。

参数

[in]	dwSessId	会话 ID。
[out]	*pucMode	VAD 模式，EN_MTC_VAD_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessSetVadMode

ZFUNC ZINT Mtc_SessGetVideoLocalSize (ZULONG dwSessId, ZULONG * pdwWidth, ZULONG * pdwHeight )

MTC 会话获取本地视频大小。

参数

[in]	dwSessId	会话 ID。
[out]	pdwWidth	特定会话视频像素宽度。
[out]	pdwHeight	特定会话视频像素高度。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessGetVideoRemoteSize (ZULONG dwSessId, ZULONG * pdwWidth, ZULONG * pdwHeight )

MTC 会话获取远程视频大小。

参数

[in]	dwSessId	会话 ID。
[out]	pdwWidth	特定会话视频像素宽度。
[out]	pdwHeight	特定会话视频像素高度。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessGetVideoSize (ZULONG dwSessId, ZULONG * pdwWidth, ZULONG * pdwHeight )

MTC 会话获取视频大小。

参数

[in]	dwSessId	会话 ID。
[out]	pdwWidth	在特定会话内视频像素宽度。
[out]	pdwHeight	在特定会话内视频像素高度。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZCONST ZCHAR* Mtc_SessGetVideoStat (ZULONG dwSessId)

Mtc 会话获取视频统计。

参数

[in] dwSessId 会话 ID。

返回值

视频统计字符串。

ZFUNC ZBOOL Mtc_SessHasAudio (ZULONG dwSessId)

MTC 会话检查是否有活跃音频流。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若是。
ZFAILED	若否。

参见: Mtc_SessHasVideo

ZFUNC ZBOOL Mtc_SessHasHeld (ZULONG dwSessId)

MTC 检查会话已经进入被保持状态。

参数

[in] dwSessId 会话 ID。

返回值

ZTRUE	若在被保持状态。
ZFALSE	若不在被保持状态。

参见: Mtc_SessHasHold

ZFUNC ZBOOL Mtc_SessHasHold (ZULONG dwSessId)

MTC 检查会话已经进入保持状态。

参数

[in] dwSessId 会话 ID。

返回值

ZTRUE	若在保持状态。
ZFALSE	若不在保持状态。

参见: Mtc_SessHasHeld

ZFUNC ZBOOL Mtc_SessHasOfferAnswer (ZULONG dwSessId)

MTC 会话检查提供/应答交换是否完成。

参数

[in] dwSessId 会话 ID。

返回值

ZTRUE	若提供有应答。
ZFALSE	若提供没有应答。

参见: Mtc_SessGetEarlyMediaStatus

ZFUNC ZBOOL Mtc_SessHasTalk (ZULONG dwSessId)

MTC 检查会话已经进入对话状态。

参数

[in] dwSessId 会话 ID。

返回值

ZTRUE	若在对话状态。
ZFALSE	若不在对话状态。

参见: Mtc_SessCall, Mtc_SessAnswer

ZFUNC ZBOOL Mtc_SessHasVideo (ZULONG dwSessId)

MTC 会话检查是否有活跃视频流。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若是。
ZFAILED	若否。

参见: Mtc_SessVideoStart, Mtc_SessVideoStop, Mtc_SessHasAudio

ZFUNC ZINT Mtc_SessHold (ZULONG dwSessId)

MTC 会话保持。

当发送会话保持成功，GUI 将由 Mtc_CallCbSetHoldOk 所设置的回调通知。

当发送会话保持失败，GUI 将由 Mtc_CallCbSetHoldFailed 所设置的回调通知。

当接收会话保持，GUI 将由 Mtc_CallCbSetHeld 所设置的回调通知。

参数

[in] dwSessId 你想要保持的会话的 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessUnhold

ZFUNC ZINT Mtc_SessInfo (ZULONG dwSessId, ZCHAR * pcInfo )

MTC 会话发送带有文本的 INFO。

参数

[in]	dwSessId	你想要发送 INFO 的会话 ID。
[in]	pcInfo	INFO 所携带的文本字符串。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessPartpGetIds (ZULONG dwSessId, ZUINT * piPartpIds, ZUINT * piPartpCnt )

获取所有成员 ID。

参数

[in]	dwSessId	会话 ID。
[in,out]	piPartpIds	指返回时被用户填满的缓存。
[in,out]	piPartpCnt	指 piPartpIds 可存储的最大数量。在返回后，它包含 piPartpIds 所存储的实际适量。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessPartpGetRenderArea (ZULONG dwSessId, ZUINT * piPartpIds, ZUINT iPartpCnt, ZUINT * piAreaIndexs )

为每一位成员获取渲染区域索引。

参数

[in]	dwSessId	会话 ID。
[in]	piPartpIds	成员 ID 阵列。
[in]	iPartpCnt	成员 ID 数量。
[in]	piAreaIndexs	指在 piPartpIds 内将填满每一个用户 ID 的渲染区域索引缓冲值得范围为0到个数-1，由 Mtc_SessRenderAdd 和 Mtc_SessRenderReset 设置。若成员当前没有被渲染，值为 ZMAXUINT。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessPartpGetIds, Mtc_SessPartpSetRenderArea

ZFUNC ZINT Mtc_SessPartpGetRtpInfo (ZULONG dwSessId, ZUINT iPartpId, ZUINT * piSsrc, ZUINT * piIp, ZUSHORT * pwPort )

获取特定成员 ID 的 RTP。

参数

[in]	dwSessId	会话 ID。
[in]	iPartpId	成员 ID。
[in,out]	piSsrc	指填满 SSRC 值得数据。
[in,out]	piIp	指填满 IP 地址的数据。
[in,out]	pwPort	指填满端口的数据。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessPartpGetIds

ZFUNC ZINT Mtc_SessPartpSetRenderArea (ZULONG dwSessId, ZUINT * piPartpIds, ZUINT iPartpCnt, ZUINT * piAreaIndexs )

设置每一位用户的渲染区域索引。

参数

[in]	dwSessId	会话 ID。
[in]	piPartpIds	成员 ID 列阵。
[in]	iPartpCnt	成员 ID 数量。
[in]	piAreaIndexs	每位成员渲染区域索引的阵列。值范围应在0到格式-1内，由 Mtc_SessRenderAdd 和 Mtc_SessRenderReset 设置。所以其他值将被分配到 ZMAXUINT，这意味着成员当前不应被渲染。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessPartpGetIds, Mtc_SessPartpGetRenderArea

ZFUNC ZBOOL Mtc_SessPeerIsFocus (ZULONG dwSessId)

MTC 会话检查对方是否包含焦点参数。

参数

[in] dwSessId 会话 ID。

返回值

ZTRUE	若对方有焦点。
ZFALSE	若对方没有焦点。

ZFUNC ZBOOL Mtc_SessPeerOfferAudio (ZULONG dwSessId)

MTC 会话检查对方是否提供音频流。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若是。
ZFAILED	若否。

参见: Mtc_SessPeerOfferVideo

ZFUNC ZBOOL Mtc_SessPeerOfferVideo (ZULONG dwSessId)

MTC 会话检查对方是否提供视频流。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若是。
ZFAILED	若否。

参见: Mtc_SessVideoStart, Mtc_SessVideoStop, Mtc_SessPeerOfferAudio

ZFUNC ZULONG Mtc_SessPickUp (ZCHAR * pcUri, ZCHAR * pcReplaceInfo, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo )

MTC PickUp, 通过取代特定会话建立带有视频或音频的会话呼叫。

若被呼叫方接收新会话呼叫，GUI 将由 Mtc_CallCbSetTalking 所设置的回调通知。

若被呼叫方拒绝新会话呼叫，或无人应答，GUI 将由 Mtc_CallCbSetTermed 所设置的回调通知。

参数

[in]	pcUri	你想要拨打会话呼叫的目标 URI。
[in]	pcReplaceInfo	用户定位被取代呼叫的取代信息。格式必须遵照 RFC3891，如 '42592.nosp@m.8@ph.nosp@m.one.e.nosp@m.xamp.nosp@m.le.or.nosp@m.g;to-tag=7743;from-tag=6472'。
[in]	zCookie	与 UI 资源相符。 cookie值可在会话的任何时间中由 Mtc_SessGetCookie 获取或由 Mtc_SessSetCookie 重设。
[in]	bAudio	指该呼叫是否有音频流
[in]	bVideo	指该呼叫是否有视频流。

返回: 新建会话 ID，若成功，否则返回 ZMAXULONG。

参见: Mtc_SessPickUpX

ZFUNC ZINT Mtc_SessPickUpX (ZULONG dwSessId)

MTC 会话 PickUp, 通过取代特定的呼叫建立带有视频或音频的会话呼叫。

参数

[in] dwSessId 所获得的会话 ID 说明。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessPickUp

ZFUNC ZINT Mtc_SessPreviewSetArea (ZULONG dwSessId, ZVIDEOHANDLE dwHandle, ZSHORT wX, ZSHORT wY, ZUSHORT wWidth, ZUSHORT wHeight )

MTC 会话设置预览区域。

参数

[in]	dwSessId	会话 ID。
[in]	dwHandle	显示本地图像的窗口句柄。
[in]	wX	本地图片左上角 X 值。
[in]	wY	本地图片左上角 Y 值。
[in]	wWidth	本地图片宽度。
[in]	wHeight	本地图片高度。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessPreviewShow (ZULONG dwSessId, ZBOOL bShow )

MTC 会话显示或隐藏预览图片。

参数

[in]	dwSessId	会话 ID。
[in]	bShow	ZTRUE 显示图片， ZFALSE 隐藏。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRecCallStart (ZCONST ZCHAR * pcFileName, ZUCHAR ucFileType )

录制呼叫开始。

它将从呼叫录制到文件。

参数

[in]	pcFileName	录音文件名称。
[in]	ucFileType	录音文件类型， EN_MTC_MFILE_TYPE

返回值

ZOK	语音录制成功。
ZFAILED	语音录制失败。

参见: Mtc_SessRecCallStop

ZFUNC ZINT Mtc_SessRecCallStop (ZFUNC_VOID )

录音停止。

参见: Mtc_SessRecCallStart

ZFUNC ZINT Mtc_SessRecMicStart (ZCONST ZCHAR * pcFileName, ZUCHAR ucFileType )

录制麦克风开始。

它将从麦克风录制到文件。

参数

[in]	pcFileName	录制文件名称。
[in]	ucFileType	录制文件类型， EN_MTC_MFILE_TYPE

返回值

ZOK	音频录制成功。
ZFAILED	音频录制失败。

参见: Mtc_SessRecMicStop

ZFUNC ZINT Mtc_SessRecMicStop (ZFUNC_VOID )

录制音频停止。

参见: Mtc_SessRecMicStart

ZFUNC ZINT Mtc_SessRecPlayStart (ZULONG dwSessId, ZCONST ZCHAR * pcFileName, ZUCHAR ucFileType )

MTC 会话录音播放。

参数

[in]	dwSessId	你想要录音的会话的 ID。若 dwSessId 无效，录制混合播放。
[in]	pcFileName	录音文件名称。
[in]	ucFileType	录音文件类型， EN_MTC_MFILE_TYPE

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRecPlayStop (ZULONG dwSessId)

MTC 会话停止录制播放。

参数

[in] dwSessId 你想要停止录制的会话的 ID，若 dwSessId 无效，停止录制混合播放。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRecRecvVideoStart (ZULONG dwSessId, ZCONST ZCHAR * pcFileName, ZUCHAR ucFileType, ZUINT iWidth, ZUINT iHeight, ZBOOL bWithAudio )

MTC 会话开始录制呼入视频。

参数

[in]	dwSessId	会话 ID。
[in]	pcFileName	存储录制数据的文件名称。
[in]	ucFileType	文件类型，EN_MTC_MFILE_TYPE。
[in]	iWidth	录制数据的视频像素宽度。
[in]	iHeight	录制数据的视频像素高度。
[in]	bWithAudio	ZTRUE 录制音频数据。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessRecRecvVideoStop

ZFUNC ZINT Mtc_SessRecRecvVideoStop (ZULONG dwSessId)

MTC 会话停止录制呼入视频。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessRecRecvVideoStart

ZFUNC ZINT Mtc_SessRecSendVideoStart (ZULONG dwSessId, ZCONST ZCHAR * pcFileName, ZUCHAR ucFileType, ZUINT iWidth, ZUINT iHeight, ZBOOL bWithAudio )

MTC 会话开始录制发送视频。

参数

[in]	dwSessId	会话 ID。
[in]	pcFileName	存储录制数据的文件名称。
[in]	ucFileType	文件类型，EN_MTC_MFILE_TYPE。
[in]	iWidth	录制数据视频像素宽度。
[in]	iHeight	录制数据视频像素高度。
[in]	bWithAudio	ZTRUE 录制音频数据。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessRecSendVideoStop

ZFUNC ZINT Mtc_SessRecSendVideoStop (ZULONG dwSessId)

MTC 会话停止录制正在发送的视频。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessRecSendVideoStart

ZFUNC ZINT Mtc_SessRecSndStart (ZULONG dwSessId, ZCONST ZCHAR * pcFileName, ZUCHAR ucFileType, ZULONG dwRecMode )

Mtc 会话开始录制声音。

参数

[in]	dwSessId	你想要录制的会话的 ID。
[in]	pcFileName	录音文件名称。
[in]	ucFileType	录音文件类型， EN_MTC_MFILE_TYPE。
[in]	dwRecMode	录音模式。 EN_MTC_CALL_REC_MODE_TYPE.

参见: Mtc_SessRecSndStop

ZFUNC ZINT Mtc_SessRecSndStop (ZULONG dwSessId)

Mtc 会话停止录制声音。

参数

[in] dwSessId 会话 ID。

参见: Mtc_SessRecSndStart

ZFUNC ZINT Mtc_SessRenderAdd (ZULONG dwSessId, ZVIDEOHANDLE dwHandle, ZSHORT wX, ZSHORT wY, ZUSHORT wWidth, ZUSHORT wHeight )

MTC 会话设置远程图片的渲染区域。

参数

[in]	dwSessId	会话 ID。
[in]	dwHandle	显示远程图片的窗口句柄。
[in]	wX	远程图片左上角 X 值。
[in]	wY	远程图片左上角 Y 值。
[in]	wWidth	远程图片宽度。
[in]	wHeight	远程图片高度。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRenderBuild (ZULONG dwSessId)

MTC 会话建立渲染显示图片。

要在调用 Mtc_SessVideoStart 后更改渲染窗口，用户应：

调用 Mtc_SessPreviewShow 隐藏预览。
调用 Mtc_SessRenderRelease 释放渲染显示图片。
调用 Mtc_SessPreviewSetArea 设置新显示窗口。
调用 Mtc_SessRenderReset 重设区域数据。
调用 Mtc_SessRenderAdd 为远程图像添加新窗口句柄。
调用 Mtc_SessRenderBuild 重建渲染显示图片。
调用 Mtc_SessPreviewShow 显示预览。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRenderRelease (ZULONG dwSessId)

MTC 会话释放渲染显示图片。

要在调用 Mtc_SessVideoStart 后更改渲染窗口，用户应：

Invoke Mtc_SessPreviewShow 隐藏预览。
Invoke Mtc_SessRenderRelease 释放渲染显示图片。
Invoke Mtc_SessPreviewSetArea 设置新显示窗口。
Invoke Mtc_SessRenderReset 重设区域数据。
Invoke Mtc_SessRenderAdd 为远程图像添加新窗口句柄。
Invoke Mtc_SessRenderBuild 重建渲染显示图片。
Invoke Mtc_SessPreviewShow 显示预览。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRenderReset (ZULONG dwSessId)

MTC 会话充塞远程图片的渲染区域设置。

参数

[in] dwSessId 会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRenderSnapshot (ZULONG dwSessId, ZCONST ZCHAR * pcFileName )

抓拍显示渲染。

参数

[in]	dwSessId	会话 ID。
[in]	pcFileName	存储照片的文件名称。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessCaptureSnapshot

ZFUNC ZINT Mtc_SessRotateLocal (ZULONG dwSessId, ZUINT iOrientation )

MTC 会话旋转本地图片方向。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	iOrientation	图片方向。 EN_MTC_ORIENTATION_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessRotateRemote (ZULONG dwSessId, ZUINT iOrientation )

MTC 会话旋转远程图片方向。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	iOrientation	图片方向。 EN_MTC_ORIENTATION_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessSetCookie (ZULONG dwSessId, ZCOOKIE zCookie )

MTC 会话设置 cookie 值。

参数

[in]	dwSessId	你想要设置 cookie 值的会话的 ID。
[in]	zCookie	你想要设置的 cookie。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessCall, Mtc_SessAnswer, Mtc_SessGetCookie

ZFUNC ZINT Mtc_SessSetMicMute (ZULONG dwSessId, ZBOOL bMute )

MTC 会话设置麦克风静音状态。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	bMute	指麦克风是否静音。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetMicMute

ZFUNC ZINT Mtc_SessSetMicScale (ZULONG dwSessId, ZFLOAT fScale )

MTC 会话设置麦克风范围。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	fScale	范围值，从 0.0 到 10.0， 1.0 表示没有缩放。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetMicScale

ZFUNC ZINT Mtc_SessSetMixVoice (ZULONG dwSessId, ZBOOL bEnable )

MTC 会话设置混音状态。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	bEnable	值是否混音。若为 ZTRUE，它将混合相应会话语音。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessSetRxAgcEnable (ZULONG dwSessId, ZBOOL bEnable )

MTC 会话设置接收侧 AGC 状态。

参数

[in]	dwSessId	会话 ID。
[in]	bEnable	ZTRUE Rx-AGC可用，ZFALSE Rx-AGC 不可用。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetRxAgcEnable

ZFUNC ZINT Mtc_SessSetRxAgcMode (ZULONG dwSessId, ZUCHAR ucMode )

MTC 会话获取接收侧 AGC 模式。

参数

[in]	dwSessId	会话 ID。
[in]	ucMode	Rx-AGC 模式，EN_MTC_RX_GC_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetRxAgcMode

ZFUNC ZINT Mtc_SessSetRxAgcTarget (ZULONG dwSessId, ZUSHORT wTargetDb )

MTC 会话设置接收侧 AGC 目标 dBOV。

参数

[in]	dwSessId	会话 ID。
[in]	wTargetDb	Rx-AGC 目标 dBOV。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetRxAgcTarget

ZFUNC ZINT Mtc_SessSetRxAnrEnable (ZULONG dwSessId, ZBOOL bEnable )

MTC 会话设置接收侧 ANR 状态。

参数

[in]	dwSessId	会话 ID。
[in]	bEnable	ZTRUE 可用 Rx-ANR， ZFALSE 不可用 Rx-ANR。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetRxAnrEnable

ZFUNC ZINT Mtc_SessSetRxAnrMode (ZULONG dwSessId, ZUCHAR ucMode )

MTC 会话获取接收侧 ANR 模式。

参数

[in]	dwSessId	会话 ID。
[in]	ucMode	Rx-ANR 模式，EN_MTC_NS_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetRxAnrMode

ZFUNC ZINT Mtc_SessSetSpkMute (ZULONG dwSessId, ZBOOL bMute )

MTC 会话设置扬声器静音状态。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	bMute	指扬声器是否静音。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetSpkMute

ZFUNC ZINT Mtc_SessSetSpkScale (ZULONG dwSessId, ZFLOAT fScale )

MTC 会话设置扬声器范围。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	fScale	范围值，从 0.0 到 10.0，1.0 表示没有缩放。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetSpkScale

ZFUNC ZINT Mtc_SessSetSpkVol (ZULONG dwSessId, ZUINT iVol )

MTC 会话设置扬声器音量。

参数

[in]	dwSessId	你想要设置的会话的 ID。
[in]	iVol	音量值，从 0 到 20。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetSpkVol

ZFUNC ZINT Mtc_SessSetVadEnable (ZULONG dwSessId, ZBOOL bEnable )

MTC 会话设置 VAD 状态。

参数

[in]	dwSessId	会话 ID。
[in]	bEnable	ZTRUE 可用 VAD， ZFALSE 不可用 VAD。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetVadEnable

ZFUNC ZINT Mtc_SessSetVadMode (ZULONG dwSessId, ZUCHAR ucMode )

MTC 会话设置 VAD 模式。

参数

[in]	dwSessId	会话 ID。
[in]	ucMode	VAD 模式，EN_MTC_VAD_TYPE。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessGetVadMode

ZFUNC ZINT Mtc_SessTerm (ZULONG dwSessId, ZULONG dwReason )

MTC 会话终止。

参数

[in]	dwSessId	你想要终止的会话的 ID。
[in]	dwReason	指终止原因，它可能触发一些 S-CSCF 中的业务，见 EN_MTC_CALL_TERM_REASON_TYPE。

返回值

ZOK	若成功
ZFAILED	若失败。

事实上 Mtc_SessTerm 不释放所有分配给这一会话的资源。它只开启终止程序。所有资源将在程序结束时自动被释放。

参见: Mtc_SessCall, Mtc_SessAnswer...

ZFUNC ZINT Mtc_SessUnhold (ZULONG dwSessId)

MTC 会话取消保持。

若发送会话取消保持成功，GUI 将由 Mtc_CallCbSetUnHoldOk 所设置的回调通知。

若发送会话取消保持失败，GUI 将由 Mtc_CallCbSetUnHoldFailed 所设置的回调通知。

当接收会话取消保持，GUI 将由 Mtc_CallCbSetUnHeld 所设置的回调通知。

参数

[in] dwSessId 你想要取消保持的会话的 ID。你想要取消保持的会话的 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessUnhold

ZFUNC ZINT Mtc_SessUpdate (ZULONG dwSessId, ZBOOL bAudio, ZBOOL bVideo )

MTC 会话发送一个多媒体更新请求给对方。此函数内的更新说明打开一个新媒体流或关闭已存在的媒体流。

若发送更新成功，GUI 将由 Mtc_CallCbSetAddAudioOk, Mtc_CallCbSetRmvAudioOk, Mtc_CallCbSetAddVideoOk, Mtc_CallCbSetRmvVideoOk 所设置的回调通知。

若发送更新失败，GUI 将由 Mtc_CallCbSetAddAudioFailed, Mtc_CallCbSetRmvAudioFailed, Mtc_CallCbSetAddVideoFailed, Mtc_CallCbSetRmvVideoFailed 所设置的回调通知。

当接收更新，GUI 将由 Mtc_CallCbSetAddAudioReq, Mtc_CallCbSetAddVideoReq 所设置的回调通知。

参数

[in]	dwSessId	你想要更新媒体的会话的 ID。
[in]	bAudio	指你是否想在更新后有音频流。
[in]	bVideo	指你是否想在更新后有视频流。

返回值

ZOK	若成功。
ZFAILED	若失败。

若更新请求被对方接受，将有一个由 Mtc_CallCbSetMdfyAcpt 所设回调通知的说明。

参见: Mtc_SessUpdateRsp, Mtc_CallCbSetMdfyAcpt

ZFUNC ZINT Mtc_SessUpdateRsp (ZULONG dwSessId, ZBOOL bAudio, ZBOOL bVideo )

MTC 会话应答对方发出的媒体更新请求。此函数中的更新说明打开一个新的媒体流或关闭一个已存在的媒体流。

若发送协商成功，GUI 将由 Mtc_CallCbSetMdfyed 所设置的回调通知。

参数

[in]	dwSessId	你想要接收媒体更新的会话 ID。
[in]	bAudio	指你是否想要在更新后有音频流。
[in]	bVideo	指你是否想要在更新后有视频流。

返回值

ZOK	若成功。
ZFAILED	若失败。

参见: Mtc_SessUpdate, Mtc_CallCbSetMdfyReq

ZFUNC ZINT Mtc_SessUTrsf (ZULONG dwSessId, ZCHAR * pcUri )

MTC 会话无人转发。

若无人转发成功，GUI 将由 Mtc_CallCbSetTrsfAcpt 所设置的回调通知。

若无人转发失败，GUI 将由 Mtc_CallCbSetTrsfFailed, Mtc_CallCbSetTrsfTerm 所设置的回调通知。

当接收无人转发时，GUI 将由 Mtc_CallCbSetRefered 所设置的回调通知。

参数

[in]	dwSessId	你想要无人转发的会话的 ID。
[in]	pcUri	你想要转发此会话的目标 URI。

返回值

ZOK	若成功。
ZFAILED	若失败。

在这一操作后，会话将被服务器终止。

参见: Mtc_SessATrsf

ZFUNC ZUINT Mtc_SessVideoJitter (ZULONG dwSessId)

MTC 获取视频流震动。

参数

[in] dwSessId 会话 ID。

返回: 以毫秒为单位震动。

参见: Mtc_SessAudioJitter

ZFUNC ZUINT Mtc_SessVideoLostCount (ZULONG dwSessId)

MTC 获取视频流的丢失数量。

参数

[in] dwSessId 会话 ID。

返回: 总丢失数量。

参见: Mtc_SessAudioLostCount

ZFUNC ZUINT Mtc_SessVideoLostRatio (ZULONG dwSessId)

MTC 获取视频流中的百分比丢失率。

参数

[in] dwSessId 会话 ID。

返回: 百分比丢失率（0-1000）。

参见: Mtc_SessAudioLostRatio

ZFUNC ZINT Mtc_SessVideoPause (ZULONG dwSessId)

MTC 会话暂停发送视频。

参数

[in] dwSessId 你想要停止视频传输的会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessVideoResume (ZULONG dwSessId)

MTC 会话续传视频。

参数

[in] dwSessId 你想要停止视频传输的会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZUINT Mtc_SessVideoRtt (ZULONG dwSessId)

MTC 获取视频流往返一次时间。

参数

[in] dwSessId 会话 ID。

返回: 以毫秒为单位往返一次时间。

参见: Mtc_SessAudioRtt

ZFUNC ZINT Mtc_SessVideoStart (ZULONG dwSessId)

MTC 会话开始视频传输。

参数

[in] dwSessId 你想要开始视频传输的会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

ZFUNC ZINT Mtc_SessVideoStop (ZULONG dwSessId)

MTC 会话停止视频传输。

参数

[in] dwSessId 你想要停止视频传输的会话 ID。

返回值

ZOK	若成功。
ZFAILED	若失败。

rcs ios

mtc_call.h 文件参考

宏定义

类型定义

枚举

函数

详细描述

宏定义说明

#define MTC_CALL_ERR_NO (MTC_EBASE_CALL + 0)

#define MTC_CALL_REC_FILE_PCM "pcm"

枚举类型说明

enum EN_MTC_CALL_ALERT_INFO_TYPE

enum EN_MTC_CALL_DTMF_TYPE

enum EN_MTC_CALL_EM_STATUS_TYPE

enum EN_MTC_CALL_REC_MODE_TYPE

enum EN_MTC_CALL_TERM_REASON_TYPE

enum EN_MTC_CALL_TRANSMISSION_STATE

enum EN_MTC_NET_STATUS_TYPE

enum EN_MTC_ORIENTATION_TYPE

enum EN_MTC_SESSION_STATE_TYPE

函数说明

ZFUNC ZINT Mtc_SessAlert (ZULONG dwSessId, ZCOOKIE zCookie, ZULONG dwType, ZBOOL bReliable )

ZFUNC ZINT Mtc_SessAnswer (ZULONG dwSessId, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo )

ZFUNC ZINT Mtc_SessArsEnableBem (ZULONG dwSessId, ZBOOL bEnable )

ZFUNC ZINT Mtc_SessArsEnableCpuCtrl (ZULONG dwSessId, ZBOOL bEnable )

ZFUNC ZINT Mtc_SessArsSetCupCtrlTgt (ZULONG dwSessId, ZUINT iLoad )

ZFUNC ZINT Mtc_SessATrsf (ZULONG dwSessId, ZULONG dwTrsfSessId )

ZFUNC ZUINT Mtc_SessAudioJitter (ZULONG dwSessId)

ZFUNC ZUINT Mtc_SessAudioLostCount (ZULONG dwSessId)

ZFUNC ZUINT Mtc_SessAudioLostRatio (ZULONG dwSessId)

ZFUNC ZUINT Mtc_SessAudioRtt (ZULONG dwSessId)

ZFUNC ZULONG Mtc_SessCall (ZCHAR * pcUri, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo )

ZFUNC ZULONG Mtc_SessCallX (ZCHAR * pcUri, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo, ZBOOL bSend, ZBOOL bRecv )

ZFUNC ZINT Mtc_SessCameraAttach (ZULONG dwSessId)

ZFUNC ZINT Mtc_SessCameraDetach (ZULONG dwSessId)

ZFUNC ZINT Mtc_SessCaptureSnapshot (ZULONG dwSessId, ZCONST ZCHAR * pcFileName )

ZFUNC ZINT Mtc_SessDiv (ZULONG dwSessId, ZCHAR * pcUri )

ZFUNC ZINT Mtc_SessDtmf (ZULONG dwSessId, ZULONG dwDtmfType )

ZFUNC ZINT Mtc_SessEnhanceColor (ZULONG dwSessId, ZBOOL bEnable )

ZFUNC ZULONG Mtc_SessGetAlertInfo (ZULONG dwSessId)

ZFUNC ZCONST ZCHAR* Mtc_SessGetAudioStat (ZULONG dwSessId)

ZFUNC ZINT Mtc_SessGetCallId (ZULONG dwSessId, ZCHAR ** ppcCallId )

ZFUNC ZCOOKIE Mtc_SessGetCookie (ZULONG dwSessId)

ZFUNC ZULONG Mtc_SessGetEarlyMediaStatus (ZULONG dwSessId, ZBOOL bVideo )

ZFUNC ZBOOL Mtc_SessGetMicMute (ZULONG dwSessId)

ZFUNC ZFLOAT Mtc_SessGetMicScale (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessGetMixVoice (ZULONG dwSessId)

ZFUNC ZINT Mtc_SessGetPeerId (ZULONG dwSessId, ZCHAR ** ppcDispName, ZCHAR ** ppcUri )

ZFUNC ZINT Mtc_SessGetPeerUri (ZULONG dwSessId, ZCHAR ** ppcDispName, ZCHAR ** ppcUri )

ZFUNC ZINT Mtc_SessGetRxAgcEnable (ZULONG dwSessId, ZBOOL * pbEnable )

ZFUNC ZINT Mtc_SessGetRxAgcMode (ZULONG dwSessId, ZUCHAR * pucMode )

ZFUNC ZINT Mtc_SessGetRxAgcTarget (ZULONG dwSessId, ZUSHORT * pwTargetDb )

ZFUNC ZINT Mtc_SessGetRxAnrEnable (ZULONG dwSessId, ZBOOL * pbEnable )

ZFUNC ZINT Mtc_SessGetRxAnrMode (ZULONG dwSessId, ZUCHAR * pucMode )

ZFUNC ZBOOL Mtc_SessGetSpkMute (ZULONG dwSessId)

ZFUNC ZFLOAT Mtc_SessGetSpkScale (ZULONG dwSessId)

ZFUNC ZUINT Mtc_SessGetSpkVol (ZULONG dwSessId)

ZFUNC ZCHAR* Mtc_SessGetStatDesc (ZULONG dwStatCode)

ZFUNC ZINT Mtc_SessGetVadEnable (ZULONG dwSessId, ZBOOL * pbEnable )

ZFUNC ZINT Mtc_SessGetVadMode (ZULONG dwSessId, ZUCHAR * pucMode )

ZFUNC ZINT Mtc_SessGetVideoLocalSize (ZULONG dwSessId, ZULONG * pdwWidth, ZULONG * pdwHeight )

ZFUNC ZINT Mtc_SessGetVideoRemoteSize (ZULONG dwSessId, ZULONG * pdwWidth, ZULONG * pdwHeight )

ZFUNC ZINT Mtc_SessGetVideoSize (ZULONG dwSessId, ZULONG * pdwWidth, ZULONG * pdwHeight )

ZFUNC ZCONST ZCHAR* Mtc_SessGetVideoStat (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessHasAudio (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessHasHeld (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessHasHold (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessHasOfferAnswer (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessHasTalk (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessHasVideo (ZULONG dwSessId)

ZFUNC ZINT Mtc_SessHold (ZULONG dwSessId)

ZFUNC ZINT Mtc_SessInfo (ZULONG dwSessId, ZCHAR * pcInfo )

ZFUNC ZINT Mtc_SessPartpGetIds (ZULONG dwSessId, ZUINT * piPartpIds, ZUINT * piPartpCnt )

ZFUNC ZINT Mtc_SessPartpGetRenderArea (ZULONG dwSessId, ZUINT * piPartpIds, ZUINT iPartpCnt, ZUINT * piAreaIndexs )

ZFUNC ZINT Mtc_SessPartpGetRtpInfo (ZULONG dwSessId, ZUINT iPartpId, ZUINT * piSsrc, ZUINT * piIp, ZUSHORT * pwPort )

ZFUNC ZINT Mtc_SessPartpSetRenderArea (ZULONG dwSessId, ZUINT * piPartpIds, ZUINT iPartpCnt, ZUINT * piAreaIndexs )

ZFUNC ZBOOL Mtc_SessPeerIsFocus (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessPeerOfferAudio (ZULONG dwSessId)

ZFUNC ZBOOL Mtc_SessPeerOfferVideo (ZULONG dwSessId)

ZFUNC ZULONG Mtc_SessPickUp (ZCHAR * pcUri, ZCHAR * pcReplaceInfo, ZCOOKIE zCookie, ZBOOL bAudio, ZBOOL bVideo )