Android | 菊风云平台

概览 JCClient JCClientCallback JCMediaDevice JCMediaDeviceCallback JCCall JCCallCallback JCMediaChannel JCMediaChannelCallback 错误码

Public 成员函数
String	toString ()

静态 Public 成员函数
static MediaConfig	generateByMode (@Mode int mode)

Public 属性
String	audioEnableCodecs = "opus;AMR;G729"

boolean	audioAecEnable = true

int	audioAecMode = AEC_MODE_SDE

boolean	audioArsEnable = true

int	audioArsBitrateMin = 20

int	audioArsBitrateMax = 75

boolean	audioRed = true

boolean	audioRxAnr = false

boolean	audioRtx = false

boolean	audioRxAgc = false

boolean	audioQosAec = true

boolean	audioQosAnr = true

boolean	audioQosAgc = true

boolean	audioQosVad = false

int	audioPacketTime = 20

int	audioQosAgcGain = 9

String	videoEnableCodecs = "H264-SVC;H264;VP8;AV1"

int	videoResolutionRecvWidth = 640

int	videoResolutionRecvHeight = 360

int	videoResolutionSendWidth = 640

int	videoResolutionSendHeight = 360

int	videoBitrate = 800

int	videoSendFramerate = 24

boolean	videoArsEnable = true

int	videoArsBitrateMin = 50

int	videoArsBitrateMax = 1500

int	videoArsFramerateMin = 1

int	videoArsFramerateMax = 30

boolean	videoRedFec = true

boolean	videoRecvFullScreen = true

boolean	videoSmallNalu = true

boolean	videoResolutionControl = true

int	videoKeyPeriod = 0

int	heartbeatTime = 30

静态 Public 属性
static final int	AEC_MODE_AEC = MtcCallDb.EN_MTC_EC_AEC

static final int	AEC_MODE_OS = MtcCallDb.EN_MTC_EC_OS

static final int	AEC_MODE_AES = MtcCallDb.EN_MTC_EC_AES

static final int	AEC_MODE_FDE = MtcCallDb.EN_MTC_EC_AEC_FDE

static final int	AEC_MODE_SDE = MtcCallDb.EN_MTC_EC_AEC_SDE

static final int	MODE_360P = 0

static final int	MODE_720P = MODE_360P + 1

static final int	MODE_INTELLIGENT_HARDWARE_SMALL = MODE_720P + 1

static final int	MODE_INTELLIGENT_HARDWARE_LARGE = MODE_INTELLIGENT_HARDWARE_SMALL + 1

static final int	MODE_IOT_LARGE = MODE_INTELLIGENT_HARDWARE_LARGE + 1

static final int	MODE_IOT_SMALL = MODE_IOT_LARGE + 1

static final int	MODE_SIP = MODE_IOT_SMALL + 1

Protected 属性
int	mode = MODE_360P

详细描述

一对一通话媒体参数配置类，作为 updateMediaConfig 方法的入参使用

成员函数说明

◆ toString()

String com.juphoon.cloud.JCCall.MediaConfig.toString ( )

inline

打印一对一通话媒体参数配置字符串

返回: 一对一通话媒体参数配置字符串

◆ generateByMode()

static MediaConfig com.juphoon.cloud.JCCall.MediaConfig.generateByMode ( @Mode int mode )

inlinestatic

根据模式生成配置参数

可通过此方法生成 MediaConfig 对象，需要在调用 call 方法发起呼叫前，通过 updateMediaConfig 方法设置媒体参数

参数

mode	参数模式，参见： MODE_360P : 360P MODE_720P : 720P MODE_INTELLIGENT_HARDWARE_SMALL : 小屏智能设备 MODE_INTELLIGENT_HARDWARE_LARGE : 大屏智能设备 MODE_IOT_LARGE : 大屏设备(手机、平板)与asr，展讯等小系统互通 MODE_IOT_SMALL : 小屏设备(手表)与asr，展讯等小系统互通

返回: MediaConfig 对象，媒体配置参数

类成员变量说明

◆ AEC_MODE_AEC

final int com.juphoon.cloud.JCCall.MediaConfig.AEC_MODE_AEC = MtcCallDb.EN_MTC_EC_AEC

static

声学回声消除。支持在免提状态下的通话，对于iOS和Windows等性能较好的机型有效。

◆ AEC_MODE_OS

final int com.juphoon.cloud.JCCall.MediaConfig.AEC_MODE_OS = MtcCallDb.EN_MTC_EC_OS

static

使用操作系统提供的声学回声消除功能，支持在免提状态下的通话。对于多数iOS和Android等品牌手机有效，但部分机型可能无效。

◆ AEC_MODE_AES

final int com.juphoon.cloud.JCCall.MediaConfig.AEC_MODE_AES = MtcCallDb.EN_MTC_EC_AES

static

声学回声抑制，通过半双工方式实现回声抑制，通常不建议使用。

◆ AEC_MODE_FDE

final int com.juphoon.cloud.JCCall.MediaConfig.AEC_MODE_FDE = MtcCallDb.EN_MTC_EC_AEC_FDE

static

软件自适应声学回声消除，对于大多数所有机型有效。但计算量比AEC稍大一些。SDE追踪延迟精度高，FDE能适应更大的延迟。

◆ AEC_MODE_SDE

final int com.juphoon.cloud.JCCall.MediaConfig.AEC_MODE_SDE = MtcCallDb.EN_MTC_EC_AEC_SDE

static

软件自适应声学回声消除，对于大多数所有机型有效。但计算量比AEC稍大一些。SDE追踪延迟精度高，FDE能适应更大的延迟。

◆ MODE_360P

final int com.juphoon.cloud.JCCall.MediaConfig.MODE_360P = 0

static

360P

◆ MODE_720P

final int com.juphoon.cloud.JCCall.MediaConfig.MODE_720P = MODE_360P + 1

static

720P

◆ MODE_INTELLIGENT_HARDWARE_SMALL

final int com.juphoon.cloud.JCCall.MediaConfig.MODE_INTELLIGENT_HARDWARE_SMALL = MODE_720P + 1

static

小屏智能设备

◆ MODE_INTELLIGENT_HARDWARE_LARGE

final int com.juphoon.cloud.JCCall.MediaConfig.MODE_INTELLIGENT_HARDWARE_LARGE = MODE_INTELLIGENT_HARDWARE_SMALL + 1

static

大屏智能设备

◆ MODE_IOT_LARGE

final int com.juphoon.cloud.JCCall.MediaConfig.MODE_IOT_LARGE = MODE_INTELLIGENT_HARDWARE_LARGE + 1

static

大屏设备(手机、平板)与asr，展讯等小系统互通

◆ MODE_IOT_SMALL

final int com.juphoon.cloud.JCCall.MediaConfig.MODE_IOT_SMALL = MODE_IOT_LARGE + 1

static

小屏设备(手表)与asr，展讯等小系统互通

◆ MODE_SIP

final int com.juphoon.cloud.JCCall.MediaConfig.MODE_SIP = MODE_IOT_SMALL + 1

static

对接落地业务

此模式会关闭 srtp 加密以及部分落地业务不支持的协商配置

◆ audioEnableCodecs

String com.juphoon.cloud.JCCall.MediaConfig.audioEnableCodecs = "opus;AMR;G729"

音频编解码

协商优先级按顺序排列，每个编解码用";"间隔，注意大小写，默认值为 "opus;AMR;G729"

◆ audioAecEnable

boolean com.juphoon.cloud.JCCall.MediaConfig.audioAecEnable = true

是否开启回声消除，默认开启

true: 开启
false: 关闭

◆ audioAecMode

int com.juphoon.cloud.JCCall.MediaConfig.audioAecMode = AEC_MODE_SDE

回声消除模式，默认为 AEC_MODE_SDE ，参见：

AEC_MODE_AEC : 声学回声消除
AEC_MODE_OS : 使用操作系统提供的声学回声消除功能
AEC_MODE_AES : 声学回声抑制
AEC_MODE_FDE : 软件自适应声学回声消除，能适应更大延时
AEC_MODE_SDE : 软件自适应声学回声消除，追踪延迟精度高

◆ audioArsEnable

boolean com.juphoon.cloud.JCCall.MediaConfig.audioArsEnable = true

是否开启音频，默认开启

true: 开启
false: 关闭

◆ audioArsBitrateMin

int com.juphoon.cloud.JCCall.MediaConfig.audioArsBitrateMin = 20

音频最小码率 kb，默认值为 20

◆ audioArsBitrateMax

int com.juphoon.cloud.JCCall.MediaConfig.audioArsBitrateMax = 75

音频最大码率 kb，默认值为 75

◆ audioRed

boolean com.juphoon.cloud.JCCall.MediaConfig.audioRed = true

是否打开语音red抗丢包，默认开启

网络不稳定，一般选择打开

true: 打开，能够增加payload码率
false: 关闭，能力节省码率从而降低功耗

◆ audioRxAnr

boolean com.juphoon.cloud.JCCall.MediaConfig.audioRxAnr = false

是否开启噪声抑制，默认关闭

一般接收端声音质量好可关闭噪声抑制，减少声音dsp处理，降低功耗

true: 开启
false: 关闭

◆ audioRtx

boolean com.juphoon.cloud.JCCall.MediaConfig.audioRtx = false

是否开启rtx重传，默认关闭

同FEC、NACK一起用，能够降低功耗。网络不稳定，一般选择打开

true: 打开
false: 关闭

◆ audioRxAgc

boolean com.juphoon.cloud.JCCall.MediaConfig.audioRxAgc = false

是否打开接收端声音自动增益控制，默认关闭

接收端声音过大过小时，可尝试打开

true: 打开
false: 关闭

◆ audioQosAec

boolean com.juphoon.cloud.JCCall.MediaConfig.audioQosAec = true

是否开启回声消除，默认开启

true: 开启
false: 关闭

◆ audioQosAnr

boolean com.juphoon.cloud.JCCall.MediaConfig.audioQosAnr = true

是否开启发送端噪声抑制，默认开启

接收端声音噪声大，提高抑制等级。接收端声音小，可在不影响声音质量情况下降低抑制等级或者关闭抑制

true: 开启
false: 关闭

◆ audioQosAgc

boolean com.juphoon.cloud.JCCall.MediaConfig.audioQosAgc = true

是否开启发送端声音自动增益控制，默认开启

true: 开启
false: 关闭

◆ audioQosVad

boolean com.juphoon.cloud.JCCall.MediaConfig.audioQosVad = false

是否开启静音检测，默认关闭

true: 开启
false: 关闭

◆ audioPacketTime

int com.juphoon.cloud.JCCall.MediaConfig.audioPacketTime = 20

音频打包时长，默认值为 20

◆ audioQosAgcGain

int com.juphoon.cloud.JCCall.MediaConfig.audioQosAgcGain = 9

发送端声音自动增益控制强度，默认值为9

取值范围为[0,90]，数值越大，增益强度越大。当 audioQosAgc 为 true 时有效

◆ videoEnableCodecs

String com.juphoon.cloud.JCCall.MediaConfig.videoEnableCodecs = "H264-SVC;H264;VP8;AV1"

视频编解码，协商优先级按顺序排列，默认值为 "H264-SVC;H264;VP8"

◆ videoResolutionRecvWidth

int com.juphoon.cloud.JCCall.MediaConfig.videoResolutionRecvWidth = 640

视频接收宽，默认值值为 640

◆ videoResolutionRecvHeight

int com.juphoon.cloud.JCCall.MediaConfig.videoResolutionRecvHeight = 360

视频接收高，默认值为 360

◆ videoResolutionSendWidth

int com.juphoon.cloud.JCCall.MediaConfig.videoResolutionSendWidth = 640

视频发送宽，默认值为 640

◆ videoResolutionSendHeight

int com.juphoon.cloud.JCCall.MediaConfig.videoResolutionSendHeight = 360

视频发送高，默认值为 360

◆ videoBitrate

int com.juphoon.cloud.JCCall.MediaConfig.videoBitrate = 800

视频初始码率 kb，默认值为 800

◆ videoSendFramerate

int com.juphoon.cloud.JCCall.MediaConfig.videoSendFramerate = 24

发送帧率，默认值为 24

◆ videoArsEnable

boolean com.juphoon.cloud.JCCall.MediaConfig.videoArsEnable = true

是否开启视频 ars，默认开启

true：开启
false: 关闭

◆ videoArsBitrateMin

int com.juphoon.cloud.JCCall.MediaConfig.videoArsBitrateMin = 50

视频最小码率 kb，默认值为 50

◆ videoArsBitrateMax

int com.juphoon.cloud.JCCall.MediaConfig.videoArsBitrateMax = 1500

视频最大码率 kb，默认值为 1500

◆ videoArsFramerateMin

int com.juphoon.cloud.JCCall.MediaConfig.videoArsFramerateMin = 1

视频最小帧率 kb，默认值为 1

◆ videoArsFramerateMax

int com.juphoon.cloud.JCCall.MediaConfig.videoArsFramerateMax = 30

视频最大帧率 kb，默认值为 30

◆ videoRedFec

boolean com.juphoon.cloud.JCCall.MediaConfig.videoRedFec = true

是否开启rfc 2198 语音fec-red，默认开启

开启后可以增强抗丢包能力，会增加一倍的payload码率，不会增加包头。比如Opus 55kbps增加一倍码率后，最终码率达到90kbps=55+35；Opus 10kbps增加一倍码率后，最终码率达到16kbps=10+6

true: 开启
false: 关闭

◆ videoRecvFullScreen

boolean com.juphoon.cloud.JCCall.MediaConfig.videoRecvFullScreen = true

本端视频分辨率是否影响请求分辨率，默认影响

这里举个例子，有假设条件：

本端默认请求是640*360的分辨率
本端屏幕分辨率为360*360

若此参数设置成 true：请求分辨率 360*360
若此参数设置成 false: 请求分辨率 640*360

true: 影响
false: 不影响

◆ videoSmallNalu

boolean com.juphoon.cloud.JCCall.MediaConfig.videoSmallNalu = true

是否开启视频数据以SmallNalu方式打包，默认开启

开启后，一个包打包的数据多，减少包头的码率，从而降低功耗

true: 开启
false: 关闭

◆ videoResolutionControl

boolean com.juphoon.cloud.JCCall.MediaConfig.videoResolutionControl = true

是否开启分辨率控制，默认开启

true: 开启，分辨率随网络波动而变化
false: 关闭，固定分辨率

◆ videoKeyPeriod

int com.juphoon.cloud.JCCall.MediaConfig.videoKeyPeriod = 0

视频关键帧间隔（毫秒），MODE_IOT_SMALL 或 MODE_IOT_LARGE 模式下默认值为 1000

仅在 MODE_IOT_SMALL 或 MODE_IOT_LARGE 模式下生效，其他模式下设置无效

◆ mode

int com.juphoon.cloud.JCCall.MediaConfig.mode = MODE_360P

protected

配置模式

默认为 MODE_360P

◆ heartbeatTime

int com.juphoon.cloud.JCCall.MediaConfig.heartbeatTime = 30

心跳间隔，默认心跳间隔为30秒

取值范围为(0,3600)。比如本端设置了心跳间隔为 X 秒，那么对端在 3*X 秒内都没有收到本端的心跳时，对端将收到 onCallItemRemove 通话结束的回调

该类的文档由以下文件生成:

cloud/src/main/call/com/juphoon/cloud/JCCall.java

Public 成员函数

静态 Public 成员函数

Public 属性

静态 Public 属性

Protected 属性

详细描述

成员函数说明

◆ toString()

◆ generateByMode()

类成员变量说明

◆ AEC_MODE_AEC

◆ AEC_MODE_OS

◆ AEC_MODE_AES

◆ AEC_MODE_FDE

◆ AEC_MODE_SDE

◆ MODE_360P

◆ MODE_720P

◆ MODE_INTELLIGENT_HARDWARE_SMALL

◆ MODE_INTELLIGENT_HARDWARE_LARGE

◆ MODE_IOT_LARGE

◆ MODE_IOT_SMALL

◆ MODE_SIP

◆ audioEnableCodecs

◆ audioAecEnable

◆ audioAecMode

◆ audioArsEnable

◆ audioArsBitrateMin

◆ audioArsBitrateMax

◆ audioRed

◆ audioRxAnr

◆ audioRtx

◆ audioRxAgc

◆ audioQosAec

◆ audioQosAnr

◆ audioQosAgc

◆ audioQosVad

◆ audioPacketTime

◆ audioQosAgcGain

◆ videoEnableCodecs

◆ videoResolutionRecvWidth

◆ videoResolutionRecvHeight

◆ videoResolutionSendWidth

◆ videoResolutionSendHeight

◆ videoBitrate

◆ videoSendFramerate

◆ videoArsEnable

◆ videoArsBitrateMin

◆ videoArsBitrateMax

◆ videoArsFramerateMin

◆ videoArsFramerateMax

◆ videoRedFec

◆ videoRecvFullScreen

◆ videoSmallNalu

◆ videoResolutionControl

◆ videoKeyPeriod

◆ mode

◆ heartbeatTime