Skip to content

边缘花园 ​

本模块中的examples组件仅用于仓库本地开发功能验证,不随应用打包或导出。 examples/edge-garden是原创边缘放置游戏。布局支持紧凑、展开和纵向,用户通过可信编辑调整位置,尺寸切换保持用户保存的位置并约束在工作区;详情滚动显示背包、技能、存档和恢复摘要。几何与编辑规则见运行模块。

成长与呈现 ​

每十秒巡逻产生金币、经验和种子;每30累计经验升一级,种子可兑换金币,阳光技能最多20级并提高收益。资源上限1e12,完整数值通过详情和可访问名称呈现;经验到顶明确显示上限,巡逻与本级经验使用进度条。强制色使用系统颜色、轮廓及文字,不仅依赖配色。

游戏暂停属于存档,隐藏不暂停。实例按成功快照推算,所有同安装实例均可提交;修订冲突停止推进并提示重新读取。装饰按显隐、锁屏/挂起、节能和减少动画控制;锁屏与挂起独立解除。试听由用户点击触发,取消/离开释放音频节点,规则见音频。

存档与恢复 ​

使用hero槽,正文结构由组件自行校验,重要操作立即提交,每十五秒检查点。初次读取或提交失败停止推进,保留最后成功快照并提供重读;不以默认值覆盖损坏或冲突。正常退出停止新操作和定时器,等待已有操作,再在共同期限内提交最后快照;停用、更新或强制结束只承诺已成功发布的进度。

时间差负值为零,单次最多八小时,按总时长常数计算。暂停期间无收益;恢复暂停先推进结算时间。读取后先结算并提交,再允许操作,避免重载重复发奖。成功恢复已有存档时显示本次有效时长、资源差额及上限/时钟回拨说明;摘要只属页面,不另记奖励,也不参与布局回退。

失败时折叠头栏提示展开重试,已有快照显示未更新,重读在途禁用重复操作。空档构造初始游戏并通过修订检查提交。found=true的无效值不能当空档,候选先校验后一起替换画面、修订和保存时间。

安装共享存档与生命周期 ​

同安装所有实例自动共享存档,不区分宿主角色,作者负责业务冲突处理。花园声明allowMultipleInstances=false,跨显示器同安装最多一个启用实例;共享存档接口本身不限制其他作者的多写设计。保存成功后发布修订提示,不把消息当作成功存档。

pagehide取消调用,解除宿主、DOM和正常关闭监听,禁用并清除进度及页签按钮;旧回调不得改旧页面或续写导出,已取得资源仍关闭。正常关闭机会与pagehide分开,允许等待最后成功修订。

可信存档管理独立于游戏:停用安装视图后从组件页管理窗口导出或清除,重新启用读取现有数据或由组件初始化空存档,不通过布局或包回退改变进度。完整语义见存档及协作消息。

验证边界 ​

DOM驱动可验证生产恢复路径,但不是UIA或物理输入;受控回复不是原生多屏。当前支持及设备/系统限制见实现说明(宿主文档:../implementation.md),验证入口见必要测试(宿主文档:../testing.md)。

当前宿主协议 · SDK 0.1.1 · MIT