FAQ

1. 登录

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

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

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

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

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

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

2. 账号查询

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

3. 一对一通话

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

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

3.2 现在呼叫等待时间是多长？

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

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

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

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

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

3.4 通话状态问题

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

3.5 onCallItemRemove 回调说明

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

3.6 关于 Mtc_CallDbSetFullScreen(bool) 的使用

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

3.7 关于 Mtc_CallDbSetAdaptiveAspect(bool)使用

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

3.8 自己采集视频数据进行传输（智能设备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);

4. 关于 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();

5. 会议支持人数说明

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