猹件开发组

Appearance

On this page

猹引擎 ​

GUI - 页面打开与关闭 ​

这页解决什么问题 ​

让页面“能打开、能关闭、能跳转下一页”。

不写代码也能做 ​

  1. 先在 plugins/ChaEngine/ui/*.yml 定义页面。
  2. 记住页面 ID，后续动作都用这个 ID。
  3. 先测打开，再测关闭，最后测跳转。

页面配置模板（可直接复制） ​

yml
活动主界面:
  # 页面文件路径，写资源包内相对路径
  html: "pages/activity/center.html"
  # true 表示居中显示
  center: true
  # 页面偏移
  x: 0
  y: 0
  # 朝向，auto 表示自动面向玩家
  yaw: "auto"
  # 宽高
  width: 1280
  height: 720

活动结算界面:
  html: "pages/activity/result.html"
  center: true
  x: 0
  y: 0
  yaw: "auto"
  width: 960
  height: 540

字段说明 ​

字段必填说明
页面 ID是页面唯一名称，后续动作用它
html是页面文件路径
center是是否居中
x y是页面偏移
yaw否页面朝向
width height是页面尺寸

技术模板（可选） ​

js
// 打开活动页
async function openActivityPage() {
  await ChaEngine.openUi('活动主界面');
}

// 关闭活动页
async function closeActivityPage() {
  await ChaEngine.sendToServer('ui.action', {
    action: 'close_page',
    pageId: '活动主界面'
  });
}

// 打开结算页
async function openResultPage() {
  await ChaEngine.openUi('活动结算界面');
}

常见问题 ​

点了没反应 ​

  1. 检查页面 ID 是否写错。
  2. 检查 HTML 文件是否真的存在。
  3. 检查是否已经重载到最新配置。

打开的是旧页面 ​

  1. 检查是否有同名页面 ID。
  2. 检查资源包是否替换到最新版本。