融合呼叫状态码 - 音视频通话 2.0

更新时间： 2024/11/18 11:08:13

直呼状态码（code)

在高接通方案中，onDirectStartCall 等直呼相关回调会返回状态码 code，通知当前直呼事件的状态。其中，部分状态码由运营商侧提供，常见状态码如下。

状态码（code）	errMsg	说明	解决方法
200	空	状态正常。	-
401	token check failed	websocket 长连接鉴权失败。	检查 Token 是否正确。
500	SERVER_ERROR	websocket 长连接处理异常。	服务端或 SDK 请求异常，请联系技术支持处理。
10000	unknown error	未知异常。	服务端异常，请联系技术支持处理。
10001	param is not allow null	参数不可为空。	检查参数传参是否为空。
10002	XXX illegal	非法参数，详细报错见 errMsg。	检查参数 XXX 传参是否正确。
10011	the session is invalid	通话不存在或已结束。	检查 uid 或 channelName 是否正确。
10031	没有权限	没有权限。	请确认是否已开通融合呼叫功能。
10032	呼叫太频繁，请稍后再试	呼叫太频繁，请稍后再试。	仅支持一对一通话，请检查当前主叫方是否重复发起了呼叫。
10033	请求超频控上限	呼叫并发达到上限。	请联系商务经理提高并发上限。
10034	未绑定外呼号码	appkey 未绑定外呼号码。	请联系技术支持处理。
10035	外呼号码不合法	外呼号码错误。	请检查外呼号码是否正确。
10036	风控服务受限	风控服务受限，即拨打电话的时间不在指定时段内。	若有需求，请联系商务经理调整风控时段。
10037	token 鉴权失败	登录 Token 校验失败。	检查 Token 是否正确。
10015	呼叫失败：电话已欠费	呼叫失败。原因是外呼号码已欠费。	请关注外呼号码余额，并在余额不足时及时充值。
10022	呼叫失败，请稍后重试	呼叫失败。通常原因为运营商网络问题。	请稍后重试。若长时间未恢复，请联系技术支持处理。

挂断状态原因（reason）

onDirectCallHangupWithReason 回调会返回状态原因 reason，通知当前状态的原因。其中，正常挂断、关机、空号、欠费、飞行模式下，reason 均为 16，非 16 的 reson 以运营商返回为准。完整状态原因请参考 ITU-T Q.850 Code。

原因码（reason）	原因	说明
0	未指明异常。	无其他适用代码。通常发生的情况与原因 1、原因 88 和原因 100 相同。
1	未分配号码。	由主叫方发起的呼叫请求无法到达目的地，因为被叫方的号码未分配。
2	没有指向指定网络的路由。	网关询问通过未被识别的或不提供指定服务的中间网络路由呼叫。
3	目的地地址解析失败。	由主叫方发起的呼叫请求无法到达目的地，因为网络呼叫通过的路由不为所需的目的地服务。
6	信道不被接受。	发送此呼叫的实体不接受最新确定的信道。
7	被给予的呼叫在已建立的信道传送。	被叫方被给予了呼入呼叫，且该呼入呼叫连接的信道是已经为该被叫方相似的呼叫设立好的。
16	正常呼叫清除。	清除了呼叫，因为其中一方请求清除呼叫。
17	用户忙。	被叫方无法接受另一通呼叫，因为遇到了用户繁忙状态。此原因值可以由被叫方或网络生成。若是被叫方确定的用户忙，此时接收呼叫的设备是与呼叫兼容的。
18	无用户应答。	当被叫在指定的分配时间内没有响应呼叫建立消息并发出警报或连接指示时，使用此原因。
19	已被激活的用户无回应。	被叫方被激活，但未在指定时间段内回应连接指示。此原因不一定由 Q.931 步骤生成，可能由内部网络计时器生成。
20	用户不在。	当一个移动节点注销时，无线电通讯没有获得一个新的移动站点，或者个人电信用户在任何用户网络接口都是不可寻址的。
21	呼叫被拒绝。	发送此原因的设备不希望接受此呼叫，并非是因为发送原因的设备是忙碌或者不兼容的。当此原因由网络生成时，表明由于附加服务限制条件清除了呼叫。诊断域可能会包含关于附加服务的其他信息和拒绝呼叫的原因。
22	号码已改变。	当主叫方请求与之建立呼叫的被叫号码不再分配，此状态码返回给主叫方。诊断域可能会包含新的被叫号码。
23	对新建目标的重定向。	由常规 ISUP 协议机制使用，决定呼叫需发送到一个不同的被叫号码。
25	交换路由错误。	呼叫请求无法到达主叫方指示的目的地，由于中间交换机在执行跃点计数过程中达到了极限而释放了呼叫。此原因由中间节点产生。当对跃点计数值进行递减时，结果为 0。
27	目的地不可达。	呼叫请求无法到达主叫方指示的目的地，因为目的地接口无法正常使用。信令消息无法发送给对端方。例如，数据链路层异常或用户设备不在线。
28	号码格式无效。	呼叫请求无法到达被叫方，因为被叫号码的格式无效或不完整。
29	设备被拒绝。	网络无法提供主叫方请求的某一附加服务。
30	响应状态查询。	当查询状态主要是为了获取状态消息时，此原因码包括状态消息。
31	未指定的正常。	此原因仅用于在正常类中没有应用其他原因的情况下报告正常事件。
34	无可用线路/信道。	目前没有合适的线路/信道来处理这个呼叫请求。
38	网络无序。	可能会在很长一段时间内无法正常使用网络。例如，用户立即重新发起呼叫请求不太可能成功。
41	暂时失败。	短时间内无法正常使用网络，可以立即尝试重连。例如，用户立即发起另一个呼叫请求可能成功。
42	交换设备拥塞。	产生该原因的交换设备正在经历一段时间的高流量。
43	访问信息被丢弃。	网络不能按照请求向远程用户传递访问信息，即用户对用户的信息、低层兼容性、高层兼容性或诊断中指出的子地址。需要注意的是，可以选择将被丢弃的特定类型的访问信息包含在诊断中。
44	没有请求的线路/信道。	当接口的另一端不能提供请求实体所指示的线路或信道时，返回此原因。
45	预留字段。	-
47	内部资源分配失败。	此原因仅用于在资源不可用类中没有应用其他原因的情况下报告正常事件。
50	请求的功能未开通。	用户请求了附加服务，但没有权限使用。
52	禁止对外呼叫。	呼入呼出时，虽然主叫方是 CUG（Closed User Group）的成员，但该成员不允许呼出。
54	禁止对内呼叫。	来电时，虽然被叫是 CUG 的成员，但不允许呼叫到该 CUG 成员。
57	承载能力未授权。	用户请求了在设备实现承载能力，但未被授权。
58	承载能力当前不可用。	用户请求了已由设备实现但目前不可用的承载能力。
63	服务或选项不可用。	此原因仅用于在服务或选项不可用类中没有应用其他原因的情况下报告正常事件。
65	媒体协商失败。	发送此原因的设备不支持所请求的承载能力。
66	信道类型未实现。	发送此原因的设备不支持所请求的信道类型。
69	请求的功能未实现。	发送此原因的设备不支持所请求的附加业务。
79	服务或选项未实现。	此原因仅用于在服务或选项未实现类中没有应用其他原因的情况下报告正常事件。
81	呼叫参考值无效。	发送此原因的设备收到了一个用户网络接口上当前没有使用的调用引用消息。
88	目标不兼容。	发送此原因的设备已经收到了一个请求，但建立了一个有低层兼容性、高层兼容性或其他兼容性属性（如数据速率）不能兼容的呼叫。
95	无效消息已接收。	此原因仅用于在无效消息类中没有应用其他原因的情况下报告正常事件。
96	必需信息元素缺少。	发送此原因的设备收到了一个缺少信息元素的消息，该信息元素必须在该消息被处理之前存在于该消息中。
97	消息类型不存在或未被实现。	发送此原因的设备收到了一个无法识别的消息类型，因为该消息是发送此原因的设备未定义或未实现的消息。
98	消息与呼叫状态不兼容，或者消息类型不存在或未被实现。	发送此原因的设备已经收到了一个消息，但这不表明这是一个在呼叫状态中允许接收的消息，而是收到的 STATUS 消息表明现在处于不兼容的呼叫状态。
99	信息元素或参数不存在或未被实现。	发送此原因的设备收到了包含无法识别的信息元素或参数的消息，因为信息元素或参数名没有被定义也没有由设备实现。
100	无效信息元素内容。	发送此原因的设备收到了已经被实现的信息元素。然而，发送此原因的设备未实现编码其中一个或很多特定字段的方式。
101	消息与呼叫状态不兼容。	已经接收的消息与呼叫状态不兼容。
102	呼叫建立超时。	计时器的过期与错误的处理步骤有关系。
103	参数不存在或未被实现。	发送此原因的设备接收的消息包括无法识别的参数，因为参数在设备上没有被定义或未被实现。
111	协议错误。	此原因仅用于在协议错误类中没有应用其他原因的情况下报告正常事件。
127	内部网络错误。	此原因表示对接呼叫（通常是对 SW 56 服务的呼叫）已经结束。
487	接入网关取消。	-
500	本次请求崩溃。	-
501	系统服务关闭。	-
502	请求丢失。	-
503	请求管控。	当用户调用 API 发送命令让通话挂起时，使用这个原因。例如 uuid_kill。
600	转发失败。	-
601	参与转发。	-
602	分配超时。	服务器取消了呼叫，因为目标信道应答时间过长。
603	USER_CHALLENGE。	-
604	媒体超时。	-
605	PICKED_OFF。	呼叫是通过从另一个分机（例如从另一个分机拨号**ext_number）截取的。
606	SIP 用户未注册。	主叫方试图向忘记注册的 SIP 用户发起呼叫。
607	处理超时。	交换机处理超时。
609	网关宕机。	网关宕机（不对选项或订阅作出回应）。
700	G2 房间不存在。	呼叫发起时，对应的 G2 房间不存在。

此文档是否对你有帮助？

有帮助

去反馈

直呼状态码（code)
挂断状态原因（reason）