WebBridge
查看 Markdown让网页 JavaScript 直接调用 XBase 公共 API，用前端框架替代 ImGui 写界面。
按关键词检索文档标题与正文
让网页 JavaScript 直接调用 XBase 公共 API，用前端框架替代 ImGui 写界面。
include/XBase/WebBridge.h · XBase::WebBridge
网页通过
window.xbase调用 XBase 的玩家、载具、世界、传送、武器接口；能力不足的方法会被拒绝，网页可以据此隐藏入口。
适合用前端框架写界面，把 ImGui 面板换成 HTML 与组件库，逻辑仍由 XBase 执行。
不属于本模块的内容：
WebView 承载XBase::WebBridge::Install(); // 注册消息通道并注入客户端脚本
XBase::WebBridge::Shutdown(); // 卸载时调用Install() 内部只做两件事：给 WebView::SetMessageHandler 挂上分发器，以及注入客户端脚本。网页若在安装前已经加载，重新导航一次即可获得 window.xbase。
注入的脚本提供三个成员：
window.xbase.call(method, params); // 返回 Promise，resolve 方法结果
window.xbase.on(event, callback); // 订阅原生事件
window.xbase.capabilities();
window.xbase.postMessage(payload); // 原始投递，封装缺失时的兜底通道 // 等价于 call('bridge.capabilities')调用示例：
const snapshot = await window.xbase.call('player.snapshot');
document.querySelector('#health').textContent = snapshot.health.toFixed(0);
await window.xbase.call('vehicle.spawn', { model: 411, asDriver: true });
await window.xbase.call('world.setTime', { hour: 12, minute: 0 });失败会 reject，错误文本包含原因：
try {
await window.xbase.call('vehicle.doors', { index: 0 });
} catch (error) {
// VC / III 上 VehicleDoors 不支持，这里会拿到 unsupported on this game
console.warn(error.message);
}请求与响应都是 JSON，响应带回同一个 id。
{ "id": 1, "method": "player.snapshot", "params": {} }
{ "id": 1, "ok": true, "result": { "health": 100, "money": 500 } }
{ "id": 2, "ok": false, "error": "unsupported on this game: vehicle.doors" }原生推事件用 Emit()，网页用 on() 接收：
XBase::Json::Value payload;
payload.Set("text", XBase::Json::Value("done"));
XBase::WebBridge::Emit("notice", payload);bridge.capabilities 返回每个方法在当前游戏上的状态，supported 与 partial 可以放行，unsupported 应隐藏入口。
| 方法 | 能力 | 参数 |
|---|---|---|
bridge.capabilities | 始终可用 | 无 |
player.snapshot | PlayerBasicState | 无 |
player.heal | PlayerBasicState | 无 |
player.armour | PlayerBasicState | 无 |
player.money | PlayerBasicState | amount |
player.wanted | PlayerBasicState | level |
player.kill | PlayerBasicState | 无 |
player.moveRelative | PlayerMovement | forward right up |
vehicle.snapshot | VehicleBasic | 无 |
vehicle.spawn | VehicleSpawn | model asDriver aircraftInAir cleanupPrevious |
vehicle.repair | VehicleBasic | 无 |
vehicle.unflip | VehicleBasic | 无 |
vehicle.colors | VehicleColors | primary secondary |
vehicle.doors | VehicleDoors | index |
world.getTime | WorldTime | 无 |
world.setTime | WorldTime | hour minute |
world.weather | WorldWeather | id lock |
world.gameSpeed | WorldGameSpeed | value |
world.gravity | WorldGravity | value |
world.freezeTime | WorldFreezeTime | enable |
teleport.to | TeleportBasic | x y z interior |
teleport.forward | TeleportBasic | distance |
teleport.marker | TeleportBasic | underwater |
weapon.give | WeaponGive | type ammo |
weapon.giveAll | WeaponGive | 无 |
weapon.infiniteAmmo | WeaponRuntimeEffects | enable |
ped.noFire | BulletAssistFireSuppression | enable |
ped.noFireOptions | BulletAssistFireSuppression | enable civilians gangs cops mission |
vehicle.trafficDensity | VehicleTrafficDensity | value（省略时回读当前密度） |
vehicle.autoDrive | VehicleAutoDrive | enable speed |
world.environment | WorldWeatherEffects | rain fog clouds wind sandstorm extraSunny wetRoads |
visual.filter | VisualFilter | id strength（省略 id 时回读当前编号） |
scene.mission | SceneMission | id fail status |
ui.notice | 始终可用 | text |
ui.notice 走 Host::QueueMessage 延迟到脚本事件外，其余方法在调用点立即生效bridge.capabilities 返回为准，未实现的方法一律返回 unknown methodwindow.xbase 未定义：确认宿主调用了 Install()，并在安装后重新导航chrome.webview 可用unsupported on this game：该方法在当前游戏不支持，按 bridge.capabilities 隐藏入口unknown method：方法名拼写或版本不一致bridge.capabilities 除逐方法支持级别外还带上当前机型，网页据此裁剪选项：
{
"protocol": 1,
"game": "vc",
"gameName": "GTA Vice City",
"methods": { "player.snapshot": "supported", "vehicle.doors": "unsupported" }
}game 取 sa / vc / iii，用于按机型挑选武器、动画等数据宿主可以注册自己的方法，名称冲突时宿主优先：
XBase::WebBridge::RegisterMethod("menu.hide", [](const XBase::Json::Value&) {
// 收起菜单
return XBase::Json::Value();
});
XBase::WebBridge::UnregisterMethod("menu.hide");
XBase::WebBridge::Emit("i18n.changed", payload); // 主动推送事件data.peds）暴露，不要把列表塞进通用接口
评论