WebUI ↔ Android Native Bridge

JsBridge API

WebUI 与 Android 原生层交互的桥梁。
涵盖游戏、建筑、地图、资源、容器与音乐页面的 — 个接口,另含 1 个页面回调,重载分项展示。

—
API 接口
—
功能分类
3
调用环境

接口概述

已同步 2026-10-16 接口文档,仅收录当前开放的桥接接口和页面回调。主页面、子容器与音乐页面的调用范围见各条目。

调用方式

主页面与普通子容器通过 JsBridge.methodName(params...) 调用主功能。SubJsBridge 只在子容器中注入,用于管理当前容器自身。

权限体系

部分接口需要 kong.json 配置 hook 为 True。

调用与完成状态

无返回值的接口通常异步执行,调用结束不代表功能已成功开启。状态接口返回 JSON 字符串,使用 JSON.parse(...) 读取。

音乐页面独立桥接

内置音乐 WebView 有独立的同名 JsBridge,仅提供音乐分类接口,不可与主桥接混用。信息、歌词、进度和播放状态接口用于同步显示,并非播放控制命令。

接口列表

点击展开查看详细参数、返回值和代码示例。

API 索引表

所有接口的快速参考索引,点击方法名可跳转到详细说明。

方法功能分类权限

注意事项

使用 JsBridge 接口前请务必了解以下要点。

权限检查

部分功能需要 DevConfig.Hook = "True",部分需要特定设备 ID 权限。无权限时会显示 Toast 提示,不会崩溃。

线程安全

UI 操作自动在主线程执行;耗时操作(文件清理、脚本下载等)在子线程执行,不阻塞 UI。

容器限制

容器名必须唯一,同名容器会覆盖旧容器。建议控制容器数量不超过 10 个。

内存管理

关闭容器会释放 WebView 资源,隐藏容器会暂停 WebView。长时间不用的容器建议关闭而非隐藏。

触摸交互

长按 500ms 触发拖动(有震动反馈),短按正常响应 WebView 交互,移动超过 10px 取消长按。

容器事件

通过页面回调 window.onSubContainerEvent 监听 containerCreated / containerClosed / containerHidden / containerShown 事件。此回调不是 JsBridge 方法。