游戏接入
开发者登录后,点击右上角头像按钮,进入开发者信息页面,进行认证。审核通过或审核中的开发者,可通过游戏管理新建游戏。
创建游戏时需遵守QQ轻游戏平台游戏规范,开发者可通过管理员帐号配置游戏相关内容,可通过帐号管理添加子账号,并赋予开发权限,使用子账号对游戏进行测试和开发(不可使用主账号进行测试)。待开发者信息认证通过后,游戏符合平台提交审核条件时,可提交审核游戏。
游戏提交审核后,平台将在2个工作日内对游戏进行评审,审核通过的游戏,由开发者操作发布至线上。
1.创建游戏
1、登录QQ帐号,点击游戏管理。
2、开发者帐号若为第一次创建游戏,则点击页面的“创建游戏”按钮;若不为第一次创建游戏,则点击已有游戏名称,选择第一栏“新建游戏”按钮。
3、进入游戏基本信息登记页面,规范游戏基本信息后,点击提交。
Tips: 游戏名称仅支持中英文、数字;游戏创建后,更换游戏名称需2个工作日的审核时间。
根据游戏实际情况选择标签,有利于该游戏在游戏城的分类及精准推广。
4、游戏创建完毕。
创建游戏页面Tips: 你可以创建多个不同游戏,每个主体一天只能创建10款游戏。
2.设置项目
创建游戏后,需要对游戏进行项目设置。
Tips:其中游戏基本信息(游戏名称、游戏简介、游戏类型)和图片素材(大图素材、小图素材)为游戏申请上架的必填项目。
2.1基本设置
基本设置分为游戏基本设置、平台功能配置项、版本支持。其中,游戏基本设置为上架游戏必填项目。
关于游戏设置各字段说明:
字段名 | 是否必选 | 含义 | 默认值 | 备注 |
---|---|---|---|---|
游戏名称 | 是 | 游戏名 | 无 | 修改需审核,审核通过前不能申请上架 |
游戏简介 | 是 | 游戏的简要说明 | 无 | 每次创建版本的时候都可以更改 |
游戏类型 | 是 | 游戏归属的类型 | 无 | 主要用于后期游戏个性化推荐,每次创建版本的时候都可以更改 |
支持最大玩家数 | 是 | 游戏中支持的最大玩家数,比如游戏有2人,3人,4人玩法,此字段填写为4 | 默认为0 | 最多支持8个人 |
单局最大时长 | 是 | 单局游戏可能的最大时间长度 | 默认180s | 单局游戏时长最多900s |
是否支持陌生人匹配 | 是 | 游戏是否具有随机匹配的功能及模式 | 否 | 若选择是,则需要选择陌生人匹配人数,最多为8人 |
是否帧同步 | 是 | 请参见通信协议 | 使用 | |
帧同步时间间隔 | 是 | 两帧之间的时间间隔 | 1000ms | 最小间隔100ms,最大间隔1000ms |
最低手Q支持版本 | 是 | 最低能够支持的手Q版本 | 7.5.8 | 为了支持最新特性,建议当前外网最新的手Q版本为最低支持版本 |
2.2开发设置
开发设置分为开发者配置项、音视频配置项。
关于开发设置各字段说明:
字段名 | 是否必选 | 含义 | 默认值 | 备注 |
---|---|---|---|---|
开发者ID | 不可修改 | 一个法人(自然人)只有一个开发者ID | 注册QQ号 | 一个开发者ID名下,可以有多个游戏 |
GAME ID | 不可修改 | 游戏ID | 随机生成 | 一款游戏对应唯一一个gameID |
APP ID | 不可修改 | 由QQ互联审核,一般审核时间为1个工作日 | 随机生成 | 未审核通过前该ID为临时ID,供测试开发使用 |
appkey | 否 | 是认证为开发者后获取的应用密钥 | 无 | 登录QQ公众平台查看 |
域名白名单 | 否 | 可添加多个域名为白名单地址 | 无 | 分为有:http:// 、https:// 、wss:// |
音视频sdk_appID | 否 | 游戏接入互动直播应用 | 无 | 请在ILVB控制台 “APP基础设置”中查询 |
音视频account_type | 否 | 游戏接入互动直播应用 | 无 | 请在ILVB控制台 “APP基础设置”中查询 |
2.3游戏设置
游戏设置分为素材配置和排行榜设置。其中,素材配置可参照平台规范-设计规范。当配置素材为审核状态时,开发者不能修改素材内容。
关于游戏设置各字段说明:
字段名 | 是否必选 | 含义 | 默认值 | 备注 |
---|---|---|---|---|
大图素材 | 是 | 用于聊天窗口分享游戏、游戏列表、玩一玩主界面 | 无 | 1080x608像素,png格式图片,大小不超过2M |
小图素材 | 是 | 用于玩一玩启动界面、搜索列表、分享游戏logo等等 | 无 | 512x512像素,png格式图片,大小不超过2M |
Gif图素材 | 否 | 用于热玩封面图、聊天窗口分享游戏界面 | 无 | 480*270像素,gif格式图片,大小不超过3M。 |
排行榜周期 | 是 | 设置排行榜清空周期 | 永久 | 有每天、每周(选择当周固定一天)、 每月(选择当月固定一天)、永久 |
排行榜顺序 | 是 | 排行榜排序规则 | 单局从高到低 | 有单局从高到低和单局从低到高两种排序选择 |
3.创建游戏版本
1、在测试版本中,点击“创建版本”,进入游戏包信息提交界面。
2、按照游戏包打包规则,上传游戏包,填写相关信息后,提交。
3、刷新页面,游戏版本创建完毕。
3.1 创建游戏及版本各字段说明:
字段名 | 是否必选 | 含义 | 默认值 | 备注 |
---|---|---|---|---|
游戏包 | 是 | 请参见打包规则 | 无 | 参考 打包规则 ,或下载demo包 |
版本备注 | 否 | 对游戏版本进行简要说明 | 无 | 最多可填写140个字符 |
游戏名称 | 是 | 游戏名 | 无 | 修改需审核,审核通过前不能申请上架 |
游戏简介 | 是 | 游戏的简要说明 | 无 | 每次创建版本的时候都可以更改 |
游戏类型 | 是 | 游戏归属的类型 | 无 | 主要用于后期游戏个性化推荐,每次创建版本的时候都可以更改 |
3.2 创建游戏版本规范:
对于同一个游戏,你可以创建多个不同的游戏版本,进行版本测试、迭代与更新。
当游戏处于审核中状态,无法提交新的游戏版本。
Tips:游戏处在审核中,不得使用vscode通过插件进行生产游戏版本,会造成游戏版本混乱,导致无法进行正常审核。
4.管理员帐号管理
主帐号可点击hudong.qq.com首页右上角的头像,在下拉菜单中点击”帐号管理”,可执行子帐号(又称白名单)的管理操作。
4.1添加子帐号
1、主帐号在某款游戏页面,点击第一行的“+”按钮,输入添加的子帐号。
2、被添加帐号进行扫码确认。
3、主帐号点击“编辑权限”,赋予子帐号相关权限,添加完成。
4.2权限内容
不同权限的子帐号,对游戏管理页面及操作内容皆为不同,具体内容可参照下表:
权限名称 | 管理相关页面 | 权限内容 |
---|---|---|
开发管理 | 开发管理 | 创建游戏版本;上架审核;发布至线上 |
设置项目 | 设置项目、创建道具 | 填写设置项目;创建和管理道具 |
数据查看 | 数据分析、广告中心 | 查看数据和广告收入页面 |
帐号管理 | 帐号管理 | 管理游戏子帐号的授权、编辑、解除关联等操作 |
4.3权限管理规范
1、一个子帐号只能够被一个主帐号所关联,可在主帐号的多个游戏里被关联。
2、一个游戏最多可关联20个子帐号。
3、仅主帐号拥有(默认拥有)创建游戏的权限和查看开发者信息。
4、当一个QQ号已是某款游戏的主帐号时,不得再做其他游戏的子帐号。
5. 游戏测试
5.1手Q拉起轻游戏测试环境步骤
1、目前手Q轻游戏平台暂时只能支持Android环境,请使用Android手机在应用宝上下载最新版的手机QQ。
2、将测试QQ号添加至子帐号管理中,主帐号登录hudong.qq,点击右上角头像,进入帐号管理,点击“+”号,输入测试QQ,生成二维码。
3、使用测试QQ登录最新版手Q,扫描二维码进行确认绑定,并获得测试点券。
4、点击“编辑权限”按钮,赋予测试帐号开发管理等权限,点击确定修改。
5、使用已经添加了管理帐号的测试QQ,扫描游戏测试版本右侧的二维码,拉起游戏。
6、体验并测试游戏。
如果你在调试过程中碰到了问题,可以考虑参考以下方式排查重试:
1). 打开抽屉页→设置→空间清理→QQ存储空间清理;
2). 关闭手Q进程,重新登录;
3). 检查自己的帐号是否在该游戏的子帐号管理中,不得使用主账号测试;
4). 从bitbucket上下载最新的qqPlayCore.js;
5). 更新最新的开发引擎;
6). 如果你在拉起游戏之后卡死,请先打log检查下你的js脚本;
7). 目前手Q轻游戏平台只能支持Android,暂时下架ios。
5.2测试中遇到的问题
开发者可根据平台提供的测试文档,对游戏进行自测。当开发者在自测过程中,遇到游戏出现错误、缺陷、bug,或游戏需要进行优化、迭代等,可参照以下步骤:
1.根据平台接入指南中的轻游戏开发和轻游戏介绍文档,进行详细阅读或全局搜索来排查问题。
2.通过游戏本身代码的排查,以及查看手Q的log,对问题进行处理。
3.开发者可将相关的技术问题详情(包括场景、截图、报错、贴代码)反馈至技术邮箱:hudong_technical@tencent.com ;轻游戏运营人员会将邮箱问题反馈至开发,并将解决办法回复开发者。
4.将“修复”完整的游戏重新上传游戏包,生成新的游戏版本号,直至游戏自测完成后,申请上架。
6.游戏提审与上架
当游戏测试没有问题之后,游戏设置项目信息填写完整,且开发者认证通过后,可点击“申请上架”的按钮,进行上架提审。当游戏无法申请上架,可能出现以下提示:
Warning: appid没有通过审核,不可申请上架;
appid提示:未审核通过前该ID为临时ID,供测试开发使用。
当开发者新建游戏时,会自动生成appid。QQ互联会审核并通过该appid,开发者无需操作,审核时间在一天左右。Warning: 没有通过开发者认证,不可申请上架;
该提示说明该帐号审核未通过,请根据接入指南——开发者接入里面的认证流程,完成开发者认证,才可申请上架游戏。
Warning:图片素材未审核通过,不可申请上架;
该提示说明在项目配置中的游戏设置里,大图素材和小图素材未配置或审核未通过。
在初次提交审核时,会要求开发者提供测试报告与备注,我们提供相应的测试文档。开发者可点击自测报告模板进行文件下载,根据文档指示测试相关项目,并填写自测结果。打包测试报告后,上传zip文件,点击提交。
当更新线上游戏版本时,开发者只需要在备注里填写修改内容即可,无需再进行游戏自测报告。
当游戏状态变更为“上架审核中”的时候,轻游戏运营和测试人员对游戏进行审核和测试,开发者在这期间无法重新创建新版本,无法再次提交申请上架。
1、游戏会先由产品同学确认是否符合游戏规范,游戏基本流程是否合理。产品同学审核通过游戏之后,会转给测试同学。
2、测试同学将按照测试用例逐一审核游戏是否符合规范,为方便测试同学审核,游戏提测时需要附带功能测试报告和性能测试报告。
3、游戏按照先来后到原则审核,一般3个工作日以内给出测试结论。
4、游戏方需要对自己的游戏质量负责,并控制申请上架频率。相应规范参见游戏规范。
5、通过审核的游戏将被发布至外网,外网用户可见,最低手q可见版本对应于开发者提交审核时给出的最低可见版本。
6、初次提审时,需提交自测报告;当存在线上版本时,游戏版本再次提交审核时,无需再提交自测报告,只需在备注详细的填写相应的修改内容即可。