游戏平台(小游戏)
游戏平台(games)分发网页小游戏(HTML + JS),用户在线游玩并提交分数到排行榜。游戏由代码资产 + 元数据 + 排行榜组成。
游戏元数据
| 字段 | 说明 | ||
|---|---|---|---|
code | 唯一标识(如 game-2048) | ||
name / description | 8 语言 | ||
cover_url | 封面图 | ||
entry_html / src_url | 游戏入口(内嵌 HTML 或外部 iframe) | ||
category | 分类(益智/动作/休闲…) | ||
play_limit | 免费游玩次数 |
公开端点
GET /games/v1/games # 游戏列表(公开)
GET /games/v1/games/{code} # 详情
GET /games/v1/games/{code}/leaderboard # 排行榜(公开)
排行榜设计
- 匿名玩家按浏览器指纹归一到同一条"匿名分数"记录(同指纹刷新最大值,不同指纹新增);
- 登录用户显示昵称;
- 游戏结束提交分数,进入前 10 触发"破纪录"特效;
- 结束必须消耗可玩次数,防止一直白嫖。
开发建议
- 游戏代码自包含(单 HTML 或纯 JS),无外部依赖;
- 移动端适配:iframe 高度要匹配游戏画布(如 2048 需额外 20px 显示分数栏);
- 提交分数接口带防刷(服务端校验分数合理性、频控);
- 每款游戏配一张 AI 生成的封面图。
游戏与插件的关系
游戏本质是"内容型插件":游戏市场 = 插件的展示形态 + 排行榜玩法。同一份代码资产可以既挂插件市场又挂游戏市场。