【后端接口】playsound 与 playeffect：服务端驱动的表现接口

实战应用：用在哪里

表现不一定由客户端驱动：playsound 与 playeffect 让服务端直接下发音效与特效的播放指令。BOSS 登场的全屏震动、任务的剧情音效、机关触发的机关音，服务端知道时机，表现跟着时机走。

音效接口

---播放音效 actor:目标 index:音效ID times:次数 flag:标志
function playsound(actor, index, times, flag) end

-- BOSS 登场：全场玩家听龙吟
function bossSpawnAnnounce(bossName, actors)
    for _, actor in ipairs(actors) do
        playsound(actor, 8100, 1, 0)
        sendcentermsg(actor, 249, 0, bossName .. " 已降临！", 0, 6, "")
    end
end

音效按 ID 引用声音表，times 支持循环播放，服务端枚举目标逐个下发。服务端驱动的优势是时机权威：BOSS 刷新的瞬间全员听到龙吟，不依赖客户端各自判断时机。声音的分层设计：环境音由客户端管、事件音由服务端推，两层的分工避免声音的混乱。

特效接口

---播放特效 actor:目标 effectid:特效ID offsetX/Y:偏移 times:次数
function playeffect(actor, effectid, offsetX, offsetY, times, behind, selfshow) end

-- 任务完成：头顶金光特效
playeffect(actor, 3201, 0, 0, 1, 0, 1)

特效接口带偏移参数，特效可以挂在目标身上也可以偏移到目标周围。behind 参数控制特效的渲染层级，身后的光环类特效置后避免遮挡角色。表现接口的调用频率控制：特效与音效的下发是网络包，高频战斗里每个命中都下发特效会让带宽爆炸，表现的下发聚合在批量场景里做合并。

验证与监控

表现接口的下发流量统计，音效与特效的网络占比超过总流量的一成即触发优化。

踩坑记录

音效 ID 引用的声音表资源被删后，服务端下发照常客户端静默，表现资源的引用完整性校验与代码资源同步管理。特效的下发曾经没做距离过滤，视野外的玩家也收到指令，AOI 过滤的下发策略让流量降了一半。

上线要点

服务端表现接口与客户端本地表现的分工要写进开发规范：时机敏感、全服一致的走服务端，氛围性、个性化的走客户端。音效与特效的 ID 分配表由表现侧统一管理，服务端脚本引用时按表取号。表现的聚合下发在团战的批量场景（百人同屏技能）是带宽的生命线。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。