新增DTMF识别相关接口

Author: Mia1234567890

en-us/api/QuecPythonClasslib.md

@@ -1355,6 +1355,70 @@ This function sets DTMF.
 
 
 
+##### Enable DTMF identification
+
+> **voiceCall.dtmfDetEnable(enable)**
+
+Enable DTMF identification. It is disabled by default.
+
+* Parameter
+
+| Parameter | Type   | Description                                                  |
+| --------- | ------ | ------------------------------------------------------------ |
+| enable    | int    | 1:Enable DTMF identification, 0:Disable DTMF identification  |
+
+* Return Value
+
+  * Returns 0 on success, -1 otherwise.
+
+* Example
+
+See the example of 'voiceCall.dtmfSetCb()'
+
+
+
+##### set the callback of DTMF identification
+
+> **voiceCall.dtmfSetCb(cb)**
+
+Set the callback of DTMF identification
+
+* Parameter
+
+| Parameter | Type     | Description                                                  |
+| --------- | ------   | ------------------------------------------------------------ |
+| cb        | function | callback function                                            |
+
+* Return Value
+
+  * Returns 0 on success, -1 otherwise.
+
+* Example
+
+```
+>>> def cb(args):
+... print(args)
+...
+...
+...
+>>> voiceCall.dtmfSetCb(cb)
+0
+>>> voiceCall.dtmfDetEnable(1)
+0
+
+>>> voiceCall.callStart('13855169092')
+
+0
+>>>
+1   //Press "1" on the phone, callback function will receive the pressed character "1".
+
+8   //Press "8" on the phone
+
+9   //Press "9" on the phone
+```
+
+
+
 ##### Set FWmode
 
 > **voiceCall.setFw(reason, fwmode, phonenum)**

zh-cn/api/QuecPythonClasslib.md

@@ -1386,6 +1386,70 @@ sim.setCallback(cb)
 
 
 
+##### DTMF识别使能接口
+
+> **voiceCall.dtmfDetEnable(enable)**
+
+DTMF识别使能接口，默认不开启DTMF识别
+
+* 参数
+
+| 参数     | 参数类型 | 参数说明                                                     |
+| -------- | -------- | ------------------------------------------------------------ |
+| enable   | int      | 使能开关，取值0/1,0：不开启DTMF识别，1：开启DTMF识别         |
+
+* 返回值
+
+  设置成功返回整型0，设置失败返回整型-1。
+
+* 示例
+
+见voiceCall.dtmfSetCb()接口示例
+
+
+
+##### 设置DTMF识别回调接口
+
+> **voiceCall.dtmfSetCb(cb)**
+
+设置DTMF识别回调接口
+
+* 参数
+
+| 参数     | 参数类型 | 参数说明                                                     |
+| -------- | -------- | ------------------------------------------------------------ |
+| cb       | function | 回调函数                                                     |
+
+* 返回值
+
+  设置成功返回整型0，设置失败返回整型-1。
+
+* 示例
+
+```
+>>> def cb(args):
+... print(args)
+...
+...
+...
+>>> voiceCall.dtmfSetCb(cb)
+0
+>>> voiceCall.dtmfDetEnable(1)
+0
+
+>>> voiceCall.callStart('13855169092')
+
+0
+>>>
+1   //手机端按下1，callback中会收到按下的字符“1”
+
+8   //手机端按下8
+
+9   //手机端按下9
+```
+
+
+
 ##### 设置控制呼叫转移
 
 > **voiceCall.setFw(reason, fwmode, phonenum)**