WebUI 与 Android 原生层交互的桥梁。
涵盖游戏、建筑、地图、资源、容器与音乐页面的 — 个接口,另含 1 个页面回调,重载分项展示。
已同步 2026-10-16 接口文档,仅收录当前开放的桥接接口和页面回调。主页面、子容器与音乐页面的调用范围见各条目。
主页面与普通子容器通过 JsBridge.methodName(params...) 调用主功能。SubJsBridge 只在子容器中注入,用于管理当前容器自身。
部分接口需要 kong.json 配置 hook 为 True。
无返回值的接口通常异步执行,调用结束不代表功能已成功开启。状态接口返回 JSON 字符串,使用 JSON.parse(...) 读取。
内置音乐 WebView 有独立的同名 JsBridge,仅提供音乐分类接口,不可与主桥接混用。信息、歌词、进度和播放状态接口用于同步显示,并非播放控制命令。
点击展开查看详细参数、返回值和代码示例。
所有接口的快速参考索引,点击方法名可跳转到详细说明。
| 方法 | 功能 | 分类 | 权限 |
|---|
使用 JsBridge 接口前请务必了解以下要点。
部分功能需要 DevConfig.Hook = "True",部分需要特定设备 ID 权限。无权限时会显示 Toast 提示,不会崩溃。
UI 操作自动在主线程执行;耗时操作(文件清理、脚本下载等)在子线程执行,不阻塞 UI。
容器名必须唯一,同名容器会覆盖旧容器。建议控制容器数量不超过 10 个。
关闭容器会释放 WebView 资源,隐藏容器会暂停 WebView。长时间不用的容器建议关闭而非隐藏。
长按 500ms 触发拖动(有震动反馈),短按正常响应 WebView 交互,移动超过 10px 取消长按。
通过页面回调 window.onSubContainerEvent 监听 containerCreated / containerClosed / containerHidden / containerShown 事件。此回调不是 JsBridge 方法。