用 TikXander 集成你的游戏

什么是本地游戏集成？

本地集成意味着你的游戏或小部件是普通网页（浏览器、OBS Browser Source 或桌面 WebView），并连接到主播机器上的 WebSocket。本地代理是桥梁：处理 TikTok Live 连接（含 browser-mode），并把规范化事件分发给主播已授权的应用。

事件保留在 localhost（127.0.0.1）。直播期间接收礼物无需公网后端——适合 OBS 叠加层、定制小游戏和开发原型。

适合谁？

• 希望用 TikTok Live 礼物与聊天驱动玩法的游戏/小部件开发者。
• 构建可实时响应 gift、like、follow、chat 的 OBS 叠加层工作室。
• 在正式上线前原型化自定义互动形态的创作者与团队。
• 更倾向主播电脑上低延迟本地事件通道、而非仅依赖云中继的开发者。

工作原理

1）主播安装并登录 TikXander 本地代理，开始捕获直播（代理上的 browser-mode 为推荐路径）。

2）你的应用连接 8767 端口的本地事件通道。同一 localhost 服务器上有两个公开面：版本化开发者通道 ws://127.0.0.1:8767/events/v1（app id／权限），以及面向本机轻量消费端的本地 DAPI ws://127.0.0.1:8767/dapi。

3）观众送礼、点赞、聊天或关注时，代理发出规范化事件帧。你的游戏可映射为生成敌人、进度条、警报或分数。

4）同一主机还提供 long-poll（/events/v1/poll）、simulate（POST /events/v1/simulate）与 status（GET /events/v1/status），便于在没有完整直播时开发。

本地端点（主播电脑）

• 开发者 WebSocket API：ws://127.0.0.1:8767/events/v1 — 按应用划分的版本化事件。
• 本地 DAPI WebSocket：ws://127.0.0.1:8767/dapi — 本机事件流。
• HTTP 辅助（同端口）：/events/v1/poll、/events/v1/simulate、/events/v1/status。
• 仅绑定 localhost（127.0.0.1:8767）：该通道不会离开主播电脑。

可响应的事件类型

• gift — 观众礼物及身份与元数据（扇出前已解析连击）。
• like — 直播点赞（适合软进度与加速）。
• chat — 关键词游戏、投票与喊麦评论。
• follow / join — 增长时刻，用于欢迎与计数。
• live_status — 会话开始/结束，便于 UI 干净进入空闲。

如何开始

1. 1. 创建 TikXander 账户

   在 games.tikxander.com 注册——与主播管理游戏、套餐与直播工具的同一控制台。

2. 2. 安装本地代理

   阅读本地代理产品页，了解叠加层、小部件以及在 localhost 暴露事件端口的桌面代理。

3. 3. 将游戏连接到 localhost

   打开到 ws://127.0.0.1:8767/events/v1（需要时带 app id）或 ws://127.0.0.1:8767/dapi 的 WebSocket，解析 gift/like/chat/follow 并映射到游戏逻辑。

4. 4. 无需完整直播即可测试

   在同一主机使用 POST /events/v1/simulate 与 GET /events/v1/status 注入测试礼物并验证处理程序。

5. 5. 按主播工作流上线

   准备就绪后，主播可在控制台将你的体验与 TikXander 目录、小部件与会话工具组合使用。

开发者为何选择 TikXander

你在 OBS 旁获得实时事件管道、清晰的事件类型（gift、like、chat、follow）、开发用模拟，以及主播已用于互动 TikTok Live 的产品面。账户与套餐在 games.tikxander.com；本地代理介绍在本站（例如 /zh/local-agent）。

常见问题