示例代码合集地址:
HarmonyOS示例代码-鸿蒙系统示例代码-华为开发者联盟 (huawei.com)
代码工程地址:
FormGame: 本示例展示了如何通过Stage模型实现一个简单的游戏卡片。 (gitee.com)
Stage模型卡片小游戏
介绍
本示例展示了如何通过Stage模型实现一个简单的游戏卡片。
-
通过卡片支持的点击事件进行交互,让用户通过点击的先后顺序把一个乱序的成语排列成正确的成语。
-
使用了C++和TS的混合编程方式,将获取随机数的能力下沉到C++实现,并通过NAPI的能力将C++实现的能力暴露到TS中。
-
用到了卡片扩展模块接口@ohos.app.form.FormExtensionAbility。
效果预览
添加卡片 | 操作卡片 |
---|---|
使用说明:
1.部分设备的桌面不支持卡片,可以通过自己的开发卡片使用方,进行卡片的创建、更新和删除等操作。
2.安装应用,并在桌面上长按本应用的桌面图标,长按后弹出选项列表。
3.点击弹出列表中的服务卡片选项进入卡片添加界面。
4.点击正下方的添加到桌面按钮,卡片就会出现在桌面上。
工程目录
├──entry/src/main/cpp // cpp代码区 │ ├──types/libinfoutil │ │ └──index.d.ts // native侧暴露给ArkTS侧接口的声明 │ ├──native_module.cpp // native侧逻辑 │ └──napi_info_util.cpp // native侧逻辑 ├──entry/src/main/ets // ets代码区 │ ├──application │ │ └──AbilityStage.ets │ ├──entryability │ │ └──EntryAbility.ets │ ├──formability │ │ └──FormAbility.ets // 定义卡片对象首次被创建时需要做的操作 │ └──pages │ └──Index.ets // 首页,包含ArkTS侧逻辑 ├──entry/src/main/js // js代码区 │ └──widget/pages/index // 定义卡片内容 │ ├──index.hml │ ├──index.css │ └──index.json ├──entry/src/main/resources // 应用资源目录 └──module.json5 // 添加卡片拓展能力
具体实现
1、在module.json5文件添加拓展能力,类型为卡片,并设置卡片入口srcEntrance和卡片元数据metadata,源码参考。 2、配置卡片:用js编写相应的卡片,将卡片配置到resources/base/profile/form_config。
3、定义小游戏逻辑:实现FormExtensionAbility中addform时初始化数据(本sample中使用的是mock数据),并将数据存储到dataStore,通过调用c++随机数,将成语顺序打乱显示, 4、监听卡片变化:通过onformEvent()监听卡片事件,更新已选择的成语数据,并随机替换成语待选列表的已被选掉的word,源码参考。
相关权限
不涉及。
依赖
不涉及。
约束与限制
1.本示例仅支持标准系统上运行,支持设备:华为手机。
2.HarmonyOS系统:HarmonyOS NEXT Developer Beta1及以上。
3.DevEco Studio版本:DevEco Studio NEXT Developer Beta1及以上。
4.HarmonyOS SDK版本:HarmonyOS NEXT Developer Beta1 SDK及以上。