查看原文
其他

Layabox率先完成bilibili小游戏的适配与IDE发布,LayaAir 2.6.1今日发版!

点我关注公众号☞ Layabox 2023-08-11
bilibili是国内知名的视频弹幕网站,是中国年轻世代高度聚集的文化社区和视频平台,被粉丝们亲切的称为“B站”。这里有最及时的动漫新番,最棒的ACG氛围,最有创意的UP主。大家可以在这里找到许多欢乐。

在Layabox与B站携手努力下,如今,Layabox率先让基于LayaAir引擎的产品可以在B站小游戏平台中运行起来,让更多的开发者可以快捷的接入到B站小游戏平台,让B站用户可以体验到更多优质游戏。

B站用户可从游戏中心、站内外APP的分享链接等入口通过点击分享、收藏、feed推荐、搜索等方式找到小游戏,点开即玩,无需安装。



bilibili小游戏接入与联系方式


技术接入方面,bilibili小游戏已经完成了LayaAir引擎的对接。同时bilibili小游戏开放平台会安排技术人员入驻对接群,全程辅助游戏接入。

资源推广与分成政策方面, 对于优质的小游戏,bilibili会提供优厚的分成扶持政策和曝光资源,具体请关注bilibili游戏开放平台公告。

如果有其它疑问,欢迎联系bilibili小游戏平台官方的对接商务或邮件咨询。



bilibili小游戏完整开发流程


一、注册成为小游戏开发者

注册开发者帐号,和添加开发与预览权限帐号,是B站小游戏开发的基础。只有拥有开发者权限的用户,才能进行上传代码包的操作。只有拥有预览权限的用户,才能扫码访问后台开发版本、提审版本的二维码。其他用户扫码后会提示无访问权限。每个小游戏最多能有50位用户,包括创建者自己。

B站游戏开放平台帐号注册地址为:

https://open.biligame.com/#/register/choose-type


二、设置域名白名单

每个小游戏在开发前,都需要事先设置一个通讯域名,小游戏只可以跟指定的域名与进行网络通信。包括普通 HTTPS 请求(request)、上传文件(uploadFile)、下载文件(downloadFile) 和 WebSocket 通信(connectSocket)。


在配置流程方面,服务器域名要在 「开发者后台-设置-开发设置-服务器域名」 中进行配置,配置时需要注意:

  • 域名只支持 https (request、uploadFile、downloadFile) 和 wss (connectSocket) 协议;

  • 域名不能使用 IP 地址或 localhost;

  • 域名必须经过 ICP 备案;

  • 出于安全考虑,.bilibili.com 不能被配置为服务器域名,相关API也不能在小游戏内调用。开发者应将 appsecret 保存到后台服务器中,通过服务器使用 appsecret 获取 accesstoken,并调用相关 API;

  • B站头像的展示是默认允许的,不需要在后台添加域名;

  • 对于每个接口,分别可以配置最多 20 个域名。


三、准备本地开发环境、调试和测试环境

1、下载支持B站小游戏发布的最新版本引擎与IDE

LayaAir1.x版本是从1.8.9开始适配以及IDE中发布,LayaAir 2.x版本是从2.6.1开始适配以及IDE中发布,所以开发者需要注意版本号,版本号低于以上版本需求的,需要升级。
1.x LayaAirIDE官网下载地址 :
https://ldc.layabox.com/layadownload/?type=layaairide

2.x LayaAirIDE官网下载地址 :

https://ldc2.layabox.com/layadownload/?type=layaairide


2、安装B站小游戏开发者工具

B站开发者工具可以命令行安装,也可以下载安装。截至当前,桌面版工具,只支持Mac版,Windows版会近期推出,开发者可关注B站官方的更新日志。

B站小游戏开发者工具更新日志与下载地址为:

http://miniapp.bilibili.com/small-game-doc/open/ide-update/



四、使用LayaAir引擎完成小游戏的本地开发与发布

1、引擎适配

2.x引擎版本,升级到支持B站的版本(>=2.6.1)即可自动适配好。但1.x版本引擎需要手动自己初始化适配库,在引擎初始化之前加上以下适配代码 :

// AS语言版本:
BLIMiniAdapter.init();   

// TS或JS语言版本:
Laya['BLIMiniAdapter'].init();

2、在LayaAirIDE中直接发布

开发完游戏后,直接在LayaAirIDE中点击发布按钮,然后在发布平台栏目选择bilibili小游戏,勾选所需的发布配置后,直接点击最下方发布按钮即可,如下图所示。


由于B站小游戏单个分包/主包大小不能超过 4M,整个小游戏所有分包大小不超过 8M。所以在发布配置里,是否提取本地包,建议勾选使用。可以通过文件提取功能,只复制需要发布到B站本地包的文件到指定B站小游戏项目目录。


五、使用B站开发者工具,导入LayaAirIDE发布的B站项目

1、创建B站项目

打开哔哩哔哩开发者工具,在弹出的面板里,点击右下角红框内的加号“ ”新建项目。然后点击项目目录输入框,选择LayaAirIDE发布项目的release文件夹下的biligame目录,或者我们发布提取时指定的目录,再点击“使用测试号:小游戏”,设置好项目名称,点击确定即可完成B站项目的创建,如下图所示。


2、哔哩哔哩开发者工具的调试与发布

哔哩哔哩开发者工具与其它的小游戏工具差不多,所以开发过小游戏的开发者应该会用起来很顺手。最常用的调试与发布,效果如下图所示。



其它发布上线操作,可以登录后台进行,后台地址为:

https://miniapp.bilibili.com/smallapp/



六、提交上线

当我们完成本地调试和扫码进行真机预览,没有BUG和问题后。可以将开发版提交审核和上线。这里大家要注意,检查并添加游戏启动埋点,否则可能无法通过审核。

埋点API地址为:

http://miniapp.bilibili.com/small-game-doc/api/base/launchSuccess/



END



引擎案例介绍:


推荐阅读:


引擎版本更新说明:

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存