##鸿蒙开发能力 ##HarmonyOS SDK应用服务##鸿蒙游戏类应用 (游戏# 一、前言 LayaAir引擎是国内最强大的全平台引擎之一,当年H5小游戏火的时候,腾讯入股了腊鸭。我还在游戏公司的时候,17年曾经开发使用腊鸭的H5小游戏,很怀念当年和腊鸭同事一起解决问题的时光。 从使用TypeScript开发语言,到界面组件封装,再到全平台发布,腊鸭走过的路与鸿蒙很相似。很多设计理念也很贴近。作为基础开源,定制商业化的全平台引擎,腊鸭在H5引擎市场上的占有率相当高。 Layabox成立于2014年,旗下的开源引擎产品LayaAir发布于2016年,已拥有超百万的全球开发者,是HTML5与小游戏领域的3D龙头引擎。 除了H5 3D小游戏,腊鸭也可以通过2D引擎开发H5应用或者H5 2D小游戏。 鸿蒙作为一个崭新的操作系统,H5小游戏和H5应用的助力可以极大丰富其生态。并且腊鸭的开发和学习入门上手较为简单,也可以为小游戏和H5开发小伙伴,在鸿蒙市场,带来广阔的未来前景。 今天本文主要讲解腊鸭的背景,腊鸭开发环境安装和鸿蒙构建发布。 二、LayaAir环境安装 官方环境搭建文章,点击跳转 LayaAir分为游戏引擎和编码工具两个部分。最早当年是自研的IDE一起负责了,后来将编码环境切换为了VSCode。 所以现在我们的Laya环境首先需要安装LayaAirIDE和VSCode。
之后因为Laya开发的编程语言是TypeScript,所以需要安装Node开发环境,并且要install TSC,用于将TS代码转化为JS代码。最后Laya的代码都是js代码。 npm install -g typescript
浏览器是方便调试,可选择安装。若是Window系统,使用自带的Edge浏览也可。或者安装GoogleChrome 下图是安装完LayaAirIDE之后,选择2D示例项目创建打开后的效果:
三、鸿蒙构建发布 点击文件-构建发布,选择鸿蒙NEXT,在右侧基本无需修改,点击下方的构建鸿蒙NEXT即可。
渲染模式这里,我考虑到鸿蒙对于web是有单独的渲染进程,所以没有选择OpenGL。选择的WebGL。
点击构建发布后,等待进度条完成,时间较长。
进度条完成后,如上图所示,会出现鸿蒙项目代码,点击箭头位置就可以到源码项目处。再使用DevEco Studio进行鸿蒙项目自动签名,运行就可运行Laya小游戏。
上图就是Laya的2D示例项目在鸿蒙手机中运行效果的静态截图。目前自动构建的鸿蒙SDK还是API11,我尝试动手i修改为API2或者API17,项目均会报错。还是等待后续官方升级吧。目前看整体效果还是很不错。 根据构建后的鸿蒙项目,我们通过Index入口文件可以发现,官方和Laya合作,新增了很多配套的自定义Component组件,例如:LayaEditBox,LayaWebview,TextInputDialog。 import laya from 'liblaya.so' import { ContextType } from '@ohos/libSysCapabilities' import { TextInputInfo } from '@ohos/libSysCapabilities/src/main/ets/components/EditBox' import { TextInputDialogEntity } from '@ohos/libSysCapabilities' import { WebViewInfo } from '@ohos/libSysCapabilities/src/main/ets/components/webview/WebViewMsg' import { VideoPlayerInfo } from '@ohos/libSysCapabilities/src/main/ets/components/videoplayer/VideoPlayer' import { WorkerMsgUtils } from '@ohos/libSysCapabilities/src/main/ets/utils/WorkerMsgUtils' import { WorkerManager } from '../workers/WorkerManager' import { LayaEditBox } from '../components/LayaEditBox' import { LayaWebview } from '../components/LayaWebview' import { LayaVideoPlayer } from '../components/LayaVideoPlayer' import { TextInputDialog } from '../components/TextInputDialog' import { GlobalContext, GlobalContextConstants } from "@ohos/libSysCapabilities" import { NapiHelper } from "@ohos/libSysCapabilities/src/main/ets/napi/NapiHelper" import { Dialog } from "@ohos/libSysCapabilities" import deviceInfo from '@ohos.deviceInfo'; import promptAction from '@ohos.promptAction' import process from '@ohos.process'; import { LayaHttpClient } from '@ohos/libSysCapabilities/src/main/ets/system/network/LayaHttpClient'
const nativePageLifecycle: laya.CPPFunctions = laya.getContext(ContextType.JSPAGE_LIFECYCLE); NapiHelper.registerUIFunctions();
let layaWorker = WorkerManager.getInstance().getWorker(); @Entry @Component struct Index { xcomponentController: XComponentController = new XComponentController(); // EditBox @State editBoxArray: TextInputInfo[] = []; private editBoxIndexMap: Map<number, TextInputInfo> = new Map; // WebView @State webViewArray: WebViewInfo[] = []; private webViewIndexMap: Map<number, number> = new Map; // videoPlayer @State videoPlayerInfoArray: VideoPlayerInfo[] = []; private videoPlayerIndexMap: Map<number, VideoPlayerInfo> = new Map;
// videoPlayer @State layaHttpClientArray: LayaHttpClient[] = []; private layaHttpClientIndexMap: Map<number, LayaHttpClient> = new Map;
private pro = new process.ProcessManager(); private m_nBackPressTime = 0; // textInputDialog showMessage: TextInputDialogEntity = new TextInputDialogEntity(''); dialogController: CustomDialogController = new CustomDialogController({ builder: TextInputDialog({ showMessage: this.showMessage }), autoCancel: true, alignment: DialogAlignment.Bottom, customStyle: true, }) // PanGesture private panOption: PanGestureOptions = new PanGestureOptions({ direction: PanDirection.Up | PanDirection.Down });
onPageShow() { console.log('[LIFECYCLE-Page] onPageShow'); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_EDIT_BOX_ARRAY, this.editBoxArray); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_EDIT_BOX_INDEX_MAP, this.editBoxIndexMap); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_WORKER, layaWorker); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_WEB_VIEW_ARRAY, this.webViewArray); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_WEB_VIEW_INDEX_MAP, this.webViewIndexMap); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_VIDEO_PLAYER_ARRAY, this.videoPlayerInfoArray); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_VIDEO_PLAYER_INDEX_MAP, this.videoPlayerIndexMap); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_DIALOG_CONTROLLER, this.dialogController); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_SHOW_MESSAGE, this.showMessage); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_HTTP_CLIENT_ARRAY, this.layaHttpClientArray); GlobalContext.storeGlobalThis(GlobalContextConstants.LAYA_HTTP_CLIENT_INDEX_MAP, this.layaHttpClientIndexMap); nativePageLifecycle.onPageShow(); Dialog.setTitle(getContext(this).resourceManager.getStringSync($r('app.string.Dialog_Title').id)); }
onPageHide() { console.log('[LIFECYCLE-Page] onPageHide'); nativePageLifecycle.onPageHide(); }
onBackPress() { console.log('[LIFECYCLE-Page] onBackPress'); layaWorker.postMessage({ type: "exit" }); let curtm = Date.now(); let MaxDelay = 3500; if (this.m_nBackPressTime == 0 || (this.m_nBackPressTime > 0 && curtm - this.m_nBackPressTime > MaxDelay)) { this.m_nBackPressTime = Date.now(); promptAction.showToast({ message: $r('app.string.text_backpress_toast'), duration: 1000 }); } else { this.pro.exit(0); } return true; }
onMouseWheel(eventType: string, scrollY: number) { // layaWorker.postMessage({ type: "onMouseWheel", eventType: eventType, scrollY: scrollY }); }
build() { // Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) { Stack() { XComponent({ id: 'xcomponentId', type: 'surface', libraryname: 'laya', controller: this.xcomponentController }) .focusable(true) .gesture( PanGesture(this.panOption) .onActionStart(() => { this.onMouseWheel("actionStart", 0); }) .onActionUpdate((event: GestureEvent) => { if (deviceInfo.deviceType === '2in1') { this.onMouseWheel("actionUpdate", event.offsetY); } }) .onActionEnd(() => { this.onMouseWheel("actionEnd", 0); }) ) .onLoad((context) => { console.log('[laya] XComponent.onLoad Callback'); layaWorker.postMessage({ type: "abilityContextInit", context: GlobalContext.loadGlobalThis(GlobalContextConstants.LAYA_ABILITY_CONTEXT) }); layaWorker.postMessage({ type: "onXCLoad", data: "XComponent" }); layaWorker.onmessage = WorkerMsgUtils.recvWorkerThreadMessage; }) .onDestroy(() => { }) ForEach(this.editBoxArray, (item: TextInputInfo) => { LayaEditBox({ textInputInfo: item }); }, (item: TextInputInfo) => item.viewTag.toString())
ForEach(this.webViewArray, (item: WebViewInfo) => {
LayaWebview({ viewInfo: item })
}, (item: WebViewInfo) => item.uniqueId.toString())
ForEach(this.videoPlayerInfoArray, (item: VideoPlayerInfo) => {
LayaVideoPlayer({ videoPlayerInfo: item })
}, (item: VideoPlayerInfo) => item.viewTag.toString())
}
.width('100%')
.height('100%')
} }