tencent cloud

腾讯特效 SDK

Skills

Download
聚焦模式
字号
最后更新时间: 2026-08-04 11:40:39

介绍

腾讯特效 SDK Skills 是面向腾讯特效 SDK 集成场景的结构化指引资源包,覆盖美颜、滤镜、动效贴纸、人像分割、3D 特效等核心能力。它将 SDK 领域知识直接注入 AI 编程助手的上下文,将自然语言需求转化为可执行的标准化步骤,帮助开发者高效完成 Android、iOS、Flutter 三平台的 SDK 集成。

优势

优势
说明
多平台覆盖
支持 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 特效、美颜面板、手势点位、身体点位、套餐包、套餐切换。
平台 / 类名关键词
AndroidXmagicApiTEBeautyTRTCAdapterTEPanelViewTEUIConfigTEPanelViewCallbackTEBeautyKit.EffectState
iOSXMagicTEBeautyKitTELicenseCheckTRTCVideoFrameDelegateV2TXLivePusherObserverYTProcessInputYTProcessOutputTRTCAdapterTELiveAdapter
Fluttertencent_effect_flutterTencentEffectApiXmagicProcesserFactoryTEBeautyPanelViewTEResConfig
SDK 套餐 / 依赖关键词TencentEffect_S1-07TencentEffect_S1TencentEffect_A1pod TencentEffect_pod TEBeautyKitte_sub_spec

Skills 内容结构

Android
iOS
Flutter
tencent-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 # 套餐素材下载脚本

帮助和支持

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

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

文档反馈