Laya引擎游戏适配FAQ 原创

如何判断是否HarmonyOS NEXT平台

• 问题描述

当开发要根据不同系统平台，务代码时，如何判断是HarmonyOS NEXT平台。

• 方法一

Laya.Browser.window.conch.config.getOS(); 这个方法返回"Conch-ohos"

image.png

• 方法二

Laya.Browser.window.layabox.devindo.os; 这个方法返回"OpenHarmony"。

image.png

游戏如何自定义侧滑/按下返回键的处理逻辑

• 问题描述

HarmonyOS NEXT上默认应用中侧滑/按手机返回键会直接触发应用进程关闭，如何自定义该处理逻辑。

• 解决方案

组件生命周期中提供了​​onBackPress​​方法，当用户点击返回键时触发（仅@Entry装饰的自定义组件生效）。

• 如果需要禁用系统本身的返回直接关闭游戏操作，必须要return true。
• 如果希望直接退出应用，将return true注释掉即可。

cke_231.png

如何调用HarmonyOS NEXT系统对话框

• 问题描述

需要在游戏中弹出HarmonyOS NEXT系统对话框退出游戏。

• 解决方案

对话框（Android上对应Dialog）是ArkTs系统UI组件，需要在ArkTs的主线程中调用sdk ts接口实现。

可以使用​​promptAction​​模块用showDialog或showToast方法来实现，示例代码如下：

cke_232.png

效果示例：

cke_233.png

如何适配屏幕旋转

• 问题描述

当需要动态更改屏幕方向时如何实现。

• 解决方案

HarmonyOS NEXT也实现了setScreenOrientation()方法，此方法使用和其他平台一样。

全面屏、状态栏、屏幕常亮

• 全面屏&状态栏

工程里面设置了默认全屏展示和隐藏状态栏。

屏幕窗口设置主要由​​@ohos.window​​控制，我们可以参考window相关API，进行实现全面屏实现。

调用​​setWindowLayoutFullScreen()​​接口，设置应用主窗口为全屏布局。然后调用​​setWindowSystemBarEnable()​​接口，设置导航栏、状态栏不显示，从而达到全面屏效果。

cke_234.png

• 屏幕常亮

屏幕常亮设置功能，HarmonyOS NEXT也实现了，通过conch.setScreenWakeLock(true)进行设置。

是否有类似sharedpreferences的键值存储功能

• 问题描述

是否有类似Android的sharedpreferences键值存储功能？

• 解决方案

请参考文档​​@ohos.data.preferences (用户首选项)​​。

如何通过命令行构建工程

• 问题描述

希望通过命令行方式构建工程，用以搭建流水线。

• 解决方案

请参考​​命令行搭建流水线​​。

如何开发自研SDK

• 问题描述

若自研SDK是Java版本，您需使用ArkTS语言重新实现。

• 解决方案

• HarmonyOS NEXT提供了HAR和HSP两种共享包用于实现功能复用，两者的区别和适用场景请参见​​共享包概述​​。
• 为开发过程中常用功能及其开发场景提供对应的经验总结、指导教程等，详情请参见​​HarmonyOS NEXT开发案例​​。

HSP内如何访问资源文件

• 问题描述

开发HSP模式的自研SDK，如何正确访问HSP内的资源文件？HSP内如何访问使用方的资源文件，例如entry。

• 解决方案

• 若访问HSP内的资源，请参考​​通过$r访问HSP中资源​​。
• 若访问其它模块下的资源，先获取到相应模块的​​ResourceManager​​对象，再调用相应方法。示例代码如下：

this.context.createModuleContext("entry").resourceManager

HSP如何以文件方式依赖

• 问题描述

HSP需要提供给多个使用方使用，不希望采用交付源码的方式，应如何操作。

• 解决方案

• 请参考​​集成态HSP​​

 更多问题可关注：

鸿蒙游戏官方网站：​​已有游戏移植-鸿蒙游戏-华为开发者联盟​​

公开课：​​华为开发者学堂​​