# FAQ

# 登录

# 登录时用户名有要求吗？用户名规范是什么

用户名为英文数字和’+’ ‘-‘ ‘’ ‘.’，’-‘ ‘’ ‘.’不能作为第一个字符，长度不要超过64字符。

# 免鉴权模式下客户如何使用自己的账号体系

免鉴权模式下，客户如果想用自己的账号体系，但是又不想将自己的账号作为服务器的账号标识，可以另起一个与自己的账号体系相对应的服务器端的账号标识作为自身的 ID，如自身账号体系为手机号：150…，服务器端账号体系可以为 ABC 之类的标识符。

# 如何根据登录状态判断是否已经跟服务器连接成功

可以通过 JCClient 类里的 onClientStateChange 回调检查登录状态的变化。

# 账号查询

如果遇到查询状态问题，可以先检查服务器地址，确保服务器地址和域保持一致，关于服务器地址的设置参考发起登录。

# 日志查询

# 设置日志等级

在调用 create 初始化 JCClient 时，传入 createParam (opens new window) 对象，设置该对象中的 sdkLogLevel (opens new window) 属性来设置日志等级。以 Java 为例：

CreateParam createParam = new CreateParam();
createParam.sdkLogLevel = JCClient.CreateParam.LOG_LEVEL_DISABLE; // 关闭日志
mClient = JCClient.create(context, "用户 appKey", this, createParam);

# 在本地查看日志

iOS：iOS如何查看本地日志

Android：Android如何查看本地日志

# 在控制台查看日志

除了查看本地日志，您还可以在日志列表 (opens new window)中查询您的日志数据并向我们反馈日志内容。

您可以在登录后直接点击上面的链接，或者手动进入日志列表界面：新版控制台页面 (opens new window) -> 数据统计 -> 数据分析 -> 进入旧版数据分析 -> 日志管理 -> 日志列表 。进入日志列表页面后，输入集成过程中使用的用户名（userID），点击获取以获取详细日志。

# 一对一通话

# 一对一通话中，对端异常退出（程序被杀，断网）本端多久会挂断

20 秒后。对端杀掉，本端 20 秒会挂断，上层会收到 notifyCallItemRemove，reason 是 term_by_self，callitem 里的 netstatus 状态为 -3。

# 现在呼叫等待时间是多长

信令模式下是 2 分钟，超时后服务器将主动挂断通话。

# A 呼叫 B，B 此时断网，A 挂断，B 网络恢复，此时 B 会弹出通话界面，并且马上就结束，是什么原因？是否可以避免

产生这个现象的原因是 B 网络恢复后，连续收到建立通话消息和结束通话消息。

A 呼叫 B 时，建立通话消息发送到服务器上，A 挂断时发送了结束通话消息，不是取消前一个消息（服务器没有取消前一个消息的功能）。这些消息会在服务器上缓存一段时间（60 秒）。如果 B 在缓冲的时间内网络恢复，则将收到缓存的消息。如果 B 在缓冲时间之外网络恢复，则缓存消息已被删除，B 不会收到这些消息，也将不会出现弹出通话界面并立刻结束的现象。

一种方式避免产生这个现象，是在收到建立通话消息的时候延迟一段时间（例如 0.5 秒）再显示通话界面，如果立刻收到结束通话的消息，就不显示通话界面。

# 通话状态问题

调用 call 接口发起通话后，收到来电状态是 pending，调用 answer 接口后，通话状态变为 connecting，接通后变为 talking 状态。

# onCallItemRemove 回调说明

当收到 onCallItemRemove 回调时，callItem 不一定是当前的通话，可以通过 getCallItems 方法获得当前所有通话。

# 关于 Mtc_CallDbSetFullScreen(bool) 的使用

调用该方法会影响本端视频请求分辨率，默认设置为 true。

TIP

前提条件 本端默认请求是 640360 的分辨率本端屏幕分辨率为 360360

如果设置为 true，则请求分辨率会被调整为 360360；如果设置为 false，则请求分辨率还是以 640360 进行请求。

# 会议

# 是否支持同时加入多频道

所有平台都不支持。

# 关于 Mtc_CallDbSetAdaptiveAspect(bool)使用

调用该方法会影响视频发送分辨率，默认 false。

TIP

前提条件 摄像头采集为 1280720 (16:9) 协商后需要发送 320240（4:3）的图像给对方

如果设置为 true，则发送视频按照摄像头采集的比例（16:9）进行发送（对端收到的视频数据不是按照协商的分辨率）；如果设置为 false，则发送视频按照协商后需要发送的视频比例（4:3）进行发送（裁剪摄像头采集的图像）。

# 自己采集视频数据进行传输（智能设备SDK没有该接口) 只关心数据发送

可以按照下面的方法进行设定：

startVideoFile - setVideoFileFrame - stopVideoFile

或者需要用到菊风云的渲染：

startVideo（通过 getVideoFileId 获得 videoSource 值） - setVideoFileFrame - stopVideo

支持的格式：

I420, IYUV, RGB24, ABGR, ARGB, ARGB444, RGB565, ARGB1555, YUY2, YV12, UYVY, MJPG, NV21, NV12, BGRA

其中，setVideoFileFrame 接口如下

/**
 * 逐帧采集视频画面
 *
 * 当为 H264 格式时
 * 1. 如果是关键帧需要将 0x67 0x68 0x41 的数据作为一帧传入
 * 2. 关键帧要以固定间隔传入，例如5秒，否则一开始可能有几秒对端无法显示视频
 *
 * @param data 画面二进制数据
 * @param format   视频像素格式
 * @param width    宽
 * @param height   高
 * @param angle    90 的倍数
 * @param mirror   0 不镜像，1进行左右镜像
 * @param keyFrame 是否为关键帧，针对 format 为 H264
 */
public abstract void setVideoFileFrame(byte[] data, @VideoPixelFormat int format, int width, int height, int angle, int mirror, boolean keyFrame);

# 关于 H264 的说明

由于媒体底层一开始默认 H264 为关闭状态，所以程序启动的第一次 setVideoFrame 必须在 connecting 之前有调用，否则会导致对端收不到画面。

解决方案1：提早调；解决方案2：SDK 初始化成功后调用以下代码。

mediaDevice.startVideoFile();
byte[] buf = new byte[10];
buf[0] = 0x5;
mediaDevice.setVideoFileFrame(buf, JCMediaDevice.H264, 1, 1, 0, 0, false);
mediaDevice.stopVideoFile();

# 会议支持人数说明

会议总人数上限为 16 人。由于 CDN 直播，WebRTC，录制等都算会议成员，所以计算人数时需要注意。加入会议时，同一区域的同一通道 ID，即时 AppKey 不同，也可以互通。其中，区域是国家（地理位置）的概念，域是指服务器的域名，如下图所示

TIP

如果参会成员不在同一区域，即使通道 ID 相同也不能互通。程序默认区域值为中国。比如，同在中国的用户 A 和 B，在通道 ID 相同的情况下均可以加入会议。如果另一个成员 C 在国外，那么即时他拥有与 A、B 相同的通道 ID，也不能加入会议。