平台/框架 | 版本号 |
Android/iOS/Flutter/uni-app(客户端) | ≥ 1.7.1 |
Web | ≥ 1.4.6 |
微信小程序 | ≥ 1.5.1 |
回调状态 | 结果表示 |
未接听:被叫方超时未接听 | not_answer |
拒接:被叫方拒接 | reject |
忙线:通话忙线 | call_busy |
取消:主叫方在接通前取消通话 | cancel |
完成:通话接通并正常结束 | normal_end |
中断:网络等原因导致通话中断 | interrupt |
https://www.example.com
。
示例:$http://www.example.com?sdkappid=$sdkappid&command=$command&contenttype=json&clientip=$clientip&optplatform=$optplatform
参数 | 说明 |
http | 请求协议为 HTTPS 或 HTTP,请求方式为 POST |
www.example.com | 回调 URL |
sdkappid | 创建应用时在即时通信 IM 控制台分配的 SDKAppID |
command | |
contenttype | 固定值为 json |
clientip | 客户端 IP,格式如:127.0.0.1 |
optplatform | 客户端平台,可能是 iOS、Android、Web、miniProgram |
POST /?sdkappid=8888888&command=call_end&contenttype=json&clientip=127.0.0.1&optplatform=iOS HTTP/1.1Host: www.example.comContent-Length: 337{"UserId": "Alice","RoomId": "Alice's Room","TotalNum": 2,"MediaType": "audio","CallType": "single","CallId": "aheahfo-eqwnknoihfsd-qweqf","Role": "caller","CallResult": "normal_end","EventTime": 170485688,"StartCallTs": 1704856873,"AcceptTs": 1704856876,"EndTs": 1704856885}
字段 | 类型 | 说明 |
UserId | String | 操作的用户 ID |
RoomId | String | 操作的房间 ID |
TotalNum | Integer | 参与通话人数 |
MediaType | String | 媒体类型: audio 音频通话video 视频通话 |
CallType | String | 通话类型: single 音频通话group 视频通话 |
CallId | String | 通话唯一 ID |
Role | String | 角色: caller 主叫 userIdcallee 被叫 userId |
CallResult | String | 通话结果,仅在结束事件中填写,其余为空: cancel 取消:主叫方在接通前取消通话reject 拒接:被叫方拒接not_answer 未接听:被叫方超时未接听normal_end 完成:通话接通并正常结束call_busy 忙线:通话忙线interrupt 中断:网络等原因导致通话中断 |
EventTime | Integer | 操作发生的时间戳(秒级) |
StartCallTs | Integer | 通话发起的时间戳(秒级)只有在normal_end才会回调此值 |
AcceptTs | Integer | 通话接听的时间戳(秒级)只有在normal_end才会回调此值 |
EndTs | Integer | 通话结束的时间戳(秒级)只有在normal_end才会回调此值 |
normal_end
。{"ErrorCode": 0,"ErrorMessage": "Success"}
字段 | 类型 | 说明 |
ErrorCode | Integer | 0 为成功,其余为失败 |
ErrorMessage | String | 您的服务器响应可以自定义携带错误信息 |
0s, 1s, 1s, 2s, 3s, 5s
若均为成功则放弃。错误码 | 含义说明 |
0 | 请求成功 |
50001 | 当前应用需要购买 TUICallKit 群组通话版套餐包方可使用 |
999 | 回调不存在 |
70001 | 请求参数无效,请检查必填参数是否缺失或填错 |
70002 | UserSig 无效 |
70003 | UserSig 过期 |
70004 | 请求用户非超级管理员 |
70005 | 请求被限频 |
未知错误码 |
本页内容是否解决了您的问题?