快速入门

最近更新时间:2026-06-04 17:56:14

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

准备账号与凭证(必做)

开始前请先在腾讯云控制台创建应用,并准备以下凭证:
凭证
获取位置
用途
SDKAppID
SDK 初始化、MCP 环境变量
SecretKey
生成 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(推荐)

详细步骤见: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:
我有一个现有的 Vue3 项目,项目路径是 <填写你的项目路径>
请帮我按 TUIRoomKit Web&H5 快速接入流程集成多人会议,使用官方 RoomKit UI。

请完成:
1. 当前项目为 Web Vue3 项目,请按 Vue3 接入方式集成。
2. 接入官方 Web RoomKit 组件:
- PC 端使用 ConferenceMainView
- H5 端使用 ConferenceMainViewH5
- 外层使用 UIKitProvider
3. 使用官方 conference API 完成会议流程:
- conference.login()
- conference.setSelfInfo()
- conference.createAndJoinRoom()
- conference.joinRoom()
- conference.leaveRoom()
- conference.endRoom()
4. UserSig 通过后端接口或本地 get_usersig 能力获取,不要在前端生成 UserSig,不要暴露 SecretKey。
5. 生成或改造:
- 会议入口页
- 会议房间页
- 路由注册
- 必要的初始化逻辑

验收目标:
1. 可以完成设备检测。
2. 可以创建会议或加入会议。
3. 入会后可以看到本地音视频。
4. 多端入会后可以看到远端音视频。
5. 屏幕共享可用;如果当前平台不支持,请给出明确提示。

如果出现问题,请优先排查:
1. 进房失败:检查 roomId、SDKAppID、UserSig 和登录状态。
2. 无画面或无声音:检查浏览器摄像头、麦克风权限。
3. 屏幕共享不可用:检查浏览器支持情况以及 HTTPS / localhost 环境。

音视频通话(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