cc - VoLTE通话功能#
示例
-- 选型手册上支持VoLTE通话功能的模组支持
-- 选型手册上支持VoLTE通话功能的模组支持
cc.lastNum()#
获取最后一次通话的号码
参数
无
返回值
返回值类型 |
解释 |
|---|---|
string |
获取最后一次通话的号码 |
例子
无
cc.dial(sim_id, number)#
拨打电话
参数
传入值类型 |
解释 |
|---|---|
number |
sim_id |
string |
电话号码 |
返回值
返回值类型 |
解释 |
|---|---|
bool |
拨打电话成功与否 |
例子
无
cc.hangUp(sim_id)#
挂断电话
参数
传入值类型 |
解释 |
|---|---|
number |
sim_id |
返回值
无
例子
无
cc.accept(sim_id)#
接听电话
参数
传入值类型 |
解释 |
|---|---|
number |
sim_id |
返回值
返回值类型 |
解释 |
|---|---|
bool |
接听电话成功与否 |
例子
无
cc.init(multimedia_id)#
初始化电话功能
参数
传入值类型 |
解释 |
|---|---|
number |
multimedia_id 多媒体id |
返回值
返回值类型 |
解释 |
|---|---|
bool |
成功与否 |
例子
无
cc.record(on_off,upload_zbuff1, upload_zbuff2, download_zbuff1, download_zbuff2)#
录音通话
参数
传入值类型 |
解释 |
|---|---|
boolean |
开启关闭通话录音功能，false或者nil关闭，其他开启 |
zbuff |
上行数据保存区1,zbuff创建时的空间容量必须是640的倍数,下同 |
zbuff |
上行数据保存区2,和上行数据保存区1组成双缓冲区 |
zbuff |
下行数据保存区1 |
zbuff |
下行数据保存区2,和下行数据保存区1组成双缓冲区 |
返回值
返回值类型 |
解释 |
|---|---|
bool |
成功与否，如果处于通话状态，会失败 |
例子
buff1 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
buff2 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
buff3 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
buff4 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
cc.on("record", function(type, buff_point)
log.info(type, buff_point) -- type==true是下行数据，false是上行数据 buff_point指示双缓存中返回了哪一个
end)
cc.record(true, buff1, buff2, buff3, buff4)
cc.quality()#
获取当前通话质量
参数
无
返回值
返回值类型 |
解释 |
|---|---|
int |
1为低音质(8K)，2为高音质(16k)，0没有在通话 |
例子
无
cc.on(event, func)#
注册通话回调
参数
传入值类型 |
解释 |
|---|---|
string |
事件名称 音频录音数据为”record” |
function |
回调方法 |
返回值
返回值类型 |
解释 |
|---|---|
nil |
无返回值 |
例子
cc.on("record", function(type, buff_point)
log.info(type, buff_point) -- type==true是下行数据，false是上行数据 buff_point指示双缓存中返回了哪一个
end)
cc.lastNum()#
获取最后一次通话的号码
参数
无
返回值
返回值类型 |
解释 |
|---|---|
string |
获取最后一次通话的号码 |
例子
无
cc.dial(sim_id, number)#
拨打电话
参数
传入值类型 |
解释 |
|---|---|
number |
sim_id |
string |
电话号码 |
返回值
返回值类型 |
解释 |
|---|---|
bool |
拨打电话成功与否 |
例子
无
cc.hangUp(sim_id)#
挂断电话
参数
传入值类型 |
解释 |
|---|---|
number |
sim_id |
返回值
无
例子
无
cc.accept(sim_id)#
接听电话
参数
传入值类型 |
解释 |
|---|---|
number |
sim_id |
返回值
返回值类型 |
解释 |
|---|---|
bool |
接听电话成功与否 |
例子
无
cc.init(multimedia_id)#
初始化电话功能
参数
传入值类型 |
解释 |
|---|---|
number |
multimedia_id 多媒体id |
返回值
返回值类型 |
解释 |
|---|---|
bool |
成功与否 |
例子
无
cc.record(on_off,upload_zbuff1, upload_zbuff2, download_zbuff1, download_zbuff2)#
录音通话
参数
传入值类型 |
解释 |
|---|---|
boolean |
开启关闭通话录音功能，false或者nil关闭，其他开启 |
zbuff |
上行数据保存区1,zbuff创建时的空间容量必须是640的倍数,下同 |
zbuff |
上行数据保存区2,和上行数据保存区1组成双缓冲区 |
zbuff |
下行数据保存区1 |
zbuff |
下行数据保存区2,和下行数据保存区1组成双缓冲区 |
返回值
返回值类型 |
解释 |
|---|---|
bool |
成功与否，如果处于通话状态，会失败 |
例子
buff1 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
buff2 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
buff3 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
buff4 = zbuff.create(6400,0,zbuff.HEAP_AUTO)
cc.on("record", function(type, buff_point)
log.info(type, buff_point) -- type==true是下行数据，false是上行数据 buff_point指示双缓存中返回了哪一个
end)
cc.record(true, buff1, buff2, buff3, buff4)
cc.quality()#
获取当前通话质量
参数
无
返回值
返回值类型 |
解释 |
|---|---|
int |
1为低音质(8K)，2为高音质(16k)，0没有在通话,其他值为具体的音频采样率 |
例子
无
cc.on(event, func)#
注册通话回调
参数
传入值类型 |
解释 |
|---|---|
string |
事件名称 音频录音数据为”record” |
function |
回调方法 |
返回值
返回值类型 |
解释 |
|---|---|
nil |
无返回值 |
例子
cc.on("record", function(type, buff_point)
log.info(type, buff_point) -- type==true是下行数据，false是上行数据 buff_point指示双缓存中返回了哪一个
end)
cc.extern_source(source, is_add_record, codec_id, is_error_stop, sample_rate, data_bits, channel_nums, is_signed)#
通话中附加额外的音频数据，额外音频的数据位数和通道数必须和通话的参数一致，否则会失败而没有任何作用
参数
传入值类型 |
解释 |
|---|---|
table/string/zbuff/boolean/nil |
输入数据，table表示播放文件（如果只播放一个文件也要用table），string表示播放tts，zbuff表示播放音频数据(文件数据放在了zbuff)，true表示启用流模式播放，nil表示停止当前第三方数据播放 |
boolean |
是否添加到上行通道，true添加到上行通道，false添加到下行通道，默认true，往对端播放第三方数据源，目前只支持上行通道 |
int |
解码器id，见audio_v2.DATA_CODEC_TYPE_XXX，如果留空则通过输入数据自行判断 |
boolean |
是否在文件解码失败后停止解码，只有在连续播放多个文件时才有用，默认true，遇到解码错误自动停止 |
int |
采样率，如果指定解码器是RAW，不能留空 |
int |
数据位数，8,16,24,32，如果指定解码器是RAW，不能留空 |
int |
通道数，1,2，如果指定解码器是RAW，不能留空 |
boolean |
是否有符号数据，默认true |
返回值
返回值类型 |
解释 |
|---|---|
boolean |
成功返回true,否则返回false |
例子
cc.extern_source({"/test_16k.mp3"})
cc.input(is_record, data, is_end)#
通话中附加额外的音频数据以流模式播放情况下，输入未解码的音频数据
参数
传入值类型 |
解释 |
|---|---|
boolean |
是否是上行数据，true是上行数据，false是下行数据, 默认true，目前只支持录音通道，所以这个参数没有用 |
string/zbuff |
输入数据，如果为空，则不输入任何数据 |
boolean |
是否是最后一帧数据，默认false |
返回值
返回值类型 |
解释 |
|---|---|
boolean |
成功返回true,否则返回false |
int |
实际写入的长度，如果数据为空或者写入失败，则返回0，单位字节。如果数据是zbuff形式，写入成功后会自动删除zbuff中的数据 |
int |
输入缓冲的剩余空间，单位字节 |
例子
local result, write_len, free_len = cc.input(true, data, is_end)