一、优势
| 优势 | 说明 |
| 多平台覆盖 | 支持 Android、iOS、Flutter。 |
| 多种集成体系 | 支持纯 API 手动路线和 TEBeautyKit 面板路线,兼容不同业务需求。 |
| 主流音视频载体 | 与 TRTC、直播 SDK 深度对接。 |
| 标准化流程 | 内置 License 鉴权、资源下载、生命周期管理等一整套可复用执行路径。 |
| 零运行时依赖 | 纯静态文本资源,不引入额外运行时开销。 |
| 一站式脚本 | 内置面板 JSON 和套餐素材自动下载脚本,Agent 可主动替用户完成资源准备。 |
二、前置条件
使用前,请确保你使用的 AI 编程工具支持 Skills 功能,目前支持的工具包括:
·CodeBuddy
·Trae
·Cursor
·Codex
·Claude Code
·Claude Desktop
三、安装方式
Skills 资源包包含三个平台的 Skill(iOS / Android / Flutter),可根据项目需要按需导入一个或多个。
1. 单击下载 tencent-effect-skills.zip。
2. 解压后获得三个 Skill 目录:tencent-effect-ios/、tencent-effect-android/、tencent-effect-flutter/。
3. 将需要的 Skill 目录(如 tencent-effect-ios/、tencent-effect-android/、tencent-effect-flutter/)复制到对应 AI 编程工具的 Skills 存放目录下。
四、使用示例
以下是几种典型集成场景的描述示例,各平台(Android、iOS、Flutter)均可使用:
五、场景一:只集成 SDK(纯 API 手动路线)
"帮我在项目中集成腾讯特效 SDK,不需要美颜面板 UI,我自己管理视频帧处理。"
Agent 会引导你完成 License 鉴权、SDK 依赖配置、核心 API 初始化,以及视频帧的手动处理流程。
六、场景二:集成 TEBeautyKit(带面板)
"接入腾讯特效 SDK,并集成的美颜面板 UI。"
Agent 会走 TEBeautyKit 路线,帮你配置面板依赖、自动下载面板 JSON 资源和套餐素材,并给出面板初始化和美颜参数回调的完整代码。
七、场景三:集成 TEBeautyKit + TRTC
"在项目中集成 TEBeautyKit,搭配 TRTC 做实时音视频美颜。"
Agent 会走 Adapter 路线,帮你完成 TRTC 视频处理回调注册、面板与 Adapter 的绑定、美颜开关状态同步,以及旋转方向适配。
八、场景四:集成 TEBeautyKit + 直播
"接入 TEBeautyKit 和直播 SDK,实现推流美颜。"
Agent 会引导你完成直播 SDK 的视频处理回调注册、TEBeautyKit 与直播推流的联合配置,并提醒生命周期管理和 License 鉴权顺序。
九、触发关键词
当你的提问中包含以下关键词时,AI Agent 会自动激活此 Skills:
·中文业务关键词:腾讯特效、美颜 SDK、滤镜、动效贴纸、人像分割、3D 特效、美颜面板、手势点位、身体点位、套餐包、套餐切换。
·平台 / 类名关键词:
·Android:XmagicApi、TEBeautyTRTCAdapter、TEPanelView、TEUIConfig、TEPanelViewCallback、TEBeautyKit.EffectState。
·iOS:XMagic、TEBeautyKit、TELicenseCheck、TRTCVideoFrameDelegate、V2TXLivePusherObserver、YTProcessInput、YTProcessOutput、TRTCAdapter、TELiveAdapter。
·Flutter:tencent_effect_flutter、TencentEffectApi、XmagicProcesserFactory、TEBeautyPanelView、TEResConfig
·SDK 套餐 / 依赖关键词:TencentEffect_S1-07、TencentEffect_S1、TencentEffect_A1、pod TencentEffect_、pod TEBeautyKit、te_sub_spec。
十、Skills 内容结构
AndroidiOSFluttertencent-effect-android/ ├── SKILL.md # Android Skills 主文件 ├── examples/ │ ├── standalone/ # 独立相机示例 │ ├── trtc/ # TRTC 示例 │ └── mlvb/ # 直播 SDK 示例 ├── references/ │ ├── 00-overview.md # 套餐选择与 License 申请 │ ├── 01-license.md # License 初始化 │ ├── 02-api-xmagicapi.md # XmagicApi 核心 API │ ├── 10-standalone.md # 独立相机集成 │ ├── 11-with-trtc.md # TRTC 集成(Adapter + 手动) │ ├── 12-with-mlvb.md # 直播 SDK 集成 │ ├── 13-beauty-panel-assets.md # 面板资源处理 │ ├── 14-suite-resources.md # 套餐素材处理 │ ├── 20-atomic-abilities.md # 原子能力(分割/点位) │ ├── 21-advanced-mode.md # 性能调优与高级模式 │ └── 30-faq-troubleshooting.md # 常见问题排错 └── snippets/ ├── license-init.kt # License 初始化 ├── resource-copy.kt # 资源拷贝到沙盒 ├── lifecycle.kt # 生命周期管理 ├── gradle-deps.txt # Gradle 依赖与权限 ├── fetch-beauty-panel.sh # 面板 JSON 下载脚本 └── fetch-suite-resources.sh # 套餐素材下载脚本tencent-effect-ios/ ├── SKILL.md # iOS Skills 主文件 ├── examples/ │ ├── standalone.md # 独立相机完整示例 │ ├── trtc.md # TRTC 联合接入示例 │ └── mlvb.md # 直播 SDK 联合接入示例 ├── references/ │ ├── 00-overview.md # 环境要求、套餐选择、Pod 依赖 │ ├── 01-license.md # License 鉴权 │ ├── 02-api-xmagic.md # 纯 XMagic API 说明 │ ├── 03-tebeautykit.md # TEBeautyKit 体系说明 │ ├── 10-standalone.md # 独立相机集成指南 │ ├── 11-with-trtc.md # TRTC 联合集成指南 │ ├── 12-with-mlvb.md # 直播 SDK 联合集成指南 │ └── 30-faq-troubleshooting.md # 常见问题排错 └── snippets/ ├── license-init.m # License 鉴权代码片段 ├── resource-bundle.m # 资源目录配置 ├── lifecycle.m # 生命周期管理 ├── podfile.txt # Podfile 依赖示例 ├── fetch-beauty-panel.sh # 面板 JSON 资源下载脚本 └── fetch-adapter.sh # Adapter 库下载脚本tencent-effect-flutter/ ├── SKILL.md # Flutter Skills 主文件 ├── examples/ │ ├── trtc/ # trtc_cloud 示例 │ ├── tencent-rtc-sdk/ # tencent_rtc_sdk 示例 │ └── live/ # live_flutter_plugin 示例 ├── references/ │ ├── 00-overview.md # 套餐选型 + Flutter 插件引入 │ ├── 01-license.md # License 鉴权(Dart 层) │ ├── 02-api-tencenteffectapi.md # TencentEffectApi 完整 API │ ├── 11-with-trtc-cloud.md # tencent_trtc_cloud 集成 │ ├── 11b-with-tencent-rtc-sdk.md # tencent_rtc_sdk 新版集成 │ ├── 12-with-live-flutter-plugin.md # live_flutter_plugin 集成 │ ├── 13-beauty-panel-assets.md # 面板资源处理 │ ├── 14-suite-resources.md # 套餐素材处理 │ └── 30-faq-troubleshooting.md # 常见问题排错 └── snippets/ ├── license-init.dart # License 初始化(Dart) ├── init-flow.dart # 完整初始化顺序 ├── native-register-beauty-factory.md # 原生层注册 BeautyFactory ├── lifecycle.dart # 生命周期管理 ├── pubspec.yaml.txt # pubspec.yaml 关键依赖 ├── fetch-beauty-panel.sh # 面板资源下载脚本 └── fetch-suite-resources.sh # 套餐素材下载脚本