tencent cloud

腾讯特效 SDK

动态与公告
产品动态
关于腾讯特效 SDK V3.5 版本更新公告
关于腾讯特效 SDK V3.0 版本相关接口及素材变更公告
产品简介
产品概述
产品功能
基本概念
产品优势
应用场景
购买指南
价格总览
购买流程
欠费退费说明
新手指引
Demo 体验
免费测试
License 指引
移动端 License 新增与续期
PC 端 License 新增与续期
Web端 License 新增与续期
常见问题
SDK 下载
功能说明
SDK 下载
版本历史
SDK 集成指引(无 UI)
通用集成腾讯特效
原子能力集成指引
SDK 集成指引(含 UI)
通用集成腾讯特效
直播 SDK 集成腾讯特效
TRTC SDK 集成腾讯特效
短视频 SDK 集成腾讯特效
Avatar 虚拟人集成指引
API 文档
iOS
Android
Flutter
Web
功能实践
SDK 包瘦身
SDK 集成问题排查
性能调优
效果调优
素材使用
美颜参数说明
美颜场景推荐参数
短视频企业版迁移指引
第三方推流接入美颜(Flutter)
小程序美颜特效实践
素材制作工具使用
Web 美颜特效
产品概述
快速上手
SDK 接入
API 文档
控制台指南
Demo 体验
内置素材总览
实践教程
常见问题
常见问题
通用类相关
技术类相关
License 相关
旧版文档
美颜场景推荐参数
美颜参数表
一分钟集成 TRTC
一分钟集成直播
TE SDK 政策
隐私协议
数据处理和安全协议
联系我们

粒子系统

PDF
聚焦模式
字号
最后更新时间: 2026-03-30 18:03:44

创建粒子系统

粒子特效组件可以添加在任意 3D 对象上,建议使用时新建一个 3D 空对象,重命名之后再添加粒子特效组件,方便管理。
粒子特效组件中的参数除了贴图以外都有默认值,添加完贴图之后,就可以看到初始效果了。







部分参数说明

Transform 只改变发射点:该参数主要与动画或者 3D 人头等功能结合使用。未勾选时,粒子对象的“3D 位置与变换”会作用在所有的粒子上;勾选之后, 3D 位置与变换只会作用在发射器的中心点及发射方向上,粒子本身仍然会遵循各自的运动状态及统一的重力参数。
开启粒子发射判断:该参数主要与流程控制等功能结合使用。勾选后,该粒子对象的出现/消失逻辑会改为判断粒子发射/不发射。
生命周期、最大粒子数:粒子系统每秒发射的粒子数 = 最大粒子数 / 平均生命周期。
发射持续时间:小于等于 0 时表示粒子持续发射,大于 0 时,表示粒子会在发射多少秒后会自动暂停发射,等待所有粒子消失之后再重新发射,如此往复,此时实际有效粒子数会小于最大粒子数。
初始颜色、结束颜色:该颜色值会与粒子贴图颜色叠加,另外如果开启了“动态透明度”功能,此处的透明度(alpha 值)将失效,并完全由动态透明度曲线控制。
点击颜色可打开调色板,在调色板中可调节颜色和透明度。



发射模式:分为“重力模式”和“自定义轨迹”两种,在自定义轨迹模式下,所有粒子的运动轨迹将遵循自定义的路线,具体的路线配置方法可参考 自定义粒子轨迹 章节。
使用雪碧图:开启之后,可以使用雪碧图纹理来配置粒子,实现类似序列帧的效果,具体配置可参考 粒子雪碧图 章节。
动态大小曲线:开启之后,每个粒子生命周期内的大小会遵循自定义的变化曲线,此时初始大小、结束大小参数失效,具体配置可参考 自定义大小和透明度曲线 章节。
动态透明度:开启之后,每个粒子生命周期内的透明度会遵循自定义的变化曲线,此时初始颜色、结束颜色参数的 alpha 值失效,具体配置可参考 自定义大小和透明度曲线 章节。

粒子雪碧图

使用雪碧图可以让粒子“动起来”。雪碧图可以理解成把多张图组合成一张图的序列帧贴图,示例如下:



使用雪碧图时,需要勾选“使用雪碧图”选项,会弹出相关参数配置项:



大图像素即整张图片的像素,子图像素是每张小图的像素宽高,子图行列数即小图是几乘几,例如上面的雪花示例图是 4 × 4,这三个参数需要根据图片实际情况手动输入。
播放方式分为头尾循环和反复循环,播放次数与 2D 贴纸、音乐等播放次数相同。为 -1 代表无限循环,大于等于 0 时实际循环次数为数值加 1,即 0 代表 1 次,1 代表 2 次。
勾选“开启随机初始图”后,每个粒子的首张小图会随机选择,非勾选时所有粒子都会从左上角第一张小图开始播放。
示例效果:




自定义粒子轨迹

在“自定义轨迹”发射模式下,可以自由配置粒子的运动路线,主要用于实现某些反重力的粒子路线效果,例如之字形路线。



曲线编辑中的蓝、红、绿线分别代表 X、Y、Z 三轴坐标的变化曲线,横轴为时间轴,纵轴为数值轴;由于曲线编辑的坐标系为归一化坐标系,需要同时设置合理的偏移系数和缩放系数参数,所以粒子每个时刻的实际位置为:偏移系数 + 曲线的纵轴数值 × 缩放系数。
说明:
曲线修改后需要刷新预览界面。
示例效果:




自定义大小和透明度曲线

粒子组件支持自由配置大小和透明度变化曲线,两者的参数组成相同:






基准值代表了曲线中的 1.0 所对应的数值,开启基准初始随机后,每个粒子的基准值会随机取范围中的数值。
随机模式分为不随机、二值随机、0-1 随机三种。
不随机表示粒子的大小/透明度完全遵循曲线规律;
二值随机表示粒子每一时刻的大小/透明度可能是曲线对应值也可能是基准值;
0-1 随机表示与曲线无关,为 [0, 基准值] 的随机值。
曲线编辑界面也相同,都是单条曲线:



曲线坐标系为归一化坐标系,横轴为时间轴,纵轴为数值轴,粒子在某时刻的大小/透明度为基准值 × 该时间点的纵轴数值,同时需要结合随机模式来确定最终实际的值。
说明:
曲线修改后需要刷新预览界面。
示例效果:




粒子配置案例参考

实现张嘴喷火效果

1. 使用 3D 模板,创建“3D 人头”对象,并创建一个粒子对象作为其子节点。
2. 使用以下火焰贴图作为粒子贴图:



同时调整以下粒子组件参数:
勾选 Transform 只改变发射点、开启粒子发射判断两个参数。
速度随机区间为 0.5~0.6。
最大粒子数调整为 300。
方向随机 X 为 -0.1~0.1 ,Y 为 0~0,Z 为 1~1。
初始大小随机为0.03~0.04,结束大小随机为 0.05~0.06。
混合模式和雪碧图配置参考下图:



3. 调整粒子对象的“3D 位置与变换”,使得该对象在人头的嘴部。



4. 进一步地,可以创建一个流程控制对象,配置成张嘴时出现粒子效果,闭嘴时粒子效果消失。具体配置方法请参考“通用能力/流程管理”。
5. 刷新预览界面,效果如下:





帮助和支持

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

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

文档反馈