6月底,我们本该发个引擎版本,由于计划搞点大动作。所以很抱歉,我们跳票了。
引擎语言从AS3全面转向TS,这个动静有点大,很多引擎小细节变了(不影响API),不止是代码迁移的工作量,还有各种测试。
为了不让大家等的太久,我们把计划中一次更新的内容,拆成两个版本来发。
今天,我们先发一个小版本,LayaAir 2.1.1beta和LayaAir 1.8.4beta。在这两个小版本里,重磅推出vivo小游戏适配与IDE内一键发布。同时,我们在这次版本里支持了spine动画3.7.89版本的音轨对齐功能。
TS引擎和3D部分的更新将保留在大版本LayaAir 2.2.0里。很快就会与大家见面了。大概一两周的样子。
下面,我们针对vivo小游戏的平台背景、产品发布与调试,进行详细的说明。
vivo小游戏背景
vivo是快应用联盟中的重要成员。据了解,快应用过去一年覆盖10亿设备、月活2亿、打开快应用20亿次、留存1亿个桌面图标。其中有35%的流量来自桌面留存的图标。
基于快应用联盟强大的设备基础,快游戏具有先天的设备覆盖及获客优势,一旦接入快游戏平台,它可以在联盟厂商手机品牌中得到推广。vivo小游戏引入Layabox等引擎方对其适配,并在引擎IDE中一键发布,这对于广大的游戏厂商而言,无疑带来了更快的游戏发布效率,并且可以将开发者的接入成本最小化。
(图1)vivo主要流量入口
vivo小游戏与系统入口深度整合,是一种更轻更快的游戏形态,拥有更高效的分发效率,用户无需安装,即点即玩,可在游戏中心、负一屏、桌面等系统级高曝光入口呈现,为产品带来更多流量。
vivo小游戏发布与调试环境准备
1、vivo品牌的手机
2、下载安装vivo的调试APP,下载页面:https://minigame.vivo.com.cn/documents/#/download/debugger
进入页面后,点击 立即下载 ,即可下载vivo调试器的apk包,然后安装即可。
3、下载新版本vivo小游戏引擎
当前调试APP内置的vivo引擎版本是1034,我们需要前往vivo小游戏官网下载最新版本的小游戏引擎apk。
下载页面为:
https://minigame.vivo.com.cn/documents/#/download/engine
当前的推荐的版本是1041,下载安装后,我们可以看到vivo快应用调试器的平台版本号那里也是显示的1041。
4、PC电脑的chrome浏览器与手机数据连接线。
5、安装nodejs 环境 [node官网:https://nodejs.org/en/]
就是下载安装,比较简单,也不细介绍。能在命令行里调起npm命令就算是成功了。
6、LayaAirIDE集中开发环境,LayaAir IDE 2.1.1beta 或以上版本 [ 官网下载: https://ldc2.layabox.com/layadownload/?type=layaairide ]
7、安装ADB
ADB可以用于授权,以及真机调试等环节,可以前往ADB的官网下载并安装。
[ ADB官网下载: http://adbshell.com/downloads ]
简单提示一下,下载 ADB Kits,下载后的压缩包,建议解压放到一个路径简单一些的目录(如:
D:\adb
)。要记得添加环境变量(不知如何添加环境变量的可自行百度)。
vivo小游戏发布流程
打开发布功能,在发布平台选择好vivo小游戏之后,如图2所示,我们就可以在当前的界面里配置发布的相关参数,然后完成一键发布。
(图2)
常规的发布选项就不介绍了。关于vivo小游戏专属的发布配置如图3所示。我们将逐一进行介绍。
(图3)
一般都填写中文汉字(不超过6个汉字长度),英文也可以。用于应用商店、桌面图标、弹窗等游戏入口处。一个好的名字是游戏能不能吸量的重要元素。
游戏包名的格式是com.company.module
第一位com不要变,第二位是公司名,第三位是项目名。都要写英文,例如:com.layabox.demoGame
。
游戏图标也是重要的游戏入口标识,和游戏名称一样,是非常重要的吸量元素,如果游戏图标设计的好,游戏名称起的好。同样的位置会获得比其它游戏更多的点击率。游戏图标需要提供192 * 192
的正方形尺寸。
游戏版本名称是真实的版本,一般是用于功能性版本的区别。比如我有个大版本改动。原来是1.0,可以变成2.0,如果只是改改Bug,那1.0完全可以改成1.1。以此类推,我们建议采用浮点数命名。比如“0.1”、“1.3”、“5.0”……
游戏版本与版本名称用处不同,这里是渠道平台用于区别版本更新。每次提审都要至少递归+1,自己测试无所谓。但是提审这里的值必须要比上次提审的值至少要+1,+N也是可以的,绝对不能等于或者小于上个版本值,建议是提审版本号递归+1。这里需要注意的是,游戏版本必须为正整数。
最小平台号,在安装好的vivo快应用调试器里可以看到,如图4所示的是1041。平台版本号这里看到是什么就在IDE这里输入什么。当前,默认下载和安装好的快应用调试器内置版本是1034,如果你看到的是1034或者是小于1041的版本,那我们推荐大家前往官网下载最新的版本(当前是1041),只有1041+的版本才与IDE进行了完美适配。网址在环境准备的章节里有,大家一定要下载使用1041版本。
(图4)
7、屏幕方向
这里大家要注意,这里的设置屏幕方向,要和游戏实际屏幕方向以及引擎的横竖屏设置保持统一。
如果只是测试版本调试,这里可以不用勾选。正式上线发布前(提版本到平台)必须勾选。
如果勾选了,就会启用正式版签名。关于release签名:
①对于公司,一般一个公司只用一个签名,如果公司已经有签名了,推荐使用公司的签名。如果没有的话,IDE中的发布集成了这个功能,方便开发者生成签名。
②对于个人开发者,可以多个项目使用一个正式签名。只需要生成一次即可。
如果已经有release签名了,将签名文件放到项目根目录sign / release 文件夹下,如图5所示。
(图5)
放到根目录下,是为了下次发版本的时候,复制到release的目录下。如果直接到releas目录内的sign目录内,下次发布会把之前的内容全部清除掉。如果没有sign/release,那就自己建一个!
这个功能是为了生成正式版签名,不勾选上一个功能或者已经有release签名的时候,不用配置这里。勾选后,配置参数如下(注意生成release签名需要OpenSSL
环境):
(图6)
图6中的签名内容建议写英文,帮大家翻译一下及示例如下:
//国家简称,例如中国CN
Country Name (2 letter code) [AU]:
CN
//省或直辖市名字,例如北京市BeiJing
State or Province Name (full name) [Some-State]:
BeiJing
//区或市县的名称,例如海淀区HaiDian
Locality Name (eg, city) []:
HaiDian
//公司或组织名,例如Layabox
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Layabox
//单位或者是部门名称,例如游戏部门Game
Organizational Unit Name (eg, p) []:
Game
//Email地址,例如:游戏对接合作 [email protected]
Email Address []:
[email protected]
vivo小游戏接入与调试流程
填写完发布界面上的各种配置信息,点击发布,即可完成产品的发布。需要提醒的是,首次发布需要下载rpk环境,要稍等一会。别着急。
发布完成后会有一个二维码的界面,如图7所示。这个界面不要关,后面手机扫码需要用。
(图7)
要启动电脑PC的chrome调试环境,我们要先安装好vivo小游戏的调试APP(快应用调试器),如图8所示。然后点击进入。
(图8)
进入快应用调试器之后,我们可以看到如图9所示的APP操作界面。
(图9)
这时候我们点击图9中的扫码安装,扫一下LayaAir IDE中发布界面上的那个二维码(之前不让关,关了的要重新发布让二维码显示出来)。手机中就可以在真机环境中运行了。
这里要提示的是:手机网络要和PC在同一个局域网段里(用4G网扫局域网的码肯定是不行的)。
如果把发布目录下/dist目录内的rpk包传到手机里,通过点本地安装
按钮来安装,也是可以的。但是建议扫码安装,因为扫码的步骤更方便快捷。
对于比较有相关经验的开发者,确保USB手机连接线物理线路是已连接状态,并且USB调试授权也没问题的,可以跳过本步骤。
第一步:先用手机连接线将手机与PC保持物理上的连接。
第二步:在之前打开的命令行下,输入adb shell,如图10所示。则是未获得USB调试模式授权。
(图10)
此时,我们要关注手机端,是否出现如图11所示的提示,如果有,则点 确定 允许USB调试。
(图11)
第三步:再次验证授权。
当USB调试模式授权成功之后,我们再次输入adb shell,应该如图12所示。
(图12)
总之,在这个环节里,我们要保障PC是有权限调试这个手机设备的。
之前扫码安装后,会自动进入刚刚安装的游戏或者DEMO。
要启动调试,就要先退出来。
然后,如图13所示,点击开始调试,进入vivo小游戏的调试模式。
(图13)
真机进入调试模式后,我们再到PC上打开chrome浏览器。
这时候别忘了,要联接USB数据线,将手机设备与PC相联,权限的问题上面已经说过,不再重复。
我们要在手机端查找到手机的IP(不知道怎么查的自行百度)并记住他。一定要注意的是,手机网要和PC网始终保持在同一个局域网段。
在chrome浏览器的输入栏里输入:
chrome-devtools://devtools/bundled/inspector.html?v8only=true&ws={IP}:5086/00010002-0003-4004-8005-000600070008
将{IP}替换为手机IP地址即可,如图14所示。
(图14)
至此,vivo小游戏从发布到启动chrome调试的完整流程已介绍完。如果想了解关于更多vivo小游戏的接入流程与文档介绍,记住这个网址:
https://minigame.vivo.com.cn
或者直接点击本篇左下角 阅读原文 直接打开链接。
小游戏相关链接:
LayaAir已支持OPPO小游戏适配与IDE内一键发布!
Layabox率先支持小米快游戏,LayaAir 2.0.2版本大幅提升3D性能、spine性能和内存优化、新增屏幕适配设置!
百度即将推出智能小游戏,Layabox率先完成引擎适配支持!
-END-
推荐阅读:
LayaAir引擎放弃Canvas API,打造次世代3D引擎与云游戏引擎,提供AI赋能!
MOBA、SLG、ARPG类型3D HTML5游戏案例精品推荐
LayaAir 2.0 正式版发布了,重要特性全面介绍