01客户端导出
| 导出 | 说明 |
|---|---|
OpenApp(tab) | 在你指定的页面打开应用：'feed'、'create'、'mine'、'drafts' 或 'settings'。未指定页面时，会打开上次使用的页面，或实时动态。 |
OpenFeed() | 在实时动态页面打开应用。 |
CloseApp() | 关闭应用。 |
IsOpen() | 此客户端上的应用处于打开状态时为 True。 |
02服务端导出
| 导出 | 说明 |
|---|---|
PostAd(text, opts) | 发布一条服务器自己的广告：免费、无需审核，并排在队列首位。opts：author、category、instant（立即发布）、reps、interval、duration 和 boosted。返回广告 id，或 nil 和错误代码。 |
GetFeed(limit) | 应用中显示的实时动态，按时间从新到旧排列：id、text、category、boosted、author（匿名广告时为 nil）、sentAt、created、sent 和 live。 |
GetAd(id) | 一条与动态格式相同的广告，或 nil。 |
IsAdmin(source) | 当玩家通过 ACE、组或标识符成为 Lifeinvader 管理员时为 True。 |
03事件
| 名称 | 端 | 说明 |
|---|---|---|
agency-lifeinvader:adShown | 客户端 | 每当广告显示在屏幕上时，在每个客户端触发的本地事件，包含 id、text、category、catLabel、icon、author（匿名时为 nil）、boosted、duration 和 system（官方公告时为 true）。 |
agency-lifeinvader:adBroadcast | 服务端 | 每次广告发布时在服务器上触发的本地事件，包含一条格式与动态相同的广告。适用于日志记录或 Discord webhook。 |
agency_lifeinvader:openMenu | 客户端 | 从 V3 保留：在“新建广告”页面打开应用，因此使用旧菜单的脚本仍可正常工作。 |
agency_lifeinvader:openRecentMenu | 客户端 | 从 V3 保留：在实时动态页面打开应用。 |
+值得了解
其他脚本可以通过 Agency-LifeinvaderV3 的 exports 和 events 发布广告、读取动态、打开应用并对任何广告做出回应。
- 从你的脚本发布内容
- PostAd 会在每个屏幕上发布服务器自己的广告：免费、无需审核、排在队列首位，并使用独立的作者和分类。
- 读取动态
- GetFeed 和 GetAd 会以实时动态的形式返回广告，可用于网站、报纸或手机应用。
- 响应广告
- 广告显示时，每个客户端都会触发 agency-lifeinvader:adShown；每次播放广告时，服务器都会触发 agency-lifeinvader:adBroadcast。用于打开菜单的 V3 事件仍然可用。
?常见问题
PostAd 需要付费或审核吗？
不需要。服务器的广告免费、无需审核，并且会优先进入队列。设置 instant = true 后，广告会立即播放。