HarmonyOS 3.1上实现游戏万能卡片

首页 > 行业资讯 > >正文

HarmonyOS 3.1上实现游戏万能卡片

来源：OST开源开发者时间：2023-06-06 11:46:51

舒尔特方格游戏，是注意力训练方法之一，可以帮助孩子纠正上课分心走神、回家做作业拖拉毛病，但不能贪玩哦，玩多了，对眼睛，视力不好。

①消息通知栏，通知用户当前最优成绩，也就是当前最快时间。

②元服务卡片，在桌面上添加 2x2 或 2x4 或 2x4 规格元服务卡片，能看到不同布局随机数字，根据左上角红色字提示，快速完成点击，用时最少为最优成绩。

(资料图片仅供参考)

③1x2 规格元服务卡片，只显示当前最优成绩，点击可以查看 2x2 或 2x4 或 2x4 规格元服务卡片最快用时游戏记录。

关系型数据库，用于查询，添加，更新，删除元服务卡片信息和各卡片游戏用时成绩数据。

效果图如下：

知识点

消息通知：提供通知管理的能力，包括发布、取消发布通知，创建、获取、移除通知通道，订阅、取消订阅通知，获取通知的使能状态、角标使能状态，获取通知的相关信息等。 关系型数据库：关系型数据库基于 SQLite 组件提供了一套完整的对本地数据库进行管理的机制，对外提供了一系列的增、删、改、查等接口，也可以直接运行用户输入的 SQL 语句来满足复杂的场景需要。 元服务卡片开发：卡片是一种界面展示形式，可以将应用的重要信息或操作前置到卡片，以达到服务直达、减少体验层级的目的。卡片提供方：显示卡片内容，控制卡片布局以及控件点击事件。卡片使用方：显示卡片内容的宿主应用，控制卡片在宿主中展示的位置。卡片管理服务：用于管理系统中所添加卡片的常驻代理服务，包括卡片对象的管理与使用，以及卡片周期性刷新等。

软件要求：

DevEco Studio 版本：DevEco Studio 3.1 Release 及以上版本。

HarmonyOSSDK 版本：APIversion 9 及以上版本。

硬件要求：

设备类型：华为手机3.1 系统或运行在 DevEco Studio 上的远程模拟器API9。

HarmonyOS 系统：3.1.0 Developer Release 及以上版本。

卡片讲解

1x2 卡片主要显示所有卡片最优成绩，也就是用时最少的，同时点击卡片，跳转到主界面，查看卡片游戏记录。

2x2 卡片显示的是 3x3 布局随机生成 1~9 数字，正上方标题显示挑战成功或失败提示，左上角红色字提示下一个要点击的数字按钮，右上角显示当次完成后用时和此卡片用时最少成绩。

当此次的用时少于最好用时，挑战成功，并更新数据库此卡片记录，如果此次用时大于最好用时，提示挑战失败，不用更新数据库。

2x4 卡片显示的是 7x2 布局随机生成 1~14 数字，显示内容和游戏规则与 2x2 卡片一样。

4x4 卡片显示的是 6x6 布局随机生成 1~36 数字，显示内容和游戏规则与 2x2 卡片一样。

首次启动或点击 1x2 卡片进入到主界面，主界面显示各卡片游戏成绩记录。

通知显示效果：

代码讲解

数据库操作后端项目结构图：

FormData.ets 实体类代码如下：

exportdefaultclassFormData{//卡片IDformId:string;//距阵数3x3matrixNum:string;//最优成绩bestScore:number;//总最优成绩totalBestScore:number;}

Form.ets 数据库卡片表如下：

exportdefaultclassForm{//卡片IDformId:string;//卡片名称formName:string;//卡片描述dimension:number;/***封装卡片数据*@returns*/toValuesBucket(){return{"formId":this.formId,"formName":this.formName,"dimension":this.dimension};}}

ScoreData.ets 游戏记录成绩表如下：

exportdefaultclassScoreData{//卡片formId:string;//距阵数3x3matrixNum:string;//最优成绩bestScore:number;/***获取插入成绩记录数*@returns*/toValuesBucket(){return{"formId":this.formId,"matrixNum":this.matrixNum,"bestScore":this.bestScore};}}

DatabaseUtils.ets 数据库操作类部分代码如下：

exportclassDatabaseUtils{/***创建RDB数据库**@param｛context｝上下文*@return｛globalThis.rdbStore｝returnrdbStoreRDB数据库*/asynccreateRdbStore(context:Context){console.info(CommonConstants.DATABASE_TAG,"xxDatabaseUtils-createRdbStore开始...")//如果全局变量rdbStore不存在，创建if(!globalThis.rdbStore){console.info(CommonConstants.DATABASE_TAG,"xx DatabaseUtils-createRdbStore 新创建！")awaitDataRdb.getRdbStore(context,CommonConstants.RDB_STORE_CONFIG).then((rdbStore)=>{console.info(CommonConstants.DATABASE_TAG,"xxRDBStore回调")if(rdbStore){//创建卡片表rdbStore.executeSql(CommonConstants.CREATE_TABLE_FORM).catch((error)=>{console.error(CommonConstants.DATABASE_TAG,"xx DatabaseUtils 创建卡片表失败："+JSON.stringify(error))Logger.error(CommonConstants.DATABASE_TAG,"executeSqlFormerror"+JSON.stringify(error));});//创建成绩表rdbStore.executeSql(CommonConstants.CREATE_TABLE_SCORE_DATA).catch((error)=>{console.error(CommonConstants.DATABASE_TAG,"xx DatabaseUtils 创建成绩表失败："+JSON.stringify(error))Logger.error(CommonConstants.DATABASE_TAG,"executeSqlSensorerror"+JSON.stringify(error));});//存储RDBStore到全局变量globalThis.rdbStore=rdbStore;console.info(CommonConstants.DATABASE_TAG,"xx DatabaseUtils-createRdbStore 创建成功！")}}).catch((error)=>{console.error(CommonConstants.DATABASE_TAG,"xx DatabaseUtils 创建RDB数据库失败："+JSON.stringify(error))Logger.error(CommonConstants.DATABASE_TAG,"createRdbStoreerror"+JSON.stringify(error));});}else{console.info(CommonConstants.DATABASE_TAG,"xx DatabaseUtils-createRdbStore 已经存在！")}console.info(CommonConstants.DATABASE_TAG,"xxDatabaseUtils-createRdbStore结束...")returnglobalThis.rdbStore;}/***插入卡片数据。**@param｛Form｝Form表单实体。*@param｛DataRdb.RdbStore｝RDB存储RDB数据库。*@return返回操作信息。*/insertForm(form:Form,rdbStore:DataRdb.RdbStore){rdbStore.insert(CommonConstants.TABLE_FORM,form.toValuesBucket()).catch((error)=>{Logger.error(CommonConstants.DATABASE_TAG,"insertFormerror"+JSON.stringify(error));});}/***将成绩插入数据库。**@param｛ScoreData｝scoreData。*@param｛DataRdb.RdbStore｝RDB存储RDB数据库。*/insertValues(scoreData:ScoreData,rdbStore:DataRdb.RdbStore){rdbStore.insert(CommonConstants.TABLE_SCORE,scoreData.toValuesBucket()).catch((error)=>{Logger.error(CommonConstants.DATABASE_TAG,"insertValueserror"+JSON.stringify(error));});}/***更新成绩到数据库*@paramscoreData*@paramrdbStore*/updateValues(scoreData:ScoreData,rdbStore:DataRdb.RdbStore){}/***删除卡片数据。**@param｛string｝formId表单ID。*@param｛DataRdb.RdbStore｝RDB存储RDB数据库。*/deleteFormData(formId:string,rdbStore:DataRdb.RdbStore){}/***更新卡片**@param｛DataRdb.RdbStore｝RDB存储RDB数据库。*/updateForms(rdbStore:DataRdb.RdbStore){}/***发送通知**@param｛string｝Steps显示的值步数。*/asyncsendNotifications(score:number){}}

卡片前端项目结构图：

EntryAbility.ets 程序入口初始化数据库代码如下：

onCreate(want,launchParam){//数据库初始化globalThis.abilityWant=want;globalThis.abilityParam=launchParam;console.info(CommonConstants.ENTRY_ABILITY_TAG,"xxonCreate创建RDB数据库")//创建RDB数据库DatabaseUtils.createRdbStore(this.context).then((rdbStore)=>{console.info(CommonConstants.ENTRY_ABILITY_TAG,"xxonCreateRDB成功")}).catch((error)=>{console.error(CommonConstants.ENTRY_ABILITY_TAG,"xx onCreate 创建数据库失败："+JSON.stringify(error))Logger.error(CommonConstants.ENTRY_ABILITY_TAG,"onCreaterdberror"+JSON.stringify(error));});}

EntryFormAbility.ets 卡片生命周期代码如下：

onAddForm(want){//获取卡片ID：ohos.extra.param.key.form_identityletformId:string=want.parameters[CommonConstants.FORM_PARAM_IDENTITY_KEY]asstring;//获取卡片名称：ohos.extra.param.key.form_nameletformName:string=want.parameters[CommonConstants.FORM_PARAM_NAME_KEY]asstring;//获取卡片规格：ohos.extra.param.key.form_dimensionletdimensionFlag:number=want.parameters[CommonConstants.FORM_PARAM_DIMENSION_KEY]asnumber;console.info(CommonConstants.ENTRY_FORM_ABILITY_TAG,`xx 添加卡片是：${formId}${dimensionFlag}${dimensionFlag}`)DatabaseUtils.createRdbStore(this.context).then((rdbStore)=>{//卡片信息letform:Form=newForm();form.formId=formId;form.formName=formName;form.dimension=dimensionFlag;console.info(CommonConstants.ENTRY_FORM_ABILITY_TAG,"xx onAddForm 新增卡片信息："+JSON.stringify(form))//保存卡片信息到数据库DatabaseUtils.insertForm(form,rdbStore);//获取最优成绩getBestScore(rdbStore,dimensionFlag,formId);}).catch((error)=>{console.error(CommonConstants.ENTRY_FORM_ABILITY_TAG,"xx onAddForm 添加卡片失败："+JSON.stringify(error))Logger.error(CommonConstants.ENTRY_FORM_ABILITY_TAG,"onAddFormrdberror"+JSON.stringify(error));});//每五分钟刷新一次formProvider.setFormNextRefreshTime(formId,CommonConstants.FORM_NEXT_REFRESH_TIME,(error,data)=>{if(error){console.error(CommonConstants.ENTRY_FORM_ABILITY_TAG,"xx onAddForm 更新卡片失败："+JSON.stringify(error))Logger.error(CommonConstants.ENTRY_FORM_ABILITY_TAG,"refreshTime,error:"+JSON.stringify(error));}else{console.info(CommonConstants.ENTRY_FORM_ABILITY_TAG,"xxonAddForm更新卡片成功")Logger.info(CommonConstants.ENTRY_FORM_ABILITY_TAG,"refreshTimesuccess"+JSON.stringify(data));}});//返回初始化卡片数据letformData:FormData=newFormData();formData.formId=formId;formData.bestScore=0;formData.matrixNum="1x1";formData.totalBestScore=0;returnformBindingData.createFormBindingData(formData);}

卡片页面部分代码，这里就显示 2x2 卡片代码如下：

build(){Column(){Text(this.message).width("100%").fontSize(12).textAlign(TextAlign.Center).fontWeight(700).margin({top:6,bottom:6})Row(){Text(`下一个:${this.flagNum==0?1:this.flagNum}`).fontSize(10).fontWeight(400).fontColor(Color.Red)Row(){Text(`此次:${this.currentScore}`).fontSize(10).fontWeight(400)Text(`最好:${this.bestScore}`).fontSize(10).fontWeight(400)}}.width("100%").padding({left:10,right:10}).alignItems(VerticalAlign.Center).justifyContent(FlexAlign.SpaceBetween)Flex({justifyContent:FlexAlign.Center,alignItems:ItemAlign.Center,wrap:FlexWrap.Wrap}){//循环显示数字按钮ForEach(this.numArray,(day:string)=>{Button(day,{type:ButtonType.Circle,stateEffect:true}).width(40).height(40).padding(1).margin(4).fontSize(12).backgroundColor(Color.Gray).stateStyles({normal:this.normalStyles,pressed:this.pressedStyles}).onClick(()=>{this.startGame(Number(day))})},day=>day)}.width("100%").height("100%").padding({top:2,left:5,right:5})}.width("100%").height("100%")}

总结

通过开发这个小游戏元服务，学习到不少知识，其实我有尝试过把数据库操作类写到动态共享包里，这样元服务打包后不就更小了，然而启动后白屏了，进步问题，等华为相关技术人员回复，想学习动态共享包的，可以参考关系型数据库-动态共享包开发。总结这个项目用到以下知识点：

使用 notification 发布通知。

使用关系型数据库插入、更新、删除卡片数据。

使用 FormExtensionAbility 创建、更新、删除元服务卡片。

审核编辑：汤梓红