动态与公告

TUILiveKit 产品动态

云直播推拉流 SDK 产品动态

新手指引

产品简介

产品概述

产品优势

性能数据

基本概念

购买指南

TRTC Live 价格总览

Live 视频直播计费说明

开通服务（TUILiveKit）

Demo 体验

Demo 体验指引

跑通 Demo（TUILiveKit）

接入指南

视频直播

准备工作

主播开播

观众观看

直播列表

语聊房

准备工作

主播开播

观众观看

直播列表

推流助手

推流助手（Electron 桌面应用）

推流助手（Web 桌面浏览器）

直播监播

监播页面（Web 桌面浏览器 React 版）

监播页面（Web 桌面浏览器 Vue 版）

UI 自定义

直播视频组件

视频源编辑组件

观众列表组件

聊天弹幕组件

媒体源配置面板

连麦管理面板

直播送礼组件

无 UI 集成

搭建视频直播

搭建语聊房

功能指南

关注主播（TUILiveKit）

至臻画质（TUILiveKit）

输入媒体流进房（TUILiveKit）

礼物系统（TUILiveKit）

客户端 API

Android

iOS

Web

服务端 API（TUILiveKit）

账号系统

REST API

第三方回调

错误码（TUILiveKit）

常见问题

平台编译

用户鉴权

云直播推拉流 SDK

产品简介

购买指南

Demo 体验

免费测试

SDK 下载

License 管理

高级功能

客户端 API

常见问题

无 UI 集成方案

API 文档

OSS information

OSS Attribution Notice

第三方回调简介

PDF

聚焦模式

字号

最后更新时间： 2026-03-11 14:47:47

为了方便您控制 App 的功能形态，LiveKit 提供了回调能力。
功能说明
用户可通过 REST API 方式配置指定 Url 的回调，当执行的 CallbackCommand 在配置列表中，将触发回调。
注意事项
一个 sdkAppId 仅允许配置一个回调。
确保回调的 URL 是可以正常访问。
回调协议
第三方回调基于 HTTP/HTTPS 协议，App 后台需要向 live 平台 提供回调 URL，Chat 使用 POST 请求的方式来向 App 后台发起回调请求。Chat 在发起回调时，会在 App 提供的 URL 之后增加如下几个參数：
参数
含义
 SdkAppId
App 在 Chat 分配的应用标识
 CallbackCommand
回调命令字
contenttype
可选，通常值为 JSON
ClientIP
客户端 IP 地址
OptPlatform
客户端平台，对应不同的平台类型，可能的取值有：RESTAPI（使用 REST API发送请求）、Web（使用 Web SDK发送请求）、Android、iOs、Windows、Mac、iPad、Unknown（使用未知类型的设备发送请求）
安全问题
安全性问题：
1. HTTP 是明文传输，数据的保密性无法保证，建议使用 HTTPS。
2. 无法验证回调请求是否真正来自于Live。
为了解决请求来源的安全性问题，我们为您提供回调应用层签名认证，启用步骤如下：
1. 首先使用 设置回调配置 设置回调。
2. 在 设置回调鉴权 Token 中，开启鉴权，并配置鉴权 Token，配置完成后，回调请求 URL 参数会增加签名 Sign 以及签名时间戳 RequestTime，签名算法：Sign=sha256(TokenRequestTime)
3. 在 App 后台支持针对回调请求进行鉴权，通过本地鉴权 Token 以及回调 URL 参数中的签名时间戳 RequestTime 计算 sha256，比较签名是否匹配。并对 RequestTime 校验时效性，RequestTime 和当前时间相差超过1分钟即可认为是无效请求，以防止重放攻击。
签名算法示例：
﻿
Token=xxxxyyyy
RequestTime=1669872112
Sign=sha256(xxxxyyyy1669872112)=17773bc39a671d7b9aa835458704d2a6db81360a5940292b587d6d760d484061
﻿
回调 URL=URL&Sign=17773bc39a671d7b9aa835458704d2a6db81360a5940292b587d6d760d484061&RequestTime=1669872112
回调不通的常见原因
如果遇到回调不通的情况，App 先依照如下清单排查一下设置的回调服务是否存在问题。
回调不通的现象
可能存在的原因
回调 URL 访问超时
1. Live无法完成 DNS 解析，请确认该域名是否在公网生效。（例如，回调 HOST 为 http://notexist.com，该域名不存在，Live 无法完成 DNS 解析。）
2.  Live无法访问到回调 URL 中配置的 IP，请确认该 IP 是否公网可达。（例如，回调 HOST 为 http://10.0.0.1，该域名为 App 内网 IP，Live无法访问到该 IP。）
3. App 回调服务防火墙策略限制，请检查防火墙配置。（例如，App 回调服务器拒绝了所有到达 80 端口的请求。）
回调服务拒绝访问
Live 可以访问到 HOST，但链接建立失败，请确认 WebServer 已经正确启动。（例如：App 回调服务器的 WebServer 并未启动，或者端口配置错误。）
回调服务 HTTP 返回码非200
回调请求成功，但应答报文中的 HTTP 返回码非200。
回调应答包体解析失败
回调请求包体非 JSON 格式。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

直播 SDK

第三方回调简介

功能说明

注意事项

回调协议

安全问题

回调不通的常见原因

帮助和支持

参数	含义
SdkAppId	App 在 Chat 分配的应用标识
CallbackCommand	回调命令字
contenttype	可选，通常值为 JSON
ClientIP	客户端 IP 地址
OptPlatform	客户端平台，对应不同的平台类型，可能的取值有：RESTAPI（使用 REST API发送请求）、Web（使用 Web SDK发送请求）、Android、iOs、Windows、Mac、iPad、Unknown（使用未知类型的设备发送请求）

回调不通的现象	可能存在的原因
回调 URL 访问超时	1. Live无法完成 DNS 解析，请确认该域名是否在公网生效。（例如，回调 HOST 为 http://notexist.com，该域名不存在，Live 无法完成 DNS 解析。） 2. Live无法访问到回调 URL 中配置的 IP，请确认该 IP 是否公网可达。（例如，回调 HOST 为 http://10.0.0.1，该域名为 App 内网 IP，Live无法访问到该 IP。） 3. App 回调服务防火墙策略限制，请检查防火墙配置。（例如，App 回调服务器拒绝了所有到达 80 端口的请求。）
回调服务拒绝访问	Live 可以访问到 HOST，但链接建立失败，请确认 WebServer 已经正确启动。（例如：App 回调服务器的 WebServer 并未启动，或者端口配置错误。）
回调服务 HTTP 返回码非200	回调请求成功，但应答报文中的 HTTP 返回码非200。
回调应答包体解析失败	回调请求包体非 JSON 格式。