小游戏管理
最后更新时间：2025-10-28 10:35:25
小游戏是小程序的一个特别类目，和所有小程序一样，小游戏无需下载、安装与卸载，即点即玩。
在 2.2.0 版本后，Exclusive 和 Enterprise 套餐支持小游戏功能，您可以使用开发者工具开发小游戏，并通过控制台来管理和发布小游戏。
前提条件
小游戏功能目前通过白名单方式开通，如需使用小游戏功能，请先联系产品团队沟通需求后开通能力。
小游戏开发指南
小游戏控制台操作
创建小游戏
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 | 小程序运营人员 | 小程序发布审核人员 |
小游戏列表 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
创建、修改、下架、删除小游戏 | 只读 | 只读 | ✓ | ✓ | - | - | - |
超级管理员/平台管理员：拥有小游戏列表模块的只读权限，不能创建、修改、下架、删除小游戏。
小程序团队管理员/小程序高级开发者：拥有小游戏列表模块的权限，拥有创建、修改、下架、删除小游戏的权限。
小程序开发者/小程序运营人员/小程序发布审核人员：拥有小游戏列表模块的查看权限。
具体功能操作
1. 在小游戏管理-小游戏列表处，点击创建小游戏。
2. 填写小游戏信息，包含以下内容：
小游戏名称：必填。支持中文、大小写英文字母、数字、空格和部分特殊符号（"+"、"="、","、"."、"@"、"-"、"_"），3-64个字符。
小游戏分类：必填。选择一个适合该小游戏的分类。
小游戏简介：必填。填写小游戏的简介，可以是游戏玩法、特性等信息。
小游戏 logo：选填。上传一张小游戏的 logo，支持 jpg、png 格式的方形图片，大小在2M 以内，若不上传 logo，则使用系统默认 logo。
点击下一步，此时小游戏已创建成功。如果您是首次创建小游戏，您可以根据第二步的指引，下载并安装开发者工具。
开发管理
开发管理包含为域名设置、敏感 API 权限申请、实时日志查询等功能。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 |
域名设置 | 只读 | 只读 | ✓ | ✓ | - |
接口权限（敏感API）申请 | 只读 | 只读 | ✓ | ✓ | - |
实时日志 | 只读 | 只读 | ✓ | ✓ | ✓ |
密钥管理 | 只读 | 只读 | ✓ | - | - |
超级管理员/平台管理员：拥有开发管理模块的只读权限。
小程序团队管理员：拥有开发管理模块的权限，拥有域名设置、接口权限（敏感API）申请、查看实时日志、密钥管理的权限。
小程序团队高级开发者：拥有开发管理模块的权限，拥有域名设置、接口权限（敏感API）申请、查看实时日志的权限。
小程序开发者：拥有开发管理模块的权限，拥有查看实时日志的权限。
域名管理
为了保障 superapp 和 superapp 用户的安全性，原则上小游戏需要事先设置后台通讯域名，且只可以跟指定的域名进行网络通信。
点击新增域名，填写域名信息。包括普通 HTTPS 请求（wx.request）、上传文件（wx.uploadFile）、下载文件 (wx.downloadFile) 和 WebSocket 通信（wx.connectSocket），为便于开发者灵活配置小游戏，产品也支持内嵌网页能力（业务域名）。
如果小游戏业务复杂难以将域名配置齐全（例如小游戏接入广告功能时广告请求域名通常会动态变化），小游戏可以向 superapp 申请跳过域名校验，待 superapp 审批通过后，无需再设置域名。点击“跳过域名校验”后，填写申请原因，阅读安全协议并确认协议内容后提交申请。
接口权限
当小游戏绑定的 superapp 设置了敏感 API 后，小游戏开发者需要向 superapp 申请调用敏感 API 的权限，在 superapp 的管理者或审核权限拥有者审批通过后，小游戏才可以正常调用这些敏感 API。
操作：
申请开通：开发者向 superapp 申请敏感 API 使用权限。
实时日志
查询条件：查询条件包括时间、日志等级维度（全部、Info 及以上、Warn 及以上、Error 及以上）、系统类型、GUID、页面链接、filterMsg 内容、基础库版本、客户端版本。
基础配置
AppSecret
AppSecret（小游戏密钥）是小游戏登录过程中鉴权所需，密钥管理仅小游戏团队管理员有权限查看和操作，可在密钥管理处生成、重置、冻结密钥。
操作：
生成
点击“生成”后，小游戏团队管理员需要将密钥复制后妥善保存，复制后关闭弹窗则无法再次复制，如果忘记密钥，需要进行重置，平台不会以明文的方式展示或保存密钥。
重置
小游戏团队管理员可重置密钥，确认重置 AppSecret 后，使用原 AppSecret 的小游戏功能将无法使用，请及时更新。
冻结
为了保障小游戏的业务安全，在小游戏密钥泄露或疑似泄露且密钥还未替换前，开发者有必要对小游戏密钥进行冻结操作，避免造成安全事故。
小游戏团队管理员可点击“冻结”，将密钥进行冻结，冻结后，使用原 AppSecret 的小游戏功能将无法正常使用，请及时更新。
OpenServer
OpenServer 是开发者在接入登录、支付和订阅消息等功能时需要访问公共服务域名。
版本管理
小游戏版本管理给开发者提供了小游戏的生命周期管理功能。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 | 小程序运营人员 | 小程序发布审核人员 |
提交小程序代码/代码包 | 只读 | 只读 | ✓ | ✓ | ✓ | - | - |
提交版本审核 | 只读 | 只读 | ✓ | ✓ | - | - | ✓ |
小程序体验 | 只读 | 只读 | ✓ | ✓ | ✓ | ✓ | ✓ |
灰度发布 | 只读 | 只读 | ✓ | ✓ | - | - | - |
小程序发布 | 只读 | 只读 | ✓ | ✓ | - | - | ✓ |
删除开发版本 | - | - | ✓ | ✓ | ✓ | - | - |
超级管理员/平台管理员：拥有版本管理模块的只读权限，不能删除开发版本。
小程序团队管理员/小程序高级开发者：拥有版本管理模块的权限，拥有提交小游戏代码/代码包、提交版本审核、小游戏体验、灰度发布、小游戏发布、删除开发版本的权限。
小程序开发者：拥有版本管理模块的权限，拥有提交小游戏代码/代码包、小游戏体验、删除开发版本的权限。
小程序运营人员：拥有版本管理模块的权限，拥有小游戏体验的权限。
小程序发布审核人员：拥有版本管理模块的权限，拥有提交版本审核、小游戏体验、小游戏发布的权限。
版本定义
开发版本
开发者通过开发者工具提交小游戏版本后，会在版本管理-开发版本处生成“开发版本”，点击右侧提交审核，可将小游戏提交到 superapp 处进行发布前的审核。
审核版本
当有版本处于审核中时，则会在“版本审核进度”处展示，审核通过后，点击发布即可将该版本发布上线。
线上版本
展示小游戏已经发布在 superapp 上的最新版本，点击右侧下载二维码，可将小游戏二维码下载到本地，可用 superapp 扫描二维码打开小游戏。
注意事项
1. 同一个开发者可以提交多个开发版本。
2. 不同开发者提交的开发版本，即使版本号一致，在版本管理-开发版本下，会存在 2 个版本号一样的开发版本。
3. 提交审核时，提审的版本号必须大于线上版本号/不能使用历史发布过的版本号。
4. 版本发布后，对应的版本号会从开发版本中移除。
其他功能和操作
小游戏离线包
通过小游戏离线包，可将小游戏内置在 superapp 内，将小游戏包从控制台下载下来，导入到 superapp 工程中，跟随 superapp 一起打包。在 superapp 使用过程中，用户打开某个内置的小游戏，无需从后端拉取下载，即使在没有网络连接的情况下也能打开并运行。
操作步骤
1. 下载小游戏离线包。
2. 将下载的小游戏包拷贝到自定义的 assets 目录，离线小游戏需严格遵守命名规则，不能随意修改。
说明：
离线小游戏命名规则：{miniAppId}_{miniAppVersion}.apkg
3. 在 SDK 初始化配置中指定上一步放置离线小游戏的 asset 目录。
注意事项
离线小游戏也需要走正常的发布流程，只有上线状态的小游戏才可下载离线包。
离线小游戏适用新版发布、版本回退、下架等版本管理逻辑，当线上版本与预置版本不一致时，客户端会正常拉取线上版本。
当小游戏被下架后，预置在 superapp 中的对应离线小游戏也无法正常使用。
小游戏版本回退
可将小游戏线上版本回滚至此前已经发布过的历史版本，不支持连续回滚。
小游戏下架
已上架的小游戏，在“小游戏列表”后，点击下架即可将小游戏从 superapp 上下架，下架后该小游戏无法被搜索，缓存的小游戏无法打开。
订阅消息
前言
消息能力是小游戏能力中的重要组成，superapp 通过为小游戏开发者提供订阅消息能力，以便实现小游戏内的服务闭环，通过消息订阅和通知的能力，及时将小游戏内的业务状态变化推送给 superapp 的用户。在使用订阅消息功能时，小游戏开发者需要在控制台-小游戏管理-订阅消息，从公共模板库中选择适用的消息模板，配置推送的字段后，添加为“我的模板”。
角色和权限
功能 | 角色 | 超级管理员 | 平台管理员 | 小程序团队管理员 | 小程序高级开发者 | 小程序开发者 |
我的模块-查看 | 只读 | 只读 | ✓ | ✓ | ✓ |
我的模块-删除 | - | - | ✓ | ✓ | - |
公共模板库-查看 | 只读 | 只读 | ✓ | ✓ | ✓ |
公共模板库-选用 | - | - | ✓ | ✓ | - |
超级管理员/平台管理员/小程序开发者：拥有订阅消息模块的只读权限，拥有我的模块、公共模板库的查看权限。
小程序团队管理员/小程序高级开发者：拥有订阅消息模块的权限，拥有我的模块的查看、删除权限，公共模板库的查看、选用权限。
小程序开发者：拥有订阅消息模块的权限，拥有我的模块、公共模板库的查看权限。
功能操作
公共模板库
开发者可在公共模板库中，根据业务场景选择需要用到的模板类型，通过模板名称搜索适用的模板。
消息类型说明
一次性订阅
一次性订阅消息用于解决用户使用小游戏后，后续服务环节的通知问题。
开发者在小游戏中调用 requestSubscribeMessage 接口后，将向用户展示弹窗，用户可打开自己想要接受的消息开关。用户订阅后，开发者可不限时间地下发一条对应的服务消息。
注意：
小游戏暂不支持长期订阅类型。
选用模板
在公共模板库中，找到目标模板，单击选择，进入模板配置页面。每个公共模板下会有多个关键词，开发者可从关键词列表中选择 1 到 5 个关键词，最终在 superapp 上给用户展示的弹窗内容请参考左侧预览效果，在已选择列表中拖拽右侧的排序按钮可进行关键词顺序排列。
配置完成后，单击提交，即可将模板配置保存至“我的模板”中。
说明：
使用同一个公共模板添加为“我的模板”时，关键词不可与已添加的“个人模板”重复。
我的模板
从公共模板库中选择并完成配置的模板会添加到“我的模板”列表中，开发者可使用“我的模板”中的消息模板来完成订阅消息功能开发。
开发注意事项
一次性模板 ID 和长期订阅模板 id 不可同时使用。
一次调用最多可订阅 3 条消息。
用户发生点击行为后，才可以调起订阅消息界面。
一次授权调用里，每个 tmplId 对应的模板标题不能存在相同的，若出现相同的，只保留一个。
隐私协议
在设置中配置用户隐私保护协议，使用产品提供的模板，填写小游戏收集的个人隐私数据，保存后，可生成小游戏的用户隐私保护协议。
1. 点击开始配置。
2. 填写隐私信息。
保存后，用户隐私保护协议可在更多-小游戏详情中，查看已生成的协议内容。
文档反馈