| 登陆失败 | 登录接口调用失败 | 正常情况下，考虑到用户使用场景，应该从网络情况、是否有内外网限制、是否参数正确、是否多传参数或者少传参数等等方面进行排查。 | 1. 检查网络是否正常； 2. 是否是外网直接访问内网地址，需要修改地址； 3. 检查每个参数是否正确：中英文、大小写、参数内容、参数类型。 4. 检查每个参数的含义，是否多穿参数或者少传参数，如不支持国密传国密或导致失败。 5. 实在排查不出请联系我们。 |
| 登出崩溃 | 挂断后登出崩溃或者偶发登出崩溃。 | 登出功能正常运行一般不会出问题，排查方向可定为使用场景、环境。 | 是否子线程，只能主线程登出。 |
| SDK非主线程调用失败 | 在非主线程中调用SDK方法失败或者导致其他问题。 | 一般情景SDK方法可以正常运行，在子线程中可能会导致出现不可知问题。 | 是否子线程，只能主线程使用。 |
| 挂断后仍然无法正常结束会议 | 成员1离开会议后，成员2仍然能看到成员1卡住的画面。此种情况大多数都是由于成员1异常离开导致的 | 正常情况下，成员1离开会议，服务端能立刻知道成员1离开。 异常离开会议后，成员1无法立刻通知服务端，这时服务端会等待成员1的心跳响应，1分钟后如果没有收到心跳回应，服务端会将成员1踢出会议。 | 1. 成员1没有调用term挂断 2. 成员1先调用logout登出，然后才调用term挂断 3. 用户1直接杀进程离开会议（此种情况不可避免） |
| 画面黑边 | 本地视频画面出现黑边 | 大部分手机屏幕宽高比是9/16，针对大部分手机可以调整摄像头采集的宽高比。 | 入会成功后，设置本地摄像头宽高比9/16。 示例代码: [_agent setRatio:0.5625]; |
| 访客看不到坐席画面 | H5界面自动播放失败 | 代码逻辑正常的情况下需要定位 WebView、权限等限制问题。 | 浏览器（WebView）安全性要求用户与界面有交互才允许自动播放（保护用户隐私，必须用户手动确认播放才允许播放视频/音频）， 有些浏览器会认为设备授权（摄像头、麦克风）行为是一次UI交互，WebView行为不确定。 另外，目前H5端这方面的策略越来越严格，自动播放受限越来越严格。页面增加自动播放异常处理，弹窗交互确认，在确认按钮下增加play()接口调用 |
| 移动端坐席收到来电后无法接起 | 集成方同时初始化坐席和访客模块，收到来电后，访客模块也收到了来电邀请，向排队机回了responseCancelInvite。 | 取消同时初始化进行定位 | 只能初始化一个模块 |
| 播放音乐无声音 | 使用SDK ringPlay播放等待铃声没有声音 | 需要确定使用的是本地播放还是会议内播放 | 本地播放接口和会议内播放接口和逻辑不同，需要分别实现ringPlay()会议内播放、enableAudioInputFromFile()本地播放 |
| JRTC 移动端屏幕共享互挤问题 | 共享被挤后，导致再次开启时无法收到授权回调，最终无法开启共享 | JRTC内部，在收到被挤下共享时，由于没去关闭共享，再次去发起后，因为采集是开着的，所以不会有授权回调，导致无法真正开启共享 | JRTC共享逻辑为上层调用共享接口后，先开启采集，采集需要授权，授权成功后才真正发起共享，被挤下之后，主动关闭一下采集。 |
