游戏接入

优质
小牛编辑
124浏览
2023-12-01

开发者登录后,点击右上角头像按钮,进入开发者信息页面,进行认证。审核通过或审核中的开发者,可通过游戏管理新建游戏。
创建游戏时需遵守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.游戏提审与上架

当游戏测试没有问题之后,游戏设置项目信息填写完整,且开发者认证通过后,可点击“申请上架”的按钮,进行上架提审。当游戏无法申请上架,可能出现以下提示:

  1. Warning: appid没有通过审核,不可申请上架;

    appid提示:未审核通过前该ID为临时ID,供测试开发使用。
    当开发者新建游戏时,会自动生成appid。QQ互联会审核并通过该appid,开发者无需操作,审核时间在一天左右。

  2. Warning: 没有通过开发者认证,不可申请上架;

    该提示说明该帐号审核未通过,请根据接入指南——开发者接入里面的认证流程,完成开发者认证,才可申请上架游戏。

  3. Warning:图片素材未审核通过,不可申请上架;

    该提示说明在项目配置中的游戏设置里,大图素材和小图素材未配置或审核未通过。

在初次提交审核时,会要求开发者提供测试报告与备注,我们提供相应的测试文档。开发者可点击自测报告模板进行文件下载,根据文档指示测试相关项目,并填写自测结果。打包测试报告后,上传zip文件,点击提交。
当更新线上游戏版本时,开发者只需要在备注里填写修改内容即可,无需再进行游戏自测报告。

当游戏状态变更为“上架审核中”的时候,轻游戏运营和测试人员对游戏进行审核和测试,开发者在这期间无法重新创建新版本,无法再次提交申请上架。

1、游戏会先由产品同学确认是否符合游戏规范,游戏基本流程是否合理。产品同学审核通过游戏之后,会转给测试同学。
2、测试同学将按照测试用例逐一审核游戏是否符合规范,为方便测试同学审核,游戏提测时需要附带功能测试报告和性能测试报告。
3、游戏按照先来后到原则审核,一般3个工作日以内给出测试结论。
4、游戏方需要对自己的游戏质量负责,并控制申请上架频率。相应规范参见游戏规范
5、通过审核的游戏将被发布至外网,外网用户可见,最低手q可见版本对应于开发者提交审核时给出的最低可见版本。
6、初次提审时,需提交自测报告;当存在线上版本时,游戏版本再次提交审核时,无需再提交自测报告,只需在备注详细的填写相应的修改内容即可。