15 抖音接口与游戏内互动命令
本章说明两类入口：
- 外部平台请求商城接口，例如抖音直播礼物触发。
- 玩家在游戏聊天里发送互动命令，例如
@签到、@购买、@领取、@发红包。
示例视频预留
这里后续可放“抖音礼物触发和游戏内命令”的视频，例如：/mp4/newwebdoc/15-tiktok-chat-commands.mp4
一、抖音接口入口
后台入口：
后台 -> 抖音插件公开接口地址格式：
http://你的域名/tiktok?key=对接码完整示例：
http://6616.scum8.com/tiktok?key=L8l9t2Q9j9f9P8f5&mingling=1&shuliang=5&steamid=76561199174639885部分内部接口也可能支持 /api/tiktok，但给外部平台配置时优先使用公开路径 /tiktok。
参数保持：
| 参数 | 说明 |
|---|---|
| key | 抖音对接码 |
| code | 对接码别名，部分场景等同于 key |
| mingling | 命令序号 |
| shuliang | 礼物数量 |
| steamid | 主播或目标 SteamID 替换值 |
前后端管理接口可以变化，但给外部平台的 /tiktok?key=... 不应随意变化。
二、抖音命令模式
后台可配置命令文本和触发模式。
常见模式：
| 模式 | 说明 |
|---|---|
| 只随机触发一条 | 多条命令中随机取一条 |
| 全部触发 | 每条命令都触发 |
| 礼物数量次数随机触发 | 按礼物数量随机触发多次 |
命令中可使用：
【主播ID】由请求参数 steamid 替换。
如果命令里有 *，会按礼物数量拆分或替换，避免一次刷出数量超过游戏可接受范围。
注意：“礼物数量次数随机触发”是按礼物数量循环随机命令。这个模式不适合依赖 * 占位的命令，建议直接写完整命令。
抖音接口只负责把命令写入游戏语句队列。真正发出仍依赖 RCON 状态和队列速度。
三、游戏内签到
玩家发送：
@签到签到奖励由签到配置控制。
常见配置：
- 最少奖励
- 最多奖励
- 日叠数量
- 最大连签
如果已移除签到加成，管理不要再向玩家承诺会员签到加成。
四、游戏内购买商品
玩家发送：
@购买商品名*数量也可以用商品编号：
@购买51*2购买逻辑会检查：
- 玩家是否在线并能识别 SteamID。
- 商品是否存在并上架。
- 会员等级是否满足。
- 余额是否足够。
- 币种是商城币还是美金。
美金商品实际扣款通过 RCON：
#ChangeCurrencyBalance Normal -金额 SteamID本地游戏美金余额主要用于购买前限制判断，真实增减仍以 RCON 命令为准。
五、游戏内领取礼包
玩家发送：
@领取礼包名礼包类型会影响可见和可领取：
- 每日礼包：按每日次数限制。
- 普通礼包：会员等级大于等于要求即可。
- 小队礼包：小队成员相关限制。
- 私人礼包：指定玩家可见或可领取。
- 称号礼包：需要玩家拥有指定有效称号。
私人礼包有两种：
- 礼包类型配置为私人礼包。
- 礼包名开头 17 位数字是玩家 SteamID。
例如：
76561199174639885橘橘礼包只有该 SteamID 玩家应看到并领取。
六、游戏内红包
管理员可以发送：
@发红包美金*5*5000
@发红包随机美金*5*5000
@发红包猫币*5*1000其中：
- 美金：游戏美金。
- 猫币：后台配置的商城币名称，实际以你的代币名称为准。
- 第一个数字：红包个数。
- 第二个数字：总金额。
- 随机：每个玩家抢到的数量随机。
玩家发送：
@抢红包即可参与。
发红包仅限商城管理员，操作会进入商城后台管理日志。
同一时间一般只允许一个有效红包。红包有效期约 5 分钟，过期或抢完后才适合发下一个。
七、复活币
副本挑战完成后，玩家可能获得复活币。
玩家可发送：
@使用复活币用于原地复活相关玩法。
八、常见玩家问题
问：为什么 @购买 没反应？
答：可能商品名不一致、商品下架、会员等级不足、余额不足，或 RCON/聊天推送没有正常接收。
问：为什么我能看到礼包分类但礼包不显示？
答：分类可能存在，但该分类下礼包因私人、小队、称号或等级条件被过滤，这是正常的。
问：为什么红包抢不了？
答：可能当前没有进行中的红包、已经抢过、红包已抢完或已过期。
问：抖音接口返回对接码错误？
答：外部平台请求的 key 与后台生成的抖音对接码不一致。
问：抖音接口返回成功，但游戏里没出现？
答：接口成功只表示命令已入队。还要检查 RCON 是否连接、发货队列是否暂停、命令格式是否能被游戏执行。
问：玩家发送命令被禁言了？
答：聊天检测会先读取玩家发言。如果玩家命令内容命中了违禁词，可能先被禁言或拦截。管理应检查聊天检测关键词。
九、管理排障检查表
- 抖音对接码是否已生成。
- 外部平台请求地址是否是
/tiktok?key=...。 mingling是否对应存在的抖音命令。- 游戏语句表是否有触发后的命令。
- RCON 是否正常发送。
- 玩家聊天推送是否正常进入后端。
- 商品/礼包名称是否与玩家输入一致。
- 红包是否仍在有效期内。
- 商城币名称是否与玩家输入一致。
- 后台管理日志是否记录管理员发红包。
- 对接码是否泄露。泄露后应重新生成，避免外部恶意触发。
- 是否开启了禁用内置命令。该开关主要影响自定义互动命令，硬编码的签到、购买、领取、红包仍要按实际页面说明核对。