快速入门

最近更新时间:2026-04-02 11:22:09

我的收藏
如果你正在使用 AI 编辑器集成 Tencent RTC,这里提供完成接入所需的关键资源,包括 MCP、Skills、面向 LLM 的文档入口,以及 Live / Room / Call 的快速开始示例,支持 Web / iOS / Android / Flutter。
资源导航
RTC MCP Server(必做)
RTC Skills(推荐)
快速开始

准备账号与凭证(必做)

开始前请先在腾讯云控制台创建应用,并准备以下凭证:
凭证
获取位置
用途
SDKAppID
SDK 初始化、MCP 环境变量
SecretKey
TRTC 控制台 → 应用管理
生成 UserSig(仅用于测试)、MCP 环境变量

配置 MCP(必做)

在你的 AI 编辑器(CodeBuddy / Trae / Cursor / Codex / Claude Code / Claude Desktop 等)里配置 MCP:
{
"mcpServers": {
"tencentcloud-sdk-mcp": {
"command": "npx",
"args": ["-y", "@tencentcloud/sdk-mcp@latest"],
"env": {
"SDKAPPID": "YOUR_SDKAPPID",
"SECRETKEY": "YOUR_SECRET_KEY"
}
}
}
}
查看 CodeBuddy、Trae 、Cursor、Codex、Claude Code 、Claude Desktop 等的详细安装说明,请点击 MCP 配置

安装 Skills(推荐)

运行以下命令安装 Skills,CLI 会自动识别你正在使用的工具(CodeBuddy / Trae / Cursor / Codex / Claude Code / Claude Desktop 等):
npx skills add Tencent-RTC/tencent-rtc-skills
建议安装 Skills,以提高 AI 调用 MCP 工具的稳定性与准确率。详细说明见:Tencent RTC Skills

给 AI 提供文档上下文

除了使用 MCP 调用工具外,你还可以直接把文档 URL 提供给 AI,作为补充上下文。对于需要查 API、找示例、查参数的问题,这种方式通常更直接。
1. 索引文档llms.txt
当你还不确定该看哪篇文档时使用。
https://gitee.com/Tencent-RTC/docs/raw/main/zh/llms.txt
2. 产品聚合文档llms-full-*.txt
当你已经知道产品时,直接提供对应产品的llms-full-*.txt
3. 单页 Markdown *.md
当你已经知道具体功能页时使用,先通过llms.txt 或对应产品的llms-full-*.txt找到页面,再提供单页面 URL 给 AI。
示例:
https://gitee.com/Tencent-RTC/docs/raw/main/zh/livekit/integration-live.md

直播互动(Live)

直接复制下面 Prompt 到 IDE 对话框,集成直播互动 LiveKit:
任务:在当前项目中集成 LiveKit(先跑通视频直播基础流程)

执行要求:
1. 自动识别框架(Web Vue3/Flutter/Android/iOS)。
2. 无法识别时,需要调用 `present_framework_choice` 给用户选择。
3. 按平台调用 MCP 工具:
- Web: `get_web_live_uikit_integration`
- Native: `get_native_live_uikit_integration`
4. 参数:`framework`
5. 调用 `get_usersig` 完成初始化和登录。
6. 生成主播开播页、观众观看页、基础互动入口。

验收清单:
- 主播可开播
- 观众可观看
- 基础互动可用(如连麦入口)

常见问题排查:
- 黑屏:检查设备权限与渲染初始化
- 无声:检查音频权限与设备路由

视频会议(Room)

直接复制下面 Prompt 到 IDE 对话框,集成视频会议 RoomKit:
任务:在当前项目中集成 RoomKit(先跑通 quick-start 模式)

执行要求:
1. 自动识别框架(Web Vue3)。
2. 无法识别时,需要调用 `present_framework_choice` 给用户选择。
3. 按平台调用 MCP 工具:
- Web: `get_web_room_uikit_integration`
4. 参数:`framework`
5. 调用 `get_usersig` 完成初始化和登录。
6. 生成会议入口页、会议房间页、路由注册。

验收清单:
- 设备检测正常
- 可入会并看到音视频
- 屏幕共享可用(平台支持时)

常见问题排查:
- 进房失败:检查 roomId 与登录状态
- 无画面/无声音:检查摄像头麦克风权限

音视频通话(Call)

直接复制下面 Prompt 到 IDE 对话框,集成音视频通话 CallKit:
任务:在当前项目中集成 CallKit(先跑通 1v1 语音通话和视频通话)

执行要求:
1. 自动识别框架(React/Vue3/Flutter/Android/iOS).
2. 无法识别时,需要调用 `present_framework_choice` 给用户选择。
3. 按平台调用 MCP 工具:
- Web: `get_web_call_uikit_integration`
- Native: `get_native_call_uikit_integration`
4. 参数:`framework`
5. 调用 `get_usersig` 完成初始化和登录。
6. 生成最小可运行的呼叫入口和来电处理页面。

验收清单:
- 初始化与登录成功
- 能发起 1v1 视频通话
- 能收到来电并接听

常见问题排查:
- 60001:重新生成 userSig
- 通话失败:检查网络与设备权限


参考

MCP NPM