蜂窝模组电话拨号API实现接口。 更多...
#include <stdint.h>#include "tuya_cloud_types.h"
tkl_cellular_call.h 的引用(Include)关系图:
此图展示该文件直接或间接的被哪些文件引用了:
宏定义 | |
| #define | TKL_CELLULAR_CALLNUM_LEN_MAX 42 |
| 电话号码最大长度 更多... | |
类型定义 | |
| typedef VOID_T(* | TKL_CELLULAR_CALL_CB) (TUYA_CELLULAR_CALL_IND_STATE_E state, UINT8_T simId, CHAR_T callNum[42]) |
| 呼叫回调处理函数原型 更多... | |
枚举 | |
| enum | TUYA_CELLULAR_CALL_IND_STATE_E { TUYA_CALL_IND_CALLIN = 1 , TUYA_CALL_IND_RELEASE , TUYA_CALL_IND_CALL_RSP_OK , TUYA_CALL_IND_CALL_RSP_FAIL , TUYA_CALL_IND_RING , TUYA_CALL_IND_ACCEPT_CALL_OK , TUYA_CALL_IND_ACCEPT_CALL_FAIL , TUYA_CALL_IND_RELEASE_RSP , TUYA_CALL_IND_DTMF_KEY , TUYA_CALL_IND_MAX } |
| 呼叫回调状态 | |
| enum | TUYA_TONE_TYPE_E { TUYA_TONE_DTMF_0 = 0 , TUYA_TONE_DTMF_1 , TUYA_TONE_DTMF_2 , TUYA_TONE_DTMF_3 , TUYA_TONE_DTMF_4 , TUYA_TONE_DTMF_5 , TUYA_TONE_DTMF_6 , TUYA_TONE_DTMF_7 , TUYA_TONE_DTMF_8 , TUYA_TONE_DTMF_9 , TUYA_TONE_DTMF_A , TUYA_TONE_DTMF_B , TUYA_TONE_DTMF_C , TUYA_TONE_DTMF_D , TUYA_TONE_DTMF_SHARP , TUYA_TONE_DTMF_STAR , TUYA_TONE_DIAL = 16 , TUYA_TONE_SUBSCRIBER_BUSY , TUYA_TONE_RADIO_PATHACKNOWLEDGEMENT , TUYA_TONE_CALL_DROPPED , TUYA_TONE_SPECIAL_INFORMATION , TUYA_TONE_CALL_WAITING , TUYA_TONE_RINGING } |
函数 | |
| OPERATE_RET | tkl_cellular_call (UINT8_T sim_id, CHAR_T callNum[42]) |
| 呼叫拨号接口函数 更多... | |
| OPERATE_RET | tkl_cellular_call_answer (UINT8_T sim_id) |
| 外部呼叫到来时，应答接听接口函数 更多... | |
| OPERATE_RET | tkl_cellular_call_cb_register (TKL_CELLULAR_CALL_CB callback) |
| 注册用户定义的呼叫回调处理函数 更多... | |
| OPERATE_RET | tkl_cellular_call_dtmf2voice (TUYA_TONE_TYPE_E dtmfTone, UINT_T duration) |
| 将DTMF数字按键音频发送到语音通道 更多... | |
| OPERATE_RET | tkl_cellular_call_get_voice_mute (PBOOL_T mute) |
| 获取通话过程中的上行声音的静音状态。 更多... | |
| OPERATE_RET | tkl_cellular_call_get_voice_vol (PINT_T vol) |
| 获取语音通话音频的音量 更多... | |
| OPERATE_RET | tkl_cellular_call_hungup (UINT8_T sim_id) |
| 呼叫通话后，挂机接口函数 更多... | |
| OPERATE_RET | tkl_cellular_call_play_tone (TUYA_TONE_TYPE_E tone, INT_T duration) |
| 播放电话的拨号音 更多... | |
| OPERATE_RET | tkl_cellular_call_service_available (UINT8_T sim_id) |
| 查询呼叫服务是否可用 更多... | |
| OPERATE_RET | tkl_cellular_call_set_callin_mute (BOOL_T mute) |
| 设置呼入时铃声静音 更多... | |
| OPERATE_RET | tkl_cellular_call_set_voice_mute (BOOL_T mute) |
| 通话过程中，上行音频是否设置静音 When the current voice call is finished, the property will be kept. 当前的语音呼叫结束后，这个属性会被保存下来。下次再进行语音通话的过程中，如果 上次被设置为静音，则继续静音。但是重启后，会被默认恢复成非静音 更多... | |
| OPERATE_RET | tkl_cellular_call_set_voice_vol (INT_T vol) |
| 设置语音通话音频的音量 更多... | |
| OPERATE_RET | tkl_cellular_call_set_volte (UINT8_T sim_id, BOOL_T enable) |
| 启动或者关闭volte功能 更多... | |
| OPERATE_RET | tkl_cellular_call_stop_tone (VOID) |
| 停止电话的拨号音 更多... | |
详细描述
蜂窝模组电话拨号API实现接口。
- 版权所有
- Copyright (c) tuya.inc 2021
宏定义说明
◆ TKL_CELLULAR_CALLNUM_LEN_MAX
| #define TKL_CELLULAR_CALLNUM_LEN_MAX 42 |
电话号码最大长度
- 注解
- 电话号码为字符串形式，该长度包含'\0'字符。
类型定义说明
◆ TKL_CELLULAR_CALL_CB
| typedef VOID_T(* TKL_CELLULAR_CALL_CB) (TUYA_CELLULAR_CALL_IND_STATE_E state, UINT8_T simId, CHAR_T callNum[42]) |
呼叫回调处理函数原型
- 参数
-
state 呼叫状态 simId sim卡ID callNum 电话号码
- 返回
- 无
枚举类型说明
◆ TUYA_TONE_TYPE_E
| enum TUYA_TONE_TYPE_E |
信号音类型定义
函数说明
◆ tkl_cellular_call()
| OPERATE_RET tkl_cellular_call | ( | UINT8_T | sim_id, |
| CHAR_T | callNum[42] | ||
| ) |
呼叫拨号接口函数
- 参数
-
simId sim卡ID号 callNUm 呼叫号码，字符串形式
- 返回
- 0 发起呼叫成功 其它 失败
◆ tkl_cellular_call_answer()
| OPERATE_RET tkl_cellular_call_answer | ( | UINT8_T | sim_id | ) |
外部呼叫到来时，应答接听接口函数
- 参数
-
无
- 返回
- 0 应答成功 其它 失败
◆ tkl_cellular_call_cb_register()
| OPERATE_RET tkl_cellular_call_cb_register | ( | TKL_CELLULAR_CALL_CB | callback | ) |
注册用户定义的呼叫回调处理函数
- 参数
-
callback 呼叫回调处理函数
- 返回
- 0 注册成功 其它 注册失败
◆ tkl_cellular_call_dtmf2voice()
| OPERATE_RET tkl_cellular_call_dtmf2voice | ( | TUYA_TONE_TYPE_E | dtmfTone, |
| UINT_T | duration | ||
| ) |
将DTMF数字按键音频发送到语音通道
- 注解
- 1、该函数用于实现10086之类的语音交互，语音提示后，用户操作按键，调用该函数 将按键音频发送到语音通道，该函数只能在通话状态后调用，否则将引起系统异常。 2、dtmfTone只能是TKL_TONE_DTMF_0 ~ TKL_TONE_DTMF_STAR中的一种。
- 参数
-
dtmfTone 拨号按键 duration 音频持续时长
- 返回
- 0 成功 -1 dtmfTone 类型错误 -2 分配内存失败 OPRT_TIMEOUT 获取信号量超时 OPRT_BASE_OS_ADAPTER_REG_NULL_ERROR 函数未适配
◆ tkl_cellular_call_get_voice_mute()
| OPERATE_RET tkl_cellular_call_get_voice_mute | ( | PBOOL_T | mute | ) |
获取通话过程中的上行声音的静音状态。
- 参数
-
mute : TRUE 静音
- 返回
- 0 成功，其他失败
◆ tkl_cellular_call_get_voice_vol()
| OPERATE_RET tkl_cellular_call_get_voice_vol | ( | PINT_T | vol | ) |
获取语音通话音频的音量
- 参数
-
vol （0~100）
- 返回
- 0 成功，其他失败
◆ tkl_cellular_call_hungup()
| OPERATE_RET tkl_cellular_call_hungup | ( | UINT8_T | sim_id | ) |
呼叫通话后，挂机接口函数
- 参数
-
无
- 返回
- 0 挂机成功 其它 失败
◆ tkl_cellular_call_play_tone()
| OPERATE_RET tkl_cellular_call_play_tone | ( | TUYA_TONE_TYPE_E | tone, |
| INT_T | duration | ||
| ) |
播放电话的拨号音
- 参数
-
tone 拨号音的特征值 duration 播放音的持续时间
- 返回
- 0 成功，其他失败
◆ tkl_cellular_call_service_available()
| OPERATE_RET tkl_cellular_call_service_available | ( | UINT8_T | sim_id | ) |
查询呼叫服务是否可用
- 注解
- 该函数用于查询呼叫服务是否可用，只有在呼叫服务可用时，才能使用使用 其它呼叫服务接口。
- 参数
-
simId sim卡ID
- 返回
- 1 服务可用 0 服务不可用
◆ tkl_cellular_call_set_callin_mute()
| OPERATE_RET tkl_cellular_call_set_callin_mute | ( | BOOL_T | mute | ) |
设置呼入时铃声静音
- 参数
-
mute TRUE 静音 FALSE 非静音
- 返回
- 0 设置成功 其它 设置失败
◆ tkl_cellular_call_set_voice_mute()
| OPERATE_RET tkl_cellular_call_set_voice_mute | ( | BOOL_T | mute | ) |
通话过程中，上行音频是否设置静音 When the current voice call is finished, the property will be kept. 当前的语音呼叫结束后，这个属性会被保存下来。下次再进行语音通话的过程中，如果 上次被设置为静音，则继续静音。但是重启后，会被默认恢复成非静音
- 参数
-
TRUE for mute uplink of voice call
- 返回
- 0 成功，其他失败
◆ tkl_cellular_call_set_voice_vol()
| OPERATE_RET tkl_cellular_call_set_voice_vol | ( | INT_T | vol | ) |
设置语音通话音频的音量
- 参数
-
vol （0~100）
- 返回
- 0 成功，其他失败
◆ tkl_cellular_call_set_volte()
| OPERATE_RET tkl_cellular_call_set_volte | ( | UINT8_T | sim_id, |
| BOOL_T | enable | ||
| ) |
启动或者关闭volte功能
- 参数
-
enable TRUE启用volte,false关闭volte
- 返回
- 0 设置成功 其它 设置失败
◆ tkl_cellular_call_stop_tone()
| OPERATE_RET tkl_cellular_call_stop_tone | ( | VOID | ) |
停止电话的拨号音
- 参数
-
无
- 返回
- 0 成功，其他失败
