1# Samples 2 3为了方便开发者快速学习与了解、针对重点特性或功能进行开发，本页面对当前OpenHarmony所有的[Samples](https://gitee.com/openharmony/applications_app_samples)资源汇总，如下所示： 4 5 6 7## UI 8 9### 声明式开发范式 10 11#### ArkUI组件集合 12 13##### 介绍 14 15本示例为ArkUI中组件、通用、动画、全局方法的集合。 16##### 使用 171.点击组件、通用、动画、全局方法四个按钮或左右滑动切换不同视图。 18 192.点击二级导航（如通用属性、通用事件等），若存在三级导航则展开三级导航（如Border 边框、点击事件等）；若不存在三级导航，则跳转至详情页面。 20 213.若存在三级导航（如Border 边框、点击事件等），点击跳转至详情页面。 22##### 基本原理 23示例使用 [Tabs容器组件](reference/arkui-ts/ts-container-tabs.md) 搭建整体应用框架，每个 [TabContent内容视图](reference/arkui-ts/ts-container-tabcontent.md) 使用 [List容器组件](reference/arkui-ts/ts-container-list.md) 布局，在每个 [ListItem](reference/arkui-ts/ts-container-listitem.md) 中使用 [循环渲染](quick-start/arkts-rendering-control-foreach.md) 加载此分类下分类导航数据，底部导航菜单使用 [TabContent中tabBar属性](reference/arkui-ts/ts-container-tabcontent.md) 设置自定义样式 。 24将组件库分成四大类： 25组件模块： 261、空白与分隔：使用全局组件TitleBar，CommonItemSlider，CommonItemSelect，引入全局样式搭建分隔器组件页面。 272、按钮与选择：使用全局组件TitleBar，引入全局样式搭建按钮，日期选择器，单选按钮，选择菜单，滑动条，切换按钮组件页面。 283、信息展示与功效：使用全局组件TitleBar，引入全局样式搭建二维码组件页面。 294、文本与输入：使用全局组件TitleBar，引入全局样式搭建行内文本，输入框，文本组件页面。 305、辅助：使用全局组件TitleBar，引入全局样式搭建标记组件页面。 31通用模块： 321、通用事件：用到全局组件TitleBar，全局样式实现点击事件组件页面。 332、通用属性：使用全局组件TitleBar，全局样式实现组件页面，使用Math.trunc()方法将参数隐式转换成数字类型后，纯粹的去除小数部分。 34动画模块： 351、转场动画：用到全局组件TitleBar实现动画转场组件页面。 36全局方法模块： 37弹窗：使用全局组件TitleBar，全局样式实现弹窗组件页面。 38##### 约束与限制 39开发语言：ArkTS 40 41配套版本：API10版本SDK，版本号：4.0.10.1 42 43[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/UI/ArkTsComponentCollection/ComponentCollection) 44 45#### 横竖屏切换 46##### 介绍 47本示例展示如何使用媒体查询，通过[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md) 接口完成在不同设备上显示不同的界面效果。 48##### 使用 491.在竖屏设备上，首页展示新闻列表，点击新闻进入详情界面。 50 512.在横屏设备上，首页左侧展示新闻列表，右侧显示新闻详情，点击新闻右侧显示所点击的新闻的详情。 52##### 基本原理 53横竖屏切换功能接口封装在Index，获取监听句柄：通过mediaQuery.matchMediaSync('screen and (min-aspect-ratio: 1.5) or (orientation: landscape)')方法来获取有一个监听横竖屏的句柄，执行控制横竖屏切换效果的函数：调用this.listener.on('change', this.onLand.bind(this))函数来实现横竖屏下不同的功能或者页面效果; 54 55##### 约束与限制 56开发语言：ArkTS 57 58配套版本：API9版本SDK，版本号：3.2.11.9 59 60[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/UI/ArkTsComponentCollection/MediaQuery) 61 62#### 状态管理 63##### 介绍 64本示例通过使用[页面级的状态变量](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Fquick-start%2Farkts-localstorage.md%2F) 和[应用级的状态变量](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Fquick-start%2Farkts-appstorage.md%2F) 来实现应用的状态管理。展示内容包括修饰的对象类型、父子组件之间的状态同步、爷孙组件之间的状态同步以及兄弟组件之间的状态同步。 65##### 使用 661.点击首页的切换按钮，可切换List和Grid布局。 67 682.点击食物单元，可跳转到食物详情页。 69##### 基本原理 70List布局：通过创建食物数据模型，ForEach循环渲染ListItem。 71 72Grid布局：通过展示食物分类信息，创建Tabs页签展示不同分类的食物。 73 74路由机制：通过@ohos.router接口、Navigator和页面间数据传递。 75##### 约束与限制 76开发语言：ArkTS 77 78配套版本：API9版本SDK，版本号：4.0.5.2 79 80[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/UI/ArkTsComponentCollection/StateManagement) 81 82#### 页面布局和连接 83##### 介绍 84本示例构建食物分类列表页面和食物详情页，包含： 85 861.[List](reference/arkui-ts/ts-container-list.md)布局：创建食物数据模型，ForEach循环渲染ListItem。 87 882.[Grid](reference/arkui-ts/ts-container-grid.md)布局：展示食物分类信息，创建Tabs页签展示不同分类的食物。 89 903.路由机制：[@ohos.router](reference/apis/js-apis-router.md)接口、[Navigator](reference/arkui-ts/ts-container-navigator.md)和页面间数据传递。 91##### 使用 921.点击首页的切换按钮，可切换List和Grid布局。 93 942.点击食物单元，可跳转到食物详情页。 95##### 基本原理 96List布局：通过创建食物数据模型，ForEach循环渲染ListItem。 97 98Grid布局：通过展示食物分类信息，创建Tabs页签展示不同分类的食物。 99 100路由机制：通过@ohos.router接口、Navigator和页面间数据传递。 101##### 约束与限制 102开发语言：ArkTS 103 104配套版本：API9版本SDK，版本号：3.2.12.5 105 106[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/UI/ArkTsComponentCollection/DefiningPageLayoutAndConnection) 107 108### 类Web开发范式 109 110#### JS组件集合 111##### 介绍 112本示例为ArkUI中组件、通用、动画、全局方法的集合。示例使用 [Tabs容器组件](reference/arkui-js/js-components-container-tabs.md)搭建整体应用框架，每个 [TabContent内容视图](reference/arkui-js/js-components-container-tab-content.md) 使用 [div容器组件](reference/arkui-js/js-components-container-div.md) 嵌套布局，在每个 [div](reference/arkui-js/js-components-container-div.md) 中使用 [循环渲染](reference/arkui-js/js-components-common-attributes.md) 加载此分类下分类导航数据，底部导航菜单使用 [TabContent中tabBar属性](reference/arkui-js/js-components-container-tab-content.md) 设置自定义样式 。通过组件、通用、动画、全局方法四个大类展现了ArkUI的能力，并把四大类中的功能进行了分类，方便开发者查看，每个示例又结合了不同的展现方式，以契合实际应用场景为主生动的体现了ArkUI能力的用法。 113##### 使用 1141.点击组件、通用、动画、全局方法四个按钮或左右滑动切换不同Tab内容。 115 1162.点击二级导航（如通用属性、通用事件等），若存在三级导航则展开三级导航（如Border 边框、点击事件等）；若不存在三级导航，则点击跳转详情页面。 117 1183.若存在三级导航，点击三级导航则跳转详情页面。 119##### 基本原理 120示例使用 [Tabs容器组件](reference/arkui-ts/ts-container-tabs.md) 搭建整体应用框架，每个 [TabContent内容视图](reference/arkui-ts/ts-container-tabcontent.md) 使用 [List容器组件](reference/arkui-ts/ts-container-list.md) 布局，在每个 [ListItem](reference/arkui-ts/ts-container-listitem.md) 中使用 [循环渲染](quick-start/arkts-rendering-control-foreach.md) 加载此分类下分类导航数据，底部导航菜单使用 [TabContent中tabBar属性](reference/arkui-ts/ts-container-tabcontent.md) 设置自定义样式 。 121将组件库分成四大类： 122组件模块： 1231、空白与分隔：使用全局组件TitleBar，CommonItemSlider，CommonItemSelect，引入全局样式搭建分隔器组件页面。 1242、按钮与选择：使用全局组件TitleBar，引入全局样式搭建按钮，日期选择器，单选按钮，选择菜单，滑动条，切换按钮组件页面。 1253、信息展示与功效：使用全局组件TitleBar，引入全局样式搭建二维码组件页面。 1264、文本与输入：使用全局组件TitleBar，引入全局样式搭建行内文本，输入框，文本组件页面。 1275、辅助：使用全局组件TitleBar，引入全局样式搭建标记组件页面。 128通用模块： 1291、通用事件：用到全局组件TitleBar，全局样式实现点击事件组件页面。 1302、通用属性：使用全局组件TitleBar，全局样式实现组件页面，使用Math.trunc()方法将参数隐式转换成数字类型后，纯粹的去除小数部分。 131动画模块： 1321、转场动画：用到全局组件TitleBar实现动画转场组件页面。 133全局方法模块： 134弹窗：使用全局组件TitleBar，全局样式实现弹窗组件页面。 135##### 约束与限制 136开发语言：JS 137 138配套版本：API9版本SDK，版本号：3.2.11.9 139 140[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/UI/JsComponentCollection/JsComponentCollection) 141 142## 基础特性 143 144### 应用模型 145 146#### Ability的启动模式 147##### 介绍 148本示例展示了在一个Stage模型中，实现standard、singleton、specified多种模式场景。 149##### 使用 1501、standard模式： 151 1521）进入首页，点击番茄，会新建一个番茄的Ability，展示番茄的详情； 153 1542）在番茄的详情界面，点击黄瓜，会新建一个黄瓜的Ability，展示黄瓜的详情； 155 1563）使用aa工具查看Ability信息，此时存在以下Ability：1个番茄的Ability、1个黄瓜的Ability、1个首页的Ability； 157 1582、singleton模式： 159 1601）进入首页，点击冰淇凌，会新建一个冰淇凌的Ability，展示冰淇凌的详情； 161 1622）在冰淇凌的详情界面，点击螃蟹，会复用冰淇凌的Ability，页面数据会刷新并展示螃蟹的详情； 163 1643）使用aa工具查看Ability信息，此时存在以下Ability：1个冰淇凌的Ability、1个首页Ability； 165 1663、specified模式： 167 1681）进入首页，点击核桃，会新建一个核桃的Ability，展示核桃的详情； 169 1702）在核桃的详情界面，点击蓝莓，会新建一个蓝莓的Ability，展示蓝莓的详情； 171 1723）在蓝莓的详情界面，点击核桃，会复用已存在的核桃的Ability，实现specified模式下的单实例特性，页面数据会刷新并展示核桃的详情； 173 1744）使用aa工具查看Ability信息，此时存在以下Ability：1个核桃的Ability、1个蓝莓的Ability、1个首页Ability； 175##### 基本原理 176本示例启动standard、singleton、specified三种模式的方法主要封装在Util当中。 177新建Ability：创建三个代表standard、singleton、specified模式的Ability，如工程目录中的SingletonAbility、SpecifiedAbility、StandardAbility，并在module.json文件中将launchType属性修改为对应的启动模式属性。 178启动指定Ability：通过Util中的startMode函数根据页面所传的abilityName，启动对应的ability并进入详情页面。 179specified多实例功能实现：specified模式则是根据MyAbilityStage中的onAcceptWant函数给用户返回一个ability标识，如果之前启动过标识的ability，不创建新的实例并拉回栈顶，否则创建新的实例并启动。 180##### 约束与限制 181开发语言：ArkTS 182 183配套版本：API9版本SDK，版本号：3.2.11.9 184 185[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/ApplicationModels/AbilityStartMode) 186 187#### 自定义分享 188##### 介绍 189自定义分享主要是发送方将文本，链接，图片三种类型分享给三方应用,同时能够在三方应用中展示。本示例使用[数据请求](reference/apis/js-apis-http.md) 实现网络资源的获取，使用[屏幕截屏](reference/apis/js-apis-screenshot.md) 实现屏幕的截取，使用[文件管理](reference/apis/js-apis-fileio.md) 实现对文件，文件目录的管理，使用[媒体库管理](reference/apis/js-apis-medialibrary.md) 获取截取的图片，使用[弹窗](reference/apis/js-apis-promptAction.md) 进行信息的提示。 190##### 使用 191使用说明： 192 1931.启动Share应用，首页展示分享跳转页面，点击分享按钮出现自定义分享弹窗（三方APP的）。 194 1952.点击分享文本+链接，选择"Chat"图标，会拉起三方应用Chat ，此时选择聊天列表 中任意的朋友进行分享。 196 1973.点击生成海报，此时第一层弹窗消失并出现新的弹窗，点击截图并分享，会出现小提示"截图成功，分享加载中..." ,稍后会拉起三方应用Chat ，此时选择聊天列表 中任意的朋友进行分享。 198 1994.安装entry以及textShare两个module的hap包 ，点击分享文本+链接，选择"文本分享"图标，会拉起应用文本分享 ,此时选择"留在文本分享"可以进入文本页面 ,若选择"返回"，则会回到Share应用主页面。 200 2015.安装entry以及textEdit两个module的hap包 ，点击分享文本+链接，选择"文本编辑"图标，会拉起应用文本编辑 ,此时选择"留在文本编辑"可以进入文本编辑页面 ,若选择"返回"，则会回到Share应用主页面。 202##### 基本原理 203本示例分为链接分享，应用内文件分享，其它应用分享三个模块： 2041、文本+链接分享模块：ButtonDialogBuilder方法展示自定义分享弹窗，@ohos.abilityAccessCtrl接口获取访问控制权限，@ohos.net.http接口获取网络资源。 2052、应用内文件分享模块：使用弹窗，屏幕截屏(截取屏幕)，文件管理(管理文件和文件目录)和媒体库管理(获取截取的图片)接口进行图片、链接，视频的分享。 2063、其他应用分享模块：使用弹窗，屏幕截屏(截取屏幕)，文件管理(管理文件和文件目录)和媒体库管理(获取截取的图片)API，把图片，链接，文件在其他应用内分享。 207本示例还包含文本分享应用及文本编辑应用： 2081、在Index.ets中加载TemplateBuilder自定义组件并显示分享信息,在加载Index页面中，如果是被分享方拉起，则加载TemplateBuilder自定义组件。若不是被分享拉起，则显示Ability设置内容。 2092、TemplateBuilder组件内容封装在TemplateBuilder.ets中，在TemplateBuilder组件中包含ShareExtAbility组件、“返回Share”和“留在文本分享/留在文本编辑”按钮，可选择返回Share应用或留在当前（文本分享/文本编辑）应用。 210##### 约束与限制 211开发语言：ArkTS 212 213配套版本：API10版本SDK，版本号：4.0.10.1 214 215[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/ApplicationModels/CustomShare) 216 217#### Stage模型 218##### 介绍 219[Stage模型](reference/apis/js-apis-app-ability-abilityStage.md) 的设计，主要是为了解决FA模型无法解决的开发场景问题，基于应用的能力与系统总体功能和功耗的平衡、原生支持组件级的迁移和协同、支持多设备和多窗口形态的特点这三个出发点，从而让开发者更加方便地开发出分布式环境下的复杂应用。 220##### 使用 2211.点击DataShareExtAbility按钮，跳转到DataShareExtAbility页面； 222 223点击**+**，向rdb数据库中添加单个数据，界面显示添加的数据内容； 224 225点击删除按钮删除指定数据； 226 227点击数据列表，弹出dialog框，可对数据进行修改，点击确认按钮确认修改； 228 229点击返回键，返回首页。 230 2312.点击各个功能按钮测试各个接口。 232##### 基本原理 233本示例主要展示Stage模型与FA模型的区别，分别从AbilityContext、ServiceExtensionContext、 FormExtensionContext、DataShareExtensionAbility、FormExtension、Bundle、Window、abilityAccessCtrl等模块进行介绍。 2341、应用的能力与系统总体功能和功耗的平衡。 2352、原生支持组件级的迁移和协同。 2363、支持多设备和多窗口形态的特点。 237##### 约束与限制 238开发语言：ArkTS 239 240配套版本：API10版本SDK，版本号：4.0.9.6 241 242[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/ApplicationModels/StageModel) 243 244### 网络与连接 245 246#### 蓝牙 247##### 介绍 248本示例通过使用蓝牙低功耗心率服务，结合[bluetooth](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-bluetooth.md%2F) 来接收BLE心率设备发送的心率数据，并使用画布[Canvas](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Farkui-ts%2Fts-components-canvas-canvas.md%2F) 来绘制实时心率图来展示蓝牙相关API用法。 249##### 使用 2501.启动应用后，弹出是否允许应用访问位置信息，点击允许后开始操作。 2512.点击界面中搜索设备，如未开启蓝牙会自动开启并搜索心率设备，如已开启直接搜索设备。 2523.点击连接按钮可以连接到对应的蓝牙心率设备。 2534.点击列表Item可以进入实时心率图查看页面。 2545.点击实时心率图页断开连接可以断开与当前心率设备的连接。 255##### 基本原理 2561.首页扫描蓝牙心率设备：使用bluetooth 来实现蓝牙的开启和BLE的扫描，然后再使用一个List显示扫描到BLE心率设备，点击连接按钮可以连接上对应的心率设备。 2572.实时心率图页：使用bluetooth 来接收心率设备发送的心率数据，并使用画布Canvas 来绘制实时心率图，点击断开连接可以断开与当前心率设备的连接。 258##### 约束与限制 259开发语言：ArkTS 260 261配套版本：API9版本SDK，版本号：3.2.12.1 262 263[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/Bluetooth) 264 265#### Http 266##### 介绍 267本示例通过[@ohos.net.http](reference/apis/js-apis-http.md) 等接口，实现了根据URL地址和相关配置项发起http请求的功能。 268##### 使用 2691.启动应用可配置网络请求，设置网址、请求方式、请求参数； 270 2712.点击确认按钮，跳转请求结果页面； 272 2733.点击返回按钮，返回配置页面； 274 2754.支持将本示例中的http模块编译成tgz包。 276##### 基本原理 277本示例将发送http请求的接口封装在Http模块。 278发起请求：在MainPage.ets中通过TextInput组件获取参数，点击“确认”按钮后通过Http.request()方法调用http.createHttp().request()接口向指定的地址发送请求。 279##### 约束与限制 280开发语言：ArkTS 281 282配套版本：API10版本SDK，版本号：4.0.9.6 283 284[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/Http) 285 286#### RPC连接 287##### 介绍 288本示例使用[@ohos.rpc](reference/apis/js-apis-rpc.md) 相关接口，实现了一个前台选择商品和数目，后台计算总价的功能，使用rpc进行前台和后台的通信。 289##### 使用 2901.点击商品种类的空白方框，弹出商品选择列表，选择点击对应的商品，空白方框显示相应内容。 291 2922.点击商品选择框后的 + 或 - 按钮，选择商品所对应的数量。 293 2943.点击 Confirm an order 按钮，根据相应的菜品数量与单价，计算出总价并显示。 295##### 基本原理 2961.发送数据：在首页的sortString()中通过rpc.MessageSequence.create()创建MessageSequence对象，然后通过MessageSequence.writeStringArray()将 我们的处理过的购物数据写入MessageSequence对象中，通过rpc.RemoteObject.sendMessageRequest()将我们得出总价所需要的参数发送到进程中; 297 2982.读取数据：处理MessageRequest请求的接口封装在ReceivedData里面，在这里接收传递来的数据，然后经过处理得出总价，并通过rpc.MessageParcel.writeInt()写入MessageParcel对象。 299##### 约束与限制 300开发语言：ArkTS 301 302配套版本：API9版本SDK，版本号：3.2.11.9 303 304[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/RPC) 305 306#### 网络管理-Socket连接（UDP） 307##### 介绍 308本示例主要使用面向非连接的协议UDP Socket，展示Socket在两端设备的连接验证、聊天通信方面的应用。 309##### 使用 3101.搭建服务器环境：修改服务器脚本中的服务端IP地址，与本机IP地址保持一致，修改完成后双击运行脚本（端口号不必修改，与客户端工程中的端口保持一致即可）。 3112.运行成功后为阻塞状态，等待客户端连接成功后会有相应提示。 3123.打开应用，点击用户选择框选择要登录的用户（不同客户端保持用户选择不一致），点击协议选择框选择通信协议（与运行的服务器一致），并输入另一个设备的IP地址(如果是TCP和TLS，则输入服务端IP地址)，点击登录按钮进入创建房间用户页面（两个设备都要依次执行此步骤）。 3134.在两台设备都成功连上服务器后，在其中一个设备上点击创建房间按钮，任意输入房间号，另一个设备会收到邀请进入房间的信息弹框，点击确定按钮后，两个设备进入聊天页面。 3145.在其中一个设备上输入聊天信息并点击发送按钮后，另一个设备的聊天页面会收到该聊天消息。 3156.点击顶部标题栏左侧的返回图标按钮，则返回创建房间页面。 3167.以上运行完成后如需再次创建房间请重启客户端和服务端进行调试。 317##### 基本原理 3181.UDP Socket：使用UDP Socket实现文本传输，无需搭建服务器，对端直接交流。 3192.TCP Socket：使用TCP Socket实现文本传输和公共通知事件转发，需要Python脚本搭建TCP服务器，公共通知用于来起音频通话应用。 3203.TLS Socket：使用TLS Socket实现文本传输，需要Python脚本搭建TLS服务器，服务器和客户端需要同一套证书文件。 321##### 约束与限制 322开发语言：ArkTS 323 324配套版本：API9版本SDK，版本号：3.2.11.9 325 326[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/Socket) 327 328#### 网络管理-Socket连接 329##### 介绍 330本示例主要设计三种协议方式：UDP Socket、TCP Socket以及TLS Socket，展示在使用不同协议时，Socket在两端设备的连接验证、聊天通信方面的应用。 331##### 使用 3321.打开应用，点击用户文本框选择要登录的用户，并输入另一个设备的IP地址，点击确定按钮进入已登录的用户页面（两个设备都要依次执行此步骤）。 333 3342.在其中一个设备上点击创建房间按钮，任意输入房间号，另一个设备会收到有房间号信息的弹框，点击确定按钮后，两个设备进入聊天页面。 335 3363.在其中一个设备上输入聊天信息并点击发送按钮后，另一个设备的聊天页面会收到该聊天消息。 337 3384.点击顶部标题栏右侧的退出图标按钮，则返回已登录的用户页面。 339 3405.点击聊天页面中的昵称栏，会弹出一个菜单，选择离线选项后，两端设备的状态图标都会切换为离线图标，并且昵称栏都会变成灰色，此时任何一端发送消息另一端都接收不到消息。 341 3426.当点击昵称栏再次切换为在线状态，则两端的己方账号状态会切换为在线图标，同时两端的昵称栏会显示蓝色，此时可正常收发消息。 343##### 基本原理 344本示例分为三个模块 3451.输入对端IP模块:使用wifi.getIpInfo()方法获取IP地址，constructUDPSocketInstance方法创建一个UDPSocket对象。 3462.创建房间模块：点击创建房间按钮，弹出创建房间框，输入房间号，点击确定，进入聊天页面。 3473.聊天模块：bindOption方法监听消息，设置在线与离线。 348##### 约束与限制 349开发语言：ArkTS 350 351配套版本：API9版本SDK，版本号：3.2.11.10 352 353[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/StageSocket) 354 355#### 上传和下载 356 357##### 介绍 358 359本示例使用[@ohos.request](reference/apis/js-apis-request.md)接口创建上传和下载任务，实现上传、下载功能，hfs作为服务器，实现了文件的上传和下载和任务的查询功能。 360 361##### 使用 3621.本示例功能需要先配置服务器环境后使用，具体配置见[上传下载服务配置](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/UploadAndDownLoad/environment)。 363 3642.首页展示上传和下载两个入口组件，点击进入对应的页面，如果要使用后台下载任务，请开启后台任务开关。 365 3663.上传页面： 367 368 点击 **+** ，**从相册选择**拉起图库选择照片，图片选择页面支持拍照，选择照片后点击**上传**进行上传。 369 370 可选的，点击缩略图，显示文件片段上传配置选项弹窗，可以配置上传起点和终点，取值为闭区间；起点默认为0，终点默认为文件结尾。点击**上传**进行选中文件片段以及后续文件全部内容上传。 371 372 点击**返回**键或片段上传配置选项弹窗外区域，取消片段上传。 373 374 在首页中打开后台任务开关后，上传页面开启的是后台上传任务，后台任务在应用退出到后台时可以在通知栏看到任务状态。 375 3764.下载页面： 377 378 点击文件列表选择要下载的文件后，点击**下载**选择指定路径后开始下载。 379 380 点击**查看下载文件**进入下载文件页面，点击文件夹查看文件夹内的文件。 381 382 在首页中打开后台任务开关后，下载页面开启的是后台下载任务，后台任务在应用退出到后台时可以在通知栏看到任务状态。 383 384 前台下载时只支持单文件下载，后台下载时支持选择多个文件下载。 385##### 基本原理 386 387* 该示例分为两个模块： 388 * 上传模块 389 * 使用[@ohos.request](reference/apis/js-apis-request.md)中API 10接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，失败的任务会调用查询接口获取失败原因并打印在日志中，支持多个文件上传及片段上传。 390 * 参考接口：[@ohos.request](reference/apis/js-apis-request.md)，[@ohos.file.picker](reference/apis/js-apis-file-picker.md) 391 * 下载模块 392 * 使用[@ohos.request](reference/apis/js-apis-request.md)中API 10接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，失败的任务会调用查询接口获取失败原因并打印在日志中，前台下载任务只支持单个文件下载，后台下载任务支持多文件下载。使用[@ohos.file.fs](reference/apis/js-apis-file-fs.md)完成指定路径的创建和查询已下载的文件。 393 * 参考接口：[@ohos.request](reference/apis/js-apis-request.md)，[@ohos.file.fs](reference/apis/js-apis-file-fs.md) 394 395##### 约束与限制 396 397开发语言：ArkTS 398 399配套版本：API10版本SDK，版本号：4.0.8.5 400 401[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/UploadAndDownLoad) 402 403#### WebSocket 404 405##### 介绍 406 407本示例展示了[WebSocket](reference/apis/js-apis-webSocket.md)的使用，包括客户端与服务端的连接和断开以及客户端数据的接收和发送。 408 409##### 使用 410 4111.输入服务器IP地址，点击**绑定服务器IP地址**按钮，即可绑定该IP并退出弹框，如果要解绑IP，重启应用即可。 412 4132.点击顶部栏的**连接**按钮，按钮颜色从灰色变为绿色，即可与服务器建立WebSocket连接，并开始监听服务器发来的消息。 414 4153.在底部消息输入框输入消息，点击**发送**按钮，即可收到来自服务端的消息回馈。 416 4174.再次点击顶部栏的**连接**按钮，按钮颜色从绿色重新变成灰色，即可与服务器断开连接，接收不到服务器发来的消息。 418 4195.重新连接需要退出应用重新绑定ip，再次点击连接才可以发送接收消息。 420 421##### 基本原理 422 423* 本示例分为两大模块 424 * 客户端与服务端的连接和断开模块 425 * BindServiceIP方法输入服务器IP地址，socket.connect方法绑定服务器，进入消息框页面，socket.on方法连接服务器，socket.off方法断开连接 426 * 接口参考：[@ohos.prompt](reference/apis/js-apis-promptAction.md)，[@ohos.net.webSocket](reference/apis/js-apis-webSocket.md) 427 428 * 客户端数据的接收和发送模块 429 * TopBar组件搭建通讯页面，socket.send方法发送信息数据。 430 * 接口参考：[@ohos.prompt](reference/apis/js-apis-promptAction.md)，[@ohos.net.webSocket](reference/apis/js-apis-webSocket.md) 431 432##### 约束与限制 433 434开发语言：ArkTS 435 436配套版本：API9版本SDK，版本号：3.2.12.1 437 438[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/WebSocket) 439 440### DFX 441 442#### 应用故障恢复 443 444##### 介绍 445 446本示例展示了在应用中如何适配故障恢复相关接口。示例包括一下场景：单Ability自动恢复、多Ability自动恢复、多Ability主动恢复、Ability后台强制终止恢复。 447 448##### 使用 449 450一.单Ability自动恢复 \ 451点击首页点击``跳转到故障触发页面`` \ 452在故障触发页面点击按钮``点击``，再点击``保存当前Ability状态``以及``触发JsError``。 \ 453以上场景预期：\ 454能够回到``故障触发页面``页面，页面上的点击次数与触发保存状态时的一致。 455 456二.多Ability自动恢复 \ 457点击首页点击跳转到``故障触发页面`` \ 458在``故障触发页面``点击``启动SecondAbility`` 459点击首页点击``跳转到故障触发页面`` \ 460在故障触发页面点击按钮``点击``，再点击``保存当前Ability状态``以及``触发JsError``。 \ 461以上场景预期：\ 462立即回到SecondAbility的故障触发页面，并恢复页面的点击次数信息。\ 463从任务管理中将EntryAbility切回前台，预期能回到故障触发页面，页面上的点击次数与触发保存状态时的一致。 464 465三.多Ability主动恢复 \ 466点击首页点击跳转到``故障触发页面`` \ 467在``故障触发页面``点击``启动SecondAbility`` 468在SecondAbility的故障触发页面点击设置重启Ability。 \ 469在SecondAbility的故障触发页面点击``触发JsError``。 \ 470以上场景预期：\ 471重启时启动RecoveryAbility。 472 473四.Ability后台强制终止恢复 \ 474点击首页点击跳转到``故障触发页面`` \ 475在``故障触发页面``点击``启动SecondAbility`` 476在SecondAbility的故障触发页面点击Counter，点击``保存当前Ability状态``,并切入后台 \ 477使用kill命令强制终止当前应用 \ 478以上场景预期：\ 479从任务管理中将EntryAbility切回前台，预期能回到故障触发页面，并恢复页面上的点击次数信息。\ 480从任务管理中将SecondAbility切回前台，预期能回到故障触发页面，并恢复页面上的点击次数信息。 481 482为避免反复拉起，两次测试的间隔至少为60秒(自动拉起的间隔为60秒)。 483 484##### 基本原理 485 486* 使能应用恢复功能 487 * 在``onCreate``中 调用[appRecovery](dfx/apprecovery-guidelines.md)接口使能功能 488* 配置支持恢复的Ability 489 * 在``Ability``的节点中增加``recoverable``的配置，并设置为``true`` 490* 实现恢复功能 491 * 在``onSaveState``中保存用于恢复的数据 492 * 在``onCreate``的``want``参数中恢复所需要的数据 493 494##### 约束与限制 495 496开发语言：ArkTS 497 498配套版本：API10版本SDK，版本号：4.0.8.5 499 500[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/AppRecovery) 501 502#### Debug 503 504##### 介绍 505 506本示例通过使用[@ohos.hidebug](reference/apis/js-apis-hidebug.md) 接口来获取应用进程实际使用的物理内存大小、进程的共享脏内存大小、进程的私有脏内存大小等内存使用情况。 507 508##### 使用 509 5101.点击界面右上方Debug图标，弹出Debug信息界面，显示当前应用内存使用情况； 511 5122.再次点击右上方Debug图标，Debug信息界面消失。 513 514##### 基本原理 515 516* 本实例获取Debug信息的功能结主要封装在Index。 517 * 获取Debug信息：在Index页面中通过点击事件调用hidebug.getPss()、hidebug.getSharedDirty()、hidebug.getPrivateDirty()等方法能够获取应用进程实际使用的物理内存大小、进程的共享脏内存大小、进程的私有脏内存大小。 518 519##### 约束与限制 520 521开发语言：ArkTS 522 523配套版本：API9版本SDK，版本号：3.2.11.9 524 525[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/Debug) 526 527#### 测试打点 528 529##### 介绍 530 531本示例展示了在eTS中如何获取应用故障相关信息，测试打点包括应用打点与性能打点两部分，应用打点通过调用[@ohos.hiAppEvent](reference/apis/js-apis-hiappevent.md)接口来记录应用运行过程中发生的各种信息。 532 533##### 使用 534 5351.点击"事件写入"按钮，显示成功写入事件。 536 5372.打开"禁用应用打点"开关，再次点击"事件写入"按钮，显示事件写入失败。 538 5393.关闭"禁用应用打点"开关，再次点击"事件写入"按钮，显示事件写入成功。 540 541##### 基本原理 542 543* 该示例使用hiAppEvent接口中write方法将事件写入到当天的事件文件中，EventType方法枚举事件类型，configure方法去配置打点开关来实现测试打点。 544* 接口参考：[@ohos.hiAppEvent](reference/apis/js-apis-hiappevent.md) 545 546##### 约束与限制 547 548开发语言：ArkTS 549 550配套版本：API9版本SDK，版本号：3.2.11.9 551 552[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/DotTest) 553 554#### 故障日志获取 555 556##### 介绍 557 558本示例使用了[@ohos.faultLogger](reference/apis/js-apis-faultLogger.md)接口，展示在eTS中如何获取js_crash故障、cpp_crash故障、freeze_crash故障等不同场景下应用故障相关信息。 559 560##### 使用 561 5621. 启动应用后，点击**构造异常**按钮，在弹窗中选择故障类型，点击确定可以构造异常场景; 5632. 构造异常场景后，重新启动应用，点击下面不同的获取异常按钮可以获取到对应类型的异常日志并显示在页面文本框中。 564 565##### 基本原理 566 567+ 创造应用故障场景，故障类型枚举值参考[faultType](reference/apis/js-apis-faultLogger.md#faulttype)： 568 + js_crash故障：通过数组访问越界构造; 569 + cpp_crash故障：通过调用不存在的Api接口构造; 570 + freeze_crash故障：通过代码产生死循环构造; 571+ 获取上述异常故障日志,源码参考： 572 + 获取异常故障日志：使用faultLogger.query接口获取异常日志信息。 573 574##### 约束与限制 575 576开发语言：ArkTS 577 578配套版本：API9版本SDK，版本号：3.2.11.9 579 580[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/FaultLogger) 581 582#### 日志打印 583 584##### 介绍 585 586本示例使用[hilog日志系统](reference/apis/js-apis-hilog.md) ，提供日志打印类，使应用/服务可以按照指定级别、标识和格式字符串输出日志内容，帮助开发者了解应用/服务的运行状态，更好地调试程序。 587 588##### 使用 589 5901.进入应用会自动生成一个空的日志文件。 591 5922.点击log按钮即可输出日志，并将日志生成到日志文件当中。 593 594##### 基本原理 595 596+ 日志输出功能封装在Logger: 597 + 日志输出：Logger类根据Configure的types参数将日志分为三个类型，其中file类型会将日志写入本地文件，console类型调用ConsoleLoggerStrategy类输出，hilog类型调用HilogLoggerStrategy类输出; 598 + 日志文件写入本地：FileLoggerStrategy类使用[@ohos.file.fs](reference/apis/js-apis-file-fs.md) 将日志写入本地文件中，本示例只是展示了文件写入文件操作的使用方法，在实战场景中，建议把耗时操作放入子线程中运行。 599 600##### 约束与限制 601 602开发语言：ArkTS 603 604配套版本：API9版本SDK，版本号：3.2.11.9 605 606[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/Logger) 607 608### 数据管理 609 610#### 首选项 611 612##### 介绍 613 614本示例使用[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md) 接口，展示了使用首选项持久化存储数据的功能。 615 616##### 使用 617 6181.点击顶部titleBar的右侧**切换**按钮，弹出主题菜单，选择任意主题则切换相应的主题界面； 619 6202.退出应用再重新进入，显示上一次退出前的主题界面。 621 622##### 基本原理 623 624* 切换主题：在首页预先设置好几套主体数据，使用preferences.getPreferences获取使用Preferences对象，调用Preferences.get() 625读取缓存中的参数，得到当前应该展示哪一套主体。每次点击切换按钮都会调用Preferences.put()来重新修改参数，然后使用 626Preferences.flush()保存并刷新文件内容。 627 628##### 约束与限制 629 630开发语言：ArkTS 631 632配套版本：API9版本SDK，版本号：3.2.11.9 633 634[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DataManagement/Preferences) 635 636### 设备管理 637 638#### 设备管理合集（非系统特性） 639 640##### 介绍 641 642本示例集合设备管理相关（非系统特性）不需要复杂功能展示的模块，展示了各个模块的基础功能，包含： 643 644- [@ohos.batteryInfo (电量信息)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-battery-info.md%2F) 645- [@ohos.charger (充电类型)](reference/apis/js-apis-charger.md) 646- [@ohos.deviceInfo (设备信息)](reference/apis/js-apis-device-info.md) 647- [@ohos.power (系统电源管理)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-power.md%2F) 648- [@ohos.runningLock (Runninglock锁)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-runninglock.md%2F) 649- [@ohos.settings (设置数据项名称)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-settings.md%2F) 650- [@ohos.stationary (设备状态感知框架)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-stationary.md%2F) 651- [@ohos.thermal (热管理)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-thermal.md%2F) 652- [@ohos.usbManager (USB管理)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-usbManager.md%2F) 653- [@ohos.multimodalInput.inputConsumer (组合按键)](reference/apis/js-apis-inputconsumer.md) 654- [@ohos.multimodalInput.inputDevice (输入设备)](reference/apis/js-apis-inputdevice.md) 655- [@ohos.multimodalInput.inputEvent (输入事件)](reference/apis/js-apis-inputevent.md) 656- [@ohos.multimodalInput.inputEventClient (按键注入)](reference/apis/js-apis-inputeventclient.md) 657- [@ohos.multimodalInput.inputMonitor (输入监听)](reference/apis/js-apis-inputmonitor.md) 658- [@ohos.multimodalInput.keyCode (键值)](reference/apis/js-apis-keycode.md) 659- [@ohos.multimodalInput.keyEvent (按键输入事件)](reference/apis/js-apis-keyevent.md) 660- [@ohos.multimodalInput.mouseEvent (鼠标输入事件)](reference/apis/js-apis-mouseevent.md) 661- [@ohos.multimodalInput.pointer (鼠标指针)](reference/apis/js-apis-pointer.md) 662- [@ohos.multimodalInput.touchEvent (触摸输入事件)](reference/apis/js-apis-touchevent.md) 663 664##### 使用 665 6661.首页展示语言基础类库各个子模块菜单，点击进入对应的模块页面。 667 6682.各个子模块界面中点击功能按钮完成各个功能。 669 6703.电量信息：进入电量信息页面，展示设备电量相关信息。 671 6724.RunningLock锁：点击按钮分别实现设备支持的休眠锁类型、设置屏幕休眠时间功能、设置是否通过接近或者远离状态来控制亮灭屏的锁功能。 673 6745.系统电源管理：点击按钮分别实现获取亮灭屏状态、获取电源模式功能。 675 6766.设置数据项名称：点击按钮分别实现获取数据项uri、开关飞行模式、检查应用是否能以悬浮形式显示功能。 677 6787.设备状态感知框架：点击按钮分别实现订阅设备状态服务、取消订阅设备状态服务、查询设备状态并显示功能。 679 6808.热管理：进入热管理页面，展示当前设备热档位信息、设备过热时提示用户。 681 6829.USB管理：打开监听开关后插入USB设备，会有提示并刷新设备列表，关闭监听后插入USB设备不会提示和自动刷新，下拉设备列表可以手动刷新设备列表。 683 684##### 基本原理 685 6861.首页菜单展示：使用一个module，menuitems完成菜单组件的实现，传入要展示的菜单的strarray类型的资源和菜单点击对应的组件即可。使用Navigation和NavRouter组件实现菜单点击进入功能界面，使用LocalStorage实现应用内Ability内数据共享，点击菜单时标记selectedLabel，在entry中的Capabilities组件中，通过selectedLabel显示对应的功能组件。 687 6882.电量信息：使用[@ohos.batteryInfo.d.ts](reference/apis/js-apis-battery-info.md) 689接口获取电池和充放电状态信息。 690 6913.RunningLock锁：使用[@ohos.runningLock.d.ts](reference/apis/js-apis-runninglock.md) 692实现对Runninglock锁的创建、查询、持锁、释放等操作。 693 6944.系统电源管理：使用[@ohos.power.d.ts](reference/apis/js-apis-power.md) 695实现获取亮灭屏状态、查询电源模式功能。 696 6975.设置数据项名称：使用[@ohos.settings.d.ts](reference/apis/js-apis-settings.md) 698实现获取获取数据项uri、开关飞行模式、检查应用是否能以悬浮窗形式显示功能。 699 7006.设备状态感知框架：使用[@ohos.stationary.d.ts](reference/apis-multimodalawareness-kit/js-apis-stationary.md) 701接口提供设备状态感知能力。 702 7037.热管理：使用[@ohos.thermal.d.ts](reference/apis/js-apis-thermal.md) 704提供热管理相关的接口，查询热档位以及注册温控等级回调。 705 7068.USB管理：使用[@ohos.usbManager.d.ts](reference/apis/js-apis-usbManager.md) 707实现usb设备列表的获取，使用[@ohos.commonEventManager.d.ts](reference/apis/js-apis-commonEventManager.md) 708订阅USB设备插入和拔出监听。 709 710##### 约束与限制 711 712开发语言：ArkTS 713 714配套版本：API10版本SDK，版本号：4.0.9.6 715 716[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/DeviceManagementCollection) 717 718#### 位置信息 719 720##### 介绍 721 722本示例使用 [geolocation](reference/apis/js-apis-geolocation.md) 实现获取当前位置的经纬度，然后通过 [http](reference/apis/js-apis-http.md) 将经纬度作为请求参数，获取到该经纬度所在的城市。通过 [AlphabetIndexer](reference/arkui-ts/ts-container-alphabet-indexer.md) 容器组件实现按逻辑结构快速定位容器显示区域。 723 724##### 使用 725 7261. 进入主页，点击国内热门城市，配送地址会更新为选择的城市。点击右边字母索引条，可快速定位到想要选择的城市区域，点击该城市后若该城市还细化到区，继续点击该城市的区，配送地址会更新为城市/区，若未细化到区，则只选择城市。 7272. 若测试机支持GPS，点击国内热门城市上面的定位图标，应用会获取本机所在经纬度，然后根据经纬度获取所在城市，定位图标后的城市会进行刷新，当前城市数据为模拟数据。 728 729##### 基本原理 730 731+ 本示例展示获取定位的功能在页面中直接调用，使用geolocation.on方法获取当前位置的经纬度，然后监听经纬度变化发送request请求获取对应城市信息。 732 733##### 约束与限制 734 735开发语言：ArkTS 736 737配套版本：API9版本SDK，版本号：3.2.11.9 738 739[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/Location) 740 741#### 屏幕探测 742 743##### 介绍 744 745本示例实时监测连接的屏幕数量状态，支持创建至多5个虚拟屏幕，点击对应的屏幕矩形能显示该屏幕的相关属性。 746 747##### 使用 748 7491.第一步：进入开始界面 750 7512.第二步：点击右下方的“+”按钮，添加虚拟屏幕，连续点击后，至多创建5个虚拟屏幕。 752 7533.第三步：点击右下方的“-”按钮，移除虚拟屏幕，连续点击删除全部的虚拟屏幕后，再次点击会提示告警信息。 754 7554.第四步：点击屏幕矩形，展示相关屏幕的属性（首字母为R的为真实屏幕，首字母为V的为虚拟屏幕） 756 757##### 基本原理 758 759* 真实屏幕模块 760 * 首字母显示为R，且不能进行删除，点击跳转屏幕属性页面展示真实屏幕属性 761 * 接口参考：[@ohos.display](reference/apis/js-apis-display.md)，[@ohos.router](reference/apis/js-apis-system-router.md) 762 763* 新增和删除虚拟屏幕模块 764 * getAllDisplay获取当前所有的display对象，getDefaultDisplay获取当前默认的display对象,push方法新增虚拟屏幕，增加超过5个虚拟屏幕时，给出警告，pop方法删除虚拟屏幕，全部删除虚拟屏幕后，点击给出警告，点击虚拟屏幕展示虚拟屏幕属性 765 * 接口参考：[@ohos.display](reference/apis/js-apis-display.md)，[@ohos.router](reference/apis/js-apis-system-router.md) 766 767##### 约束与限制 768 769开发语言：ArkTS 770 771配套版本：API9版本SDK，版本号：3.2.11.9 772 773[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/ScreenDetector) 774 775#### 振动 776 777##### 介绍 778 779本示例模拟倒计时场景，通过[@ohos.vibrator](reference/apis/js-apis-vibrator.md) 等接口来实现振动。 780 781##### 使用 782 7831.点击倒计时文本，弹出时间选择框，选择任意时间，点击**确认**，倒计时文本显示选择的时间。 784 7852.点击**start**，开始倒计时，圆形进度条和文本开始变化；倒计时结束，开始振动，进度条恢复初始状态并且弹出振动提示框，按照描述进行选择。 786 7873.点击**reset**，可以结束倒计时并使文本和进度条恢复初始状态。 788 789##### 基本原理 790 791* 本示例实现振动的方法主要封装在TextTimerComponent中。 792 * 设置倒计时间：Timepicker文件中通过TextPicker组件来设置倒计的时间，并将设定的时间数据双向绑定到TextTimerComponent组件当中。 793 * 启动倒计时：点击start按钮通过setInterval执行倒计时，每隔一段时间Process组件的进度值会被此代码this.progressValue += TOTAL / this.duration进行处理同步刷新。 794 * 触发振动：当时间为0的时候，则执行vibrator.vibrate()方法去触发振动效果。 795 * 初始化时间：点击reset按钮会将Process组件的value以及时间进行初始化，并清除定时器。 796 797##### 约束与限制 798 799开发语言：ArkTS 800 801配套版本：API9版本SDK，版本号：3.2.11.9 802 803[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/Vibrator/BasicVibration) 804 805#### 自定义振动 806 807##### 介绍 808 809本示例使用[Vibrator模块](reference/apis/js-apis-vibrator.md)展示了振感定制化的基本功能，包括振感与音效、视频协同振动等。 810 811##### 使用 812 8131. 在"我的"界面中包含开发信息及基本设置，点击振动强度设置，可选择振动强度等级，本步骤可选，默认为低强度模式； 8142. 在"发现"界面，振效库中罗列了不同体验场景，可点击各条目享受音效与振动的协同感受； 8153. 在"发现"界面，触感效果视频可体验视频与振动的协同，点击视频预览图片进入全屏播放界面； 8164. "显示更多"中罗列了当前的振感视频列表。 817 818##### 基本原理 819 820+ 振动强度设置：可以选择振动的强度等级； 821+ 振效库：点击振效库中各项，会调用媒体库AVPlayer播放音效，并同时调用vibrator模块startVibration接口启动振动; 822+ 振感视频：使用Video控件全屏播放视频，在开始播放同时调用vibrator模块startVibration接口启动振动； 823+ 自定义振动：使用[Vibrator模块](reference/apis/js-apis-vibrator.md)的startVibration方法播放应用内置的振动资源文件; 824 825##### 约束与限制 826 827开发语言：ArkTS 828 829配套版本：API10版本SDK，版本号：4.0.10.7 830 831[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/Vibrator/CustomHaptic) 832 833### 设备信息统计 834 835#### 设备使用信息统计 836 837##### 介绍 838 839本示例使用[bundleState](reference/apis/js-apis-deviceUsageStatistics.md)相关接口完成设备中应用时长的统计功能。 840 841##### 使用 842 8431.顶部的数据面板展示了最常用的五个应用的使用时间占比情况。 844 8452.中部的竖向滑动栏展示了每个应用的使用总时长和最后一次使用的时间。 846 8473.底部的横向滑动栏展示了不常用应用列表。 848 849##### 基本原理 850 851* 该示例使用bundleState接口中isIdleState方法判断指定bundleName的应用当前是否是空闲状态来分类不常用应用列表，queryBundleStateInfos方法通过指定起始和结束时间查询应用使用时长统计信息来获得每个应用的使用总时长。 852* 接口参考：[@ohos.bundleState](reference/apis/js-apis-deviceUsageStatistics.md) 853 854##### 约束与限制 855 856开发语言：ArkTS 857 858配套版本：API9版本SDK，版本号：3.2.11.9 859 860[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceUsageStatistics/DeviceUsageStatistics) 861 862### 文件管理 863 864#### 应用接入数据备份恢复 865 866##### 介绍 867 868本示例主要给备份流程提供应用，用于生成数据和显示数据。应用接入数据备份恢复需要通过配置BackupExtensionAbility实现。BackupExtensionAbility，是[Stage模型](application-models/stage-model-development-overview.md)中扩展组件[ExtensionAbility](application-models/extensionability-overview.md)的派生类。开发者可以通过修改配置文件定制备份恢复框架的行为，包括是否允许备份恢复，备份哪些文件等。 869 870##### 使用 871 8721. 点击按钮“生成文件数据”，应用会随机生成2个到10个txt文件，大小在1Byte到1024Byte之间，用于校验备份和恢复的数据为同一数据。 8732. 本应用仅适用于生成和显示数据，具体的备份和恢复的操作目前需要使用hdc shell命令操作。 8743. 具体操作方面，进入应用点击按钮生成文件数据后，进入hdc shell，使用backup_tool backup --isLocal=true --bundle com.samples.backupextension --pathCapFile /data/backup/tmp命令进行备份。然后可以把应用删掉，重新安装应用后进入hdc shell，使用backup_tool restore --bundle com.samples.backupextension --pathCapFile /data/backup/tmp，提示成功后，重新打开应用可以看到备份的文件显示在列表里。 875 876##### 基本原理 877 8781. 在应用配置文件`module.json5`中注册`extensionAbilities`相关配置 8792. 新增元数据资源配置文件 8803. 使用应用生成数据 8814. 备份与恢复操作 882 883##### 约束与限制 884 885开发语言：ArkTS 886 887配套版本：API10版本SDK，版本号：4.0.8.5 888 889[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/FileBackupExtension) 890 891#### 文件管理 892 893##### 介绍 894 895本示例主要展示了文件管理相关的功能，使用[@ohos.multimedia.medialibrary](reference/apis/js-apis-medialibrary.md) 、[@ohos.filemanagement.userFileManager](reference/apis/js-apis-userFileManager.md) 、[@ohos.fileio](reference/apis/js-apis-fileio.md) 、[@ohos.file.fs](reference/apis/js-apis-file-fs.md) 896 897等接口，实现了增添文件、删除文件、查找指定类型文件文件、复制并移动文件和预览图片、监听文件的功能。 898 899##### 使用 900 9011. 在主界面，可以点击图片、视频、文档、音频等按钮进入对应目录的文件列表浏览界面； 9022. 在文件列表浏览界面，点击“+”按钮，可以添加文件； 9033. 在文件列表浏览界面，长按列表项会出现删除图片，点击删除图标可以删除文件； 9044. 在图片文件列表界面，点击图片可以进入图片预览界面。 9055. 在主页点击“我的手机”，进入应用沙箱目录下。 9066. 在主页点击“监听文件”，进入文件监听页面。 907 908##### 基本原理 909 910* 增添文件、删除文件、查找指定类型文件文件和预览图片的功能接口封装在MediaLibraryManager。 911* MyPhone模块中的文件增删、复制移动、查找功能封装在FileSystem。 912* 在Library模块中通过封装FileManager向外提供功能接口，如MediaLibraryManager.getPixelMapByFileAsset()。 913* 监听文件模块中的文件增删、查找、修改、监听功能封装在MyWatcher 914 915 916##### 约束与限制 917 918开发语言：ArkTS 919 920配套版本：API10版本SDK，版本号：4.0.9.6 921 922[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/FileManager) 923 924#### 选择并查看文档与媒体文件 925 926##### 介绍 927 928应用使用[@ohos.file.picker](reference/apis/js-apis-file-picker.md)、[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)、[@ohos.file.fs](reference/apis/js-apis-file-fs.md) 等接口，实现了picker拉起文档编辑保存、拉起系统相册图片查看、拉起视频并播放的功能。 929 930##### 使用 931 9321. 在首页，应用展示出最近打开过的文档信息，点击信息可以进入对应文档的查看界面。通过点击右上方的三个按钮，可以分别实现新建文档、选择图片或视频并打开预览、选择文档并打开的功能。 9332. 在查看文档界面，点击右上方左一按钮，可以实现当前文档另存为的功能；点击右上方中间的按钮，开启文档的编辑功能，textArea变成可编辑状态，用户输入数据后点击右上方第三个按钮，可以将当前文档内容进行保存操作。 9343. 在查看图片界面，picker拉起系统相册的图片，用户至多可选择三张图片查看，点击图片可以切换所显示的图片名及大小信息。 9354. 在查看视频界面，picker拉起系统相册的视频，用户至多可选择三个视频查看，点击视频播放并且可以显示的视频名及大小信息。 936 937##### 基本原理 938 939- 拉起picker选择文件、拉起picker保存文件、拉起picker选择图片或视频的功能封装在Index.ets 940 * 使用mediaLiabrary.getMediaLibrary来获取媒体库的实例，用于访问和修改用户等个人媒体数据信息（如视频、图片、文档等）；使用media.getFileAssets来获取文件资源；使用来fetchFileResult.getFirstObject获取文件检索结果中的头一个文件资产，接口参考：[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md) 941 * 使用new picker.DocumentViewPicker来创建文件picker实例，使用documentPicker.select来拉起picker选择文件，使用documentPicker.save来拉起picker保存文件，接口参考：[@ohos.file.picker](reference/apis/js-apis-file-picker.md) 942 * 使用new picker.PhotoViewPicker来创建图库picker实例，使用photoPicker.select来拉起picker选择图片或视频，接口参考：[@ohos.file.picker](reference/apis/js-apis-file-picker.md) 943 944- 编辑文件并保存的功能封装在EditFile.ets 945 * 使用fs.mkdirSync、fs.openSync、fs.writeSync、fs.readSync、fs.closeSync分别用来来创建文件夹、打开文件、写文件、读文件、关闭文件，接口参考：[@ohos.file.fs](reference/apis/js-apis-file-fs.md) 946 947- 拉起图片或视频并查看的功能封装在ViewMedia.ets 948 * 使用new picker.PhotoViewPicker来创建图库picker实例，使用photoPicker.save来拉起picker保存图片或视频，接口参考：[@ohos.file.picker](reference/apis/js-apis-file-picker.md) 949 * 使用mediaLiabrary.getMediaLibrary来获取媒体库的实例，用于访问和修改用户等个人媒体数据信息（如视频、图片、文档等），然后使用media.getFileAssets来获取文件资源再使用fileAsset.displayName来获取图片或视频的名称，接口参考：[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md) 950 951 952##### 约束与限制 953 954开发语言：ArkTS 955 956配套版本：API10版本SDK，版本号：4.0.10.7 957 958[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/FileShare/Picker) 959 960#### 为应用之间分享和文件访问提供统一的入口能力 961 962##### 介绍 963 964本示例主要展示了沙箱文件分享相关的功能，使用 [@ohos.file.fileuri](reference/apis/js-apis-file-fileuri.md) 、[@ohos.file.fs](reference/apis/js-apis-file-fs.md)、[@ohos.ability.wantConstant](reference/apis/js-apis-ability-wantConstant.md)、[@ohos.application.Want](reference/apis/js-apis-app-ability-want.md) 等接口，实现了获取文件uri、创建沙箱文件、提供want中操作want常数和解释Flags说、应用组件间的信息传递的功能。 965 966##### 使用 967 9681. 因本应用的功能依赖Picker应用，在使用本应用之前首先应安装[Picker](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/FileShare/Picker)应用; 9692. 在主界面，可以点击沙箱文件夹列出文件夹中的文件，同时也可以直接点击沙箱目录下的文件进入文件分享界面； 9703. 点击沙箱文件，进入文件分享界面，点击分享图标，文件将以picker方式打开文件，点击编辑图标，文件进入可编辑模式，在textArea中输入内容，然后点击保存，文件内容更新，返回沙箱应用首页，文件修改成功。 971 972##### 基本原理 973 974* 增添文件、查找指定类型文件、获取文件uri、传递want信息启动ability的功能接口封装在fileFs.ts 975 976 * 使用fs.mkdirSync、fs.openSync、fs.writeSync、fs.readSync、fs.closeSync分别用来来创建文件夹、打开文件、写文件、读文件、关闭文件，接口参考：[@ohos.file.fs](reference/apis/js-apis-file-fs.md) 977 978 * 使用fileUri.getUriFromPath来获取文件uri，接口参考：[@ohos.file.fileuri](reference/apis/js-apis-file-fileuri.md) 979 980 * 分享文件至picker应用打开并编辑： 981 982 调用 implicitStartAbility 方法传递want参数启动新的ability，接口参考：[@ohos.ability.wantConstant](reference/apis/js-apis-ability-wantConstant.md)、[@ohos.application.Want](reference/apis/js-apis-app-ability-want.md) 983 984 985##### 约束与限制 986 987开发语言：ArkTS 988 989配套版本：API9版本SDK，版本号：3.2.12.2 990 991[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/FileShare/SandboxShare) 992 993#### 媒体管理合集 994 995##### 介绍 996 997本示例主要展示网络流播放能力、音视频播控能力、音量调节能力。 998 999##### 使用 1000 10011. 启动应用，点击音频或视频可以查看本地音视频资源。若本地没有音视频资源，可以push视频到本地媒体库路径，视频路径(storage/media/100/local/files/Videos) 音频路径(storage/media/100/local/files/Audios)，需要先hdc进入storage/media/100/local/files路径下查看是否有Videos/Audios文件夹，没有则需要mkdir Videos/Audios创建文件夹后push音视频资源。 10022. 进入首页，可以通过输入网络地址或点击音频，视频进行播放音视频。 10033. 音视频播放后，对于播控按键显示，点击播放、暂停可以播放、暂停音视频，点击循环图标可以在单曲循环和列表循环进行切换。 10044. 点击下一曲、上一曲可以切换音视频，拖动seek可以跳到指定位置播放，点击详细信息可以查看当前音视频信息，视频点击倍速可以开启倍速播放。 10055. 音视频列表左滑可以开启重命名、删除图标，点击对应图标可以进行音视频的重命名和删除。 1006 1007##### 基本原理 1008 1009* 获取音频模块 1010 * 使用媒体库接口进行音视频的扫描，获取音视频详细信息，重命名和删除操作，使用PixelMap方法读取或写入图像数据以及获取图像信息。 1011 * 接口参考：[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)，[@ohos.multimedia.image](reference/apis/js-apis-image.md)，[@ohos.prompt](reference/apis/js-apis-prompt.md) 1012 1013* 音频，视频操作模块 1014 * 使用媒体服务进行音视频播放，暂停，seek等操作，其中AudioPlayer方法播放音频，VideoPlayer方法播放视频。 1015 * 接口参考：[@ohos.multimedia.media](reference/apis/js-apis-display.md)，[@ohos.multimedia.audio](reference/apis/js-apis-audio.md) 1016 1017* 设备适配模块 1018 * 使用屏幕管理接口获取设备宽度进行适配。 1019 * 接口参考：[@ohos.display](reference/apis/js-apis-display.md) 1020 1021##### 约束与限制 1022 1023开发语言：ArkTS 1024 1025配套版本：API9版本SDK，版本号：3.2.12.5 1026 1027[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/MediaCollections) 1028 1029#### 相册 1030 1031##### 介绍 1032 1033本示例主要展示了相册相关的功能，使用[@ohos.file.photoAccessHelper](reference/apis/js-apis-photoAccessHelper.md) 接口，实现了查看系统相册、创建用户相册、查看相册照片、用户相册文件添加和删除、以及预览图片、最近删除、收藏夹操作等功能。 1034 1035##### 使用 1036 10371. 主界面：查询显示所有照片、系统相册（相机/视频/截屏录屏/我的收藏/最近删除）、用户相册 10382. 主界面点击“+”，创建用户相册 10393. 创建用户相册时添加图片到用户相册 10404. 长按相册，删除相册 10415. 长按相册，重命名相册（不可重名） 10426. 长按相册，相册多选，批量删除 10437. 点击相册，查看相册中的图片列表 10448. 点击图片，查看单个图片大图 10459. 点击心形图标，收藏图片 104610. 点击心形图标，取消收藏 104711. 大图界面，重命名文件（可重名） 104812. 大图界面，删除文件（移动到最近删除相册） 104913. 从最近删除恢复照片 105014. 点击视频，查看视频并播放 105115. 点击图片页面右上角叹号，查看图片详情 105216. 长按图片批量操作：多选/全选、删除、恢复 105317. 相册内图片列表界面点击“+”，从已有相册添加照片 105418. 长按图片列表图片，更多菜单，从图片选择添加到已有相册 105519. 在相册图片列表界面，长按图片，选择图片，点击更多，可以将图片加入到其他相册（可多选） 105620. 在用户相册图片列表界面，长按图片，选择图片，点击更多，可以将图片从当前相册移除（可多选） 105721. 在用户相册图片列表界面，长按图片，选择图片，点击更多，可以查看图片详情（可多选） 1058 1059##### 基本原理 1060 1061在base模块中通过封装photoAccessHelper向外提供功能接口。 1062 1063##### 约束与限制 1064 1065开发语言：ArkTS 1066 1067配套版本：API10版本SDK，版本号：4.0.9.1 1068 1069[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/Photos) 1070 1071### IDL 1072 1073#### Ability与ServiceExtensionAbility通信 1074 1075##### 介绍 1076 1077本示例展示通过[IDL的方式](IDL/idl-guidelines.md#ts开发步骤) 和 [@ohos.rpc](reference/apis/js-apis-rpc.md) 等接口实现了Ability与ServiceExtensionAbility之间的通信。 1078 1079##### 使用 1080 10811.启动应用后，首页展示城市的天气信息，当前温度每隔5S会刷新一次。 1082 1083##### 基本原理 1084 1085* Ability与ServiceExtensionAbility通信的方法主要封装在idl_weather_service_proxy、idl_weather_service_stub、HomeFeature、ServiceExtAbility中。 1086 * 建立服务器连接：通过HomeFeature中的this.context.connectAbility(want, this.options)方法来建立服务器连接； 1087 * 接收服务端实例并发送请求：连接成功时new IdlWeatherServiceProxy(proxy)来接收服务端实例，通过[@ohos.rpc](reference/apis/js-apis-rpc.md) 接口来执行new rpc.MessageOption(0)、 new rpc.MessageParcel()、 new rpc.MessageParcel()获取 MessageParcel对象和请求的模式，调用idl_weather_service_proxy中的this.proxy.sendRequest()来发送请求； 1088 * 接收远程请求处理数据：在idl_weather_service_stub中接收远程请求并通过ServiceExtAbility中的updateWeather()函数来处理数据进行返回； 1089 * 获取数据：最后将获得的数据渲染到页面中去； 1090 * 断开连接：可以通过HomeFeature中的this.context.disconnectAbility(this.connection)方法来断开服务器连接，这里的this.connection是建立连接之后的返回值。 1091 1092##### 约束与限制 1093 1094开发语言：ArkTS 1095 1096配套版本：API9版本SDK，版本号：3.2.11.9 1097 1098[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/IDL/AbilityConnectServiceExtension) 1099 1100### 国际化 1101 1102#### 国际化 1103 1104##### 介绍 1105 1106本示例主要展示了国际化模块的相关功能，使用[@ohos.i18n](reference/apis/js-apis-i18n.md) 接口，实现简单日历展示、字符类型判断、文本断点处理功能。 1107 1108##### 使用 1109 11101. 在主界面，可以点击日历、字符文本处理按钮进入对应功能界面； 11112. 在日历界面，点击“<” “>”按钮，可以查看上/下月公历信息； 11123. 在字符、文本处理界面，上方输入框输入一个字符，点击字符类型判断可以查看当前输入的字符类型，下方输入框输入长文本，点击文本断点可以查看文本断点结果，断点处用红色/标记； 1113 1114##### 基本原理 1115 11161. 日历功能使用[@ohos.i18n](reference/apis/js-apis-i18n.md)模块中Calendar实现，全部逻辑处于Calendar。 11172. 字符类型判断功能使用[@ohos.i18n](reference/apis/js-apis-i18n.md)模块中Unicode实现，全部逻辑处于TextProcessing。 11183. 文本断点功能使用[@ohos.i18n](reference/apis/js-apis-i18n.md)模块中breakIterator实现，全部逻辑处于TextProcessing。 1119 1120##### 约束与限制 1121 1122开发语言：ArkTS 1123 1124配套版本：API9版本SDK，版本号：3.2.11.10 1125 1126[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/International/International) 1127 1128### 媒体 1129 1130#### 音视频录制 1131 1132##### 介绍 1133 1134本示例主要使用@ohos.multimedia.media中的AVRecorder接口实现了录制功能；另外辅助使用@ohos.multimedia.medialibrary接口，实现了创建录制文件功能，接口使用以及权限获取详见[媒体库管理](reference/apis/js-apis-medialibrary.md)。使用@ohos.multimedia.camera接口，实现了相机预览及出流功能，接口使用以及权限获取详见[相机管理](reference/apis/js-apis-camera.md)。 1135 1136##### 使用 1137 11381. 在主界面，可以点击视频录制、音频录制进入对应功能界面； 11392. 点击视频录制页面，进入页面呈现摄像头预览画面，用户可以通过点击左上角的设置图标进行视频分辨率参数设置，点击”开始“”暂停“”恢复“”停止“等对应图标按钮进行视频录控相关操作。 11403. 点击音频录制页面，用户可以通过点击左上角的设置图标进行音频采样率参数设置，点击”开始“”暂停“”恢复“”停止“等对应图标按钮进行音频录控相关操作。 1141 1142##### 基本原理 1143 1144* 录控功能接口调用实现参考工程目录中的音频录制页面和视频录制页面 1145 * 调用create()、prepare()、getInputSurface()、start()、pause()、resume()、stop()、reset()、release()接口实现录制器的创建、准备、录控操作、重置、销毁实例等功能； 1146 * 视频录制调用Camera接口实现相机出流功能配合视频录制功能，相机的实现方法参考自相机接口[@ohos.multimedia.camera](reference/apis/js-apis-camera.md) 1147* 调用MediaLibrary实现创建录制，实现方法参考[@ohos.multimedia.medialibrary](reference/apis/js-apis-medialibrary.md)接口说明 1148 1149##### 约束与限制 1150 1151开发语言：ArkTS 1152 1153配套版本：API9版本SDK，版本号：3.2.10.8 1154 1155[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AVRecorder) 1156 1157#### 媒体会话——控制方（仅对系统应用开放） 1158 1159##### 介绍 1160 1161本示例主要展示了媒体会话（媒体控制方）的相关功能，使用[@ohos.multimedia.avsession](reference/apis/js-apis-avsession.md)等接口实现媒体提供方与媒体控制方自定义信息的交互功能。 1162 1163##### 使用 1164 11651. 打开媒体控制方示例应用，可以看到音乐应用的历史记录。 11662. 点击播放按钮，应用的播放状态发生变化。 11673. 点击暂停按钮，应用的播放状态开始变化。 11684. 点击上一首按钮，界面展示播放列表中的上一首歌曲的信息。 11695. 点击下一首按钮，界面展示播放列表中的下一首歌曲的信息。 11706. 点击歌词按钮，界面中出现歌词。 11717. 点击播放列表按钮，界面中出现播放列表。 11728. 点击播放列表中的歌曲，媒体提供方切换到对应的歌曲。 1173 1174##### 基本原理 1175 1176* 界面相关的实现都封装在pages/Index.ets下 1177 * 使用`@StorageLink`来设置与逻辑代码同步更新的变量，当逻辑代码中对应的变量更新时，界面会同步的刷新。 1178 * 通过引入逻辑代码对应的类，创建出对象，实现对onClick事件的响应 1179 1180* 逻辑相关的实现都封装在feature/MediaController.ets下 1181 1182 应用的初始化相关操作 1183 1184 * 链接变量 1185 1186 通过`AppStorage.SetAndLink()`将逻辑代码中的变量与界面代码中使用`@StorageLink`声明的变量连接起来，通过`set()`与`get()`操作来修改或获取变量的值 1187 * 获取当前设备中会话并创建Controller 1188 1189 通过接口`getAllSessionDescriptors()`获取当前设备中的媒体会话； 1190 通过接口`createController()`创建媒体会话对应的控制器； 1191 通过接口`getHistoricalSessionDescriptors()`获取当前设备中的媒体会话历史记录； 1192 通过接口`on(metadataChange | playbackStateChange | queueItemsChange | queueTitleChange | sessionEvent)`开启对媒体提供方发送事件的监听，对媒体提供方的事件进行处理； 1193 1194 应用在运行中相关的操作 1195 1196 * 发送基础控制命令到媒体提供方 1197 1198 基础控制命令可以通过接口`sendControlCommand()`发送。本示例中，从媒体控制方到媒体提供方的基础控制命令主要包括`play, pause, playPrevious, playNext` 1199 1200 * 获取自定义会话数据 1201 1202 媒体控制方可以使用接口`sendCommonCommand()`发送自定义控制命令，当媒体会话提供方接收到命令后，会通过接口`dispatchSessionEvent()`与接口`setExtras()`将歌词信息发送给媒体会话控制方。（此部分请参见媒体会话提供方Sample） 1203 1204 * 获取当前会话信息 1205 通过接口`getAVQueueItems()`获取当前歌曲列表信息； 1206 通过接口`getAVQueueTitle()`获取当前歌曲列表名称信息； 1207 通过接口`getAVPlaybackState()`获取当前歌曲播放状态信息； 1208 通过接口`getAVMetadata()`获取当前歌曲媒体会话元数据信息； 1209 1210##### 约束与限制 1211 1212开发语言：ArkTS 1213 1214配套版本：API10版本SDK，版本号：4.0.9.6 1215 1216[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AVSession/MediaController) 1217 1218#### 媒体会话——提供方 1219 1220##### 介绍 1221 1222本示例主要展示了媒体会话（媒体提供方）的相关功能，使用[@ohos.multimedia.avsession](reference/apis/js-apis-avsession.md)等接口实现媒体提供方与媒体控制方自定义信息的交互功能。 1223 1224##### 使用 1225 12261. 打开媒体提供方示例应用。 12272. 点击播放按钮，应用的播放状态发生变化，歌词开始更新。 12283. 点击暂停按钮，应用的播放状态开始变化，歌词停止更新。 12294. 点击上一首按钮，应用界面展示播放列表中的上一首歌曲的信息。 12305. 点击下一首按钮，应用界面展示播放列表中的下一首歌曲的信息。 1231 1232##### 基本原理 1233 1234* 界面相关的实现都封装在pages/Index.ets下 1235 * 使用`@StorageLink`来设置与逻辑代码同步更新的变量，当逻辑代码中对应的变量更新时，界面会同步的刷新。 1236 1237 * 通过引入逻辑代码对应的类，创建出对象，实现对onClick事件的响应 1238 1239* 逻辑相关的实现都封装在feature/ProviderFeature.ets下 1240 1241 应用的初始化相关操作 1242 1243 * 链接变量 1244 1245 通过`AppStorage.SetAndLink()`将逻辑代码中的变量与界面代码中使用`@StorageLink`声明的变量连接起来，通过`set()`与`get()`操作来修改或获取变量的值 1246 1247 * 创建并设置媒体会话 1248 1249 通过接口`createAVSession()`创建媒体会话； 1250 通过接口`activate()`激活媒体会话； 1251 通过接口`setAVQueueItems()`设置播放列表，设置后媒体控制方可以读取使用该信息； 1252 通过接口`setAVQueueTitle()`设置播放列表标题，设置后媒体控制方可以读取使用该信息； 1253 通过接口`setAVMetadata()`设置当前媒体的元数据，设置后媒体控制方可以读取使用此信息； 1254 通过接口`on()`开启对媒体控制方控制命令的监听，对媒体控制方的命令进行处理； 1255 1256 应用在运行中相关的操作 1257 1258 * 切换歌曲 1259 1260 在切换歌曲时，除了需要设置媒体提供方自身的状态，还需要使用接口`setAVPlaybackState()`与接口`setAVMetadata()`将当前播放状态与元数据同步给媒体控制方。 1261 1262 * 发送自定义数据包 1263 1264 媒体提供方可以使用接口`dispatchSessionEvent()`与接口`setExtras()`来发送自定义数据包。 1265 1266##### 约束与限制 1267 1268开发语言：ArkTS 1269 1270配套版本：API10版本SDK，版本号：4.0.9.6 1271 1272[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AVSession/MediaProvider) 1273 1274#### 音频管理 1275 1276##### 介绍 1277 1278本示例主要展示了音频的相关功能，使用[@ohos.multimedia.audio](reference/apis/js-apis-audio.md)等接口实现音频的发声设备的切换与查询、音频焦点、音效的查询与设置以及音频录制等功能。 1279 1280##### 使用 1281 1282注意：6，7，8是连续的串行操作，不是并行的 1283 12841. 弹出麦克风权限访问提示框，点击“允许” 12852. 在主界面点击“发声设备查询与选择”按钮，进入发声设备查询与选择页面 12863. 在发声设备查询与选择页面界面，展示当前发声设备类型名称 12874. 在发声设备查询与选择页面界面，当设备存在“插入耳机”、“拔掉耳机”、“连接蓝牙”、“断开蓝牙”等操作行为时，当前发声设备类型名称会随之切换 12885. 在发声设备查询与选择页面界面，点击“返回”按钮，回到主页 12896. 在主界面点击“音频焦点”按钮，进入音频焦点页面 12907. 在音频焦点页面，点击音乐播放器，音乐开始播放 12918. 在音频焦点页面，点击铃声播放器，铃声开始播放，同时音乐被暂停 12929. 在音频焦点页面，点击铃声播放器，停止铃声播放，音乐恢复播放 129310. 在音频焦点页面，点击“返回”按钮，回到主页 129411. 在主界面点击“音效管理”按钮，进入预置音效查询页面 129512. 在预置音效查询页面，选择内容类型和场景后，点击“查询”按钮，预置音效模式会显示在下方查询结果中 129613. 在预置音效查询页面，重新修改内容类型和场景，查询结果会重置 129714. 在预置音效查询页面，点击右下方”实时音效设置“按钮，进入实时音效设置页面 129815. 在实时音效设置页面，选择内容类型和场景后，点击播放按钮，音频流开始播放，同时内容类型和场景选择框被置灰 129916. 在实时音效设置页面，点击”查询“按钮，当前音频流音效模式会显示在下方的查询结果中 130017. 在实时音效设置页面，点击暂停按钮，音频流暂停，内容类型和场景选择框使能 130118. 在实时音效设置页面，修改内容类型与场景选择，查询结果被重置 130219. 在实时音效设置页面，再次点击播放按钮，音频流开始播放，点击”查询“按钮，结果显示在查询结果内 130320. 在实时音效设置页面，在”音频流音效模式设置“选择框中选择另一种与上次查询结果不同的音效模式，可以听到音频流出现变化 130421. 在实时音效设置页面，再次点击”查询“按钮，查询结果与上一步设置的模式相同 130522. 在实时音效设置页面，点击左上方返回图标，回到主页 130623. 在实时音效设置页面，点击左下方”预置音效查询“按钮，回到预置音效查询页面 130724. 在主界面点击“音频录制”，进入音频录制界面，音频录制界面默认是普通录制界面 130825. 在普通录制界面，点击录制按钮，开始录制，录音时间开始计时，5s内不允许结束 130926. 在普通录制界面，点击暂停按钮，暂停录制，录音时间也停止计时 131027. 在普通录制界面，点击继续按钮，继续录制，录音时间继续计时 131128. 在普通录制界面，点击停止录制按钮，停止录制，也可以不停止录制，应用设置了30s的超时后，自动停止录制 131229. 停止录制后，会生成录制结果，界面上有一个录制成功的音频播放器，点击播放可听到录制的音频 131330. 点击并行录制按钮，可切换到并行录制界面 131431. 在并行录制界面中，点击音乐播放器，播放音乐 131532. 在并行录制界面中，点击录制按钮，开始录制，同时开启麦克风录制和屏幕录制，5s内不允许结束 131633. 在并行录制界面中，点击停止录制按钮，停止录制，或者超时30s会自动停止录制，停止后按钮点成不可点击状态 131734. 在并行录制界面中，录制停止后，会生成两个音频播放器，一个是麦克风的录音结果，一个是屏幕录制的结果，点击进行播放，暂停，播放结束自动停止 131835. 点击返回按按钮回到主页 1319 1320##### 基本原理 1321 1322* 发声设备查询与切换功能都封装在PreferOutputDevice。 1323* 音频焦点功能都封装Focus。 1324* 预置音效查询功能都封装在PresetEffect。 1325* 音频录制-普通录制功能都封装在NormalCapturer。 1326* 音频录制-并行录制功能都封装在ParallelCapturer。 1327 1328##### 约束与限制 1329 1330开发语言：ArkTS 1331 1332配套版本：API10版本SDK，版本号：4.0.9.6 1333 1334[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Audio) 1335 1336#### 拼图 1337 1338##### 介绍 1339 1340该示例通过[@ohos.multimedia.image](reference/apis/js-apis-image.md)和[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)接口实现获取图片，以及图片裁剪分割的功能。 1341 1342##### 使用 1343 13441. 使用预置相机拍照后启动应用，应用首页会读取设备内的图片文件并展示获取到的第一个图片，没有图片时图片位置显示空白； 13452. 点击Start开始后，时间开始倒计时，在规定时间内未完成拼图则游戏结束。在游戏中，玩家点击Restart进行游戏重置； 13463. 点击开始游戏后，玩家可以根据上方的大图，点击灰格周围的图片移动，点击后图片和灰格交换位置,最终拼成完整的图片； 13474. 不在游戏中时，玩家可以点击上方大图，选择自定义图片来进行拼图游戏。 1348 1349##### 基本原理 1350 1351+ 游戏中图片裁剪分割的效果实现在ImageModel中: 1352 + 获取本地图片：首先使用getMediaLibrary获取媒体库实例，然后使用getFileAssets方法获取文件资源，最后使用getAllObject获取检索结果中的所有文件资产方便展示； 1353 + 裁剪图片准备：裁剪图片需要使用[@ohos.multimedia.image](reference/apis/js-apis-image.md)接口，裁剪前需要申请图片编辑权限，使用[requestPermissionsFromUser](reference/apis/js-apis-abilityAccessCtrl.md#requestpermissionsfromuser9)申请; 1354 + 图片编辑：首先使用createImagePacker创建ImagePacker实例，然后使用fileAsset.open打开文件，调用createImageSource接口创建图片源实例方便操作图片，接下来使用getImageInfo方法获取图片大小便于分割，最后使用createPixelMap方法传入每一份的尺寸参数完成图片裁剪。 1355 1356##### 约束与限制 1357 1358开发语言：ArkTS 1359 1360配套版本：API9版本SDK，版本号：3.2.11.9 1361 1362[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/GamePuzzle) 1363 1364#### 图片编辑 1365 1366##### 介绍 1367 1368本示例使用 [TextArea](reference/arkui-ts/ts-basic-components-textarea.md) 实现多文本输入，使用 [@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md) 依赖系统的图库引用，实现在相册中获取图片，使用 [@ohos.multimedia.image](reference/apis/js-apis-image.md) 生成pixelMap，使用pixelMap的scale()，crop()，rotate()接口实现对图片的缩放，裁剪，旋转功能。 使用[@ohos.effectKit](reference/apis/js-apis-effectKit.md) 生成effectKit,使用effectKit.getHighestSaturationColor() 接口实现对图片的高亮调节。添加文字/贴纸，利用组件的组合编辑素材大小和位置，再使用OffscreenCanvasRenderingContext2D进行离屏绘制保存。 1369 1370##### 使用 1371 13721. 发表评价页面点击添加图片/照片，页面跳转到图片选择页面； 13732. 进入图片选择页面后，选择需要显示的图片； 13743. 选中图片后，页面会跳转到发表评价页面，点击图片跳转到图片编辑删除页面，点击编辑进入到编辑功能页； 13754. 调整菜单有裁剪、缩放、旋转、调色功能； 13765. 标记菜单有添加文字、添加贴纸功能； 13776. 编辑完成后，点击撤回按钮图片会还原到上一个编辑状态； 13787. 图片编辑完成后，点击保存，页面会跳转到发表评价页面，显示相关照片； 13798. 点击返回按钮，退出应用。 1380 1381##### 基本原理 1382 1383+ 图片选择功能在GetPictures中实现: 1384 + 图片选择：首先使用startAbilityForResult()启动系统图库应用，然后将选择的图片用select数组保存路径，展示到页面便于选择，选择完跳转到首页，点击一张图片，进入到编辑删除界面。 1385+ 图片编辑功能在EditImage中实现: 1386 + 图片编辑：图片编辑权限需要使用[requestPermissionsFromUser](reference/apis/js-apis-inner-application-uiAbilityContext.md) 1387 申请 1388 ，首先根据选择图片获取到的uri打开图片文件，fileAsset.open选择‘rw'读写模式，然后使用image.createImageSource创建图片源实例，接下来使用createPixelMap创建PixelMap对象，便于处理图片，最后使用crop对图像进行裁剪处理，使用scale对图像进行缩放处理，rotate进行旋转处理。亮度调节使用effectKit.getHighestSaturationColor() 1389 接口实现对图片的高亮调节。添加文字/贴纸，编辑模式下，使用组件组合（Image、Shape、Text）进行交互完成素材大小和位置选择；编辑确认后，再使用OffscreenCanvasRenderingContext2D进行离屏绘制，保存为新的pixelMap。 1390 1391##### 约束与限制 1392 1393开发语言：ArkTS 1394 1395配套版本：API10版本SDK，版本号：4.0.9.6 1396 1397[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Image) 1398 1399#### 图片显示 1400 1401##### 介绍 1402 1403本示例使用 [TextArea](reference/arkui-ts/ts-basic-components-textarea.md) 组件实现多文本输入，使用 [mediaLibrary](reference/apis/js-apis-mediaquery.md) 实现从相册选择图片展示在商品评价页面。 1404 1405##### 使用 1406 14071.点击添加图片/照片，页面跳转到图片选择页面。 1408 14092.进入图片选择页面后，选择需要显示的图片，选择的图片数量会显示在右上方，选择的图片会显示在下方。最多选择6张图片。 1410 14113.选定图片后点击下一步，页面会跳转回主页面，图片显示在主页。若不确定选择，点击添加图片/照片进行重新选择。 1412 14134.图片选择后，点击文本输入框，可以对商品进行评价。 1414 14155.点击返回按钮，退出应用。 1416 1417##### 基本原理 1418 1419* 本示例分为三个模块： 1420 * 发表评价页面模块： 1421 * 使用scroll，TextArea，Grid等组件开发发表评价页面 1422 * 参考接口：[@ohos.router](reference/apis/js-apis-router.md) 1423 1424 * 选择图片/照片模块 1425 * 调用依赖中ChoicePhotos方法打开相册，mediaquery媒体查询相册，getMediaLibrary获取媒体库的实例，访问用户等个人媒体数据信息并选中图片 1426 * 参考接口：[@ohos.router](reference/apis/js-apis-router.md)，[@ohos.promptAction](reference/apis/js-apis-promptAction.md)，[@ohos.mediaquery](reference/apis/js-apis-system-mediaquery.md)，[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)，[@ohos.abilityAccessCtrl](reference/apis/js-apis-abilityAccessCtrl.md) 1427 1428 * 提交模块 1429 * 选中图片后点击下一步按钮，回到发表评价页面，点击提交按钮进行提交 1430 * 参考接口：[@ohos.router](reference/apis/js-apis-router.md) 1431 1432##### 约束与限制 1433 1434开发语言：ArkTS 1435 1436配套版本：API9版本SDK，版本号：3.2.11.9 1437 1438[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/ImageShow) 1439 1440#### 二维码扫描 1441 1442##### 介绍 1443 1444本示例使用[媒体库管理](reference/apis/js-apis-medialibrary.md)、[相机管理](reference/apis/js-apis-camera.md)、[图片处理](reference/apis/js-apis-image.md)、[文件管理](reference/apis/js-apis-fileio.md)展示二维码扫描功能，包括相机扫描解析二维码和从相册中选择二维码图片解析。 1445 1446##### 使用 1447 14481. 启动应用，授予权限。 14492. 自动识别二维码图片。 14503. 点击右上角图片图标，在相册中选择对应的二维码图片，会返回首页展示结果。 1451 1452##### 基本原理 1453 1454+ 相机功能在CameraServices中 1455 + 获取相机实例：首先使用getCameraManager方法获取相机管理器，然后使用getSupportedCameras方法得到设备列表； 1456 + 打开相机：使用createCameraInput方法创建CameraInput实例，调用open方法打开相机； 1457 + 获取相机输出流：使用getSupportedOutputCapability查询相机设备在模式下支持的输出能力，然后使用createPreviewOutput创建相机输出流，使用[@ohos.multimedia.image](reference/apis/js-apis-image.md#getreceivingsurfaceid9)接口的createPhotoOutput方法创建相片输出流； 1458 + 获取相片输出：首先使用createCaptureSession方法创建**捕获会话**的实例，然后使用beginConfig方法配置会话，接下来使用addInput方法添加一个摄像头输入流，使用addOutput添加一个摄像头和相机照片的输出流，使用commitConfig方法提交会话配置后，调用start方法开始捕获相片输出。 1459+ 二维码解析功能在QRCodeParser中 1460 + 拍照获取图片：使用( 1461 cameraService.imageReceiver.on)[reference/apis/js-apis-image.md#on9]接收图片时注册回调，然后调用readNextImage获取处理图片的操作，然后使用getComponent方法根据图像的组件类型从图像中获取组件缓存，然后将获取到的ArrayBuffer写入指定文件中，返回文件uri，然后通过[ImageBitmap](reference/arkui-ts/ts-components-canvas-imagebitmap.md)将uri转化为ImageBitMap格式，具体文件写入方式参考[@ohos.file.fs](reference/apis/js-apis-file-fs.md)。 1462 + 打开相册选取图片：首先需要使用[startAbilityForResult](reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartabilityforresult)启动相册，将选到的图片通过ImageBitmap转化为ImageBitmap格式。 1463 + 图片解析：使用[CanvasRenderingContext2D](reference/arkui-ts/ts-canvasrenderingcontext2d.md)的getImageData方法创建ImageData对象将相册中获取到的图片转化为util8格式的图片，然后调用jsQR库解析图片中的二维码。 1464 1465##### 约束与限制 1466 1467开发语言：ArkTS 1468 1469配套版本：API9版本SDK，版本号：3.2.11.9 1470 1471[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/QRCodeScan) 1472 1473#### 录音机 1474 1475##### 介绍 1476 1477本示例使用[audio](reference/apis/js-apis-audio.md)相关接口实现音频录制和播放的功能，使用[mediaLibrary](reference/apis/js-apis-medialibrary.md)实现音频文件的管理。 1478 1479##### 使用 1480 14811.启动应用，点击首页底部**录制**按钮跳转到录制界面开始录制音频，录制过程中可以点击右下角的**暂停**按钮暂停录制，点击顶部**返回键**或红色的**停止**按钮停止录音并返回首页，首页中展示录制好的音频文件。 1482 14832.点击**音频文件**可以播放该文件，播放界面可以点击按钮进行暂停和继续播放。 1484 14853.长按音频文件进入多选状态，可以选择音频文件，选择后可以点击底部的按钮进行重命名和删除操作。 1486 14874.左滑音频文件，可以滑出重命名和删除按钮，点击可以对该音频文件进行重命名和删除操作。 1488 1489##### 基本原理 1490 1491* 本示例分为三个模块： 1492 * 录音页面模块 1493 * 使用FileAsset提供封装文件属性的方法，createAudioPlayer同步方式创建音频播放实例实现录音，暂停录音功能 1494 * 参考接口：[audio](reference/apis/js-apis-audio.md)，[@ohos.router](reference/apis/js-apis-router.md)，[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)，[@ohos.multimedia.media](reference/apis/js-apis-media.md)，[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md)，[@ohos.window](reference/apis/js-apis-window.md)，[@ohos.promptAction](reference/apis/js-apis-promptAction.md)，[@ohos.abilityAccessCtrl](reference/apis/js-apis-abilityAccessCtrl.md)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md) 1495 1496 * 录音列表模块 1497 * getMediaLibraryAPI访问媒体数据信息，renameCallBack，renameDialogController方法对录音进行重命名，deleteFile，deleteDialogShow方法删除某条录音。 1498 * 参考接口：[@ohos.router](reference/apis/js-apis-router.md)，[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)，[@ohos.multimedia.media](reference/apis/js-apis-media.md)，[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md)，[@ohos.window](reference/apis/js-apis-window.md)，[@ohos.promptAction](reference/apis/js-apis-promptAction.md)，[@ohos.abilityAccessCtrl](reference/apis/js-apis-abilityAccessCtrl.md)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md) 1499 1500 * 播放模块 1501 * createAudioPlayer方法创建音频播放实例，onPageShow方法播放音频，onPageHide方法暂停播放音频。 1502 * 参考接口：[@ohos.router](reference/apis/js-apis-router.md)，[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)，[@ohos.multimedia.media](reference/apis/js-apis-media.md)，[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md) 1503 1504##### 约束与限制 1505 1506开发语言：ArkTS 1507 1508配套版本：API9版本SDK，版本号：3.2.11.9 1509 1510[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Recorder) 1511 1512#### 视频播放 1513 1514##### 介绍 1515 1516视频播放的主要工作是将视频数据转码并输出到设备进行播放，同时管理播放任务。本文将对视频播放全流程、视频切换、视频循环播放等场景开发进行介绍说明。 本示例主要展示了播放本地视频和网络视频相关功能,使用 [@ohos.multimedia.media](reference/apis/js-apis-media.md#bufferinginfotype8),[@ohos.resourceManager](reference/apis/js-apis-resource-manager.md),[@ohos.wifiManager](reference/apis/js-apis-wifiManager.md)等接口,实现了视频播放、暂停、调节倍速、切换视频的功能。 1517 1518##### 使用 1519 15201.点击视频界面，唤起视频操作面板，再次点击操作面板消失，如果不做任何操作操作界面会5s自动消失; 1521 15222.点击暂停/播放按钮，控制视频暂停播放; 1523 15243.滑动视频进度条，视频跳转到指定位置,在视频中间会出现时间进度方便用户查看视频进度; 1525 15264.点击倍速，可以选择1.0、1.25、1.75、2.0进行倍速调节; 1527 15285.点击下方视频名称，可以选择视频进行切换。注意：network是网络视频，检测到没有连接网络会退出应用，有网络能在本地视频和网络视频进行切换; 1529 15306.点击左上角退出箭头，退出应用。 1531 1532##### 基本原理 1533 1534+ 视频倍速切换、暂停、播放、切换视频、视频跳转的功能接口都封装在AvPlayManager.ts; 1535+ 使用media.createAVPlayer()来获取AVPlayer对象; 1536+ 倍速切换：选择不同的倍速时调用avPlayer.setSpeed(speed: PlaybackSpeed); 1537+ 暂停、播放：点击暂停、播放时调用avPlayer.pause()、avPlayer.play(); 1538+ 切换视频：在切换视频前要先调用avPlayer.reset()重置资源，再通过avPlayer.fdSrc为fdSrc赋值触发initialized状态机上报; 1539+ 视频跳转：在拖动滑动条时调用avPlayer.seek() 1540 1541##### 约束与限制 1542 1543开发语言：ArkTS 1544 1545配套版本：API9版本SDK，版本号：3.2.11.10 1546 1547[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/VideoPlay) 1548 1549#### 媒体库视频 1550 1551##### 介绍 1552 1553本示例使用[Video组件](reference/arkui-ts/ts-media-components-video.md)展示了视频组件的基本功能，包括视频组件化，全屏化，窗口化，上下轮播视频等。 1554 1555##### 使用 1556 15571. 进入首页点击播放按键； 15582. 点击视频播放按钮，视频开始播放,再次点击视频进入视频全屏页； 15593. 首页下滑500vp后，视频小窗口化； 15604. 点击直播按钮进入直播页，上下滑动视频。 1561 1562##### 基本原理 1563 1564 + 视频播放：start方法视频开始播放； 1565 + 全屏播放：再次点击视频进入全屏播放页面，使用setCurrentTime参数设定当前播放时间，pause方法停止播放; 1566 + 小窗口播放：记录当前播放时间，小窗口页面渲染之前设置视频当前播放时间，页面滚动到固定距离开始展示组件； 1567 + 直播：使用[http](reference/apis/js-apis-http.md)接口的request方法获取直播数据; 1568 1569##### 约束与限制 1570 1571开发语言：ArkTS 1572 1573配套版本：API9版本SDK，版本号：3.2.11.9 1574 1575[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/VideoShow) 1576 1577#### 音频通话示例 1578 1579##### 介绍 1580 1581本示例主要展示了音频通话相关的功能，使用[@ohos.multimedia.audio](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-audio.md%2F) 、[@ohos.net.socket](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-socket.md%2F) 等接口，实现音频录制和渲染，音频数据网络传输等功能。 1582 1583##### 使用 1584 15851.语音通话需要运行服务端代码模拟启动流媒体服务端，连接成功后服务端会在终端打印client连接数： 1586 15872.服务端和两台设备在局域网内组成socket网络，运行时需要注意修改ip地址： 1588 1589- 服务端地址在socket.js 1590- 客户端地址在BufferModel.ets，将serverIp替换为服务端IP地址即可 1591 15923.仅体验语音通话功能时，可以两台设备都手动启动语音通话应用，分别点击接听按钮进入通话页面 1593 15944.体验场景所有功能时，需要两台设备启动[聊天应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/StageSocket/),通过左下方语音按钮发起语音通话 1595 15965.一方发起语音通话请求，对方选择同意或拒绝 1597 15986.对方同意后，进行通话 1599 16007.通话页或请求通话页可以选择关闭麦克风或扬声器 1601 16028.对方拒接或同意后挂断，则返回聊天页面 1603 1604##### 基本原理 1605 1606+ TCP socket模拟音频流网络传输： 1607 1608 + 使用@ohos.net.socket 的constructTCPSocketInstance创建TCP socket连接，模拟实现音频流网络传输 1609 + 3s一次检查网络状态和尝试连接，实现网络异常时的处理逻辑 1610+ 音频录制： 1611 + 使用@ohos.multimedia.audio.AudioCapturer完成音频采集 [具体使用参考](media/using-audiocapturer-for-recording.md) 1612+ 音频播放： 1613 + 使用@ohos.multimedia.audio.AudioRenderer完成音频播放 [具体使用参考](media/using-audiorenderer-for-playback.md) 1614+ 麦克风与扬声器以及通话场景控制： 1615 + 使用@ohos.multimedia.audio.AudioManager的setAudioScene接口切换通话场景 1616 + 使用@ohos.multimedia.audio.AudioVolumeGroupManager的setMicrophoneMute接口切换麦克风 1617 + 使用@ohos.multimedia.audio.AudioRoutingManager的setCommunicationDevice接口切换扬声器 1618 1619##### 约束与限制 1620 1621开发语言：ArkTS 1622 1623配套版本：API9版本SDK，版本号：3.2.11.10 1624 1625[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/VoiceCallDemo) 1626 1627### Native 1628 1629#### 获取Rawfile资源 1630 1631##### 介绍 1632 1633本示例中主要介绍开发者如何使用Native Rawfile接口操作Rawfile目录和文件。功能包括文件列表遍历、文件打开、搜索、读取和关闭Rawfile。 1634 1635##### 使用 1636 1637应用界面中展示了Rawfile相关的接口调用，包括获取resources/rawfile目录下的文件及目录结构、对应的rawfile文件内容、对应rawfile文件的descriptor。其中使用到的功能包括文件列表遍历、文件打开、搜索、读取和关闭Rawfile。 1638 1639##### 基本原理 1640 1641通过在IDE中创建Native c++ 工程，在c++代码中定义对外接口为getFileList、getRawFileContent、getRawFileDescriptor，映射C++接口分别为GetFileList、GetRawFileContent、GetRawFileDescriptor。 1642通过获取Js的资源对象，并转为Native的资源对象，即可调用资源的Native接口，获取rawfile列表、rawfile文件内容以及rawfile描述符{fd, offset, length}。 1643在Js侧导入"libentry.so"，通过getContext().resourceManager获取资源管理对象。调用src/main/cpp/types/libentry/index.d.ts中声明的接口，传入js的资源对象和相关参数获取对于rawfile相关资源信息。 1644 1645##### 约束与限制 1646 1647开发语言：ArkTS 1648 1649配套版本：API10版本SDK，版本号：4.0.10.5 1650 1651[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkRawfile) 1652 1653#### Native XComponent 1654 1655##### 介绍 1656 1657本示例中主要介绍开发者如何使用Native XComponent接口来获取NativeWindow实例、获取布局/事件信息、注册事件回调并通过OpenGL/EGL实现在页面上绘制形状。功能主要包括点击按钮绘制一个五角星，并可以通过点击XComponent区域改变五角星的颜色。 1658 1659##### 使用 1660 16611. 安装编译生成的hap包，并打开应用。 1662 16632. 点击页面底部“Draw Star”按钮，页面将绘制一个五角星。 1664 16653. 点击XComponent组件区域（页面中灰色区域）改变五角星颜色。 1666 1667##### 基本原理 1668 1669通过在IDE中创建Native c++ 工程，在c++代码中定义对外接口为drawPattern，在js侧调用该接口可在页面上绘制出一个三角形。 1670 1671在XComponent的OnSurfaceCreated回调中获取NativeWindow实例并初始化EGL环境。调用OH_NativeXComponent_GetXComponentSize接口获取XComponent的宽高，并以此为输入调用EGL相关的绘制接口在NativeWindow上绘制出一个五角星。在DispatchTouchEvent回调中再次调用EGL相关的绘制接口在NativeWindow上绘制出一个大小相同、颜色不同的五角星，以达到点击后改变颜色的目的。 1672 1673##### 约束与限制 1674 1675开发语言：ArkTS 1676 1677配套版本：API10版本SDK，版本号：4.0.8.2 1678 1679[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkXComponent) 1680 1681#### OpenGL三棱椎 1682 1683##### 介绍 1684 1685本示例展示了XComponent相关控件的使用，及采用OpenGL (OpenGL ES)相关标准API绘制3D图形（三棱锥，3D渲染的光源用的是简单的线性光源）。此外，可在屏幕触摸滑动，以使三棱锥进行旋转，其中主要采用了napi接口来更新3D图形的旋转角度。 1686 1687##### 使用 1688 1689应用界面中展示了XComponent相关控件的使用，及采用OpenGL (OpenGL ES)相关标准API绘制3D图形（三棱锥，3D渲染的光源用的是简单的线性光源）。此外，可在屏幕触摸滑动，以使三棱锥进行旋转，其中主要采用了napi接口来更新3D图形的旋转角度。 1690 1691##### 基本原理 1692 1693通过在IDE中创建Native C++工程，在C++代码中定义接口为Init和Update用于3D图形绘制环境的初始化和图形渲染更新，并映射NAPI相关接口UpdateAngle。ArkTS侧主要利用XComponent控件实现Index.ets，C++侧主要采用OpenGL ES相关标准API实现三棱锥的绘制流程相关代码，并可与ArkTS进行交互。 1694 1695应用启动时，NAPI模块也相应进行初始化，此时可通过C++侧的OH_NativeXComponent_GetXComponentId()接口，获取到当前XComponent控件的控件指针，并给到C++侧三棱锥绘制相关的Init和Update函数，实现3D图形显示。同时，为实现三棱锥的触摸屏滑动旋转效果，在C++代码中映射的NAPI接口UpdateAngle给到ArkTS侧调用。ArkTS侧需在导入NAPI模块"libtetrahedron_napi.so"正确的前提下，通过调用src/main/cpp/type/libentry/tetrahedron_napi.d.ts中声明的UpdateAngle接口更新三棱锥旋转角度。 1696 1697##### 约束与限制 1698 1699开发语言：ArkTS 1700 1701配套版本：API10版本SDK，版本号：4.0.9.6 1702 1703[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkOpenGL) 1704 1705### 通知 1706 1707#### 公共事件的订阅和发布 1708 1709##### 介绍 1710 1711本示例主要展示了公共事件相关的功能，实现了一个检测用户部分行为的应用。具体而言实现了如下几点功能： 1712 17131.通过订阅系统公共事件，实现对用户操作行为（亮灭屏、锁屏和解锁屏幕、断联网）的监测； 1714 17152.通过在用户主动停止监测行为时发布自定义有序公共事件，实现对用户主动触发监听行为的持久化记录； 1716 17173.通过在用户设置对某一事件的监听状态时发布粘性事件，记录下本次应用运行期间允许监听的事件列表，同时在应用退出时将临时允许的修改为不允许。 1718 1719##### 使用 1720 17211.安装编译生成的hap包，依赖包hap，桌面上显示应用图标，点击图标即可进入应用。 1722 17232.进入应用显示菜单页，可选择“进入”，“历史”，“设置”及“关于”几个选项。 1724 17253.点击“进入”后跳转至主页面，点击主页面“开始监控”按钮，将开始监听系统公共事件，并进行计时，此时按钮内容变更为“停止监听”；点击停止监听按钮，页面上将显示本次监听时长及监听期间收到的干扰信息汇总，并在页面右下角显示“查看详情”按钮，点击按钮将跳转至详情页，显示监听期间收到的干扰信息，应用当前仅监听了亮灭屏、锁屏和解锁屏幕、断联网等用户可操作的系统公共事件，后续可根据需求快速扩展。 1726 17274.返回至应用菜单页面，点击“历史”可查看用户操作监听的历史记录，当前支持每次运行期间最多存储10条历史记录，超过10条后将删除历史数据。 1728 17295.返回至应用菜单页面，点击“设置”可进行具体系统事件的监听配置，应用提供了“一直”、“仅本次”及“从不”三个选项，其中“仅本次”选项是指本次应用运行期间将监听特定系统公共事件，应用退出后该选项将自动调整为“从不”。 1730 17316.在设置页面，点击“自定义事件定向订阅”进入订阅页面， 1732 17337.返回至应用菜单页面，点击“关于”可查看应用版本信息及本示例的说明。 1734 1735##### 基本原理 1736 1737* 该示例entry部分分为五个模块： 1738 * 进入模块 1739 * 使用到应用文上下文，createSubscriber方法创建订阅者，getCurrentTime获取获取自Unix纪元以来经过的时间进行对用户操作行为的监测功能页面开发。 1740 * 参考接口：[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md)，[@ohos.commonEventManager](reference/apis/js-apis-commonEventManager.md)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md)，[@ohos.commonEvent](reference/apis/js-apis-commonEvent.md)，[@ohos.router](reference/apis/js-apis-router.md)，[@ohos.systemTime](reference/apis/js-apis-system-time.md) 1741 1742 * 历史模块 1743 * 使用到应用文上下文，getPreferences方法获取Preferences实例，组件Header进行历史页面开发。 1744 * 参考接口：[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md) 1745 1746 * 设置模块 1747 * 本模块分为三个事件，分别为记录联网事件，记录灭屏事件，记录亮屏事件，进行锁屏事件、进行解锁屏幕事件，每一个事件都可进行一直，仅本次和从不的单项选择，使用到应用文上下文吗，CommonEvent.publish发布公共事件，getPreferences方法获取Preferences实例进行功能页面开发。 1748 * 参考接口：[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md)，[@ohos.commonEvent](reference/apis/js-apis-commonEvent.md),[@ohos.router](reference/apis/js-apis-router.md)，[@ohos.commonEvent](reference/apis/js-apis-commonEvent.md) 1749 1750 * 关于模块 1751 * 该模块开发主要介绍了本示例的功能作用以及说明了什么情况下不能使用。 1752 1753 - 设置中订阅事件模块 1754 - 本模块主要支持指定应用订阅自定义事件。subScribeInfo新增可选属性publisherBundleName,创建订阅对象时可指定PublisherBundlerName，事件发布时，获取订阅者信息，增加校验bundleName是否等于publisherBundlerName，相等则加入事件回调方，达成只接收指定发布方发布的事件的效果。 1755 - 参考接口：[@ohos.commonEventManager](reference/apis/commonEventManager-definitions.md)，[@ohos.hilog](reference/apis/js-apis-hilog.md)，[@ohos.app.form.formInfo](reference/apis/js-apis-app-form-formInfo.md)，[@ohos.app.form.formBindingData](reference/apis/js-apis-app-form-formBindingData.md)，[@ohos.app.form.FormExtensionAbility](reference/apis/js-apis-app-form-formExtensionAbility.md) 1756 1757##### 约束与限制 1758 1759开发语言：ArkTS 1760 1761配套版本：API10版本SDK，版本号：4.0.9.6 1762 1763[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomCommonEvent) 1764 1765#### 自定义Emitter 1766 1767##### 介绍 1768 1769本示例使用[Emitter](reference/apis/js-apis-emitter.md)实现事件的订阅和发布，使用[自定义弹窗](reference/arkui-ts/ts-methods-custom-dialog-box.md)设置广告信息。 1770 1771##### 使用 1772 17731. 进入首页后弹出广告弹窗，点击即可关闭。 17742. 点击商品列表中的一个商品可以跳转到商品详情页。 17753. 在商品详情页点击首页可以返回到商品列表页，点击购物车可以跳转到购物车页面，点击加入购物车可以在购物车页面添加一条商品信息，点击立即购买可以增加一次已购物数量显示在购物车页面。 17764. 在购物车页面点击购物车列表内商品的减号图标，可以将此商品信息从购物车列表内删除，点击清空购买数量可以将已购物数量清空、显示为0。 1777 1778##### 基本原理 1779 1780+ 订阅事件通知在CustomEmitter中实现 1781 + 广告弹窗：使用Emitter的事件单次订阅emitter.once(eventId,call)，eventId为number类型，单次订阅CustomDialogController弹窗事件，弹窗触发后自动取消订阅。 1782 + 关闭广告弹窗：使用Emitter的事件单次订阅emitter.once(eventId,call)，eventId为string类型，单次订阅CustomDialogController弹窗事件，弹窗关闭后自动取消订阅。 1783 + 购物车添加商品：使用Emitter.on持续订阅商品添加事件，eventId为number类型，添加商品时更新购物车商品列表。 1784 + 购物车删除商品：使用Emitter.on持续订阅商品删除事件，eventId为string类型，删除商品时更新购物车商品列表。 1785 + 购物数量：使用Emitter.getListenerCount获取购买事件订阅者数量，进入购物车页面显示数量结果，清空时取消订阅，结果为0。 1786 1787##### 约束与限制 1788 1789开发语言：ArkTS 1790 1791配套版本：API9版本SDK，版本号：3.2.11.9 1792 1793[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomEmitter) 1794 1795#### 自定义通知 1796 1797##### 介绍 1798 1799本示例使用[@ohos.notificationManager](reference/apis/js-apis-notificationManager.md) 等接口，展示了如何初始化不同类型通知的通知内容以及通知的发布、取消及桌面角标的设置，通知类型包括基本类型、长文本类型、多行文本类型、图片类型、带按钮的通知、点击可跳转到应用的通知。 1800 1801##### 使用 1802 18031.启动应用后，弹出是否允许发送通知的弹窗，点击允许后开始操作； 1804 18052.点击界面中对应的按钮发布不同类型的通知，下拉状态栏，在通知栏可以看到发布的通知； 1806 18073.打开提示音和震动效果开关后，再点击对应按钮发布不同类型的通知，在通知的同时会伴有提示音或震动效果； 1808 18094.点击消息列表Tab页，可以查看到刚才发送的消息，消息右边会显示数量，点击相应的消息可进行消息读取，取消相应通知； 1810 18115.回到仿桌面，可以看到角标数量，对应消息数量（使用前需安装并启动[仿桌面应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/Launcher)）； 1812 18136.点击取消所有通知，可以取消本应用发布的所有通知； 1814 1815##### 基本原理 1816 1817* 允许发送通知、发送通知、取消通知的功能接口封装在NotificationUtil 1818 * 允许发送通知：在进入Index.ets前 1819 通过notificationUtil.enableNotification()调用notification.requestEnableNotification()接口向用户请求发送通知； 1820 * 发送通知：通过publishNotification()封装发布通知的接口； 1821 * 取消通知：Index.ets 页面中通过点击事件调用cancelAllNotifications()取消所有的通知或者通过cancelNotificationById()取消指定id的通知； 1822 1823* 获取应用所有消息通知、取消相关类型通知，角标管理接口封装在NotificationManagementUtil 1824 * 获取应用所有消息通知：在constructor() 1825 构造函数中调用@ohos.notificationManager中的getActiveNotifications接口获取所有通知及相应类型通知数量，通过封装getAllNotifications() 1826 对外提供接口获取当前消息及消息数量。 1827 * 取消相关类型通知：通过cancelNotificationType()封装取消相关通知类型的接口； 1828 * 角标管理接口：通过setBadgeNumber()封装设置应用角标数量的接口，通过getBadgeNumber()封装获取当前应用角标数量的接口。 1829 * 添加一条通知：通过addNotification()封装接口添加一条通知到消息管理器，当发送通知的时候进行调用。 1830 1831* NotificationOperations向外提供接口，在页面中调用它们来实现功能 1832 * 发布通知： 1833 页面中通过点击事件调用NotificationOperations中封装的对应的方法，然后从NotificationContentUtil中获取对应的主体内容content， 1834 将content传递给NotificationRequestUtil得到完整的发布信息，最后调用NotificationUtil.publishNotification()发布内容； 1835 1836* 播放提示音、马达震动的功能在NotificationUtil调用发布通知的接口处进行判断是否开启 1837 * 发布通知： 1838 通过publishNotification()封装发布通知的接口的同时，根据NotificationUtil类中对应变量的值判断是否开启了提示音或马达，若已开启，则执行对应代码段； 1839 * 控制提示音或马达的开关， 1840 通过调用NotificationUtil类两个方法对NotificationUtil类中对应变量进行更改，开启为true，关闭为false； 1841 1842* 自动化测试，对应用接口或系统接口进行单元测试，并且对基于UI操作进行UI自动化测试 1843 * 模拟点击：在Index.test.ets的beforeAll中调用startAbility()拉起应用并进入首页， 1844 然后通过Driver的assertComponentExist、findComponent和findWindow等获取到对应组件的位置， 1845 最后通过click()模拟出人工点击对应组件的效果； 1846 * 模拟各种操作流程：在Index.test.ets 1847 的每个it里面，按一定逻辑顺序排好点击组件的顺序，从而模拟出人为操作的过程，最终，所有的it组成了整一个应用的自动化测试。 1848 1849##### 约束与限制 1850 1851开发语言：ArkTS 1852 1853配套版本：API10版本SDK，版本号：4.0.7.5 1854 1855[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomNotification) 1856 1857#### 自定义通知角标 1858 1859##### 介绍 1860 1861本示例主要展示了设定应用的桌面图标角标的功能，使用[@ohos.notificationManager](reference/apis/js-apis-notificationManager.md) 接口，进行桌面角标的设置，通知的发送，获取等。 1862 1863##### 使用 1864 18651. 在使用本应用时，需安装并启动[仿桌面应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/Launcher)； 18662. 在主界面，可以看到当前应用的所有消息通知； 18673. 点击右下角Tab页签进入通知发送页面，点击对应的通知即可发送相应类型的通知，点击几次发送几条； 18684. 点击左下角Tab页签进入消息列表，可以查看刚才发送的消息，消息右边会显示消息数量，点击相应的消息可进行消息读取，取消相应通知； 18695. 回到仿桌面，可以看到角标数量，对应消息数量。 1870 1871##### 基本原理 1872 1873* 允许发送通知，发送通知的功能接口封装在NotificationUtil 1874 * 允许发送通知： 1875 前通过notificationUtil.enableNotification()调用notification.requestEnableNotification()接口向用户请求发送通知； 1876 * 发送通知：通过publishNotification()封装发布通知的接口； 1877 1878* 获取应用所有消息通知、取消相关类型通知，角标管理接口封装在NotificationManagementUtil 1879 * 获取应用所有消息通知：在constructor()构造函数中调用@ohos.notificationManager中的getActiveNotifications接口获取所有通知及相应类型通知数量，通过封装getAllNotifications()对外提供接口获取当前消息及消息数量。 1880 * 取消相关类型通知：通过cancelNotificationType()封装取消相关通知类型的接口； 1881 * 角标管理接口：通过setBadgeNumber()封装设置应用角标数量的接口，通过getBadgeNumber()封装获取当前应用角标数量的接口。 1882 * 添加一条通知：通过addNotification()封装接口添加一条通知到消息管理器，当发送通知的时候进行调用。 1883 1884* NotificationOperations向外提供接口，在页面中调用它们来实现功能 1885 * 发布通知： 1886 页面中进入发送通知Tab页签，通过点击事件调用NotificationOperations中封装的对应的方法，然后从NotificationContentUtil中获取对应的主体内容content，将 1887 content传递给NotificationRequestUtil得到完整的发布信息，最后调用NotificationUtil.publishNotification()发布内容，并调用NotificationManagementUtil的addNotification()添加一条消息； 1888 1889##### 约束与限制 1890 1891开发语言：ArkTS 1892 1893配套版本：API10版本SDK，版本号：4.0.7.5 1894 1895[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomNotificationBadge) 1896 1897#### 自定义通知推送 1898 1899##### 介绍 1900 1901本示例主要展示了通知过滤回调管理的功能，使用[@ohos.notificationManager](reference/apis/js-apis-notificationManager.md) 接口，进行通知监听回调，决定应用通知是否发送。 1902 1903##### 使用 1904 19051. 在使用本应用时，需安装[自定义通知角标应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomNotificationBadge)； 19062. 在主界面，进行通知过滤的开启及关闭； 19073. 开启通知过滤后，可以选择允许通知的类型，去勾选后，相应类型的通知将不会发送出现通知栏； 19084. 打开自定义通知角标应用应用，进行通知的发送，查看是否发送成功； 19095. 发送通知的应用必须为普通应用才能进行通知过滤，系统应用默认所有通知都能发送。 1910 1911##### 基本原理 1912 1913* 允许通知过滤、指定通知类型过滤的功能接口封装在NotificationFilterUtil 1914 * 允许通知过滤： 1915 页面中通过Toggle状态改变事件调用setNotificationEnableFilter()接口开启通知监听并设置通知过滤回调管理； 1916 * 指定类型通知过滤： 1917 页面中，开启通知过滤后，勾选或取消勾选指定通知类型调用接口setContentTypeEnable()接口设置通知类型是否允许发送； 1918 1919##### 约束与限制 1920 1921开发语言：ArkTS 1922 1923配套版本：API10版本SDK，版本号：4.0.7.5 1924 1925[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomNotificationPush) 1926 1927### 资源 1928 1929#### 资源管理器 1930 1931##### 介绍 1932 1933本工程使用[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md) 接口中的AbilityContext类，获取资源管理器resourceManager，使用[@ohos.resourceManager.d.ts](reference/apis/js-apis-resource-manager.md) 中的接口，展示了格式化字符串查询、基于指定屏幕分辨率查询媒体资源、获取系统资源管理对象等基础功能，以及展示了资源静态overlay以及运行时overlay的特性功能。 1934 1935##### 使用 1936 1937此界面为主页面，其中展示了资源管理API各类接口的调用以及特性Overlay场景功能。其作用有： 1938 19391、点击资源API调用示例按钮，可跳转到资源API示例页面 1940 19412、点击Overlay使用示例，可以跳转到Overlay的使用示例界面。 1942 1943##### 基本原理 1944 1945此页面展示静态overlay功能，功能使用如下： 1946 19471、静态overlay是默认使能的，当前显示的是静态overlay中的字符串和图标。 1948 19492、点击Disable可以触发去使能，重启应用可以恢复显示应用的字符串和图标。 1950 19513、点击enable可以触发使能，重启应用可以再次显示overlay中的字符串和图标。 1952 1953##### 约束与限制 1954 1955开发语言：ArkTS 1956 1957配套版本：API10版本SDK，版本号：4.0.9.6 1958 1959[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Resource/ResourceManager) 1960 1961### 安全 1962 1963#### 应用帐号管理 1964 1965##### 介绍 1966 1967本示例选择应用进行注册/登录，并设置帐号相关信息，简要说明应用帐号管理相关功能。 1968 1969##### 使用 1970 19711.首页面选择想要进入的应用，首次进入该应用需要进行注册，如已注册帐号则直接登录。 1972 19732.注册页面可设置帐号名、邮箱、个性签名、密码（带*号为必填信息），注册完成后返回登录页面使用注册的帐号进行登录。 1974 19753.登录后进入帐号详情界面，点击**修改信息**按钮可跳转至帐号信息修改页面重新设置帐号信息。 1976 19774.点击**切换应用**按钮则退出该帐号并返回首页面。重新选择想要进入的应用。 1978 19795.点击**删除帐号**按钮则会删除该帐号所有相关信息。 1980 1981##### 基本原理 1982 1983* 本示例分为音乐，视频，地图三个模块 1984 * 音乐模块 1985 * 使用Navigation,Button，Text,TextInput组件开发注册，登录，修改信息和切换应用页面， createAppAccountManager方法创建应用帐号管理器对象 1986 * 接口参考：[@ohos.account.appAccount](reference/apis/js-apis-appAccount.md#account_appaccountcreateappaccountmanager)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md)，[@ohos.router](reference/apis/js-apis-system-router.md) 1987 1988 * 视频模块 1989 * 使用Navigation,Button，Text,TextInput组件开发注册，登录，修改信息和切换应用页面，createAppAccountManager方法创建应用帐号管理器对象 1990 * 接口参考：[@ohos.account.appAccount](reference/apis/js-apis-appAccount.md#account_appaccountcreateappaccountmanager)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md)，[@ohos.router](reference/apis/js-apis-system-router.md) 1991 1992 * 地图模块 1993 * 使用Navigation,Button，Text,TextInput组件开发注册，登录，修改信息和切换应用页面，createAppAccountManager方法创建应用帐号管理器对象 1994 * 接口参考：[@ohos.account.appAccount](reference/apis/js-apis-appAccount.md#account_appaccountcreateappaccountmanager)，[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md)，[@ohos.router](reference/apis/js-apis-system-router.md) 1995 1996##### 约束与限制 1997 1998开发语言：ArkTS 1999 2000配套版本：API9版本SDK，版本号：3.2.11.9 2001 2002[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/AppAccountManager) 2003 2004#### 证书算法库框架 2005 2006##### 介绍 2007 2008本示例使用了[@ohos.security.cert](reference/apis/js-apis-cert.md)相关接口实现了对签名数据进行校验的功能。 2009 2010实现场景如下： 2011 20121）使用**正确**的原始数据和签名数据进行签名校验场景：模拟服务端通过客户端证书获取公钥，利用公钥对签名数据进行校验，验证客户端身份和原始数据完整性。 2013 20142）使用**错误**的原始数据或签名数据进行签名校验场景：模拟攻击者修改原始数据或签名数据，服务端在利用公钥进行签名校验时，攻击者身份不可信或原始数据不完整，验证失败。 2015 2016##### 使用 2017 20181、点击**数据展示**按钮，页面文本框中分别显示正确的证书、原始和签名数据内容。 2019 20202、点击**签名校验**按钮，页面弹出弹窗，提示**校验通过**。 2021 20223、点击**修改原始数据**按钮，页面显示修改后的原始数据和正确的证书、签名数据；点击签名校验按钮，页面弹出弹窗，提示**校验失败**。 2023 20244、点击**修改签名数据**按钮，页面显示修改后的签名数据和正确的证书、原始数据；点击签名校验按钮，页面弹出弹窗，提示**校验失败**。 2025 20265、点击**数据展示**按钮，页面恢复正确证书、原始和签名数据的展示；点击**签名校验**按钮，页面弹出弹窗，提示**校验通过**。 2027 2028##### 基本原理 2029 2030* 使用证书公钥实现签名校验的功能接口Verify封装在CertFrameworkModel中 2031 * 获取证书公钥：首先调用[cert.createX509Cert](reference/apis/js-apis-cert.md#cryptocertcreatex509cert)接口生成证书对象certObject，使用certObject对象的[getPublicKey](reference/apis/js-apis-cert.md#getpublickey)能力获取公钥pubKey；然后调用[cryptoFramework.createAsyKeyGenerator](reference/apis/js-apis-cryptoFramework.md#cryptoframeworkcreateasykeygenerator)接口创建密钥生成器keyGenerator，使用keyGenerator的[convertKey](reference/apis/js-apis-cryptoFramework.md#convertkey-1)能力将公钥pubKey转换为正确的格式。 2032 * 使用公钥校验签名：首先调用[cryptoFramework.createVerify](reference/apis/js-apis-cryptoFramework.md#cryptoframeworkcreateverify)接口创建验签对象verifier，使用公钥pubKey对验签对象verifier进行初始化[verifier.init](reference/apis/js-apis-cryptoFramework.md#init-6)；然后使用验签对象verifier的[verify](reference/apis/js-apis-cryptoFramework.md#verify-1)能力对签名进行校验。 2033 2034##### 约束与限制 2035 2036##### 介绍 2037 2038开发语言：ArkTS 2039 2040配套版本：API9版本SDK，版本号：3.2.12.2 2041 2042[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/CertificateFramework) 2043 2044#### 加解密 2045 2046##### 介绍 2047 2048本示例使用[cipher](reference/apis/js-apis-system-cipher.md)相关接口实现了字符串加解密算法，包括RSA加密算法与AES加密算法。 2049 2050##### 使用 2051 20521.点击主页面的**加密**按钮，在加密界面中点击**Encryption Algorithm**下拉选择加密算法，在输入框中输入待加密的内容，点击**加密** 2053按钮，下方文本框中显示加密后内容。 2054 20552.点击**重置**按钮，清除文本框中内容。 2056 20573.点击主页面的**解密**按钮，在解密界面中点击**Decrypt Algorithm**下拉选择解密算法，在输入框中输入待解密的内容，点击**解密** 2058按钮，下方文本框中显示解密后内容。 2059 20604.点击**重置**按钮，清除文本框中内容。 2061 2062##### 基本原理 2063 2064* 本示例分成加密与解密两个模块 2065 * 加密模块 2066 * 使用到rsaEncrypt(RSA算法加密)与aesEncrypt(AES算法加密)两种加密方法进行加密操作。 2067 * 接口参考：[@system.cipher](reference/apis/js-apis-system-cipher.md#cipheraes)，[@ohos.prompt](reference/apis/js-apis-promptAction.md)，[@system.router](reference/apis/js-apis-system-router.md) 2068 2069 * 解密模块 2070 * 使用到rsaDecrypt(RSA算法解密)与aesDecrypt(AES算法解密)两种解密方法进行解密操作。 2071 * 接口参考：[@system.cipher](reference/apis/js-apis-system-cipher.md#cipheraes)，[@ohos.prompt](reference/apis/js-apis-promptAction.md)，[@system.router](reference/apis/js-apis-system-router.md) 2072 2073##### 约束与限制 2074 2075开发语言：ArkTS 2076 2077配套版本：API9版本SDK，版本号：3.2.11.9 2078 2079[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/Cipher) 2080 2081#### 通用密钥库系统（cryptoFramework） 2082 2083##### 介绍 2084 2085本示例使用[@ohos.security.cryptoFramework](reference/apis/js-apis-cryptoFramework.md) 相关接口实现了对文本文件的加解密、签名验签操作。 2086 2087实现场景如下： 2088 20891）软件需要加密存储本地文本文件，需要调用加解密算法库框架选择密钥文本文件，对本地文本文件进行加密，其中密钥文本文件可由加解密算法库生成。 2090 20912）软件需要解密存储本地文本文件，需要调用加解密算法库框架选择密钥文本文件，对本地文本文件进行解密，其中密钥文本文件可由加解密算法库生成。 2092 20933）软件需要对存储本地文本文件签名，调用加解密算法库框架选择密钥文本文件，对本地文本文件进行完整性签名，其中密钥文本文件可由加解密算法库生成。 2094 20954）软件需要验证存储本地文本文件的签名完整性，需要调用加解密算法库框架选择密钥文本文件与签名文件，对文件进行验签，其中密钥文本文件可由加解密算法库生成。 2096 2097##### 使用 2098 20991.点击主页面tab栏的**加密**，在加密界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回加密界面， 2100其内容显示在**文件内容**文本框中， 2101点击**选择密钥**，选择密钥文件，如果没有密钥文件，可以通过在加密界面点击**随机生成AES密钥**，生成并通过文件选择器保存密钥文件。 2102选择完文本文件和密钥文件后，点击**加密**按钮，完成加密，并通过文件选择器保存密文文件。 2103下方**加密内容**文本框中显示加密后的消息内容。 2104 21052.点击主页面tab栏的**解密**，在解密界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回解密界面， 2106其内容显示在**文件内容**文本框中， 2107点击**选择密钥**，选择和**加密相同**的密钥文件。 2108选择完文本文件和密钥文件后，点击**解密**按钮，完成解密，并通过文件选择器保存明文文件。 2109下方**解密内容**文本框中显示解密后的消息内容。 2110 21113.点击主页面tab栏的**签名**，在签名界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回签名界面， 2112其内容显示在**文件内容**文本框中， 2113点击**选择密钥**，选择密钥文件，如果没有密钥文件，可以通过在签名界面点击**随机生成RSA密钥**，生成并通过文件选择器保存密钥文件，注意RSA密钥生成耗时较长。 2114选择完文本文件和密钥文件后，点击**签名**按钮，完成完整性签名，并通过文件选择器保存签名文件。 2115 21164.点击主页面tab栏的**验签**，在验签界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回验签界面， 2117其内容显示在**文件内容**文本框中， 2118点击**选择密钥**，选择和签名一致的密钥文件。点击**选择签名文件**，通过文件选择器选择签名时保存的签名文件， 2119选择完文本文件、密钥文件和签名文件后，点击**验签**按钮，完成验签。 2120 2121##### 基本原理 2122 2123* 进行对文本文件进行加解密、签名验签的功能接口封装在CryptoOperation中 2124 2125* 对文本文件加密： 2126 文件中依次点击打开文件、选择密钥，通过filePicker选择明文文本文件和密钥文件，点击加密按钮，调用加密函数实现对文本内容进行加密，并将密文文件通过filePicker保存。 2127 需要生成密钥文本文件时，可以点击随机生成AES密钥，通过调用[cryptoFramework.symKeyGenerator](reference/apis/js-apis-cryptoFramework.md#symkeygenerator) 2128 生成用于加密的AES密钥，并通过filePicker保存密钥文本文件。 2129 对消息加密的过程中采用[cryptoFramework.Cipher](reference/apis/js-apis-cryptoFramework.md#cipher) 2130 完成加密操作。 2131* 对文本文件解密： 2132 文件中依次点击打开文件、选择密钥，通过filePicker选择密文文本文件和密钥文件，点击解密按钮，调用解密函数实现对文本内容进行解密，并将明文文件通过filePicker保存。 2133 对消息解密的过程中采用[cryptoFramework.Cipher](reference/apis/js-apis-cryptoFramework.md#cipher) 2134 完成解密操作。 2135* 对文本文件签名： 2136 文件中依次点击打开文件、选择密钥，通过filePicker选择待签名文本文件和密钥文件，点击签名按钮，调用签名函数实现对文本内容进行加密，并将签名文件通过filePicker保存。 2137 需要生成密钥文本文件时，可以点击随机生成RSA密钥，通过调用[cryptoFramework.asyKeyGenerator](reference/apis/js-apis-cryptoFramework.md#asykeygenerator) 2138 生成用于签名的RSA密钥，并通过filePicker保存密钥文本文件。 2139 对消息签名的过程中采用[cryptoFramework.Sign](reference/apis/js-apis-cryptoFramework.md#sign) 2140 完成加密操作。 2141* 对文本文件验签： 2142 文件中依次点击打开文件、选择密钥、选择签名文件，通过filePicker选择密文文本文件、密钥文件和签名文件，点击验签按钮，调用验签函数实现对文本内容进行验签，并显示验签结果。 2143 对消息验签的过程中采用[cryptoFramework.Verify](reference/apis/js-apis-cryptoFramework.md#verify) 2144 完成验签操作。 2145 2146##### 约束与限制 2147 2148开发语言：ArkTS 2149 2150配套版本：API9版本SDK，版本号：3.2.12.2 2151 2152[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/CryptoFramework) 2153 2154#### 通用密钥库系统（huks） 2155 2156##### 介绍 2157 2158本示例使用[@ohos.security.huks](reference/apis/js-apis-huks.md)相关接口实现了对任意输入内容进行加密和解密的功能。 2159 2160实现场景如下： 2161 21621）使用新密钥进行消息加解密传输：使用HUKS的生成密钥接口在本地生成一个新密钥，模拟设备对发送的消息进行加密和对接收的消息进行解密场景。 2163 21642）使用旧密钥进行消息加解密传输：使用HUKS的导入密钥接口导入一个旧密钥，模拟在旧设备上对发送的消息进行加密，在新设备上对接收的消息进行解密的场景。 2165 2166##### 使用 2167 21681.点击主页面的**新密钥**按钮，在新密钥界面的输入框中输入待发送的消息内容，点击**发送消息** 2169按钮，下方文本框中显示加密后的消息内容，然后点击**接收消息**按钮，下方文本框中显示解密后的消息内容。 2170 21712.点击主页面的**旧密钥**按钮，在旧密钥界面的输入框中输入待发送的消息内容，点击**发送消息** 2172按钮，下方文本框中显示加密后的消息内容，首先点击**导入密钥**按钮，弹窗提示导入密钥成功，然后点击**接收消息**按钮，下方文本框中显示解密后的消息内容。 2173 21743.点击主页面的**低安访问控制**按钮，在新密钥界面的输入框中输入待保存的密码内容，点击**保存密码** 2175按钮，下方文本框中显示加密后的密码内容，录入锁屏密码， 然后点击**读取密码**按钮，在输入PIN码（锁屏密码，需要预先录入）之后，下方文本框中显示解密后的消息内容。 2176 2177##### 基本原理 2178 2179* 使用新密钥、旧密钥与低安访问控制进行消息的加密和解密的功能接口封装在HuksModel中 2180 * 使用新密钥加密：在NewKey.ets文件中通过HuksModel.encryptData方式调用加密函数实现对发送的消息内容进行加密，设置好生成密钥和解密密钥的密钥属性信息，加密前会先调用生成密钥接口 2181 [huks.generateKeyItem](reference/apis/js-apis-huks.md#huksgeneratekeyitem9-1) 2182 生成用于加密的AES密钥，对消息加密的过程中采用三段式接口[huks.initSession,huks.updateSession,huks.finishSession](reference/apis/js-apis-huks.md#huksinitsession9-1) 2183 完成加密操作。 2184 * 使用新密钥解密：NewKey.ets文件中通过HuksModel.decryptData方式调用解密函数实现对发送消息的解密，设置好解密密钥的密钥属性信息，使用加密时的密钥对消息进行解密，仍然是采用三段式接口完成解密操作，解密动作完成后调用删除密钥接口 2185 [huks.deleteKeyItem](reference/apis/js-apis-huks.md#huksdeletekeyitem9-1)清除本地保存的密钥。 2186 * 使用旧密钥加密：在OldKey.ets文件中通过HuksModel.encryptDataUserOldKey方式调用加密函数对发送的消息内容进行加密，设置好加密密钥的密钥属性信息，采用三段式接口使用本地已保存的旧密钥完成加密操作。 2187 * 使用旧密钥解密：在OldKey.ets文件中通过HuksModel.decryptDataUserOldKey方式调用解密函数对发送的消息内容进行解密，首先模拟在新设备上导入旧设备的加密密钥，同样采用三段式接口完成解密操作，解密完成后删除密钥。 2188 * 使用低安访问控制管理密码：在MinAccessControl.ets文件中通过 huksModel.encryptDataUseSm2 方式生成SM2密钥并调用加密函数对发送的消息内容进行加密，设置好加密密钥的密钥属性信息，采用两段式接口使用本地已保存的旧密钥完成加密操作。读取密码时（需先设定系统锁屏密码）调用IAM的PIN码（锁屏密码）接口进行验证。 2189 2190##### 约束与限制 2191 2192开发语言：ArkTS 2193 2194配套版本：API10版本SDK，版本号：4.0.10.1 2195 2196[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/Huks) 2197 2198#### 支付 2199 2200##### 介绍 2201 2202本示例主要展示了加解密算法库框架的相关功能，使用[@ohos.security.cryptoFramework](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-cryptoFramework.md%2F) 接口，利用RSA非对称加密、ECC数字签名模拟选购支付功能。 2203 2204##### 使用 2205 22061. 在选购首页，点击任意商品进入对支付主面； 22072. 在支付主面，点击立即支付按钮，弹出密码输入框； 22083. 输入密码满6位后得到支付结果，支付成功会进入支付成功界面，3s后自动回到选购首页； 2209 2210##### 基本原理 2211 22121. 选购页面通过商家云获取商品信息，选定商品通过商家云生成订单。 22132. 商家云通过RSA非对称加密，使用支付云公钥，将商品信息传输给支付云SDK。 22143. 支付云通过支付云私钥解密获得消息后生成订单明文orderString返回商家云。 22154. 商家云通过ECC进行数字签名，添加到明文orderString后，形成完整的orderString返回给选购端。 22165. 支付SDK通过RSA非对称加密，使用支付SDK公钥，将支付账号密码信息传输给支付云SDK，并携带完整的orderString。 22176. 支付云通过支付SDK私钥解密账号密码信息，并通过商家云公钥进行验签。 2218 2219- 商家云可用接口封装在cloud模块MerchantServer，提供商品获取，生成订单功能 2220- 支付云可用接口封装在cloud模块PayServer，提供生成支付订单，支付转账功能 2221- 支付SDK为单独feature，需要支付时拉起此hap,提供输入密码进行支付功能。逻辑位于PaySDK模块index 2222 2223##### 约束与限制 2224 2225开发语言：ArkTS 2226 2227配套版本：API9版本SDK，版本号：3.2.11.10 2228 2229[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/PaySecurely) 2230 2231### 任务管理 2232 2233#### 长时任务 2234 2235##### 介绍 2236 2237本示例展示后台任务的长时任务。通过使用[@ohos.resourceschedule.backgroundTaskManager](reference/apis/js-apis-resourceschedule-backgroundTaskManager.md)实现后台播放音乐时避免进入挂起（Suspend）状态。 2238 2239##### 使用 2240 22411.进入应用，点击播放，退出音乐界面推送至后台执行，当任务在后台开始执行时下拉菜单栏会有通知提醒； 2242 22432.再次进入应用，音乐播放进度条显示正常； 2244 22453.点击暂停播放，取消长时任务。 2246 2247##### 基本原理 2248 2249* 该示例使用startBackgroundRunning方法向系统申请长时任务，stopBackgroundRunning方法向系统申请取消长时任务，getWantAgent方法创建一个WantAgent，createAudioPlayer方法创建一个视频播放实例，createAVSession方法创建一个会话对象，fileIo.open方法打开文件等接口实现后台音乐播放。 2250* 接口参考：[@ohos.resourceschedule.backgroundTaskManager](reference/apis/js-apis-resourceschedule-backgroundTaskManager.md)，[@ohos.multimedia.media](reference/apis/js-apis-media.md)，[@ohos.multimedia.avsession](reference/apis/js-apis-avsession.md)，[@ohos.fileio](reference/apis/js-apis-fileio.md)，[@ohos.app.ability.wantAgent](reference/apis/js-apis-app-ability-wantAgent.md) 2251 2252##### 约束与限制 2253 2254开发语言：ArkTS 2255 2256配套版本：API9版本SDK，版本号：3.2.11.9 2257 2258[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/TaskManagement/ContinuousTask) 2259 2260#### 小鸟避障游戏 2261 2262##### 介绍 2263 2264本示例使用[@ohos.app.ability.ServiceExtensionAbility](reference/apis/js-apis-app-ability-serviceExtensionAbility.md)的ServiceExtension接口验证提供的Stage模型， [Canvas组件](reference/arkui-ts/ts-components-canvas-canvas.md)绘制小游戏，[@ohos.resourceschedule.usageStatistics](reference/apis/js-apis-resourceschedule-deviceUsageStatistics.md)的queryBundleStatsInfos接口通过指定起始和结束时间查询应用使用时长统计信息来统计展示游戏在线时长，[@ohos.backgroundTaskManager](reference/apis/js-apis-backgroundTaskManager.md)的requestSuspendDelay接口申请后台应用延迟挂起来验证短时任务API能否正常执行，[@ohos.rpc](reference/apis/js-apis-rpc.md)提供进程间通信能力，[@ohos.wantAgent](reference/apis/js-apis-wantAgent.md)验证系统能力。 2265 2266##### 使用 2267 22681.点击**ConnectService**按钮，创建一个ServiceAbility并连接。 2269 22702.点击**DisconenctService**按钮，断开ServiceAbility。 2271 22723.点击**set game alarm**按钮，利用闹钟提醒代理API，验证游戏进程在收到闹铃通知时不被拉起。 2273 22744.点击**set game calendar**按钮，利用日历提醒代理API，验证游戏进程在收到日历通知时不被拉起。 2275 22765.点击**start game**按钮，选择对应的游戏难度1-5关玩游戏，游戏玩的过程中会利用后台信息统计API统计展示游戏在线时长。 2277 22786.点**home**按钮后，应用生命周期为onInactive, 在此回调中起一个短时任务，验证短时任务API能否正常执行。 2279 2280##### 基本原理 2281 2282* 该示例使用ServiceExtension接口验证提供的Stage模型，Canvas组件绘制小游戏，queryBundleStatsInfos接口通过指定起始和结束时间查询应用使用时长统计信息来统计展示游戏在线时长，requestSuspendDelay接口申请后台应用延迟挂起来验证短时任务API能否正常执行，rpc接口提供进程间通信能力，wantAgent接口验证系统能力。 2283 2284* 接口参考[@ohos.resourceschedule.usageStatistics](reference/apis/js-apis-resourceschedule-deviceUsageStatistics.md)，[@ohos.backgroundTaskManager](reference/apis/js-apis-backgroundTaskManager.md)，[@ohos.wantAgent](reference/apis/js-apis-wantAgent.md)，[@ohos.app.ability.ServiceExtensionAbility](reference/apis/js-apis-app-ability-serviceExtensionAbility.md)，[@ohos.rpc](reference/apis/js-apis-rpc.md) 2285 2286##### 约束与限制 2287 2288开发语言：ArkTS 2289 2290配套版本：API9版本SDK，版本号：3.2.11.9 2291 2292[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/TaskManagement/Flybird) 2293 2294#### 后台代理提醒 2295 2296##### 介绍 2297 2298本示例使用 [Tabs组件](reference/arkui-ts/ts-container-tabs.md) 进行应用布局，使用 [Canvas组件](reference/arkui-ts/ts-components-canvas-canvas.md) 绘制时钟、倒计时，使用 [后台代理提醒](reference/apis/js-apis-reminderAgentManager.md) 发布后台代理提醒，使用 [振动](reference/apis/js-apis-vibrator.md) 设置振动效果。保证应用被冻结或退出时，计时和弹出提醒的功能可以被后台系统服务代理。 2299 2300##### 使用 2301 23021.点击**闹钟**、**日历**、**计时器**三个按钮切换不同视图。 2303 23042.1.点击闹钟页面右上角**+**按钮选择闹钟提醒时间添加闹钟提醒。 2305 23062.2.点击闹钟列表中可设置闹钟重复日期、延迟次数、延迟时长、是否震动、响铃音乐。 2307 23082.3.点击闹钟列表右侧开关按钮，可关闭或打开当前提醒。 2309 23102.4.右滑当前闹钟列表可选择删除当前提醒。 2311 23123.1.点击点击日历页面右上角**+**按钮选择日期提醒时间添加日期提醒。 2313 23143.2.点击日期列表中可设置日历提醒当天具体提醒时间、是否振动、是否响铃。 2315 23163.3.点击日历列表右侧开关按钮，可关闭或打开当前提醒。 2317 23183.4.右滑当前日历列表可选择删除当前提醒。 2319 23204.1.滑动计时器时间选项设置计时器时间。 2321 23224.2.点击**开始**按钮，开始当前计时器并设置倒计时后台提醒。 2323 23244.3.点击**重置**按钮，取消当前计时器提醒并重新设置计时器。 2325 23264.4.点击**暂停**按钮，暂停当前计时器提醒与倒计时；再次点击按钮恢复计时器提醒与计时器计时。 2327 2328##### 基本原理 2329 2330* 该示例分为闹钟，日历，计时器三个模块 2331 * 闹钟模块 2332 * 使用Canvas组件绘制一个闹钟，SlotType方法获取对应的系统能力内容类型，addNotificationSlot方法添加一个NotificationSlot，ReminderRequestAlarm方法获取闹钟实例对象，用于设置提醒的时间，ReminderType方法设置提醒的类型，ActionButtonType方法设置按钮的类型，VibratorStopMode方法停止的振动。 2333 * 接口参考：[@ohos.notification](reference/apis/js-apis-notification.md)，[@ohos.reminderAgent](reference/apis/js-apis-reminderAgent.md)，[@ohos.vibrator](reference/apis/js-apis-vibrator.md) 2334 2335 * 日历模块 2336 * 使用SlotType方法获取对应的系统能力内容类型，ReminderRequestCalendar方法获取日历实例对象，用于设置提醒的时间，ReminderType方法设置提醒的类型，ActionButtonType方法设置按钮的类型，VibratorStopMode方法停止的振动。 2337 * 接口参考：[@ohos.notification](reference/apis/js-apis-notification.md)，[@ohos.reminderAgent](reference/apis/js-apis-reminderAgent.md)，[@ohos.vibrator](reference/apis/js-apis-vibrator.md) 2338 2339 * 计时器模块 2340 * 使用SlotType方法获取对应的系统能力内容类型，addNotificationSlot方法添加一个NotificationSlot，ReminderRequestTimer方法获取倒计时实例对象，用于设置提醒的时间，ReminderType方法设置提醒的类型，ActionButtonType方法设置按钮的类型，VibratorStopMode方法停止的振动。 2341 * 接口参考：[@ohos.notification](reference/apis/js-apis-notification.md)，[@ohos.reminderAgent](reference/apis/js-apis-reminderAgent.md)，[@ohos.vibrator](reference/apis/js-apis-vibrator.md) 2342 2343##### 约束与限制 2344 2345开发语言：ArkTS 2346 2347配套版本：API9版本SDK，版本号：3.2.11.9 2348 2349[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/TaskManagement/ReminderAgentManager) 2350 2351#### 短时任务 2352 2353##### 介绍 2354 2355本示例主要展示后台任务中的短时任务。 2356 2357通过[@ohos.resourceschedule.backgroundTaskManager](reference/apis/js-apis-resourceschedule-backgroundTaskManager.md) ，[@ohos.app.ability.quickFixManager](reference/apis/js-apis-app-ability-quickFixManager.md) 等接口实现应用热更新的方式去展现短时任务机制。 2358 2359##### 使用 2360 23611.安装本应用之前，先编译好未签名的应用包，然后在终端执行工程里的脚本b_sign_hap_release.bat去生成签名的应用包，再将此签名应用包进行安装即可； 2362 23632.进入应用，点击检查更新按钮，点击弹出框更新按钮会进行下载补丁包； 2364 23653.将应用退出到后台后关闭； 2366 23674.再次进入应用，页面版本信息由3.1.7.5更新为3.2.8.3； 2368 2369##### 基本原理 2370 2371* 该示例使用cancelSuspendDelay方法取消延迟挂起，applyQuickFix方法快速修复补丁，createHttp方法创建一个HTTP请求，openSync方法同步打开文件，writeSync方法同步将数据写入文件，closeSync方法同步关闭文件流等接口实现应用热更新的方式去展现短时任务机制。 2372 2373* 接口参考：[@ohos.backgroundTaskManager](reference/apis/js-apis-backgroundTaskManager.md)，[@ohos.app.ability.quickFixManager](reference/apis/js-apis-app-ability-quickFixManager.md)，[@ohos.net.http](reference/apis/js-apis-http.md)，[@ohos.fileio](reference/apis/js-apis-fileio.md) 2374 2375##### 约束与限制 2376 2377开发语言：ArkTS 2378 2379配套版本：API9版本SDK，版本号：3.2.11.9 2380 2381[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/TaskManagement/TransientTask) 2382 2383#### 任务延时调度 2384 2385##### 介绍 2386 2387本示例使用[@ohos.WorkSchedulerExtensionAbility](reference/apis/js-apis-WorkSchedulerExtensionAbility.md) 、[@ohos.net.http](reference/apis/js-apis-http.md) 、[@ohos.notification](reference/apis/js-apis-notification.md) 、[@ohos.bundle](reference/apis/js-apis-Bundle.md) 、[@ohos.fileio](reference/apis/js-apis-fileio.md) 等接口，实现了设置后台任务、下载更新包 、保存更新包、发送通知 、安装更新包实现升级的功能。 2388 2389##### 使用 2390 23911. 安装本应用之前，先编译好未签名的应用包，然后在终端执行工程里的脚本，目录为：WorkScheduler/signTool/b_sign_hap_release.bat； 23922. 未连接wifi状态下进入应用； 23933. 进入首页后连接wifi； 23944. 后台判断版本号后会下载新的升级包，并在页面中给出弹窗询问是否安装，点击“确定”按钮； 23955. 应用会安装已经下载的升级包，实现版本更新，安装后会回到设备桌面，此时点击应用图标，可以看到版本已经是新版本了。 23966. 运行自动化测试用例时，必须使用命令行装包，不能使用ide自动装包，安装自动化测试包之前，先编译好未签名的测试包， 2397然后在终端执行工程里的脚本，目录为：WorkScheduler/signTool/a_sign_hap_release.bat； 23987. 运行自动化测试应用时需要使用如下命令： 2399``` 2400hdc shell aa test -b ohos.samples.workschedulerextensionability -m entry_test -s unittest OpenHarmonyTestRunner -s class ActsAbilityTest -s timeout 150000 2401``` 2402 2403##### 基本原理 2404 2405* 设置延时任务、下载更新包、保存更新包、发送通知、安装更新包的功能接口都封装在WorkSchedulerSystem中 2406 * 设置延时任务：在运行示例时会通过WorkSchedulerSystem.startUpdateSample()方法调用workScheduler.startWork()建立任务； 2407 * 下载更新包：当任务条件满足后，会通过WorkSchedulerSystem.getNewHap()方法调用http.createHttp().request()接口下载需要的文件； 2408 * 保存更新包：通过WorkSchedulerSystem.saveFile()来实现，受限调用fileio.openSync()创建文件，然后调用fileio.writeSync()将下载的内容写入指定文件内； 2409 * 发送通知：通过WorkSchedulerSystem.publishNotification()方法，调用Notification.publish()接口发送指定内容的信息； 2410 * 接收通知：通过WorkSchedulerSystem.handleNotification()方法调用Notification.subscribe()接口获取信息，根据信息内容决定是否提示用户升级； 2411 * 安装更新包：通过WorkSchedulerSystem.installBundle()方法实现，首先调用bundle.getBundleInstaller()获取Installer对象，然后调用bundleInstall.install()接口实现装包，完成升级。 2412 2413##### 约束与限制 2414 2415开发语言：ArkTS 2416 2417配套版本：API9版本SDK，版本号：3.2.12.5 2418 2419[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/TaskManagement/WorkScheduler) 2420 2421### 电话服务 2422 2423#### 拨打电话 2424 2425##### 介绍 2426 2427本示例使用[call](reference/apis/js-apis-call.md)相关接口实现了拨打电话并显示电话相关信息的功能。主要展示拨打电话功能，dial方法拨打电话，可设置通话参数，hasCall方法判断是否存在通话，getCallState方法获取当前通话状态，isEmergencyPhoneNumber方法判断是否是紧急电话号码，formatPhoneNumber方法格式化电话号码，formatPhoneNumberToE164方法将电话号码格式化为E.164表示形式。 2428 2429##### 使用 2430 24311.输入电话号码后，点击**电话**按钮，进行拨打电话。 2432 24332.拨打电话后文本框会显示拨打是否成功，是否存在通话，通话状态，是否紧急号码，格式化后的电话号码。 2434 2435##### 基本原理 2436 2437* 该示例展示拨打电话功能，dial方法拨打电话，可设置通话参数，hasCall方法判断是否存在通话，getCallState方法获取当前通话状态，isEmergencyPhoneNumber方法判断是否是紧急电话号码，formatPhoneNumber方法格式化电话号码，formatPhoneNumberToE164方法将电话号码格式化为E.164表示形式。 2438* 接口参考：[@ohos.telephony.call](reference/apis/js-apis-call.md) 2439 2440##### 约束与限制 2441 2442开发语言：ArkTS 2443 2444配套版本：API9版本SDK，版本号：3.2.11.9 2445 2446[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/Call) 2447 2448#### 联系人 2449 2450##### 介绍 2451 2452本示例使用[@ohos.contact](reference/apis/js-apis-contact.md) 接口，实现了对联系人的增删查改功能。 2453 2454##### 使用 2455 24561.点击 **+** 按钮，跳转添加联系人界面，输入联系人信息，点击 **√**，确认添加联系人，并返回首页； 24572.点击联系人列表跳转页面查看详细信息，并且可以编辑或删除联系人信息； 24583.在搜索栏输入号码或邮箱可查询对应的联系人。 2459 2460##### 基本原理 2461 2462* 本示例的主要逻辑功能和源码在下列相关类中： 2463 * 查询所有联系人：调用contact.queryContacts()查询所有的联系人； 2464 * 新建联系人：检验数据格式后通过contact.addContact()创建新的联系人； 2465 * 搜索联系人：调用contact.queryContactsByPhoneNumber()通过电话号码查询联系人或者调用contact.queryContactsByEmail()通过邮箱查询联系人； 2466 * 删除联系人：调用contact.deleteContact()删除指定的联系人； 2467 * 修改联系人：页面调用contact.updateContact()。 2468 2469##### 约束与限制 2470 2471开发语言：ArkTS 2472 2473配套版本：API9版本SDK，版本号：3.2.11.9 2474 2475[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/Contact) 2476 2477#### 短信服务 2478 2479##### 介绍 2480 2481本示例使用[@ohos.telephony.sms](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Beta5/zh-cn/application-dev/reference/apis/js-apis-sms.md) 接口展示了电话服务中发送短信的功能。 2482 2483##### 使用 2484 24851. 首页点击**创建联系人**，弹框输入联系人姓名和电话，点击确定按钮后，联系人列表中添加该联系人; 24862. 点击**管理**，该按钮变成**取消**，联系人列表出现删除x按钮，点击x按钮可删除联系人，点击**取消**，按钮变成**管理**; 24873. 联系人列表中每个联系人右侧有**发送短信**图标按钮，点击该图标按钮跳转到发送短信页面; 24884. 发送短信页面，输入短信点击向上箭头的**发送**按钮，可以发送短信; 24895. 需授予短信发送权限且插入SIM卡才可成功发送短信，有预置短信内容，每次退出应用数据会清空，未添加存储功能，发送短信为默认卡发送。 2490 2491##### 基本原理 2492 2493+ 发送短信功能在SmsModel中: 2494 + 发送短信：发送短信首先需要使用createMessage方法创建短信实例，然后获取基本参数，getDefaultSmsSlotId可以获取发短信默认卡槽id，getSmscAddr获取短信发送地址，然后调用sms.sendMessage方法发送短信。 2495 2496##### 约束与限制 2497 2498开发语言：ArkTS 2499 2500配套版本：API9版本SDK，版本号：3.2.11.9 2501 2502[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/Message) 2503 2504#### 蜂窝数据 2505 2506##### 介绍 2507 2508本示例使用 [SystemCapability.Telephony.CellularData系统能力](reference/apis/js-apis-telephony-data.md) 获取SIM卡信息及网络信息。使用 [@Builder](quick-start/arkts-builder.md) 在一个自定义组件内快速生成多个布局内容。通过获取SIM卡相关信息，展示打开本应用时网络信息。 2509 2510##### 使用 2511 25121.默认移动数据的SIM卡背景色显示为蓝色。 25132.若已经开启移动数据，则显示开启，否则显示为关闭。 25143.若已经开启漫游服务，则显示开启，否则显示为关闭。 25154.显示打开本应用时数据流类型及连接状态。 2516 2517##### 基本原理 2518 2519* 该示例使用蜂窝数据接口，getDefaultCellularDataSlotId方法获取默认移动数据的SIM卡，isCellularDataEnabled方法检查蜂窝数据业务是否启用，isCellularDataRoamingEnabled方法检查蜂窝数据业务是否启用漫游，getCellularDataFlowType方法获取蜂窝数据业务的上下行状态，getCellularDataState方法获取分组交换域（PS域）的连接状态等方法获取SIM卡相关信息，展示打开本应用时网络信息。 2520* 接口参考：[@ohos.telephony.data](reference/apis/js-apis-telephony-data.md) 2521 2522##### 约束与限制 2523 2524开发语言：ArkTS 2525 2526配套版本：API9版本SDK，版本号：3.2.11.9 2527 2528[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/MobileNetwork) 2529 2530#### 事件订阅 2531 2532##### 介绍 2533 2534本示例通过[@ohos.telephony.radio](reference/apis/js-apis-radio.md)，[@ohos.telephony.call](reference/apis/js-apis-call.md)，[@ohos.telephony.data](reference/apis/js-apis-telephony-data.md)，[@ohos.telephony.observer](reference/apis/js-apis-observer.md)订阅网络状态、信号状态、通话状态、蜂窝数据、sim状态等事件，并获取状态变化返回的结果。 2535 2536##### 使用 2537 25381.打开应用，开启所有订阅事件开关。 25392.开关一次网络，触发网络状态变化。 25403.拨打一次电话，触发通话状态变化。 25414.插拔一次sim卡，触发sim卡状态变化和信号状态变化。 25425.点击**查看详情**按钮，跳转详情页，显示监听到的数据结果。 2543 2544##### 基本原理 2545 2546* 该示例使用NetworkState方法获取网络注册状态，SignalInformation方法获取网络信号强度信息，RadioTechnology方法获取无线接入技术，CallState方法获取通话状态码，DataConnectState方法描述蜂窝数据链路连接状态，DataFlowType方法描述蜂窝数据流类型，SimStateData方法获取SIM卡类型和状态等方法提供订阅管理功能。 2547* 接口参考：[@ohos.telephony.radio](reference/apis/js-apis-radio.md)，[@ohos.telephony.call](reference/apis/js-apis-call.md)，[@ohos.telephony.data](reference/apis/js-apis-telephony-data.md)，[@ohos.telephony.observer](reference/apis/js-apis-observer.md) 2548 2549##### 约束与限制 2550 2551开发语言：ArkTS 2552 2553配套版本：API9版本SDK，版本号：3.2.11.9 2554 2555[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/Observer) 2556 2557#### 网络搜索 2558 2559##### 介绍 2560 2561本示例通过[@ohos.telephony.sim](reference/apis/js-apis-sim.md) 、[@ohos.telephony.radio](reference/apis/js-apis-radio.md) 等接口来展示电话服务中网络搜索功能，包含无线接入技术、网络状态、选网模式、ISO国家码、信号强度信息列表及Radio是否打开。 2562 2563##### 使用 2564 25651.点击**SIM1 status**，弹出面板显示卡1的无线接入技术、注册网络信号强度信息列表、选网模式、ISO国家码， 2566再次点击面板消失， 点击**SIM2 status**显示同理； 25672.**NetworkState**显示网络状态相关信息； 25683.**IsRadioOn**显示Radio是否打开，true为打开，false为关闭。 2569 2570##### 基本原理 2571 2572* 网络搜索功能的实现主要封装在RadioStatus: 2573 * 获取网络状态以及服务商名称：打开应用触发RadioStatus中的getNetworkState()函数调用radio.getNetworkState()方法来获取网络状态，getRadioOn()函数调用radio.isRadioOn()方法判断指定卡槽位的Radio是否打开，RadioStatus中的getSimSpn()函数调用sim.getSimSpn(slotId)方法来获取指定卡槽SIM卡的服务提供商名称（Service Provider Name，SPN）。 2574 * 显示SIM卡信息：点击SIM status，弹出面板显示卡1的无线接入技术、注册网络信号强度信息列表、选网模式、ISO国家码。 2575 * 获取无线接入技术：RadioStatus中的getRadioTech(this.slotId)函数来调用radio.getRadioTech(slotId)方法来获取当前接入的CS域和PS域无线接入技术， 2576 * 获取指定SIM卡网络强度信息：getSignalInformation(this.slotId)函数来调用radio.getSignalInformation(slotId)方法来获取指定SIM卡槽对应的注册网络信号强度信息列表。 2577 * 获取选网模式：getNetworkSelectionMode(this.slotId)函数来调用radio.getNetworkSelectionMode(slotId)方法来获取当前选网模式。 2578 * 获取ISO国家码：getISOCountryCodeForNetwork(this.slotId)函数来调用radio.getISOCountryCodeForNetwork(slotId)方法来获取注册网络所在国家的ISO国家码。 2579 2580##### 约束与限制 2581 2582开发语言：ArkTS 2583 2584配套版本：API9版本SDK，版本号：3.2.11.9 2585 2586[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/RadioTech) 2587 2588#### SIM卡管理 2589 2590##### 介绍 2591 2592本示例使用[sim](reference/apis/js-apis-sim.md)相关接口，展示了电话服务中SIM卡相关功能，包含SIM卡的服务提供商、ISO国家码、归属PLMN号信息，以及默认语音卡功能。 2593 2594##### 使用 2595 25961.若SIM卡槽1插入SIM卡则SIM卡1区域显示为蓝色，否则默认为白色。 25972.点击SIM卡1区域，弹窗显示SIM卡1的相关信息，再次点击面板消失。 25983.默认拨号的SIM卡其按钮背景色为蓝色，目前只展示默认拨号的SIM卡，更改默认拨号卡功能暂不支持。 25994.呼叫转移界面功能暂不支持，故点击按钮无实际操作。 2600 2601##### 基本原理 2602 2603* 该示例主要通过hasSimCard方法获取指定卡槽SIM卡是否插卡，getSimState方法获取指定卡槽的SIM卡状态，SimState方法判断SIM卡状态，isSimActive方法获取指定卡槽SIM卡是否激活，getSimSpn方法获取指定卡槽SIM卡的服务提供商名称，getISOCountryCodeForSim方法获取指定卡槽SIM卡的ISO国家码，getSimOperatorNumeric方法获取指定卡槽SIM卡的归属PLMN号，getDefaultVoiceSlotId方法获取默认语音业务的卡槽ID等开发电话服务的相关功能。 2604* 接口参考：[@ohos.telephony.sim](reference/apis/js-apis-sim.md) 2605 2606##### 约束与限制 2607 2608开发语言：ArkTS 2609 2610配套版本：API9版本SDK，版本号：3.2.11.9 2611 2612[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/SimManager) 2613 2614### Web 2615 2616#### 浏览器 2617 2618##### 介绍 2619 2620本示例使用[@ohos.systemparameter](reference/apis/js-apis-system-parameter.md)接口和[Web组件](reference/arkui-ts/ts-basic-components-web.md)展示了一个浏览器的基本功能,展示网页，根据页面历史栈前进回退等。 2621 2622##### 使用 2623 26241. 连接Wifi，启动应用，展示默认页面内容; 26252. 点击默认页面的图标跳转到对应网页，或者在输入框输入网址，点击右侧跳转按钮跳转到对应网页; 26263. 点击输入框左侧向右向左按钮进行页面的前进后退; 26274. 点击主页图标回到主页，点击加号按钮新建一个页面。 2628 2629##### 基本原理 2630 2631+ Web展示与历史栈操作功能在Browser中: 2632 + 加载网页及刷新：使用WebController提供的loadUrl可以加载目标网址内容，使用refresh方法刷新页面; 2633 + 页面前进后退功能：页面在前进或者后退前使用accessForward/accessBackward查询是否有历史记录,然后调用forward/backward进行前进/后退操作。 2634 2635##### 约束与限制 2636 2637开发语言：ArkTS 2638 2639配套版本：API9版本SDK，版本号：3.2.11.9 2640 2641[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Web/Browser) 2642 2643#### JS注入与执行 2644 2645##### 介绍 2646 2647本示例基于H5游戏，通过arkui的[Button](reference/arkui-ts/ts-basic-components-button.md)实现对游戏实现基本控制，展示[@ohos.web.webview](reference/apis/js-apis-webview.md)的JS注入与执行能力，及native应用与H5的通信能力。 2648 2649##### 使用 2650 26511. 设备连接热点，可访问互联网。 26522. 打开应用，通过界面中按钮进行游戏控制。 2653 2654##### 基本原理 2655 2656* 本示例分成一个模块 2657 * 通过button实现对游戏的基本控制，WebviewController方法控制Web组件各种行为，使用webview注入JS与执行能力。 2658 * 接口参考：[@ohos.window](reference/apis/js-apis-window.md)，[@ohos.web.webview](reference/apis/js-apis-webview.md) 2659 2660##### 约束与限制 2661 2662开发语言：ArkTS 2663 2664配套版本：API9版本SDK，版本号：3.2.11.9 2665 2666[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Web/RunJsInWeb) 2667 2668### 窗口管理 2669 2670#### 窗口 2671 2672##### 介绍 2673 2674本实例使用[窗口管理](reference/apis/js-apis-window.md)，展示了在应用主窗口中创建和拉起子窗口，并对子窗口设置窗口相关属性，以及设置窗口规避区域、窗口沉浸式和小窗口等功能。 2675 2676##### 使用 2677 26781. 启动应用,首页展示窗口沉浸式以及设置状态栏和任务栏属性,点击窗口视频跳转到播放页。 26792. 点击视频屏幕可以拉起小窗口播放视频，小窗口可以拖拽，再次点击视频可以关闭小窗口。 26803. 点击全屏播放并切换窗口方向按钮可以全屏播放视频并且改变窗口方向。 26814. 点击视频屏幕拉起小窗口播放视频, 界面显示小窗口状态为“获焦状态”; 再次点击视频关闭小窗口, 界面显示小窗口状态为“失焦状态” 26825. 点击视频屏幕拉起小窗口视频，再点击小窗口中的“拉起悬浮应用”按钮，成功拉起WindowRatio悬浮应用 2683 2684##### 基本原理 2685 2686* 本示例主要分为三个模块 2687 * 首页入口模块 2688 * 使用WindowStage实例化一个窗口，引入WindowManger方法设置一个主窗口与子窗口 2689 * 接口参考：[@ohos.window](reference/apis/js-apis-window.md)，[@ohos.events.emitter](reference/apis/js-apis-emitter.md)，[@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md)，[@ohos.router](reference/apis/js-apis-router.md) 2690 2691 * 窗口视频模块 2692 * 这里用到依赖window-components中WindowComponent方法来进行视频的播放 2693 2694 * 全屏播放窗口并切换窗口方向模块 2695 * 通过EventPriority方法表示事件被发送的优先级，emitter.emit方法发送指定的事件进行全屏播放和切换窗口方向 2696 * 参考接口：[@ohos.events.emitter](reference/apis/js-apis-emitter.md) 2697 2698##### 约束与限制 2699 2700开发语言：ArkTS 2701 2702配套版本：API10版本SDK，版本号：4.0.9.6 2703 2704[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/WindowManagement/WindowManage) 2705 2706#### 悬浮窗 2707 2708##### 介绍 2709 2710本示例使用[@ohos.window](reference/apis/js-apis-window.md)，主要展示了在子窗口中以悬浮窗模式拉起悬浮应用，并对新的应用设置窗口缩放比例，窗口以设置的比例进行缩放，并在界面显示窗口当前的宽度和高度。 2711 2712##### 使用 2713 27141. 安装[WindowRatio](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/WindowManagement/WindowRatio)工程hap包(即本示例)和[WindowManage](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/WindowManagement/WindowManage)工程hap包 27152. 打开WindowManage应用sample，点击**窗口预览**进入视频播放页面，点击主窗口后拉起子窗口。 27163. 点击**拉起悬浮应用**按钮后，将以悬浮窗模式拉起应用WindowRatio 。 27174. 点击悬浮应用中的下拉框，选择窗口缩放比例，点击**确定**按钮，以新的宽度/比例计算得到窗口宽高，监听到窗口缩放比例发生变化，窗口以设置的比例改变大小，窗口监听到大小发生变化，在页面上显示当前窗口的宽度和高度。另外，窗口不具备记忆之前位置大小的能力，当前sample所调用的接口展示结果不居中，若要使得窗口居中，则需调用resize接口指定成想要的大小。 2718 2719##### 基本原理 2720 2721- 设置窗口缩放比例的功能接口封装在Index: 2722 - 使用windows.setAspectRatio来设置窗口缩放比例; 2723- 设置以悬浮窗模式显示窗口和设置监听窗口大小接口的功能封装在MainAbility; 2724 - 使用windows.setWindowMode来设置窗口为悬浮窗模式; 2725 - 使用windows.on('windowSizeChange', (data))来监听窗口大小信息； 2726 2727##### 约束与限制 2728 2729开发语言：ArkTS 2730 2731配套版本：API10版本SDK，版本号：4.0.8.2 2732 2733[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/WindowManagement/WindowRatio) 2734 2735 2736 2737## 语言基础类库 2738 2739#### 多线程任务 2740 2741##### 介绍 2742 2743本示例通过[@ohos.taskpool](reference/apis/js-apis-taskpool.md) 和[@ohos.worker](reference/apis/js-apis-worker.md) 接口，展示了如何启动worker线程和taskpool线程。 2744 2745##### 使用 2746 27471. 在主界面，可以点击**字符串排序**和**拷贝文件**按钮进入对应的界面； 2748 27492. 点击**字符串排序**按钮进入多线程界面： 2750 2751 worker： 2752 2753 1. 选择**Worker**页签，输入待排序的字符串，并以逗号分割。 2754 2755 2. 点击**字符串排序**按钮，会将排序前的字符串发送给worker线程，在worker线程实现字符串排序，然后将排序后的字符串发送给主线程，主线程中显示排序后的字符串。 2756 2757 3. 点击**清除**按钮，清除字符串。 2758 2759 taskpool： 2760 2761 1. 选择**TaskPool**页签，输入待排序的字符串，并以逗号分割。 2762 2763 2. 选择**添加至任务组**按钮，将当前字符串的排序任务添加至任务组。 2764 2765 3. 点击**立即执行**按钮，如之前有添加至任务组操作则任务组执行完成后将排序后的字符串显示出来；如没有上述操作则执行当前任务完成，将排序后的字符串显示出来。 2766 2767 4. 点击**超时3s执行**按钮，任务延迟3s后执行，执行完成后将排序后的字符串显示出来。 2768 2769 5. 点击**函数任务**按钮，直接调用执行操作，执行完成后将排序后的字符串显示出来。需要注意的是，通过**函数任务**创建的task任务不支持取消。 2770 2771 6. 点击**取消任务**按钮，会取消最后一个未执行的task任务。需要注意的是，只有当任务数大于最大线程数且任务未开始执行时才可以取消成功。 2772 2773 7. 点击**清除**按钮，清除字符串。 2774 27753. 点击**拷贝文件**按钮进入文件拷贝界面： 2776 2777 选择需要拷贝的文件，然后点击**拷贝文件**按钮，文件拷贝成功，触发事件日志显示沙箱下文件个数以及显示部分拷贝成功的文件名。 2778 2779##### 基本原理 2780 2781* worker页签的实现在字符串排序页面调用: 2782 * 字符串排序：通过调用executeWorkerFunc()创建一个worker线程，把待排序字符串发送给worker线程，等worker线程排序完成后再把结果返回。 2783 * 清除：把字符串输入框和结果都清除。 2784 2785* taskpool页签的实现在字符串排序页面调用: 2786 * 立即执行：如没有添加至任务组操作，通过调用executeImmediately()创建一个task任务，这个任务是立即执行字符串排序；如先进行了添加至任务组操作，则通过调用executeImmediately()将任务组执行完毕。 2787 * 超时3s执行：通过调用executeDelay()创建一个task任务，这个任务是延迟3s后执行字符串排序。 2788 * 函数任务：调用executeFunc()接口，不创建task任务，直接调用taskpool.execute()执行字符串排序。 2789 * 取消任务：调用cancelTask()接口，取消最后一个未执行的task任务。 2790 * 清除：把字符串输入框和结果都清除。 2791 * 添加至任务组：调用addTask()接口，将当前任务添加至任务组。 2792 2793* 批量拷贝文件的功能封装在MyWorker: 2794 * 拷贝文件：调用MyWorker.WorkToCopyFiles()，在WorkToCopyFiles方法中向worker03线程发消息，并在worker03线程中批量拷贝，拷贝完成后将结果返回。 2795 2796##### 约束与限制 2797 2798开发语言：ArkTS 2799 2800配套版本：API9版本SDK，版本号：3.2.12.2 2801 2802[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/LaunguageBaseClassLibrary/ConcurrentModule) 2803 2804#### 语言基础类库 2805 2806##### 介绍 2807 2808本示例集合语言基础类库的各个子模块，展示了各个模块的基础功能，包含： 2809 2810- [@ohos.buffer (Buffer)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-buffer.md) 2811- [@ohos.convertxml (xml转换JavaScript)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-convertxml.md) 2812- [@ohos.process (获取进程相关的信息)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-process.md) 2813- [@ohos.taskpool (启动任务池)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-taskpool.md) 2814- [@ohos.uri (URI字符串解析)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-uri.md) 2815- [@ohos.url (URL字符串解析)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-url.md) 2816- [@ohos.util (util工具函数)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-util.md) 2817- [@ohos.util.ArrayList (线性容器ArrayList)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-arraylist.md) 2818- [@ohos.util.Deque (线性容器Deque)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-deque.md) 2819- [@ohos.util.HashMap (非线性容器HashMap)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-hashmap.md) 2820- [@ohos.util.HashSet (非线性容器HashSet)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-hashset.md) 2821- [@ohos.util.LightWeightMap (非线性容器LightWeightMap)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-lightweightmap.md) 2822- [@ohos.util.LightWeightSet (非线性容器LightWeightSet)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-lightweightset.md) 2823- [@ohos.util.LinkedList (线性容器LinkedList)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-linkedlist.md) 2824- [@ohos.util.List (线性容器List)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-list.md) 2825- [@ohos.util.PlainArray (非线性容器PlainArray)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-plainarray.md) 2826- [@ohos.util.Queue (线性容器Queue)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-queue.md) 2827- [@ohos.util.Stack (线性容器Stack)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-stack.md) 2828- [@ohos.util.TreeMap (非线性容器TreeMap)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-treemap.md) 2829- [@ohos.util.TreeSet (非线性容器TreeSet)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-treeset.md) 2830- [@ohos.util.Vector (线性容器Vector)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-vector.md) 2831- [@ohos.xml (xml解析与生成)](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Release/zh-cn/application-dev/reference/apis/js-apis-xml.md) 2832 2833##### 使用 2834 28351. 首页展示语言基础类库各个子模块菜单，点击进入对应的模块页面。 28362. 各个子模块界面中点击功能按钮完成各个功能。 28373. Util中有二级菜单，点击进入对应的二级界面，包含： 2838 * StringCode：字符串编解码，点击功能按钮完成各个功能。 2839 * RationnalNumber：有理数比较，点击功能按钮完成各个功能。 2840 * LRUCache：LRU缓冲区，点击功能按钮完成各个功能。 2841 * ScopeHelper：范围判断，点击功能按钮完成各个功能。 2842 * Base64Helper：Base64编解码，点击功能按钮完成各个功能。 2843 * TypeCheck：类型检查，点击功能按钮完成各个功能。 28444. TaskPool界面中，点击Execute task执行任务，点击Cancel task取消任务。 28455. ArrayList界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 28466. Deque界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 28477. HashMap界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 28488. HashSet界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 28499. LightWeightMap界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285010. LightWeightSet界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285111. LinkedList界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285212. List界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285313. PlainArray界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285414. Queue界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285515. Stack界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285616. TreeMap界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285717. TreeSet界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 285818. Vector界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 2859 2860##### 基本原理 2861 28621. 首页菜单展示：使用一个module，menuitems完成菜单组件的实现，传入要展示的菜单的strarray类型的资源和菜单点击对应的组件即可。使用Navigation和NavRouter组件实现菜单点击进入功能界面，使用LocalStorage实现应用内Ability内数据共享，点击菜单时标记selectedLabel，在entry中的Capabilities组件中，通过selectedLabel显示对应的功能组件。 28632. Xml & ConvertXml：使用[xml](reference/apis/js-apis-xml.md) 和[convertxml](reference/apis/js-apis-convertxml.md) 实现xml的解析和生成以及xml转换为js对象，点击按钮实现对应的功能。 28643. Process：使用[process](reference/apis/js-apis-process.md) 实现获取进程相关信息的功能，点击按钮实现对应的功能。 28654. TaskPool：使用[taskpool](reference/apis/js-apis-taskpool.md) 实现创建后台任务（Task），并对所创建的任务进行如任务执行、任务取消的操作。 28665. Url：使用[URL](reference/apis/js-apis-url.md) 对URL字符串的查找参数进行了增删改查的一系列操作，使得读者对URL的结构用途更加明了，点击按钮实现对应的功能。 28676. Util，使用util中不同的功能函数实现以下功能： 2868 * StringCode：字符串编解码。 2869 * RationnalNumber：有理数比较。 2870 * LRUCache：LRU缓冲区。 2871 * ScopeHelper：范围判断。 2872 * Base64Helper：Base64编解码。 2873 * TypeCheck：类型检查。 28747. ArrayList：展示线性容器ArrayList的数据类型的使用，包括添加、删除。 28758. Deque：展示线性容器Deque的数据类型的使用，包括头部插入、头部删除、尾部删除。 28769. HashMap：展示非线性容器HashMap的数据类型的使用，包括添加键值对、删除键值对。 287710. HashSet：展示非线性容器HashSet的数据类型的使用，包括添加、删除。 287811. LightWeightMap：展示非线性容器LightWeightMap的数据类型的使用，包括添加键值对、删除键值对。 287912. LightWeightSet：展示非线性容器LightWeightSet的数据类型的使用，包括添加、删除。 288013. LinkedList：展示线性容器LinkedList的数据类型的使用，包括尾部添加、头部删除、尾部删除。 288114. List：展示线性容器List的数据类型的使用，包括添加、删除。 288215. PlainArray：展示非线性容器PlainArray的数据类型的使用，包括添加、删除。 288316. Queue：展示线性容器Queue的数据类型的使用，包括尾部添加、头部删除。 288417. Stack：展示线性容器Stack的数据类型的使用，包括尾部添加、尾部删除。 288518. TreeMap：展示非线性容器TreeMap的数据类型的使用，包括添加键值对、删除键值对。 288619. TreeSet：展示非线性容器TreeSet的数据类型的使用，包括添加、删除。 288720. Vector：展示线性容器Vector的数据类型的使用，包括添加、删除。 2888 2889##### 约束与限制 2890 2891开发语言：ArkTS 2892 2893配套版本：API10版本SDK，版本号：4.0.8.3 2894 2895[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/LaunguageBaseClassLibrary/LanguageBaseClassLibrary) 2896 2897#### 压缩与解压 2898 2899##### 介绍 2900 2901本示例通过[@ohos.zlib](reference/apis/js-apis-zlib.md) 和[@ohos.fileio](reference/apis/js-apis-fileio.md) 接口，实现添加文件、解压和压缩文件场景。 2902 2903##### 使用 2904 29051. 点击屏幕右上角 **+** 按钮，弹出创建文件窗口； 29062. 输入文件名称、文件内容，并点击 **确定** 按钮来创建文件； 29073. 文件创建成功后，文件名称自动追加.txt后缀并在主页面列表会显示，同时文件的物理地址为/data/app/el2/100/base/ohos.samples.ziplib/haps/entry/files/，点击 **压缩** 按钮，提示“文件压缩成功”，并会在文件列表创建一个相同名称的.zip文件； 29084. 点击压缩文件后的 **解压** 按钮，提示“文件解压成功”，并会再次在文件列表创建一个同名文件夹。 2909 2910##### 基本原理 2911 2912* 添加文件、解压和压缩文件的接口都在首页调用: 2913 * 添加文件：通过调用fileio.openSync()创建文件并调用fileio.writeSync()向文件中写入内容； 2914 * 压缩文件：通过调用zlib.zipFile()压缩文件； 2915 * 解压文件：通过zlib.unzipFile解压文件。 2916 2917##### 约束与限制 2918 2919开发语言：ArkTS 2920 2921配套版本：API9版本SDK，版本号：3.2.11.9 2922 2923[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/LaunguageBaseClassLibrary/ZipLib) 2924 2925 2926 2927## Performance 2928 2929### ArkRuntime 2930 2931#### N-Body模拟程序 2932 2933##### 介绍 2934 2935本示例使用[@ohos.taskpool](reference/apis/js-apis-taskpool.md)和[@ohos.worker](reference/apis/js-apis-worker.md) 接口，使用ArkTS编程语言开发了业界编程语言基准测试项目[Benchmarks Game](https://gitee.com/link?target=https%3A%2F%2Fsalsa.debian.org%2Fbenchmarksgame-team%2Fbenchmarksgame%2F)中的[N体问题模拟程序](https://gitee.com/link?target=https%3A%2F%2Fbenchmarksgame-team.pages.debian.net%2Fbenchmarksgame%2Fdescription%2Fnbody.html%23nbody)，实现类木星体轨道计算。 2936 2937##### 使用 2938 29391.点击按钮Calculate By TaskPool，会从任务池创建一个任务，进行N-Body计算。 29402.点击按钮Calculate By Worker，会创建一个Worker，进行N-Body计算。 2941 2942##### 基本原理 2943 2944- 使用TaskPool开启子线程运行，计算500万次时间推移天体运行轨道: 2945 - 通过调用computeNBodyByTaskPool()创建一个task任务，并向taskpool线程池派发子线程任务。 2946 - 等待子线程执行任务computeTask()，计算完成后再把结果返回主线程。 2947- 使用Worker开启子线程运行，计算5000万次时间推计算移天体运行轨道 2948 - 通过调用computeNBodyByWorker()创建一个worker线程，把要计算的时间推移量发送给worker线程。 2949 - 等待worker线程调用computeTask()计算完成后再把结果返回主线程。 2950- computeTask()完成具体计算任务 2951 - offsetMomentum() 建立孤立系统的动量守恒。 2952 - advance() 更新天体在按指定的时间变化后的位置信息。 2953 - energy() 判断系统计算前后机械能守恒。 2954 2955##### 约束与限制 2956 2957开发语言：ArkTS 2958 2959配套版本：API9版本SDK，版本号：4.0.9.6 2960 2961[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Performance/ArkRuntime/NBody) 2962 2963 2964 2965## 工程 2966 2967### 应用程序包 2968 2969#### 多HAP 2970 2971##### 介绍 2972 2973本示例使用应用上下文Context接口 [@ohos.app.ability.common](reference/apis/js-apis-app-ability-common.md)和媒体服务接口[@ohos.multimedia.media](reference/apis/js-apis-media.md)，展示多HAP开发，简单介绍了多HAP的使用场景，应用包含了一个entry HAP和两个feature HAP，两个feature HAP分别提供了音频和视频播放组件，entry中使用了音频和视频播放组件。 三个模块需要安装三个hap包，最终会在设备上安装一个主entry的hap包。 2974 2975##### 使用 2976 29771.第一步：选择entry模块，运行生成entry模块的hap包 2978 29792.第二步：安装audioFeature和videoFeature的hap包：打开cmd执行hdc install hdc-path。例如audioFeature模块中hdc-path为：绝对路径/audioFeature/build/default/outputs/default/entry/audioFeature-entry-default-signed.hap 2980 29813.第三步：安装完三个模块hap包后重新运行entry模块 2982 29834.第四步：安装应用，点击桌面MultiHap图标，进入应用：点击audio，进入audio播放页面，点击PlayAudio按钮，播放音频 2984 29855.第五步：点击video，进入video播放页面，可点击播放按钮播放视频 2986 2987##### 基本原理 2988 2989* 新创建两个Module作为将被跳转的hap，分别命名为videoFeature，audioFeature。 2990 * 配置每个hap的type：把entry文件夹下的module.json5中"type": "entry",videoFeature和audioFeature文件夹下的module.json5中"type": "feature"； 2991 * 使用Want跳转到其他的Ability：在entry模块的index.ets中通过common.UIAbilityContext()配置Want，作为多hap间信息传递的载体，用于应用组件间的信息传递； 2992 * want的配置：通过指定bundleName和abilityName可以唯一确定一个Ability。 2993 * 新hap的跳转：在entry模块index.ets首页中，在按钮.onclick()事件内，通过Want配置显式拉起一个新的指定的Ability。 2994 2995##### 约束与限制 2996 2997开发语言：ArkTS 2998 2999配套版本：API9版本SDK，版本号：3.2.11.9 3000 3001[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Project/ApplicationHap/MultiHap) 3002 3003### 资源配置 3004 3005#### 应用主题切换 3006 3007##### 介绍 3008 3009本示例使用[@ohos.application.abilityManager](reference/apis/js-apis-application-abilityManager.md) 能力，对Ability状态进行修改：其中AbilityManager.updateConfiguration()通过修改colorMode属性来更新配置系统主题颜色，展示多种应用主题切换。通过创建 base 同级资源文件夹 dark 和 light 完成深色浅色主题相关资源配置，实现深色浅色主题切换，在 ThemeConst 文件中配置自定义主题文件，通过控制变量实现多主题切换。 3010 3011##### 使用 3012 30131. 点击头部切换主题按钮，选择想要切换的主题。 30142. 系统深浅模式切换，应用主题自动跟随切换深浅模式。 3015 3016##### 基本原理 3017 3018* 三种模式资源统一放在ThemeConst内，在ThemeGet中定义全局变量theme控制主题模式(0:黑夜 1：白天 3：自定义主题)，步骤如下， 3019 * 1）整理主题资源：例如创建系统主题dark,light和自定义主题custom相关目录，并完善需要切换的资源比如icon、color等，系统主题下的相同资源，资源名称必须相同，比如dark下title.icon和light下title.icon 3020 * 2）定义资源池函数引用需要切换的主题资源，需要主题切换的资源通过getTheme(this.theme).资源名，实现组件对资源的动态引用和动态渲染。 3021 * 3）定义全局变量@storagelink('theme') 3022 * 4）定义事件修改变量theme的值，如果是系统主题（dark，light），调用AbilityManager.updateConfiguration()，通过修改colorMode属性来更新配置系统主题颜色（0：深夜 1：白天） 3023 * 5）自定义主题无须修改系统配置，只需修改theme全局变量的值，全局变量会通过@storagelink双向绑定机制，自动重新渲染绑定了theme值的组件 3024 3025##### 约束与限制 3026 3027开发语言：ArkTS 3028 3029配套版本：API9版本SDK，版本号：3.2.12.5 3030 3031[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Project/ResourceAllocation/ApplicationThemeSwitch) 3032 3033### 测试框架 3034 3035##### 介绍 3036 3037本示例展示[测试框架](https://gitee.com/openharmony/testfwk_arkxtest)的使用示例，主要介绍了 jsunit单元测试框架和uitestUI测试框架的使用示例。 3038 3039##### 使用 3040 3041- 将jsunit或uitest目录下的项目工程整体导入到DevEco Studio开发工具中。 3042- 查看ohostest目录下的测试代码实现。 3043- 在DevEco Studio中执行测试用例代码查看执行效果，执行方式请[参考](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-openharmony-test-framework-0000001263160453)。 3044 3045##### 基本原理 3046 30471. jsunit单元测试框架示例内容 30482. uitestUI测试框架示例内容 3049 3050##### 约束与限制 3051 3052开发语言：ArkTS 3053 3054配套版本：API9版本SDK，版本号：3.2.11.9 3055 3056[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Project/Test) 3057 3058 3059 3060## 行业解决方案 3061 3062### 游戏 3063 3064#### 分布式五子棋 3065 3066##### 介绍 3067 3068本示例使用使用分布式设备管理能力[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md)、分布式数据管理[@ohos.data.distributedData](reference/apis/js-apis-distributed-data.md)等接口，结合[Canvas组件](reference/arkui-ts/ts-components-canvas-canvas.md) 实现棋盘、棋子的绘制，使用[分布式数据管理](reference/apis/js-apis-distributed-data.md) 实现两台设备间数据的同步。 3069 3070##### 使用 3071 30721.启动应用，同一个网络下两台设备都确认权限后，一台设备退出。点击右上角流转按钮，选择需要拉起的远程设备，点击后拉起远程设备，第一次拉起设备时，若未进行认证，输入认证码进行认证，认证成功后拉起远程设备。 3073 30742.游戏过程中，本地设备的用户可以重开，悔棋，远程设备无此功能。下子时，在棋盘某位置点击第一次时预下子，若确定下在该位置，继续点击该位置，若不确定，点击其他位置即可。若远程设备因特殊原因退出或者掉线，本地设备可重新拉起远程设备，拉起后，本地设备点击棋盘任意位置，数据会同步到远程设备，继续进行未完成的游戏。 3075 3076##### 基本原理 3077 3078* 管理分布式设备（节点） 3079 1、创建设备管理对象，并指定参数kvstore应用包deviceManager.createDeviceManager("ohos.samples.distributeddatagobang", (error, value) => {})。 3080 2、获取可信设备列表"this.deviceManager.getTrustedDeviceListSync()"。 3081 3、监听设备状态"this.deviceManager.on('deviceStateChange', (data) => {})"。 3082* 分布式数据管理 3083 1、页面初始化时获取此应用所需能力，引入@ohos.data.distributedData初始化分布式数据库，并使用kvstore.on对数据change进行监听，通过appstorge判断获取相应的key判断是否是分布式节点。 3084 2、如果是分布式节点，如果数据发生变化处理数据，使用this.kvManager.getKVStore()通过指定Options和storeId，创建并获取KVStore数据库。以及添加键值对到数据库this.kvStore.put(key, value)。 3085 3、页面通过kvStore对象进行增删改查会触发其他已连接设备的kvStore.on监听。 3086* 游戏规则编写 3087 1、init()函数初始化游戏规则，通过canvas组件绘制棋盘背景和棋子，游戏状态为开始，共计回合为0，并生成棋盘。 3088 2、触发onClick函数，每click一次，清除一次canvas，数组中添加当前棋子，重绘。 3089 3、当在A盘，且步长是偶数，表示B下的棋子会在A盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'A' && this.distributedData.step % 2 === 0; 3090 4、当在B盘，且步长是奇数，表示A下的棋子会在B盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'B' && this.distributedData.step % 2 !== 0; 3091 5、如果A盘重开(isRestart=true)，那B盘就要清空棋子;不重开(isRestart=false)时，B盘正常显示。 3092 3093##### 约束与限制 3094 3095开发语言：ArkTS 3096 3097配套版本：API9版本SDK，版本号：3.2.11.9 3098 3099[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Game/DistributedDataGobang) 3100 3101#### 游戏2048 3102 3103##### 介绍 3104 3105本示例使用用户首选项[ohos.data.preferences](reference/apis/js-apis-data-preferences.md) 以及屏幕属性[@ohos.display](reference/apis/js-apis-display.md#displaygetdefaultdisplaydeprecated) 等接口，结合[Grid](reference/arkui-ts/ts-container-grid.md)组件，实现了2048小游戏功能。 3106 3107##### 使用 3108 31091.启动应用，同一个网络下两台设备都确认权限后，一台设备退出。点击右上角流转按钮，选择需要拉起的远程设备，点击后拉起远程设备，第一次拉起设备时，若未进行认证，输入认证码进行认证，认证成功后拉起远程设备。 3110 31112.游戏过程中，本地设备的用户可以重开，悔棋，远程设备无此功能。下子时，在棋盘某位置点击第一次时预下子，若确定下在该位置，继续点击该位置，若不确定，点击其他位置即可。若远程设备因特殊原因退出或者掉线，本地设备可重新拉起远程设备，拉起后，本地设备点击棋盘任意位置，数据会同步到远程设备，继续进行未完成的游戏。 3112 3113##### 基本原理 3114 3115* 管理分布式设备（节点） 3116 1、创建设备管理对象，并指定参数kvstore应用包deviceManager.createDeviceManager("ohos.samples.distributeddatagobang", (error, value) => {})。 3117 2、获取可信设备列表"this.deviceManager.getTrustedDeviceListSync()"。 3118 3、监听设备状态"this.deviceManager.on('deviceStateChange', (data) => {})"。 3119* 分布式数据管理 3120 1、页面初始化时获取此应用所需能力，引入@ohos.data.distributedData初始化分布式数据库，并使用kvstore.on对数据change进行监听，通过appstorge判断获取相应的key判断是否是分布式节点。 3121 2、如果是分布式节点，如果数据发生变化处理数据，使用this.kvManager.getKVStore()通过指定Options和storeId，创建并获取KVStore数据库。以及添加键值对到数据库this.kvStore.put(key, value)。 3122 3、页面通过kvStore对象进行增删改查会触发其他已连接设备的kvStore.on监听。 3123* 游戏规则编写 3124 1、init()函数初始化游戏规则，通过canvas组件绘制棋盘背景和棋子，游戏状态为开始，共计回合为0，并生成棋盘。 3125 2、触发onClick函数，每click一次，清除一次canvas，数组中添加当前棋子，重绘。 3126 3、当在A盘，且步长是偶数，表示B下的棋子会在A盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'A' && this.distributedData.step % 2 === 0; 3127 4、当在B盘，且步长是奇数，表示A下的棋子会在B盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'B' && this.distributedData.step % 2 !== 0; 3128 5、如果A盘重开(isRestart=true)，那B盘就要清空棋子;不重开(isRestart=false)时，B盘正常显示。 3129 3130##### 约束与限制 3131 3132开发语言：ArkTS 3133 3134配套版本：API9版本SDK，版本号：3.2.11.9 3135 3136[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Game/Game2048) 3137 3138#### Lottie动画 3139 3140##### 介绍 3141 3142本示例展示了lottie对动画的操作功能。引入[Lottie模块](https://gitee.com/openharmony-tpc/lottieETS)，实现控制动画的播放、暂停、倍速播放、播放顺序、播放到指定帧停止或从指定帧开始播放、侦听事件等功能，动画资源路径必须是json格式。 3143 3144##### 使用 3145 31461. 进入页面默认开始2016动画，点击**请选择**进行选择动画资源; 31472. 上面部分播放暂停是对两个动画进行控制，下面部分播放暂停功能是对grunt动画控制; 31483. 点击销毁动画功能之后需要重新选择动画资源才可以进行其余功能操作。 3149 3150##### 基本原理 3151 3152* 页面中使用了Lottie对象控制动画的一系列操作: 3153 * 初始化动画：在canvas的onReady里使用loadAnimation加载动画，须提前声明Animator(‘__lottie_ets’)对象，并在Canvas完成布局后调用； 3154 * Lottie动画操作：lottie.play播放动画，lottie.pause暂停播放，lottie.setDirection设置播放顺序 3155 3156##### 约束与限制 3157 3158开发语言：ArkTS 3159 3160配套版本：API9版本SDK，版本号：3.2.11.9 3161 3162[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Game/Lottie) 3163 3164### 即时通信 3165 3166#### 聊天实例应用 3167 3168##### 介绍 3169 3170本示例使用图片处理能力接口[@ohos.multimedia.image](reference/apis/js-apis-image.md)以及文件存储管理能力接口[@ohos.fileio](reference/apis/js-apis-fileio.md) 。展示一个仿聊天类应用，使用静态布局搭建了不同的页面。为了优化内存与性能体验，在部分list场景使用了懒加载。 3171 3172##### 使用 3173 31741. 应用包含“聊天”、”通讯录“、”发现“、”我“四个主页面，使用Tabs组件实现模块的切换，“聊天”和“通讯录”模块使用了LazyForEach懒加载功能。 3175 31762. 二级及以上页面左上角都有一个返回按钮。 3177 31783. 聊天内容页面的下方输入框点击可以输入内容，表情的图标点击可以发送图片。 3179 31804. “发现”页面的“朋友圈”点击会进入“朋友圈”页面。 3181 3182##### 基本原理 3183 3184懒加载：开发框架提供数据懒加载（LazyForEach组件）从提供的数据源中按需迭代数据，并在每次迭代过程中创建相应的组件。 3185 3186多线程：开发框架提供[多线程并发能力](performance/multi_thread_capability.md)，允许在同一时间段内同时执行多段代码，进行大量或调度点较分散的任务开发和处理。 3187 3188##### 约束与限制 3189 3190开发语言：ArkTS 3191 3192配套版本：API10版本SDK，版本号：4.0.9.6 3193 3194[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/IM/Chat) 3195 3196### 输入法 3197 3198#### 自绘编辑框 3199 3200##### 介绍 3201 3202本示例通过输入法框架实现自会编辑框，可以绑定输入法应用，从输入法应用输入内容，显示和隐藏输入法。 3203 3204##### 使用 3205 32061. 点击编辑框可以绑定并拉起输入法，可以从输入法键盘输入内容到编辑框。 3207 32082. 可以点击**attach**/**dettach**、**show**/**hide**、**on**/**off**按钮来绑定/解绑、显示/隐藏、开启监听/关闭监听。 3209 32103. 输入光标信息后点击**updateCursor**向输入法应用发送光标信息，发送成功会右toast提示。 3211 32124. 输入选中文本的开始和结束位置，点击**changeSelection**可以选中文本。 3213 32145. 选择文本输入类型和Enter键类型后，点击**updateAttribute**可以更新拉起的输入法的输入类型和Enter键类型，依赖输入法应用是否适配。 3215 3216##### 基本原理 3217 3218* 自绘编辑框 3219 * 使用输入法框架实现组件绑定输入法应用，监听输入法事件，显示和隐藏输入法，发送光标和编辑框属性到输入法应用功能。 3220 * 参考接口：[@ohos.inputMethod](reference/apis/js-apis-inputmethod.md) 3221 3222##### 约束与限制 3223 3224开发语言：ArkTS 3225 3226配套版本：API10版本SDK，版本号：4.0.7.2 3227 3228[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/InputMethod/CustomInputText) 3229 3230#### 轻量级输入法 3231 3232##### 介绍 3233 3234本示例使用[@ohos.application.InputMethodExtensionAbility](application-models/inputmethodextentionability.md)系统权限的系统接口，展示一个轻量级的输入法应用，支持在运行OpenHarmony OS的智能终端上。 3235 3236##### 使用 3237 32381. 点击编辑框可以绑定并拉起输入法，可以从输入法键盘输入内容到编辑框。 3239 3240##### 基本原理 3241 3242* 参考接口：[@ohos.application.InputMethodExtensionAbility](application-models/inputmethodextentionability.md) 3243 3244##### 约束与限制 3245 3246开发语言：ArkTS 3247 3248配套版本：API9版本SDK，版本号：3.2.12.5 3249 3250[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/InputMethod/KikaInput) 3251 3252#### Kika输入法应用 3253 3254##### 介绍 3255 3256本示例使用[inputMethodEngine](reference/apis/js-apis-inputmethodengine.md)实现一个轻量级输入法应用kikaInput，支持在运行OpenHarmony OS的智能终端上。 3257 3258##### 使用 3259 32601.使用hdc shell aa start ability -a InputMethod -b cn.openharmony.inputmethodchoosedialog命令拉起切换输入法弹窗，点击kikainput切换输入法到当前应用。 3261 32622.点击应用中的编辑框，拉起输入法键盘。 3263 32643.点击键盘可以在编辑框中输入内容，点击回退键可以删除文本。 3265 32664.点击左上角的键盘图标可以进入二级菜单，当前只有编辑菜单。 3267 32685.点击编辑可以进入编辑状态，点击方向键可以移动光标。 3269 32706.编辑状态点击选择按钮，进入选择状态，点击方向键可以选中文本。 3271 3272##### 基本原理 3273 3274* 该示例分为两个模块： 3275 * 键盘布局 3276 * 在Index中完成键盘的总体布局。在components中自定不同的按键组件。 3277 * 参考接口：[ArkTs声明式开发范式](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/reference/arkui-ts) 3278 * 输入法控制 3279 * 使用[@ohos.request](reference/apis/js-apis-request.md)中API 10接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，前台任务只支持单文件下载，后台任务支持多文件下载。使用[@ohos.file.fs](reference/apis/js-apis-file-fs.md)完成指定路径的创建和查询已下载的文件。 3280 * 参考接口：[@ohos.inputMethodEngine](reference/apis/js-apis-inputmethodengine.md) 3281##### 约束与限制 3282 3283开发语言：ArkTS 3284 3285配套版本：API10版本SDK，版本号：4.0.7.2 3286 3287[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/InputMethod/KikaInputMethod) 3288 3289### 媒体 3290 3291#### 相机和媒体库 3292 3293##### 介绍 3294 3295本示例使用权限管理能力[@ohos.abilityAccessCtrl](reference/apis/js-apis-abilityAccessCtrl.md)、相机模块能力接口[@ohos.multimedia.camera](reference/apis/js-apis-camera.md)、图片处理接口[@ohos.multimedia.image](reference/apis/js-apis-image.md)、音视频相关媒体业务能力接口[@ohos.multimedia.media](reference/apis/js-apis-media.md)、媒体库管理接口[@ohos.multimedia.medialibrary](reference/apis/js-apis-medialibrary.md)、设备信息能力接口[@ohos.deviceInfo](reference/apis/js-apis-device-info.md)、文件存储管理能力接口[@ohos.fileio](reference/apis/js-apis-fileio.md)、弹窗能力接口[@ohos.prompt](reference/apis/js-apis-prompt.md)，展示如何在eTS中调用相机拍照和录像，以及如何使用媒体库接口进行媒体文件的增、删、改、查操作。 3296 3297##### 使用 3298 32991.启动应用，在权限弹窗中授权后返回应用，首页显示当前设备的相册信息，首页监听相册变化会刷新相册列表。 3300 33012.点击 **+** 按钮，弹出相机、录音、文本文件三个图标。 3302 33033.点击**相机**图标，进入相机界面，默认是拍照模式，点击底部拍照按钮可以拍照，拍照完成会在底部左侧显示照片预览图。点击**录像**切换到录像模式，点击底部按钮开始录像，点击结束按钮结束录像，结束录像后底部左侧显示视频图标。点击系统**Back**键或界面顶部**返回**按钮返回首页。 3304 33054.点击**录音**图标进入录音界面，点击右侧**开始**按钮开始录音，按钮变为暂停按钮，点击可以暂停和继续录音，点击左侧**结束**按钮结束录音返回首页。 3306 33075.点击**文本**图标进入文本编辑界面，输入文本内容后点击**Save**按钮，会创建并写入文本文件，完成后返回首页。 3308 33096.点击相册进入文件列表界面，展示相册内的文件，列表中有**删除**和**重命名**按钮，点击可以删除文件和重命名文件。 3310 33117.安装视频播放VideoPlayer应用后，点击视频文件可以调起视频播放界面播放该视频。 3312 3313##### 基本原理 3314 3315* 布局原理：定义@ObjectLink 装饰的数组变量album存放资源文件，使用list()组件中ListItem()循环数组展示，加号Button()，点击后触发 animateTo({ duration: 500, curve: Curve.Ease })控制动画展示。 3316* 获取资源文件：通过引入媒体库实例（入口）接口@ohos.multimedia.medialibrary，例如通过this.getFileAssetsFromType(mediaLibrary.MediaType.FILE)获取FILE类型的文件资源，并通过albums.push()添加至album数组中。 3317* 展示系统资源文件：当album内的值被修改时，只会让用 @ObjectLink 装饰的变量album所在的组件被刷新，当前组件不会刷新。 3318* 录音功能：通过引入音视频接口@ohos.multimedia.media，例如通过media.createAudioRecorder()创建音频录制的实例来控制音频的录制，通过this.audioRecorder.on('prepare', () => {this.audioRecorder.start()})异步方式开始音频录制。 3319* 拍照录像功能：通过引入相机模块接口@ohos.multimedia.camera，例如通过this.cameraManager.createCaptureSession()创建相机入口的实例来控制拍照和录像，通过this.captureSession.start()开始会话工作。 3320 3321##### 约束与限制 3322 3323开发语言：ArkTS 3324 3325配套版本：API9版本SDK，版本号：3.2.11.9 3326 3327[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Media/MultiMedia) 3328 3329### 电商 3330 3331#### 购物示例应用 3332 3333##### 介绍 3334 3335本示例使用延迟任务回调能力接口[@ohos.WorkSchedulerExtensionAbility](reference/apis/js-apis-WorkSchedulerExtensionAbility.md) 、通知管理的能力接口[@ohos.notification](reference/apis/js-apis-notification.md) 、HTTP数据请求能力接口[@ohos.net.http](reference/apis/js-apis-http.md) 、媒体查询接口[@system.mediaquery](reference/apis/js-apis-system-mediaquery.md) 、管理窗口能力接口[@ohos.window](reference/apis/js-apis-window.md) 。实现在进场时加载进场动画，使用[Tabs容器](reference/arkui-ts/ts-container-tabs.md) 实现通过页签进行内容视图切换。使用[自定义弹窗](reference/arkui-ts/ts-methods-custom-dialog-box.md) 设置位置信息。使用[Swiper](reference/arkui-ts/ts-container-swiper.md) 组件实现页面展示图轮播。使用[Grid](reference/arkui-ts/ts-container-list.md) 容器组件设置展示的商品信息。 3336 3337##### 使用 3338 33391、启动应用进入进场动画，然后进入首页的时候会有升级弹窗的提示，判断应用需不需要升级，整个应用分四部分，首页、新品、购物车、我的。可以点击进行切换。 3340 33412、“首页”页面具有扫一扫功能、搜索框、轮播图、tabs、商品列表。 3342 33433、“首页”页面的扫一扫点击可以进行二维码扫描，点击商品可以跳转到详情页。 3344 33454、“商品详情页”上部分是视频，点击视频进行播放，也可以点击进入全屏模式，向下滑动详情页视频可以变成小窗口模式。点击右侧悬浮的直播按钮，可进入直播页面，直播页面可进行视频播放。 3346 33475.“商品详情页”有个分享功能，点击可进行分享。点击选择收货地址可弹出选择地址的选项，可进行选择地址。 3348 33496.断开网络链接，“商品详情页”中点击降价通知后，重新连接网络后通知栏有降价通知。 3350 33517.新品、购物车、我的目前是静态页面。 3352 3353##### 基本原理 3354 33551.应用创建时进行必要的权限判断：在app.json5文件中对```"requestPermission"```对象进行权限匹配。如果有如果权限列表中有-1，说明用户拒绝了授权。 3356 33572.配置Module信息 3358 33593.Navigation的使用 3360 33614.动态加载的使用 3362 33635.hsp包的创建与使用 3364 3365##### 约束与限制 3366 3367开发语言：ArkTS 3368 3369配套版本：API9版本SDK，版本号：3.2.11.9 3370 3371[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Shopping/OrangeShopping) 3372 3373### 工具 3374 3375#### ArkTS时钟 3376 3377##### 介绍 3378 3379本示例通过添加setInterval定时器启动时钟，使用[Canvas组件](reference/arkui-ts/ts-components-canvas-canvas.md)绘制时钟，通过[CanvasRenderingContext2D](reference/arkui-ts/ts-canvasrenderingcontext2d.md) 来画表盘背景、时针、分针、秒针、圆心以及表盘下方文本，结合[@ohos.display](reference/apis/js-apis-display.md) 接口来实现一个简单的时钟应用。 3380 3381##### 使用 3382 33831.界面通过setInterval实现周期性实时刷新时间，使用Canvas绘制时钟，指针旋转角度通过计算得出。 3384 3385##### 基本原理 3386 3387* 本示例展示简单时钟的方法主要封装在Index中。 3388 * 设置表盘大小：通过Index中的display.getDefaultDisplay()方法来获取设备宽高计算表盘大小； 3389 * 获取当前时间：调用updateTime函数，执行new Date().getHours()、new Date().getMinutes()、new Date().getSeconds()获取当前时间。 3390 * 绘制表盘内容：通过[CanvasRenderingContext2D](reference/arkui-ts/ts-canvasrenderingcontext2d.md) 来画表盘背景、时针、分针、秒针、圆心以及表盘下方文本； 3391 * 启动时钟：添加setInterval定时器，每隔1s执行一次updateTime函数。 3392 3393##### 约束与限制 3394 3395开发语言：ArkTS 3396 3397配套版本：API9版本SDK，版本号：3.2.11.9 3398 3399[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/ArkTSClock) 3400 3401#### 翻页时钟 3402 3403##### 介绍 3404 3405本示例集中展示了时钟、闹钟、倒计时、设置屏幕亮度相关的场景， 34061、使用[@ohos.reminderAgentManager](reference/apis/js-apis-reminderAgentManager.md)完成闹钟的相关功能， 34072、使用animateTo完成翻页时钟动画，使用[@ohos.runningLock](reference/apis/js-apis-runninglock.md)完成屏幕常亮功能， 34083、设置屏幕亮度，使用[@ohos.brightness](reference/apis/js-apis-brightness.md)系统能力调节屏幕亮度， 34094、后台消息提醒，使用[@ohos.notificationManager](reference/apis/js-apis-notificationManager.md)系统能力做后台代理提醒。 34105、需要系统存储信息，使用用户首选项接口[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md)。 3411 3412##### 使用 3413 34141.主页面有四个底部标签栏，时钟页面展示了数字翻页时钟功能。 3415 34162.闹钟功能点击**+**号可以创建一个闹钟，等闹钟时间到了会进行提醒。 3417 34183.倒计时功能。 3419 34204.设置里边实现的功能有全屏、调节屏幕亮度和不熄屏。 3421 3422##### 基本原理 3423 3424* 在entry/pages/index.ets中通过tabArray.TabType.num的值来加载每个TabContent()的资源，num:[0,1,2,3]分别加载翻页时钟，闹钟，倒计时，设置组件。 3425* 页面编写步骤： 3426 1、定义以下四个页面组件 FlipClock()//翻转时钟 AlarmClock()// 闹钟CountDown()// 倒计时Setting()//设置 3427 2、使用tabs()标签，将四个组件封装。 3428* 组件逻辑实现 3429 1、时钟： 通过aboutToAppear()中new date()获取当前时间，通过获取date的时、分、秒，10位数通过math.floor()取整，个位数通过对10取余，从而实现对时间格式化，使用box标签，对获取到的数据进行渲染。 3430 2、闹钟： 3431 * a) 使用自定义对话控制器CustomDialogController，定义时间选择器，使用data.preferences存储设置的闹钟，并使用reminderAgentManager将其添加到系统中。 3432 import data_preferences from '@ohos.data.preferences' 3433 import reminderAgentManager from '@ohos.reminderAgentManager' 3434 * b) 页面从data.preferences获取添加的闹钟数据，通过Scroll()标签渲染，在标签row内，设置delete按钮，如果删除就调用以下函数取消系统时钟 3435 import reminderAgentManager from '@ohos.reminderAgentManager' 3436 reminderAgentManager.cancelReminder 3437 3、倒计时 3438 * a) 使用aboutToAppear()初始化界面布局，通过this.listener.on('change', portraitFunc)添加监听， 3439 * b) 点击开始按钮触发以下函数开始计时，并修改按钮的样式为暂停，并将running=true，触发canvas样式 3440 * c) 点击暂停按钮，时间暂停，并将按钮样式修改为开始 3441 * d) 点击reset计时重置，将所有数据初始化 3442 3443##### 约束与限制 3444 3445开发语言：ArkTS 3446 3447配套版本：API9版本SDK，版本号：3.2.11.9 3448 3449[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/FlipClock) 3450 3451#### JS时钟 3452 3453##### 介绍 3454 3455本示例使用JS语言编写示例，设置一个定时器（timer），捕捉用户动作，当用户离开首页时（onHide事件）定时器注销（clearInverval）定时器，当用户回到小程序首页时（onShow事件），重新设置一个定时器（timer）setInterval，使用[transform](reference/arkui-js/js-components-svg-animatetransform.md)设置平移/旋转/缩放的属性，实现一个简单时钟应用。 3456 3457##### 使用 3458 34591.安装hap包。 3460 34612.在桌面上找到hap包打开。 3462 34633.展示时钟页面。 3464 3465##### 基本原理 3466 34671、在首页设置一个定时器（timer），定时调用接口从index.js刷新最新消息通知，更新首页通知列表; 3468 34692、捕捉用户动作，当用户离开首页时（onHide事件）定时器注销（clearInverval）定时器; 3470 34713、当用户回到小程序首页时（onShow事件），重新设置一个定时器（timer）setInterval，定时从index.js刷新最新消息通知。 3472 34734、实现动画样式：通过transform设置平移/旋转/缩放的属性。时钟的指针使用rotate设置x轴和y轴两个维度参数，rotate可以传入具体角度值。指针旋转角度通过计算得出。 3474例如："transform : rotate\(\{\{ second \* 6 \}\}deg\)", 秒针1秒转动6度。 3475 3476##### 约束与限制 3477 3478开发语言：JS 3479 3480配套版本：API9版本SDK，版本号：3.2.11.9 3481 3482[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/JsClock) 3483 3484#### 图案密码锁组件 3485 3486##### 介绍 3487 3488本示例使用用户首选项接口[@ohos.data.preferences](reference/apis/js-apis-data-preferences.md) 异步获取用户设定过的密码，以宫格图案的方式输入密码，用于密码验证。手指触碰图案密码锁时开始进入输入状态，手指离开屏幕时结束输入状态并向应用返回输入的密码。展示图案密码锁组件的使用，实现了密码设置、验证和重置功能。 3489 3490##### 使用 3491 34921.首次进入时需要设置密码，需要两次输入密码相同后点击**设置密码**进行设置，如果第二次输入密码和第一次输入密码不同，会提示重新输入。 3493 34942.设置密码后，需要输入密码解锁，退出应用后重新进入应用，需要再次输入密码验证，密码验证成功进入主页。 3495 34963.设置密码后，在输入密码界面有**重置密码**按钮，点击后需要输入旧密码，旧密码验证成功后开始设置新的密码。 3497 3498##### 基本原理 3499 3500* 在pages/Home.ets中定义密码锁组件，通过定义两个变量isHasPass：是否已经设过密码;isReset：是否需要重置密码; 3501* 密码验证分为几种情况： 3502 1. 首次进入页面， 通过aboutToAppear()初始化调用preferences.getPreferences()获取密码，此时defaultPassword='null'，isHassPass=false，需设置密码并确认密码； 3503 2. 已经设过密码： 通过aboutToAppear()初始化调用preferences.getPreferences()获取密码，此时defaultPassword='oldPassword'，isHassPass=true，页面渲染重置密码text()。 3504 需输入密码和defaultPassword比较，正确后跳转相应页面，若失败提示密码错误，需重新输入密码。 3505 3. 点击重置密码，此时组件清除旧密码，即defaultPassword='null'，此时无密码，走首次无密码流程。 3506* 在pages/index.ets中定义密码通过后的首页页面。 3507 3508##### 约束与限制 3509 3510开发语言：ArkTS 3511 3512配套版本：API9版本SDK，版本号：3.2.11.9 3513 3514[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/PatternLock) 3515 3516 3517 3518## 关键特性 3519 3520### 分布式 3521 3522#### ArkTS分布式计算器 3523 3524##### 介绍 3525 3526本示例使用分布式数据管理接口[@ohos.data.distributedData](reference/apis/js-apis-distributed-data.md)、媒体查询接口[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md)，实现设备之间的kvStore对象的数据传输交互。通过StartAbility实现远端应用的拉起以及DistributedDataKit分布式数据框架实现异端应用的数据同步，实现一个简单的计算器应用，可以进行简单的数值计算，支持远程拉起另一个设备的计算器应用，两个计算器应用进行协同计算。 3527 3528##### 使用 3529 35301.点击桌面应用图标，启动应用。 3531 35322.点击应用右上角按钮，或者在界面任意位置滑动（上下左右滑动皆可）即可弹出设备选择框。 3533 35343.在设备选择框中点击对端设备名称，拉起对端应用。 3535 35364.对端应用启动后，可在任意一端中操作应用，两端应用可实现数据实时同步。 3537 35385.在设备选择框中选中本机即可关闭对端应用。 3539 3540##### 基本原理 3541 3542在分布式计算器应用中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 3543首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 3544#### 分布式设备搜索 3545通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见startDeviceDiscovery(){}模块。 3546#### 分布式设备列表弹窗 3547使用@CustomDialog装饰器来装饰分布式设备列表弹窗。 3548#### 远端设备拉起 3549通过startAbility(deviceId)方法拉起远端设备的包。 3550#### 分布式数据管理 3551(1) 管理分布式数据库 3552创建一个KVManager对象实例，用于管理分布式数据库对象。通过distributedData.createKVManager(config)，并通过指定Options和storeId，创建并获取KVStore数据库，并通过Promise方式返回，此方法为异步方法，例如this.kvManager.getKVStore(STORE_ID, options).then((store) => {})。 3553(2) 订阅分布式数据变化 3554通过订阅分布式数据库所有（本地及远端）数据变化实现数据协同。 3555 3556##### 约束与限制 3557 3558开发语言：ArkTS 3559 3560配套版本：API10版本SDK，版本号：4.0.10.7 3561 3562[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/ArkTSDistributedCalc) 3563 3564#### ArkTS分布式音乐播放 3565 3566##### 介绍 3567 3568本示例使用与用户进行交互的Ability的能力接口[@ohos.ability.featureAbility](reference/apis/js-apis-ability-featureAbility.md)、文件存储管理能力接口[@ohos.fileio](reference/apis/js-apis-fileio.md)、屏幕属性接口[@ohos.display](reference/apis/js-apis-display.md)、媒体查询接口[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md)、分布式数据管理接口[@ohos.data.distributedData](reference/apis/js-apis-distributed-data.md)、音视频相关媒体业务能力接口[@ohos.multimedia.media](reference/apis/js-apis-media.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md)，实现设备之间的kvStore对象的数据传输交互。通过AudioPlayer实现音频播放能力，调用分布式数据各个接口，应用程序可将数据保存到分布式数据库中，并可对分布式数据库中的数据进行增/删/改/查等各项操作。 3569 3570##### 使用 3571 35721.**音乐播放**，点击**播放**、**暂停**、上**一曲**、下**一曲**按钮可以对音乐进行操作。 3573 35742.**跨设备分享**，组网并且双端均已授权条件下，点击**分享**按钮，选择设备，拉起对端设备上的音乐，并将本端的播放状态同步到对端上。 3575 35763.**跨设备停止分享**，分享成功前提条件下，点击**停止分享**按钮，将对端设备拉起的音乐应用停止退出。 3577 3578##### 基本原理 3579 3580在分布式音乐播放器中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 3581首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 3582#### 分布式设备搜索 3583通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见registerDeviceListCallback(callback) {}模块。 3584#### 分布式设备列表弹窗 3585使用@CustomDialog弹出分布式设备列表弹窗，参考首页。 3586#### 远端设备拉起 3587通过startAbility(deviceId)方法拉起远端设备的包。 3588#### 分布式数据管理 3589(1) 管理分布式数据库 3590创建一个KVManager对象实例，用于管理分布式数据库对象。通过distributedData.createKVManager(config)，并通过指定Options和storeId，创建并获取KVStore数据库，并通过Promise方式返回，此方法为异步方法，例如this.kvManager.getKVStore(STORE_ID, options).then((store) => {}) 3591(2) 订阅分布式数据变化 3592通过订阅分布式数据库所有（本地及远端）数据变化实现数据协同。 3593 3594##### 约束与限制 3595 3596开发语言：ArkTS 3597 3598配套版本：API9版本SDK，版本号：3.2.11.9 3599 3600[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/ArkTSDistributedMusicPlayer) 3601 3602#### JS分布式计算器 3603 3604##### 介绍 3605 3606本示例使用分布式数据管理接口[@ohos.data.distributedData](reference/apis/js-apis-distributed-data.md)、媒体查询接口[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md)，实现设备之间的kvStore对象的数据传输交互。通过StartAbility实现远端应用的拉起以及DistributedDataKit分布式数据框架实现异端应用的数据同步，实现一个简单的计算器应用，可以进行简单的数值计算，支持远程拉起另一个设备的计算器应用，两个计算器应用进行协同计算。 3607 3608##### 使用 3609 36101.点击桌面应用图标，启动应用。 3611 36122.点击应用右上角按钮，或者在界面任意位置滑动（上下左右滑动皆可）即可弹出设备选择框。 3613 36143.在设备选择框中点击对端设备名称，拉起对端应用。 3615 36164.对端应用启动后，可在任意一端中操作应用，两端应用可实现数据实时同步。 3617 36185.在设备选择框中选中本机即可关闭对端应用。 3619 3620##### 基本原理 3621 3622在分布式计算器应用中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 3623首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 3624#### 分布式设备搜索 3625通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见startDeviceDiscovery(){}模块 3626#### 分布式设备列表弹窗 3627使用calc-select-device-dialog渲染分布式设备列表弹窗 3628#### 远端设备拉起 3629selectDevice()发起远程设备调用，featureAbility.startAbility()方法拉起远端设备的包，调用dataChange(key, value)改变kvstore的值。 3630#### 分布式数据管理 3631(1) 管理分布式数据库 3632创建一个KVManager对象实例，用于管理分布式数据库对象。通过distributedData.createKVManager(config)，并通过指定Options和storeId，创建并获取KVStore数据库，并通过Promise方式返回，此方法为异步方法，例如this.kvManager.getKVStore(STORE_ID, options).then((store) => {})。 3633(2) 订阅分布式数据变化 3634通过订阅分布式数据库所有（本地及远端）数据变化实现数据协同。 3635 3636##### 约束与限制 3637 3638开发语言：JS 3639 3640配套版本：API10版本SDK，版本号：4.0.9.6 3641 3642[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributeCalc) 3643 3644#### 分布式帐号 3645 3646##### 介绍 3647 3648本示例主要展示了分布式帐号相关的功能，使用[@ohos.account.distributedAccount](reference/apis/js-apis-distributed-account.md)、[@ohos.account.osAccount](reference/apis/js-apis-osAccount.md)等接口，实现了绑定分布式帐号、解绑分布式帐号、更新分布式帐号信息和管理分布式帐号的功能。 3649 3650##### 使用 3651 36521. 首次进入应用会根据分布式帐号绑定状态进行页面跳转，若帐号已绑定，则直接跳转至帐号列表界面；若帐号未绑定，则需要在首页进行绑定； 36531. 首页输入分布式帐号名（必填）、昵称，选择头像（需先使用hdc命令将图片推到storage/media/100/local/files/Pictures/路径下并重启），选择绑定的系统帐号，点击**绑定**，绑定成功跳转至帐号列表界面； 36542. 在帐号列表界面，可对所有可解绑分布式帐号进行管理，点击选择分布式帐号，跳转至对应的帐号信息界面； 36553. 在帐号信息界面，点击**解绑**，可解绑该分布式帐号； 36563. 在帐号解绑之后，可对分布式帐号信息进行更新，在首页直接进行输入后点击绑定即可。 3657 3658##### 基本原理 3659 3660* 绑定、解绑、查询、更新分布式帐号的功能接口封装在DistributedAccountModel： 3661 * 使用distributedAccount.getDistributedAccountAbility()获取分布式帐号单实例对象accountAbility; 3662 * 绑定、解绑和更新分布式帐号：使用accountAbility.setOsAccountDistributedInfoByLocalId(); 3663 * 查询分布式帐号信息：使用accountAbility.getOsAccountDistributedInfo()和accountAbility.getOsAccountDistributedInfoByLocalId; 3664 3665##### 约束与限制 3666 3667开发语言：ArkTS 3668 3669配套版本：API10版本SDK，版本号：4.0.7.5 3670 3671[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedAccount) 3672 3673#### 设备管理 3674 3675##### 介绍 3676 3677本示例主要展示了设备管理相关的功能，使用[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md) 等接口，实现了包括获取本机设备信息，获取授信设备列表，根据过滤条件扫描设备，设备认证，设备状态订阅，导入凭据，控制设备是否允许被发现等功能。 3678 3679##### 使用 3680 36811. 进入应用会自动获取本机设备信息，并且注册设备状态监听，在有设备上下线的时候，刷新可信设备列表 36822. 在主界面，可以点击允许被发现开关控制本机是否允许被发现； 36833. 在主界面，可以点击刷新，刷新可信设备列表，点击已认证，解除认证关系； 36844. 在主界面，可以点击过滤条件，选择对应的过滤条件，在发现设备时进行过滤； 36855. 在主界面，可以点击发现，发现周边的设备，并点击发现的设备，进行PIN码认证； 3686 3687##### 基本原理 3688 3689获取本机设备信息，获取授信设备列表，根据过滤条件扫描设备，设备认证，设备状态订阅，控制设备是否允许被发现等功能，接口封装在RemoteDeviceModel： 3690 3691 * 使用RemoteDeviceModel.createDeviceManager()来获取DeviceManager对象； 3692 * 获取本机设备信息：调用RemoteDeviceModel.getLocalDeviceInfo()来获取本机设备信息； 3693 * 注册设备状态监听：调用RemoteDeviceModel.registerDeviceStateListener()，来注册设备状态监听; 3694 * 获取可信设备列表：调用RemoteDeviceModel.getTrustedDeviceList()来获取可信设备列表; 3695 * 发布设备：调用RemoteDeviceModel.setIsSupportRange()设置是否上报距离，然后调用deviceManager.publishDeviceDiscovery()发布设备; 3696 * 停止发布设备：调用RemoteDeviceModel.unAuthenticateDevice()停止发布; 3697 * 发现和停止发现设备：调用RemoteDeviceModel.startDeviceDiscovery()发现设备，调用RemoteDeviceModel.stopDeviceDiscovery()停止发现设备; 3698 * 认证和取消认证设备：调用RemoteDeviceModel.authenticateDevice()认证，调用RemoteDeviceModel.unAuthenticateDevice()取消认证设备; 3699 3700##### 约束与限制 3701 3702开发语言：ArkTS 3703 3704配套版本：API10版本SDK，版本号：4.0.9.6 3705 3706[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedAuthentication) 3707 3708#### 分布式备忘录 3709 3710##### 介绍 3711 3712本示例使用分布式数据管理接口[@ohos.data.distributedData](reference/apis/js-apis-distributed-data.md)、权限管理能力[@ohos.abilityAccessCtrl](reference/apis/js-apis-abilityAccessCtrl.md)、分布式数据对象接口[@ohos.data.distributedDataObject](reference/apis/js-apis-data-distributedobject.md)以及分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md)，实现设备之间的distributedDataObject对象的数据传输交互，展示在eTS中如何使用分布式数据对象实现一个简单的分布式备忘录。 3713 3714##### 使用 3715 37161. 启动应用，选择允许授权后，选择不同的分布式对象进入，如选择distributiedNote，则进入笔记界面： 3717 1. 点击右上角按钮可以连接组网设备，选择设备后进行连接，连接成功后两个设备上首页状态均显示绿色，每次连接其他设备，界面会清空备忘录内容。 3718 2. 点击**添加**按钮进入添加界面，可以编辑标题、内容、标记颜色，点击**提交**按钮添加备忘录。 3719 3. 点击**清除**按钮清除所有备忘录内容。 3720 4. 点击已经添加的备忘录可以进入编辑界面更新备忘录内容，编辑完成后点击**提交**按钮更新备忘录。 3721 5. 两台设备连接成功后步骤2、3、4的操作会同步到另一台设备上。 37222. 如选择distributiedCanvas，则进入画布界面： 3723 1. 点击右上角按钮可以连接组网设备，选择设备后进行连接，连接成功后两个设备上首页状态均显示绿色。 3724 2. 点击ellipse或者rect按钮，则进行绘制对应的图形。 3725 3. 点击delete，则删除所有绘制的图形。 3726 4. 两台设备连接成功后步骤2、3的操作会同步到另一台设备上。 3727 5. 点击back按钮，则回退到选择分布式对象的首页。 3728 3729##### 基本原理 3730 3731在分布式笔记应用中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 3732首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 3733#### 分布式设备搜索 3734通过SUBSCRIBE_ID搜索分布式组网内的设备，详见startDeviceDiscovery(){}模块。 3735#### 分布式设备列表弹窗 3736使用@CustomDialog装饰器来装饰分布式设备列表弹窗。 3737#### 远端设备拉起 3738通过startAbility(deviceId)方法拉起远端设备的包。 3739#### 分布式数据管理 3740(1) 管理分布式数据库 3741创建一个distributedObject分布式数据对象实例，用于管理分布式数据对象。详见distributedObject.createDistributedObject()。 3742(2) 订阅分布式数据变化 3743通过this.distributedObject.on('status', this.statusCallback)监听分布式数据对象的变更。 3744#### 笔记 3745(1)UIAbility拉起弹框请求用户授权:在onCreate()时通过abilityAccessCtrl.createAtManager.requestPermissionsFromUser(this.context, ['ohos.permission.DISTRIBUTED_DATASYNC']).then((data)=> {})获取不同设备间的数据交换权限。 3746(2)将sessionID存在应用全局的UI状态存储AppStorage内：在onCreate(want, launchParam) {}时拿到sessionId并存储在AppStorage内，并把同时把sessionId绑定到@StorageLink上实现双向数据绑定。 3747(3)对笔记内容进行存储在dataArray:note[]中：通过this.noteDataSource['dataArray'] = this.globalObject.distributedObject.documents。 3748(4)笔记内容更新：通过绑定Button的onClick事件指定this.globalObject.update(index, this.note.title, this.note.content, this.note.mark)进行笔记内容和状态更新。 3749(5)实现分布式数据自动同步：通过this.globalObject.distributedObject.setSessionId(this.sessionId)，从而实现当可信组网中有多个设备时，多个设备间的对象如果设置为同一个sessionId的笔记数据自动同步，并将其封装在share()函数内。 3750(6)在首页的onPageShow()钩子中，调用share()实现首页在分布式设备上同步渲染组件。 3751 3752##### 约束与限制 3753 3754开发语言：ArkTS 3755 3756配套版本：API10版本SDK，版本号：4.0.9.1 3757 3758[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedNote) 3759 3760#### 分布式关系型数据库 3761 3762##### 介绍 3763 3764本示例使用[@ohos.data.relationalStore](reference/apis/js-apis-data-relationalStore.md) 接口和[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md) 接口展示了在eTS中分布式关系型数据库的使用，在增、删、改、查的基本操作外，还包括分布式数据库的数据同步同能。 3765 3766##### 使用 3767 37681. 启动应用后点击“**+**”按钮可以添加联系人; 37692. 点击联系人可以进入编辑界面编辑联系人信息; 37703. 长按联系人进入多选状态，底部有“**全选**”、“**取消**”、“**删除**”、“**退出**”按钮，点击退出可以退出多选状态; 37714. 点击右上角更多按钮，点击“**连接设备**”，选择要同步数据的设备，连接成功后可以开始将本端数据同步到对端; 37725. 点击右上角更多按钮，点击“**设置**”可以进入设置界面设置数据同步方式，包括自动同步和手动同步。 3773 3774##### 基本原理 3775 3776+ 数据库的增、删、改、查操作都在RdbModel中，: 3777 + 数据库操作：使用[@ohos.data.relationalStore](reference/apis/js-apis-data-relationalStore.md) 接口的getRdbStore获得一个相关的操作型关系数据库RdbStore，通过这个RdbStore调用相关接口进行增删改查，RdbStore.insert数据插入,RdbStore.delete数据删除，RdbStore.update更新数据，RdbStore.query根据条件查询数据; 3778 + 数据同步：RdbStore.on注册数据库观察者，使用RdbStore.obtainDistributedTableName根据本地表名获取指定远程设备的分布式表名，数据发生变动时通过RdbStore.sync同步数据，不需要用时删除指定观察者使用RdbStore.off。 3779+ 连接设备管理在RemoteDeviceModel中: 3780 + 设备同步：设备同步数据需要[ohos.permission.DISTRIBUTED_DATASYNC](security/AccessToken/permissions-for-all.md#ohospermissiondistributed_datasync) 权限，在页面渲染前申请权限,使用[@ohos.distributedDeviceManager](reference/apis/js-apis-distributedDeviceManager.md) 接口，首先通过createDeviceManager创建设备管理器实例，然后通过getTrustedDeviceListSync同步获取所有可信设备列表； 3781 + 设备连接：首先通过on方法注册设备状态，例如发现设备，设备连接失败，然后通过startDeviceDiscovery方法发现周边设备，然后选择连接设备，再启动连接设备的应用。 3782 3783##### 约束与限制 3784 3785开发语言：ArkTS 3786 3787配套版本：API10版本SDK，版本号：4.0.9.6 3788 3789[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedRdb) 3790 3791#### JS分布式音乐播放 3792 3793##### 介绍 3794 3795本示例使用与用户进行交互的Ability的能力接口[@ohos.ability.featureAbility](reference/apis/js-apis-ability-featureAbility.md)、文件存储管理能力接口[@ohos.fileio](reference/apis/js-apis-fileio.md)、屏幕属性接口[@ohos.display](reference/apis/js-apis-display.md)、媒体查询接口[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md)、分布式数据管理接口[@ohos.data.distributedData](reference/apis/js-apis-distributed-data.md)、音视频相关媒体业务能力接口[@ohos.multimedia.media](reference/apis/js-apis-media.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md)，实现设备之间的kvStore对象的数据传输交互。通过AudioPlayer实现音频播放能力，调用分布式数据各个接口，应用程序可将数据保存到分布式数据库中，并可对分布式数据库中的数据进行增/删/改/查等各项操作。 3796 3797##### 使用 3798 37991.**音乐播放**，点击**播放**、**暂停**、上**一曲**、下**一曲**按钮可以对音乐进行操作。 3800 38012.**跨设备迁移播放**，组网条件下，点击**流转**按钮，选择设备，拉起对端设备上的音乐，本端退出。 3802 3803##### 基本原理 3804 3805在分布式音乐播放器中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 3806首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 3807###### 分布式设备搜索 3808通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见registerDeviceListCallback_(callback) {}模块。 3809###### 分布式设备列表弹窗 3810使用continueAbilityDialog弹出分布式设备列表弹窗，参考首页。 3811###### 远端设备拉起 3812通过startAbility(deviceId)方法拉起远端设备的包。 3813 3814##### 约束与限制 3815 3816开发语言：JS 3817 3818配套版本：API10版本SDK，版本号：4.0.9.6 3819 3820[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/JsDistributedMusicPlayer) 3821 3822#### 分布式数据管理 3823 3824##### 介绍 3825 3826本示例展示了在eTS中分布式数据管理的使用，包括KVManager对象实例的创建和KVStore数据流转的使用。 3827 3828通过设备管理接口[@ohos.distributedHardware.deviceManager](reference/apis/js-apis-device-manager.md) ，实现设备之间的kvStore对象的数据传输交互，该对象拥有以下能力[详见](reference/apis/js-apis-device-manager.md) ; 38291、注册和解除注册设备上下线变化监听 38302、发现周边不可信设备 38313、认证和取消认证设备 38324、查询可信设备列表 38335、查询本地设备信息，包括设备名称，设备类型和设备标识 38346、发布设备发现 3835 3836##### 使用 3837 38381.两台设备组网。 3839 38402.在一台界面中点击右上角的流转按钮，在弹窗中选择对端设备拉起对端设备上的应用。 3841 38423.拉起对端设备后，在界面中点击"+"按钮新增笔记卡片，点击每个卡片右上角的"X"按钮可以删除此卡片，可以看到对端设备和当前设备界面数据保持一致。 3843 38444.操作对端设备，当前设备界面也会保持和对端设备界面显示一致。 3845 3846##### 基本原理 3847 38481、页面初始化时获取此应用所需能力：引入@ohos.data.distributedKVStore初始化kvstore数据库并对使用kvstore.on数据change进行监听，通过appstorge判断获取相应的key判断是否是分布式节点。 38492、如果是分布式节点，如果数据发生变化，处理数据并使用.noteDataSource()进行reload数据。 38503、页面通过kvStore对象进行增删改查会触发其他已连接设备的kvStore.on监听。 3851 3852 3853##### 约束与限制 3854 3855开发语言：ArkTS 3856 3857配套版本：API9版本SDK，版本号：3.2.11.9 3858 3859[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/Kvstore) 3860 3861### 一次开发多端部署 3862 3863#### ArkTS多设备自适应能力 3864 3865##### 介绍 3866 3867本示例是[《一次开发，多端部署》](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)的配套示例代码，展示了[页面开发的一多能力](key-features/multi-device-app-dev/layout-intro.md)，包括自适应布局、响应式布局、典型布局场景以及资源文件使用。 3868 3869| 名称 | 简介 | 3870| ------------ | ------------------------------------------------------------ | 3871| 自适应布局 | 当外部容器大小发生变化时，元素可以**根据相对关系自动变化**以适应外部容器变化的布局能力。 | 3872| 响应式布局 | 当外部容器大小发生变化时，元素可以**根据断点或特定的媒体特征（如屏幕方向、窗口宽高等）自动变化**以适应外部容器变化的布局能力。 | 3873| 典型布局场景 | 应用开发中的典型场景，包括运行横幅、网格、侧边栏等。 | 3874| 资源文件使用 | 根据当前的设备特征（如设备类型、屏幕密度等）或应用场景（如语言、国家、地区等），从resources目录下不同的资源限定词目录中获取相应的资源值。 | 3875 3876##### 使用 3877 38781. 启动应用，首页展示了自适应布局、响应式布局、典型布局场景和资源文件使用四个按钮。 3879 38802. 点击"自适应布局"进入新页面，分别展示拉伸能力、缩放能力、隐藏能力、折行能力、均分能力、占比能力和延伸能力共7种自适应布局能力。 3881 38823. 点击"响应式布局"进入新页面，分别展示断点、媒体查询和栅格布局3种响应式布局能力。 3883 38844. 点击"典型布局场景"进入新页面，展示了如何通过自适应布局能力和响应式布局能力，实现应用开发中的典型场景。 3885 38865. 点击"资源文件使用"进入新页面，展示字符串和图片资源的使用。 3887 3888##### 基本原理 3889 3890* 该示例使用了路由跳转接口，实现了各个不同布局之间的页面跳转，通过MediaQueryListener方法查询媒体，matchMediaSync方法设置媒体查询的查询条件。 3891* 接口参考：[@ohos.router](reference/apis/js-apis-system-router.md)，[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md) 3892 3893##### 约束与限制 3894 3895开发语言：ArkTS 3896 3897配套版本：API10版本SDK，版本号：4.0.9.6 3898 3899[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/AdaptiveCapabilities) 3900 3901#### 一多应用市场首页 3902 3903##### 介绍 3904 3905本示例使用媒体查询接口[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md)，结合[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示，展示应用市场首页，页面中包括Tab栏、运营横幅、精品应用、精品游戏等。 3906 3907##### 使用 3908 39091. 启动应用，可以查看本应用在全屏状态下的显示效果。 3910 39112. 在应用顶部，下滑出现窗口操作按钮。（建议通过外接鼠标操作，接入鼠标只需要将鼠标移动至顶部即可出现窗口） 3912 39133. 点击悬浮图标，将应用悬浮在其它界面上显示。 3914 39154. 拖动应用悬浮窗口的边框，改变窗口尺寸，触发应用刷新，即可查看应用在不同窗口下的显示效果。 3916 39175. 改变窗口尺寸的过程中，窗口尺寸可能超出屏幕尺寸。此时在屏幕中只能看到应用部分区域的显示，但可以通过移动窗口位置，查看应用其它区域的显示。 3918 3919##### 基本原理 3920 3921本示例介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口，将页面分拆为5个部分。 3922#### 底部/侧边导航栏 39231、在sm和md断点下，导航栏在底部；在lg断点下，导航栏在左侧。 39242、通过Tab组件的barPosition和vertical属性控制TabBar的位置在主轴方向起始或结尾位置和水平或垂直方向，同时还可以通过barWidth和barHeight属性控制TabBar的尺寸。 3925 3926##### 约束与限制 3927 3928开发语言：ArkTS 3929 3930配套版本：API9版本SDK，版本号：3.2.11.9 3931 3932[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/AppMarket) 3933 3934#### 健康饮食 3935 3936##### 介绍 3937 3938本示例使用了路由跳转[@ohos.router](reference/apis/js-apis-system-router.md)，比如点击食物，可以跳转至相应的食物详情页面，通过[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)，使用其中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示，使用[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md)的MediaQueryListener方法查询媒体，matchMediaSync方法设置媒体查询的查询条件，[@ohos.curves](reference/apis/js-apis-curve.md)的cubicBezierCurve方法构造三阶贝塞尔曲线对象。 3939 3940##### 使用 3941 39421. 本应用一共有“启动动画页面”、“首页”和“食物详情”三个主页面； 39432. 启动应用，进入“启动动画页面”，动画播放完成自动进入主页； 39443. 首页，使用Tabs组件把首页分为两个页签：“主页”页签和“记录”页签。“主页”页签展示所有食物，支持通过Tab子页签展示的食物分类网格布局和字母排序列表两种方式查看，点击食物项可进入相应的食物详情页面，查看食物详情。食物“记录”页签，展示饮食记录，通过卡片展示不同时间段的饮食信息，卡片信息包含有食物的种类、重量、卡路里值以及用餐时间；以柱状图的形式展示每一餐所有食物的热量值和包含的营养元素含量；可以在卡片里面通过使用加减按钮来修改食物的重量，同时会重新统计相应用餐时间的总热量值、总蛋白质、总脂肪和总碳水值，并且柱状图的数据会及时更新; 39455. 食物详情页面，使用滑动组件展示食物的详细信息，包括使用画布组件展示单位重量的食物各个营养元素的的占比,使用进度条组件展示当前食物是否为高热食物，以及展示单位重量的食物所包含的热量、脂肪、蛋白质、碳水以及维他命C值；并且点击记录按钮可以弹出记录饮食的弹窗，包括记录食物的种类、重量以及用餐时间，可以通过点击完成添加饮食，同时添加的饮食信息会在“记录”Tab页签做展示。 3946 3947##### 基本原理 3948 3949* 本实例使用了路由跳转，比如点击食物，可以跳转至相应的食物详情页面，通过一次开发多端部署，使用其中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示，使用MediaQueryListener方法查询媒体，matchMediaSync方法设置媒体查询的查询条件，cubicBezierCurve方法构造三阶贝塞尔曲线对象。 3950* 接口参考：[@ohos.router](reference/apis/js-apis-system-router.md)，[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)，[@ohos.curves](reference/apis/js-apis-curve.md)，[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md) 3951 3952##### 约束与限制 3953 3954开发语言：ArkTS 3955 3956配套版本：API9版本SDK，版本号：3.2.11.9 3957 3958[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/HealthyDiet) 3959 3960#### JS多设备自适应能力 3961 3962##### 介绍 3963 3964此Demo展示在JS中的多设备自适应能力，包括资源限定词、原子布局和响应式布局。 3965 3966##### 使用 3967 39681.本示例中的资源限定词和响应式布局针对常见设备类型做了适配，可以在预览器中开启"Multi-profile preview"进行多设备预览。 3969 39702.本示例中的原子布局提供了滑动条（slider），通过拖动滑动条更改父容器尺寸可以更直观的查看原子布局的效果。为了突出重点以及易于理解，此部分的代码做了一定精简，建议通过IDE预置的MatePadPro预览器查看此部分效果。 3971 39723.启动应用，首页展示了**资源限定词**、**原子布局**和**响应式布局**三个按钮。 3973 39744.点击**资源限定词**进入新界面，展示字符串和图片资源的使用。 3975 39765.点击**原子布局**进入新界面，分别展示原子布局的拉伸能力、缩放能力、隐藏能力、折行能力、均分能力、占比能力、延伸能力。 3977 39786.点击**响应式布局**进入新界面，展示媒体查询、栅格布局、典型场景三类响应式布局能力。 3979 3980##### 基本原理 3981 39821、index下定义三个box，分别资源限定词resourceQualifier、原子布局atomicLayoutCapability、响应式布局responsiveLayout，并通过onclick路由到各自的组件。 39832、资源限定词组件： 在MainAbility.resource下定义需要访问的资源，在资源限定词resourceQualifier组件中，使用$r('')即可实现不同形态和规格访问到不同的资源。 39843、原子布局atomicLayoutCapability组件：该布局下，通过slide滑动控制样式的展示比率rate,例如下面这个样例。 39854、响应式布局responsiveLayout ：该布局下需要相对应的媒体资源，比如sm、md、lg，然后监听媒体的变化，从而对资源进行响应式的调整。 例如栅格布局。本案例定义了xs、sm、md、lg下的栅格宽度，根据系统的规格自动选择相应的属性。 39865、使用mediaQuery对规格进行监听，判断当前系统的横竖屏，从而加载相应的资源。 3987 3988##### 约束与限制 3989 3990开发语言：JS 3991 3992配套版本：API9版本SDK，版本号：3.2.11.9 3993 3994[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/JsAdaptiveCapabilities) 3995 3996#### 一多分栏控件 3997 3998##### 介绍 3999 4000本示例分别展示了多场景下，一多分栏控件的响应式变化效果。分别用到了[SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md)组件与[Navigation](reference/arkui-ts/ts-basic-components-navigation.md)组件，对应使用场景如下： 4001 4002- A+B+C：即SideBarContainer组件组合Navigation组件 4003 1. 预览器窗口宽度>840vp时，显示A、B、C三列，放大缩小时，优先变化C列 4004 2. 预览器窗口宽度<=840vp并且>600vp时，显示B、C两列，放大缩小时，优先变化C列 4005 3. 预览器窗口宽度<=600vp并且>360vp时，仅显示C列 4006- A+C：SideBarContainer组件 4007 1. 预览器窗口宽度>600vp时，显示A、C三列，放大缩小时，优先变化C列 4008 2. 预览器窗口宽度<=600vp并且>360vp时，仅显示C三列 4009- B+C：Navigation组件 4010 1. 预览器窗口宽度>600vp时，显示B、C三列，放大缩小时，优先变化C列 4011 2. 预览器窗口宽度<=600并且>360vp时，仅显示C三列 4012 4013##### 使用 4014 40151.在预览器中查看页面效果 4016 40172.在预览器中开启窗口拖拽模式，拖动窗口变化，可以查看组件的响应式变化 4018 4019##### 基本原理 4020 4021* [SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md)组件，自动隐藏侧边栏的功能是由minContentWidth与minSideBarWidth属性实现的。当设置[SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md)组件组件的显示类型为SideBarContainerType.Embed,并且窗口宽度达到minContentWidth + minSideBarWidth的边界值时，侧边栏自动隐藏。 4022 4023* [Navigation](reference/arkui-ts/ts-basic-components-navigation.md)组件，自动隐藏侧边栏的功能是由minContentWidth属性实现的。当[Navigation](reference/arkui-ts/ts-basic-components-navigation.md)的内容区域达到minContentWidth设置的值时，navBar自动隐藏。 4024 4025##### 约束与限制 4026 4027开发语言：ArkTS 4028 4029配套版本：API10版本SDK，版本号：4.0.9.2 4030 4031[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/MultiColumns) 4032 4033#### 一多导航栏 4034 4035##### 介绍 4036 4037本示例展示了导航组件在不同设备形态下的样式。 4038 4039- 在sm设备上，以tabs形式展示，内容、导航为上下样式布局，通过点击底部tabs切换内容； 4040- 在md/lg设备上，以[SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md)形式展示，内容、导航为左右布局，通过点击侧边一二级菜单进行内容切换。 4041 4042本示例使用[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev) 中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，主要通过组件提供窗口断点事件，保证应用在不同设备或不同窗口尺寸下可以正常显示。 4043 4044##### 使用 4045 40461. 打开首页，在IDE编辑器中打开预览器查看预览效果。 40472. 在预览器中开启窗口拖拽模式，拖动窗口变化，可以查看组件的响应式变化。 40483. 手动自由拖拽窗口，将应用窗口在sm/md/lg三种设备形态下进行切换并查看预览效果。 40494. 在sm/lg窗口下，点击左上角图标进行侧边栏样式切换。 4050 4051##### 基本原理 4052 4053本示例介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口,将页面分拆为2部分。 4054 4055**整体布局:** 4056 40571.通过GridRow组件提供的断点事件，获取到当前窗口的断点，通过visibility属性将[Tabs](reference/arkui-ts/ts-container-tabs.md)组件与[SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md)组件分别在sm/(md、lg) 4058形态下展示/隐藏。 4059 40602.同时通过断点，对组件设置不同的样式属性，以最优的效果展示。 4061 4062**侧边栏SideBar/底部TabsController:** 4063 40641.侧边栏内容布局通过Flex容器分别在sm/(md、lg)形态下进行横竖展示。 4065 40662.内容区域通过不同的窗口断点进行选择显隐。 4067 40683.md、lg形态侧边栏一级菜单对应sm形态最外层的TabsController组件、二级菜单对应里层的TabsController组件。 4069 40704.侧边栏同时存在两种形态list/tabs，通过侧边栏左上角图标切换，list模式下内容区域较小，根据窗口断点只显示图标/图标+文字，tabs模式下内容区域较大，显示图标+文字。 4071 4072**内容区域:** 4073 40741.Swiper组件通过获取窗口断点，设置displayCount属性，在不同窗口下显示不同数量的图片。 4075 40762.Gird组件通过获取窗口断点，设置columnsTemplate与rowsTemplate属性，在不同窗口下显示不同数量的Item。 4077 40783.内容浏览的连续性，进行窗口切换时，内容区域的浏览进度可以保持，不会进行重新刷新。 4079 4080##### 约束与限制 4081 4082开发语言：ArkTS 4083 4084配套版本：API10版本SDK，版本号：4.0.8.2 4085 4086[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/MultiNavBar) 4087 4088#### 一多音乐专辑主页 4089 4090##### 介绍 4091 4092本示例使用媒体查询接口[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md)，[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示，展示音乐专辑主页。 4093 4094- 头部返回栏: 因元素单一、位置固定在顶部，因此适合采用自适应拉伸，充分利用顶部区域。 4095- 专辑封面: 使用栅格组件控制占比，在小尺寸屏幕下封面图与歌单描述在同一行。 4096- 歌曲列表: 使用栅格组件控制宽度，在小尺寸屏幕下宽度为屏幕的100%，中尺寸屏幕下宽度为屏幕的50%，大尺寸屏幕下宽度为屏幕的75%。 4097- 播放器: 采用自适应拉伸，充分使用底部区域。 4098 4099##### 使用 4100 41011.启动应用，查看本应用在全屏状态下的效果。 4102 41032.在应用顶部，下滑出现窗口操作按钮。（建议通过外接鼠标操作，接入鼠标只需要将鼠标移动至顶部即可出现窗口） 4104 41053.点击悬浮图标，将应用悬浮在其他界面上显示。 4106 41074.拖动应用悬浮窗口的四个顶角，改变窗口尺寸，触发应用显示刷新。改变窗口尺寸的过程中，窗口尺寸可能超出屏幕尺寸，此时在屏幕中只能看到应用部分区域的显示。可以通过移动窗口位置，查看应用其它区域的显示。 4108 4109##### 基本原理 4110 4111本示例介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口，将页面分拆为4个部分。 4112###### 标题栏 4113由于在不同断点下，标题栏始终只显示“返回按钮”、“歌单”以及“更多按钮”，但“歌单”与“更多按钮”之间的间距不同。 4114通过栅格实现：将标题栏划分为“返回按钮及歌单”和“更多按钮”两部分，这两部分在不同断点下占据的列数不同。 4115###### 歌单封面 4116通过栅格实现歌单封面，它由封面图片、歌单介绍及常用操作三部分组成这三部分的布局在md和lg断点下完全相同，但在sm断点下有较大差异。 41171、在sm断点下，封面图片和歌单介绍占满12列，常用操作此时会自动换行显示。 41182、在lg和md断点下，封面图片，歌单和常用操作各占一行中显示。 4119###### 歌单列表 4120通过List组件的lanes属性实现：在不同断点下，歌单列表的样式一致，但sm和md断点下是歌单列表是单列显示，lg断点下是双列显示。 4121###### 播放控制栏 4122通过Blank组件实现拉伸能力：在不同断点下，播放控制栏显示的内容完全一致，唯一的区别是歌曲信息与播放控制按钮之间的间距有差异。 4123###### 总体运行效果 4124通过在首页Column()中引用上述各组件后，可实现首页的组件整合渲染，即可完成整体页面开发。 4125 4126##### 约束与限制 4127 4128开发语言：ArkTS 4129 4130配套版本：API9版本SDK，版本号：3.2.11.9 4131 4132[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/MusicAlbum) 4133 4134#### 一多设置典型页面 4135 4136##### 介绍 4137 4138本示例使用[Navigation组件](reference/arkui-ts/ts-basic-components-navigation.md)，实现小窗口单栏显示、大窗口双栏显示的效果，结合[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示。 实现单/双栏的显示效果、 实现点击跳转或刷新、 实现多级跳转。展示设置应用的典型页面，其在小窗口和大窗口有不同的显示效果，体现一次开发、多端部署的能力。 4139 4140##### 使用 4141 41421. 启动应用，查看应用在全屏状态下的显示效果。 41432. 依次点击`WLAN` -> `更多WLAN设置`，查看应用的显示效果。 41443. 依次点击`更多连接`->`NFC`，查看应用的显示效果。 41454. 在应用顶部，下滑出现窗口操作按钮。（建议通过外接鼠标操作，接入鼠标只需要将鼠标移动至顶部即可出现窗口） 41465. 点击悬浮图标，将应用悬浮在桌面上显示。 41476. 拖动应用悬浮窗口改变窗口尺寸，触发应用显示刷新。改变窗口尺寸的过程中，窗口尺寸可能超出屏幕尺寸，此时在屏幕中只能看到应用部分区域的显示。可以通过移动窗口位置，查看应用其它区域的显示。 41487. 重复步骤2和3，查看应用在不同窗口尺寸下的显示效果。 4149 4150##### 基本原理 4151 4152本示例介绍如何实现不同断点下存在单栏和双栏设计的场景，主要有以下三方面： 4153###### 实现单/双栏的显示效果 4154通过Navigation组件实现单/双栏展示，由Navbar(设置主页面)和Content(跳转子页面)两部分区域组成，Navigation组件支持Stack、Split以及Auto三种模式。 41551、stack模式：导航栏与内容区独立显示，相当于多个页面。展示效果：从Navbar(设置主页面)跳转到Content1(WLAN页面)跳转到Content2(更多WLAN模式)。 41562、Split模式：导航栏与内容区分两栏显示。展示效果：Navbar+Content1。 41573、auto模式：Navigation组件可以根据应用窗口尺寸，自动选择合适的模式：窗口宽度小于520vp时，采用Stack模式显示；窗口宽度大于等于520vp时，采用Split模式显示。当窗口尺寸发生改变时，Navigation组件也会自动在Stack模式和Split模式之间切换。 4158 4159###### 实现点击跳转或刷新 4160Navigation组件通常搭配NavRouter组件以及NavDestination组件一起使用： 4161* NavRouter组件用于控制Navigation组件Content区域的显示和刷新逻辑：其必须包含两个孩子节点。 41621、容器类组件-直接控制NavRouter的显示效果。 41632、NavDestination组件：刷新Navigation组件Content区域的显示。 41643、NavRouter组件通过onStateChange回调事件，用于通知开发者NavRouter的状态：用户点击NavRouter，激活NavRouter并加载对应的NavDestination子组件时，回调onStateChange(true)； 41654、NavRouter对应的NavDestination子组件不再显示时，回调onStateChange(false)。 4166* NavDestination组件用于实际刷新Navigation组件Content区域的显示。 4167* 例如：在本示例中wlan功能项为NavRouter的第一个孩子节点，跳转的子页面WLAN为NavRouter的第二个孩子节点。 4168 4169###### 实现多级跳转 4170Navigation组件支持自动切换单栏和双栏的显示效果，同时可以根据当前状态自动添加返回键及响应系统的返回键事件。 41711、通过激活SettingList中的WLANSettingItem，可以加载及显示WlanSetting。 41722、激活WlanSetting中的WlanMoreSettingItem，可以加载及显示WlanMoreSetting。 4173 4174##### 约束与限制 4175 4176开发语言：ArkTS 4177 4178配套版本：API9版本SDK，版本号：3.2.11.9 4179 4180[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/Settings) 4181 4182#### 一多天气 4183 4184##### 介绍 4185 4186本示例使用[SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md)实现侧边栏功能，[栅格容器组件](reference/arkui-ts/ts-container-gridrow.md)实现界面内容的分割和展示，[Canvas组件](reference/arkui-ts/ts-components-canvas-canvas.md)和[CanvasRenderingContext2D](reference/arkui-ts/ts-canvasrenderingcontext2d.md) 完成空气质量和日出月落图的曲线绘制，再结合[一次开发，多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)的指导中响应式布局的栅格断点系统实现在不同尺寸窗口界面上不同的显示效果。展示一个天气应用界面，包括首页、城市管理、添加城市、更新时间弹窗，体现一次开发，多端部署的能力。 4187 4188##### 使用 4189 41901.启动应用后，首页展示已添加城市的天气信息，默认展示2个城市，左右滑动可以切换城市，在LG设备上，默认显示侧边栏，侧边栏显示时，右侧内容区占2/3，侧边栏隐藏时，内容区自动铺满界面。 4191 41922.在支持窗口自由拖拽的设备上，拖拽窗口大小，可以分别实现拖动到最大窗口侧边栏显示（点击侧边栏控制按钮可以隐藏和显示侧边栏），拖动窗口缩小到MD大小时侧边栏和侧边栏控制按钮隐藏。 4193 41943.在支持窗口自由拖拽的设备上，拖拽窗口大小，天气内容区跟随窗口大小会自动换行显示。 4195 41964.点击右上角菜单按钮，在菜单中点击**更新时间**，弹出更新时间弹窗，没有功能，此处只做展示，在平板设备上显示2列，在小屏设备上显示一列。 4197 41985.点击右上角菜单按钮，在菜单中点击**管理城市**，进入管理城市界面，展示已添加的城市，在平板设备上显示2列，在小屏设备上显示一列。 4199 42006.点击管理城市界面的**添加城市**，进入添加城市界面，已添加的城市不可点击，未添加的城市点击可以添加并返回管理城市界面显示。 4201 4202##### 基本原理 4203 42041、home.ets中引入SideContent()和homeContent()。 42052、定义showSideBar来判断是否展示侧边栏，定义mediaquery.MediaQueryListener媒体监听器smListener、mdListener、lgListener。 42063、在aboutToAppear调用mediaquery对界面进行监听。 42074、监听到当前屏幕大小，调用this.isBreakpoint断点，对curBp、showSideBar进行赋值。 4208 4209##### 约束与限制 4210 4211开发语言：ArkTS 4212 4213配套版本：API9版本SDK，版本号：3.2.11.9 4214 4215[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/Weather) 4216 4217### 卡片 4218 4219#### JS多设备自适应服务卡片 4220 4221##### 介绍 4222 4223本示例使用卡片扩展模块接口[@ohos.app.form.FormExtensionAbility](reference/apis/js-apis-app-form-formExtensionAbility.md) 、卡片信息和状态等相关类型和枚举接口[@ohos.app.form.formInfo](reference/apis/js-apis-app-form-formInfo.md) 、卡片数据绑定的能力接口[@ohos.app.form.formBindingData](reference/apis/js-apis-app-form-formBindingData.md) 。展示Js工程中服务卡片的布局和使用，其中卡片内容显示使用了一次开发，多端部署的能力实现多设备自适应。 4224 4225##### 使用 4226 4227长按示例应用，等待出现服务卡片字样，点击后可左右滑动选择需要的卡片尺寸，添加到屏幕。 4228 4229##### 基本原理 4230 42311、在module.json5文件添加拓展能力，类型为卡片，并设置卡片入口srcEntrance和卡片元数据metadata。例如："metadata": [ 4232{ 4233"name": "ohos.extension.form", 4234"resource": "$profile:form_config" 4235}。 42362、初始化卡片：通过实现@ohos.app.form.FormExtensionAbility卡片操作类，在卡片对象首次被创建时，初始化卡片绑定数据为空，并将卡片状态设置为就绪状态READY。 例如：onCreate(){ 4237formBindingData.createFormBindingData({}) onAcquireFormState(want) { 4238return formInfo.FormState.READY }。 42393、配置卡片：用js编写相应的卡片，将卡片配置到resources/base/profile/form_config。 4240 4241##### 约束与限制 4242 4243开发语言：JS 4244 4245配套版本：API9版本SDK，版本号：3.2.11.9 4246 4247[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/AdaptiveServiceWidget) 4248 4249#### ArkTS卡片 4250 4251##### ArkTS卡片计算器 4252 4253##### 介绍 4254 4255本示例展示了使用ArkTS卡片开发的计算器模型。部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 4256 4257##### 使用 4258 42591.部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 4260 4261##### 基本原理 4262 4263不涉及 4264 4265##### 约束与限制 4266 4267开发语言：ArkTS 4268 4269配套版本：API9版本SDK，版本号：3.2.12.5 4270 4271[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/ArkTSCard/Calculator) 4272 4273##### ArkTS卡片Canvas小游戏 4274 4275##### 介绍 4276 4277本示例展示了如何通过ArkTS卡片的Canvas自定义绘制能力实现一个简单的五子棋游戏卡片。 4278 4279- 使用Canvas绘制棋盘和黑白棋子的落子。 4280- 通过卡片支持的[点击事件](reference/arkui-ts/ts-universal-events-click.md)进行交互，让用户在棋盘上进行黑白棋子的对局。 4281- 通过TS的逻辑代码实现五子棋输赢判定、回退等逻辑计算，整个游戏过程无需拉起FormExtensionAbility。 4282 4283##### 使用 4284 42851.部分设备的桌面不支持卡片，可以通过自己开发的卡片使用方，进行卡片的创建、更新和删除等操作。 4286 42872.安装应用，并在桌面上长按本应用的桌面图标，长按后弹出选项列表。 4288 42893.点击弹出列表中的**服务卡片**选项进入卡片预览界面。 4290 42914.点击正下方的**添加到桌面**按钮，卡片就会出现在桌面上。 4292 42935.卡片添加到桌面后就可以在桌面进行五子棋游戏，包含黑白棋子的落子、重新开始、悔棋等操作。 4294 4295##### 基本原理 4296 4297- 界面绘制：通过Canvas画布组件进行绘制，在Canvas组件收到onReady回调时取出context的width和height作为画布的大小。 4298- 逻辑处理：通过注册Canvas画布onClick点击事件，并取出回调中的ClickEvent入参，这个对象中包含了点击的x轴和y轴坐标，通过坐标信息进行点击位子匹配就可以实现黑白棋子的落子。 4299 4300##### 约束与限制 4301 4302开发语言：ArkTS 4303 4304配套版本：API9版本SDK，版本号：3.2.12.5 4305 4306[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/ArkTSCard/CanvasGame) 4307 4308##### ArkTS音乐卡片 4309 4310##### 介绍 4311 4312本示例展示了如何通过ArkTS卡片实现一个简单的音乐卡片。 4313 4314##### 使用 4315 43161.安装应用，并在桌面上长按本应用的桌面图标，长按后弹出选项列表。 4317 43182.点击弹出列表中的服务卡片选项进入卡片添加界面。 4319 43203.点击正下方的添加到桌面按钮，卡片就会出现在桌面上。 4321 4322##### 基本原理 4323 4324不涉及。 4325 4326##### 约束与限制 4327 4328开发语言：ArkTS 4329 4330配套版本：API9版本SDK，版本号：3.2.12.5 4331 4332[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/ArkTSCard/MusicControl) 4333 4334#### Stage模型卡片 4335 4336##### 介绍 4337 4338本示例使用卡片扩展模块接口[@ohos.app.form.FormExtensionAbility](reference/apis/js-apis-app-form-formExtensionAbility.md) 、卡片信息和状态等相关类型和枚举接口[@ohos.app.form.formInfo](reference/apis/js-apis-app-form-formInfo.md) 、卡片提供方相关接口的能力接口[@ohos.app.form.formProvider](reference/apis/js-apis-app-form-formProvider.md) 、应用组件间的信息传递接口[@ohos.app.ability.Want](reference/apis/js-apis-app-ability-want.md) 。展示了Stage模型卡片提供方的创建与使用。 4339 4340##### 使用 4341 43421.部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 4343 43442.卡片的样式如"添加卡片"所示。当卡片更新时，卡片上的温度和时间会产生变化。 4345 43463.安装[卡片应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/FormExtAbility/processProxyForm/)或[formProvider应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/FormExtAbility/persistentProxyForm/)，长按卡片应用图标或formProvider应用图标弹出菜单，点击"服务卡片"选项可以添加服务卡片至桌面（第3张，第4张卡片为formProvider应用卡片；第5张，第6张为卡片应用卡片）； 4347 43484.长按数据卡片弹出菜单，点击"移除"可以将已添加至桌面的数据卡片从桌面上移除； 4349 43505.点击打开卡片应用图标或formProvider应用图标，点击"修改订阅条件"按键，界面将跳转至修改订阅条件界面，对应选择想要发布的数据完成对订阅条件的修改，离开页面或退出应用后再次打开修改订阅条件页面，页面单选框会显示当前订阅的城市； 4351 43526.在卡片应用或formProvider应用应用中点击"发布数据"按键，界面将跳转至数据发布界面，对应选择想要发布的数据并点击"发布数据"完成数据发布(若选择发布的城市与当前订阅城市不一致，则不能将数据更新至卡片)； 4353 4354##### 基本原理 43551、在module.json5文件添加拓展能力，类型为卡片，并设置卡片入口srcEntrance和卡片元数据metadata。 43562、初始化卡片：通过实现@ohos.app.form.FormExtensionAbility卡片操作类，在卡片对象首次被创建时，初始化卡片绑定数据为空，并将卡片状态设置为就绪状态READY。 43573、配置卡片：用js编写相应的卡片，将卡片配置到resources/base/profile/form_config。 4358 4359##### 约束与限制 4360 4361开发语言：ArkTS 4362 4363配套版本：API10版本SDK，版本号：4.0.10.7 4364 4365[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/FormExtAbility) 4366 4367#### Stage模型卡片小游戏 4368 4369##### 介绍 4370 4371本示例展示了如何通过Stage模型实现一个简单的游戏卡片。 4372 4373- 通过卡片支持的[点击事件](reference/js-service-widget-ui/js-service-widget-common-events.md)进行交互，让用户通过点击的先后顺序把一个乱序的成语排列成正确的成语。 4374- 使用了C++和TS的混合编程方式，将获取随机数的能力下沉到C++实现，并通过[NAPI](napi/napi-guidelines.md)的能力将C++实现的能力暴露到TS中。 4375- 用到了卡片扩展模块接口，[@ohos.app.form.FormExtensionAbility](reference/apis/js-apis-app-form-formExtensionAbility.md) 。 4376 4377##### 使用 4378 43791.部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 4380 43812.安装应用，并在桌面上长按本应用的桌面图标，长按后弹出选项列表。 4382 43833.点击弹出列表中的**服务卡片**选项进入卡片添加界面。 4384 43854.点击正下方的**添加到桌面**按钮，卡片就会出现在桌面上。 4386 4387##### 基本原理 4388 43891、在module.json5文件添加拓展能力，类型为卡片，并设置卡片入口srcEntrance和卡片元数据metadata。 43902、配置卡片：用js编写相应的卡片，将卡片配置到resources/base/profile/form_config。 43913、定义小游戏逻辑：实现FormExtensionAbility中addform时初始化数据(本sample中使用的是mock数据)，并将数据存储到dataStore，通过调用c++随机数，将成语顺序打乱显示， 43924、监听卡片变化：通过onformEvent()监听卡片事件，更新已选择的成语数据，并随机替换成语待选列表的已被选掉的word。 4393 4394##### 约束与限制 4395 4396开发语言：ArkTS 4397 4398配套版本：API9版本SDK，版本号：3.2.11.9 4399 4400[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/FormGame) 4401 4402#### 应用主动添加数据代理卡片到桌面 4403 4404##### 介绍 4405 4406本示例主要展示了使用[@ohos.app.form.formBindingData](reference/apis/js-apis-app-form-formBindingData.md)、[@ohos.app.form.formProvider](reference/apis/js-apis-app-form-formProvider.md)等接口，实现了在com.ohos.hag.famanager应用上，主动添加数据代理卡片到桌面的功能。 4407 4408##### 使用 4409 44101. 点击桌面上AppStore应用图标，打开com.ohos.hag.famanager应用。 4411 44122. 点击按钮<添加ArkTs卡片到桌面>或<添加Js卡片到桌面>按钮，AppStore应用自动切到后台并且开始将数据代理卡片添加到桌面。 4413 44143. 桌面切到前台显示后，刷新组件并将添加的数据代理卡片显示到页面上。 4415 4416##### 基本原理 4417 4418- 发布ArkTs数据代理卡片到桌面 4419 - 使用requestPublishForm接口，将应用内的ArkTs数据代理卡片主动添加到桌面上，接口参考：[@ohos.app.form.formProvider](reference/apis/js-apis-app-form-formProvider.md) 4420- 发布Js数据代理卡片到桌面 4421 - 使用requestPublishForm接口，将应用内的Js数据代理卡片主动添加到桌面上，接口参考：[@ohos.app.form.formProvider](reference/apis/js-apis-app-form-formProvider.md) 4422 4423##### 约束与限制 4424 4425开发语言：ArkTS 4426 4427配套版本：API10版本SDK，版本号：4.0.8.5 4428 4429[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/RequestAddForm) 4430 4431 4432 4433## 系统特性 4434 4435### 应用模型 4436 4437#### AccessibilityExtensionAbility示例 4438 4439##### 介绍 4440 4441本示例展示了[AccessibilityExtensionAbility](application-models/accessibilityextensionability.md)的简单应用，使用多个辅助功能接口，启动或关闭无障碍扩展服务，实现了一些快捷的交互方式。 4442 4443##### 使用 4444 44451. 在启动无障碍扩展服务前，需退出当前应用保证界面节点正常生成； 44462. 启动关闭无障碍扩展服务可参考[AccessibilityExtensionAbility开发指南](application-models/accessibilityextensionability.md), 服务连接状态将显示在屏幕上; 44473. 启动无障碍扩展服务后，在设备屏幕上绘画右划后再下划的手势`rightThenDown`获取当前界面全部节点，之后绘画左划后再下划的手势`leftThenDown`打印所有节点的指定信息； 44484. 在设备屏幕上绘画左划手势`left`对按钮`获焦`进行聚焦，之后可通过绘画右划手势`right`取消对按钮聚焦； 44495. 在设备屏幕上绘画下划手势`down`，触发对按钮`未点击/已点击`的点击动作。 4450 4451##### 基本原理 4452 4453* 获取界面元素、查询元素指定信息、通过text查找元素和获取元素执行指定动作的功能封装在AccessibilityManager： 4454 * 使用 [getWindowRootElement()](reference/apis/js-apis-inner-application-accessibilityExtensionContext.md#accessibilityextensioncontextgetwindowrootelement) 获取界面根节点； 4455 * 获取元素属性值：使用AccessibilityUtils.getAttributeValue()； 4456 * 获取界面所有元素：基于获取的根元素，使用AccessibilityUtils.createElementArray()获取界面所有元素； 4457 * 打印界面元素指定信息：使用AccessibilityUtils.getElementWantedInfo()获取元素指定的信息； 4458 * 寻找指定元素：使用AccessibilityUtils.findElementByKey()。 4459 4460##### 约束与限制 4461 4462开发语言：ArkTS 4463 4464配套版本：API9版本SDK，版本号：3.2.11.9 4465 4466[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/AccessibilityExtAbility) 4467 4468#### EnterpriseAdminExtensionAbility的创建与使用 4469 4470##### 介绍 4471 4472本示例通过[@ohos.enterprise.EnterpriseAdminExtensionAbility](reference/apis/js-apis-EnterpriseAdminExtensionAbility.md)接口实现了系统管理状态变化通知功能，[@ohos.enterprise.adminManager](reference/apis/js-apis-enterprise-adminManager.md)接口中enableAdmin方法去激活当前用户下的指定设备管理员应用，disableSuperAdmin方法去根据bundleName将管理员用户下的超级管理员应用去激活，subscribeManagedEvent方法去指定设备管理员应用订阅系统管理事件，unsubscribeManagedEvent方法去指定设备管理员应用取消订阅系统管理事件来实现应用激活、去激活、应用安装、卸载事件。 4473 4474##### 使用 4475 44761.启动应用后，点击激活设备管理器，会显示激活成功。由企业管理员或者员工部署MDM应用，激活设备管理器，系统通知MDM应用已激活DeviceAdmin权限。MDM应用可在onAdminEnable回调函数中进行初始化策略设置。 4477 44782.点击去激活设备管理器，会显示去激活成功。系统或者员工去激活设备管理器，应用可以通知企业管理员设备已脱管。 4479 44803.点击订阅应用安装卸载事件，会显示订阅成功。企业应用管理场景下，企业管理员订阅应用安装卸载事件，端侧应用安装和卸载事件通知MDM应用，MDM应用可以在回调函数中进行事件上报，通知企业管理员。 4481 44824.点击取消订阅应用安装卸载事件，会显示取消订阅成功。企业应用管理场景下，企业管理员取消订阅应用安装卸载事件。 4483 4484##### 基本原理 4485 4486* 该示例通过EnterpriseAdminExtensionAbility接口实现了系统管理状态变化通知功能，adminManager接口中enableAdmin方法去激活当前用户下的指定设备管理员应用，disableSuperAdmin方法去根据bundleName将管理员用户下的超级管理员应用去激活，subscribeManagedEvent方法去指定设备管理员应用订阅系统管理事件，unsubscribeManagedEvent方法去指定设备管理员应用取消订阅系统管理事件来实现应用激活、去激活、应用安装、卸载事件。 4487* 接口参考：[@ohos.enterprise.EnterpriseAdminExtensionAbility](reference/apis/js-apis-EnterpriseAdminExtensionAbility.md)，[@ohos.enterprise.adminManager](reference/apis/js-apis-enterprise-adminManager.md)，[@ohos.app.ability.Want](reference/apis/js-apis-app-ability-want.md) 4488 4489##### 约束与限制 4490 4491开发语言：ArkTS 4492 4493配套版本：API9版本SDK，版本号：3.2.11.9 4494 4495[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/EnterpriseAdminExtensionAbility) 4496 4497#### 仿桌面应用 4498 4499##### 介绍 4500 4501本示例使用[@ohos.bundle.launcherBundleManager](reference/apis/js-apis-launcherBundleManager.md)模块接口，获取所有应用信息和给定包名获取应用信息，实现桌面展示所有安装的应用。使用[@ohos.bundle](reference/apis/js-apis-Bundle.md)的getBundleInstaller接口获取到，调用uninstall接口实现应用卸载功能。使用[@ohos.app.form.formHost](reference/apis/js-apis-app-form-formHost.md)接口，获取应用卡片信息，使用FormComponent组件展示卡片内容，从而实现添加卡片到桌面的功能。使用关系型数据库[@ohos.data.relationalStore](reference/apis/js-apis-data-relationalStore.md)接口，实现桌面数据持久化存储，存储应用的位置信息，卡片信息。使用[@ohos.application.missionManager](reference/apis/js-apis-application-missionManager.md)接口，获取最近任务信息，并实现加锁、解锁、清理后台任务的功能。使用[@ohos.app.ability.ServiceExtensionAbility](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.app.ability.ServiceExtensionAbility.d.ts)的startRecentAbility接口，拉起最近任务至前台显示，若应用Ability未启动时，则拉起新创建的应用Ability显示到前台。实现了一个简单桌面应用，概括为以下几点： 4502 45031.展示了系统安装的应用，实现点击启动、应用上滑弹出卡片、卡片添加到桌面、卡片移除功能。 4504 45052.实现桌面数据持久化存储，应用支持卸载、监听应用卸载和安装并显示。 4506 45073.实现最近任务管理功能，包括任务卡片加锁、解锁、清理和清理所有任务功能。 4508 45094.通过点击应用图标或点击由长按图标弹出的菜单栏中的打开按钮的方式打开应用，是以打开最近任务方式拉起应用Ability。 4510 4511##### 使用 4512 45131.安装编译的hap包，使用hdc shell aa start -b ohos.samples.launcher -a MainAbility命令启动应用，应用启动后显示系统安装的应用。 4514 45152.点击应用主界面上的应用图标可以启动应用，长按弹出菜单，点击打开可以正常启动应用。 4516 45173.图库等支持卡片的应用，长按菜单中有服务卡片，点击进入卡片预览界面，在卡片预览界面点击**添加到桌面**，返回到桌面并且卡片成功添加到桌面。 4518 45194.上滑图库等支持卡片的应用，可以弹出默认上滑卡片，点击上滑卡片右上角的**+**图标，可以添加卡片到桌面。 4520 45215.应用在桌面界面，使用hdc install安装一个应用，桌面可以监听到应用安装，并显示新安装的应用到桌面上。 4522 45236.应用在桌面界面，使用hdc uninstall 卸载第5步安装的应用，桌面可以监听到卸载，并移除桌面上的应用。 4524 45257.在桌面空白处上滑，可以进入最近任务管理界面，下滑任务卡片可以加锁/解锁，上滑卡片可以清理该后台任务，点击垃圾桶可以清除所有后台任务（加锁的应用不会被清理掉）。 4526 4527##### 基本原理 4528 4529* 获取应用功能模块 4530 * 使用launcherBundleManager模块接口（系统能力：SystemCapability.BundleManager.BundleFramework），获取所有应用信息和给定包名获取应用信息，实现桌面展示所有安装的应用。使用on接口监听应用的安装和卸载从而实现应用安装和卸载刷新桌面。 4531 * 接口参考：[@ohos.bundle.launcherBundleManager](reference/apis/js-apis-launcherBundleManager.md) 4532 4533* 应用卸载功能模块 4534 * 使用bundle模块的getBundleInstaller接口获取到BundleInstaller（系统能力：SystemCapability.BundleManager.BundleFramework），调用uninstall接口实现应用卸载功能。 4535 * 接口参考：[@ohos.bundle](reference/apis/js-apis-Bundle.md) 4536 4537* 添加卡片功能模块 4538 * 使用formHost接口（系统能力：SystemCapability.Ability.Form），获取应用卡片信息，使用FormComponent组件展示卡片内容，从而实现添加卡片到桌面的功能。 4539 * 接口参考：[@ohos.app.form.formHost](reference/apis/js-apis-app-form-formHost.md) 4540 4541* 桌面数据持久化存储功能模块 4542 * 使用关系型数据库rdb接口（系统能力：SystemCapability.DistributedDataManager.RelationalStore.Core），实现桌面数据持久化存储，存储应用的位置信息，卡片信息。 4543 * 接口参考：[@ohos.data.relationalStore](reference/apis/js-apis-data-relationalStore.md) 4544 4545* 加锁、解锁、清理后台任务功能模块 4546 * 使用missionManager模块接口（系统能力：SystemCapability.Ability.AbilityRuntime.Mission），获取最近任务信息，并实现加锁、解锁、清理后台任务的功能。 4547 * 接口参考：[@ohos.application.missionManager](reference/apis/js-apis-application-missionManager.md) 4548 4549* 点击桌面应用拉起最近任务至前台功能模块 4550 * 使用ServiceExtensionContext模块的startRecentAbility接口（系统能力：SystemCapability.Ability.AbilityRuntime.Core），拉起最近任务至前台显示，若应用Ability未启动时，则拉起新创建的应用Ability显示到前台。 4551 * 接口参考：[@ohos.app.ability.ServiceExtensionAbility](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.app.ability.ServiceExtensionAbility.d.ts) 4552 4553##### 约束与限制 4554 4555开发语言：ArkTS 4556 4557配套版本：API10版本SDK，版本号：4.0.9.6 4558 4559[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/Launcher) 4560 4561#### 系统任务管理 4562 4563##### 介绍 4564 4565本示例通过调用系统任务管理的能力，使用[@ohos.application.missionManager](reference/apis/js-apis-application-missionManager.md) 、[@ohos.multimedia.image](reference/apis/js-apis-image.md) 等接口完成对系统任务执行锁定、解锁、清理、切换到前台等操作。 4566 4567##### 使用 4568 45691.下拉“**获取系统任务信息**”，获取当前系统任务的包名、运行状态、锁定状态、任务是否支持迁移、任务快照等信息列表，且最多可获取10条任务； 4570 45712.左滑任务列表，点击“**锁定**”，即可锁定指定的任务； 4572 45733.若当前任务已锁定，可点击“**解锁**”，即可解锁指定的任务； 4574 45754.点击“**删除**”，即可删除指定的任务； 4576 45775.点击“**移动**”，即可将指定的任务移动到前台执行。 4578 4579##### 基本原理 4580 4581* 任务执行锁定、解锁、清理、切换到前台等操作的功能结构主要封装在Index、MissionInfoComponent 4582 * 获取任务信息：在Index页面中通过missionManager.getMissionInfos()方法来获取所有的mission； 4583 * 执行或者解锁锁定任务：在MissionInfoComponent组件当中可以通过missionManager.lockMission(missionId)方法来锁定指定的mission，而missionManager.unlockMission(missionId)用来解锁mission; 4584 * 移动指定的任务：将指定的任务移动到前台执行可以使用missionManager.moveMissionToFront(missionId)方法； 4585 * 删除指定的任务：删除指定的任务可以通过missionManager.clearMission(missionId)方法实现。 4586 4587##### 约束与限制 4588 4589开发语言：ArkTS 4590 4591配套版本：API9版本SDK，版本号：3.2.12.5 4592 4593[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/MissionManager) 4594 4595#### 静态订阅 4596 4597##### 介绍 4598 4599本示例主要展示了静态订阅的创建与使用，以及静态订阅的使能和去使能。通过[CommonEventManager](reference/apis/js-apis-commonEventManager.md)发布自定义事件，使能和去使能静态订阅。通过[StaticSubscriberExtensionAbility](reference/apis/js-apis-application-staticSubscriberExtensionAbility.md)、[NotificationManager](reference/apis/js-apis-notificationManager.md)静态订阅已发布的自定义事件，订阅后即可自动收到该事件，收到该事件后，发送通知将自定义事件数据显示在通知栏。 4600 4601##### 使用 4602 46031. 在entry/src/main/resources/base/profile/subscribe.json中添加需要订阅的目标事件。 4604 46052. 修改系统配置文件/system/etc/app/install_list_capability.json，将应用的包名添加至该json文件中。 4606 46073. 本示例编译后共有两个hap包，包括静态订阅hap包和自定义事件发布hap包，需要全部安装。静态订阅hap包需要签名成系统应用并安装才可实现对目标事件的静态订阅，安装后即默认订阅了目标事件；自定义事件发布hap包直接安装即可，发布事件后即可被静态订阅方收到。 4608 46094. 点击关闭静态订阅按钮将不再进行静态订阅，不会收到相关通知，点击开启静态订阅会重新恢复。 4610 4611##### 基本原理 4612 4613* 通过CommonEventManager.publish方法发布自定义事件，该自定义事件为数据传输事件。 4614 4615* 接口参考：[@ohos.commonEventManager](reference/apis/js-apis-commonEventManager.md) 4616 4617* 通过CommonEventManager.setStaticSubscriberState方法为当前应用设置静态订阅事件使能或去使能状态。 4618 4619* 接口参考：[@ohos.commonEventManager](reference/apis/js-apis-commonEventManager.md) 4620 4621* 通过StaticSubscriberExtensionAbility接口静态订阅已发布的自定义事件，订阅后即可自动收到该事件，收到该事件后，setNotificationEnable，ContentType方法发送通知将自定义事件数据显示在通知栏。 4622 4623* 接口参考：[@ohos.application.StaticSubscriberExtensionAbility](reference/apis/js-apis-application-staticSubscriberExtensionAbility.md)，[@ohos.notificationManager](reference/apis/js-apis-notificationManager.md) 4624 4625##### 约束与限制 4626 4627开发语言：ArkTS 4628 4629配套版本：API10版本SDK，版本号：4.0.9.6 4630 4631[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/StaticSubscriber) 4632 4633#### 测试依赖 4634 4635##### 跨任务链返回 4636 4637##### 介绍 4638 4639本示例为一个仿桌面应用测试demo，使用[@ohos.app.ability.ServiceExtensionAbility](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.app.ability.ServiceExtensionAbility.d.ts)接口中ServiceExtensionContext类的startRecentAbility能力（系统能力：SystemCapability.Ability.AbilityRuntime.Core），实现了跨任务链返回的功能。 4640 4641##### 使用 4642 46431.基于CrossChainBack工程（com.acts.abilityabacktoabilityb），对该工程编译产生的hap包进行手动签名。（仅CrossChainBack工程可实现跨任务链返回功能）。 4644 46452.安装签名成功后的hap包，启动仿桌面（Launcher）。 4646 46473.点击应用主界面上的应用图标，可以启动应用。 4648 46494.长按应用图标弹出菜单，点击打开，可以正常启动应用。 4650 46515.本应用包含：EntryAbility页面（页面中显示有"EntryAbility"文本）和SecondAbility页面（页面中显示有"SecondAbility"文本）。 4652 46536.在EntryAbility页面上点击StartSecondAbility按钮，打开SecondAbility，此时点击返回键，回到EntryAbility页面而不是桌面。 4654 4655##### 基本原理 4656 4657- 拉起任务至前台显示的功能接口封装在LauncherAbilityManager。 4658 - 跨任务链返回：在ServiceExtensionAbility，使用ServiceExtensionContext.startRecentAbility(),将Want中将"ABILITY_BACK_TO_OTHER_MISSION_STACK"(返回当前任务链字段)设置为"true",以实现返回至打开ServiceExtensionAbility的ability的功能。 4659 - 接口参考：[@ohos.app.ability.wantConstant](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.app.ability.wantConstant.d.ts)、[@ohos.app.ability.ServiceExtensionAbility](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.app.ability.ServiceExtensionAbility.d.ts) 4660 4661##### 约束与限制 4662 4663开发语言：ArkTS 4664 4665配套版本：API9版本SDK，版本号：3.2.11.9 4666 4667[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/TestRely/LauncherTest/CrossChainBack) 4668 4669##### 启动上一次的组件实例 4670 4671##### 介绍 4672 4673本示例为一个仿桌面应用测试demo，测试的功能为：点击仿桌面应用上的应用图标，若应用未启动则启动应用，若应用已经被启动并创建多个实例则启动上一次拉起的实例。 4674 4675##### 使用 4676 46771.基于StartRecentAbility工程（com.acts.startrecentability），对该工程编译产生的hap包进行手动签名。（仅StartRecentAbility工程可实现启动上一次的组件实例功能）。 4678 46792.安装签名成功后的hap包，启动仿桌面（Launcher）。 4680 46813.点击应用主界面上的应用图标，可以启动应用。 4682 46834.长按应用图标弹出菜单，点击打开，可以正常启动应用。 4684 46855.打开EntryAbility页面，页面中会有时间戳显示，点击"StartEntryAbility"按钮，新建一个EntryAbility实例，会有一个新的时间戳显示，此时点击home键回到桌面，点击应用图标打开应用，会看到时间戳显示为第二个时间戳。 4686 46876.打开EntryAbility页面，会有时间戳显示，点击"startSingletonAbility"按钮，打开单实例的SecondAbility（页面中显示"SingletonAbility"），当打开SecondAbility后，点击home键回到桌面，点击应用图标打开应用，显示为EntryAbility且时间戳内容未改变。 4688 4689##### 基本原理 4690 4691- 应用启动的功能接口封装在LauncherAbilityManager： 4692 - 启动上次打开的的组件实例：拉起上次打开的任务至前台显示，若应用Ability未启动时，则拉起新创建的应用Ability显示到前台。 4693 4694##### 约束与限制 4695 4696开发语言：ArkTS 4697 4698配套版本：API9版本SDK，版本号：3.2.11.9 4699 4700[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/TestRely/LauncherTest/StartRecentAbility) 4701 4702### 网络与连接 4703 4704#### 蓝牙 4705 4706##### 介绍 4707 4708本示例通过[@ohos.bluetooth](reference/apis/js-apis-bluetooth.md) 接口实现蓝牙设备发现、配对、取消配对功能。 4709 4710##### 使用 4711 47121.启动应用，若蓝牙本来就打开的，系统会直接搜索周围可配对的设备，若蓝牙未打开，打开开关。 4713 47142.搜索到附近的设备后，选择需要配对的设备，点击该设备，会跳出匹配弹窗，若确定匹配，点击**匹配**按钮，否则点击**取消**按钮。 4715 47163.匹配后，若想删除匹配的设备，点击已配对的设备列表中的设备，会跳出断开连接弹窗，若确定删除该设备，点击**确定**，否则点击**取消**。 4717 4718##### 基本原理 4719 4720* 蓝牙设备发现、配对、取消配对等操作的功能结构主要封装在Index、PinDialog： 4721 * 启动和关闭蓝牙：在Index页面中通过Toggle组件的onChange函数来控制蓝牙的开关，开关打开的情况下会执行initBluetooth函数，关闭的情况下执行bluetooth.disableBluetooth()方法来断开蓝牙； 4722 * 验证蓝牙是否处于连接状态：蓝牙打开的时候通过bluetooth.on('stateChange')方法来监听蓝牙连接状态改变事件，确认已打开，则执行foundDevices()函数来查找设备接口，确认已关闭则执行bluetooth.stopBluetoothDiscovery()方法来停止查询接口。 4723 * 发现设备：在foundDevices()函数中通过bluetooth.on('bluetoothDeviceFind')方法来监听设备发现事件，并且通过bluetooth.getPairedDevices()方法来更新已配对蓝牙地址，然后通过bluetooth.startBluetoothDiscovery()方法开启蓝牙扫描，去发现远端设备，并且通过bluetooth.setBluetoothScanMode()方法来被远端设备发现。 4724 * 蓝牙配对：通过bluetooth.on('pinRequired')方法来监听远端蓝牙设备的配对请求事件，点击配对执行bluetooth.setDevicePairingConfirmation(this.data.deviceId, true)方法，点击取消执行bluetooth.setDevicePairingConfirmation(this.data.deviceId, false)方法。 4725 * 取消配对：最后通过bluetooth.cancelPairedDevice()来断开指定的远端设备连接。 4726 4727##### 约束与限制 4728 4729开发语言：ArkTS 4730 4731配套版本：API9版本SDK，版本号：3.2.12.5 4732 4733[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Connectivity/Bluetooth) 4734 4735#### WLAN 4736 4737##### 介绍 4738 4739本示例通过[@ohos.wifiManager](reference/apis/js-apis-wifiManager.md) 相关API实现wlan激活和关闭、扫描和连接WIFI等功能。 4740 4741##### 使用 4742 47431. 启动应用后会判断WLAN是否激活，如果是激活状态，会扫描并展示可用WiFi列表，同时获取已连接WiFi信息并展示； 4744 47452. 点击界面的Switch开关可以禁用和激活WLAN，界面会监听WLAN状态扫描可用WiFi列表，也会监听WiFi连接状态展示已连接WiFi； 4746 47473. 点击可用WLAN列表中的WLAN信息，可以连接WiFi，如果是加密类型，会弹窗输入密码后连接； 4748 47494. 点击首页右上角的**关于**图标，进入关于界面，展示获取的IP信息、国家码和支持WLAN相关特性信息。 4750 4751##### 基本原理 4752 4753* wlan激活和关闭功能：点击首页的切换按钮，如果是打开，使用wifi.enableWifi()开启wifi；如果是关闭，则使用wifi.disconnect()断开wifi，然后使用wifi.disableWifi()关闭wifi， 4754 4755* wifi的连接、扫描、获取详细信息等功能封装在WifiModel模块中。 4756 * wifi的连接功能：点击wifi列表中加密的wifi，并在弹窗中输入密码后，通过WifiModule.connectNetwork()调用wifi.connectToDevice()连接wifi。 4757 * wifi的扫描功能：进入后就会间歇性的调用wifi.scan()开启扫描，然后通过WifiModel模块中的getScanInfos()调用wifi.getScanResults()来获取扫描的结果。 4758 * 获取wifi的详细信息：通过WiFiModel中的getIpInfo()、getCountryCode()、getFeatureSupport()分别调用wifi.getIpInfo()、wifi.getCountryCode()、wifi.isFeatureSupported()来获取对应信息。 4759 4760##### 约束与限制 4761 4762开发语言：ArkTS 4763 4764配套版本：API9版本SDK，版本号：3.2.11.9 4765 4766[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Connectivity/Wlan) 4767 4768### 数据管理 4769 4770#### 跨应用数据共享 4771 4772##### 介绍 4773 4774本示例使用数据共享扩展能力[@ohos.data.DataShareResultSet](reference/apis/js-apis-application-dataShareExtensionAbility.md)，关系型数据库[@ohos.data.relationalStore](reference/apis/js-apis-data-dataShare.md)，[@ohos.data.rdb](reference/apis/js-apis-data-rdb.md)实现了一个跨应用数据共享实例，分为联系人（数据提供方）和联系人助手（数据使用方）两部分：联系人支持联系人数据的增、删、改、查等功能；联系人助手支持同步联系人数据，当联系人与联系人助手数据不一致时，支持合并重复数据。 4775 4776##### 使用 4777 47781. 联系人应用，首页中点击**+**按钮可以添加联系人，在首页展示联系人列表。 47792. 联系人应用首页点击搜索框可以搜索联系人，点击联系人进入详情页，详情页提供编辑和删除功能入口。 47803. 联系人助手应用，点击同步联系人可以同步联系人应用的数据到联系人助手，同步后可以点击联系人进入详情页，详情页提供编辑和删除功能。 47814. 联系人助手首页点击**+**按钮，可以新增联系人。 47825. 联系人助手设置页面可以设置同步策略，根据不同的同步策略，每次点击首页的同步联系人按钮会同步一次联系人数据，默认使用联系人覆盖联系人助手策略。 4783 4784##### 基本原理 4785 4786* 使用DataShareExtensionAbility实现数据共享，关系型数据库实现数据的增、删、改、查接口，DataShare管理和访问数据库数据变化。 4787* 接口参考：[@ohos.data.DataShareResultSet](reference/apis/js-apis-application-dataShareExtensionAbility.md)，[@ohos.data.relationalStore](reference/apis/js-apis-data-dataShare.md)，[@ohos.data.rdb](reference/apis/js-apis-data-rdb.md) 4788 4789##### 约束与限制 4790 4791开发语言：ArkTS 4792 4793配套版本：API9版本SDK，版本号：3.2.11.9 4794 4795[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DataManagement/CrossAppDataShare) 4796 4797### 设备管理 4798 4799#### 设备管理合集(系统特性) 4800 4801##### 介绍 4802 4803本示例集合设备管理相关(系统特性)不需要复杂功能展示的模块，展示了各个模块的基础功能，包含： 4804 4805- [@ohos.batteryStatistics (耗电统计)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-batteryStatistics.md%2F) 4806- [@ohos.brightness (屏幕亮度)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-brightness.md%2F) 4807- [@ohos.power (系统电源管理)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-power.md%2F) 4808- [@ohos.settings (设置数据项名称)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-settings.md%2F) 4809- [@ohos.systemCapability (系统能力)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-system-capability.md%2F) 4810- [@ohos.systemParameterEnhance (系统参数)](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv3.2%2Fzh-cn%2Fapplication-dev%2Freference%2Fapis%2Fjs-apis-system-parameterEnhance.md%2F) 4811- [@ohos.batteryInfo (电量信息)](reference/apis/js-apis-battery-info.md) 4812- [@ohos.deviceInfo (设备信息)](reference/apis/js-apis-device-info.md) 4813- [@ohos.multimodalInput.inputConsumer (组合按键)](reference/apis/js-apis-inputconsumer.md) 4814- [@ohos.multimodalInput.inputDevice (输入设备)](reference/apis/js-apis-inputdevice.md) 4815- [@ohos.multimodalInput.inputEvent (输入事件)](reference/apis/js-apis-inputevent.md) 4816- [@ohos.multimodalInput.inputEventClient (按键注入)](reference/apis/js-apis-inputeventclient.md) 4817- [@ohos.multimodalInput.inputMonitor (输入监听)](reference/apis/js-apis-inputmonitor.md) 4818- [@ohos.multimodalInput.keyCode (键值)](reference/apis/js-apis-keycode.md) 4819- [@ohos.multimodalInput.keyEvent (按键输入事件)](reference/apis/js-apis-keyevent.md) 4820- [@ohos.multimodalInput.mouseEvent (鼠标输入事件)](reference/apis/js-apis-mouseevent.md) 4821- [@ohos.multimodalInput.pointer (鼠标指针)](reference/apis/js-apis-pointer.md) 4822- [@ohos.multimodalInput.touchEvent (触摸输入事件)](reference/apis/js-apis-touchevent.md) 4823 4824##### 使用 4825 48261.首页展示语言基础类库各个子模块菜单，点击进入对应的模块页面。 4827 48282.各个子模块界面中点击功能按钮完成各个功能。 4829 48303.耗电统计：进入耗电统计页面，展示软硬件耗电排行。 4831 48324.屏幕亮度：获取当前屏幕亮度，设置屏幕亮度。 4833 48345.系统电源管理：点击按钮分别实现休眠、关机、重启、设置电源模式功能。 4835 48366.设置数据项名称：将数据项名称及数据项的值保存到数据库中。 4837 48387.系统能力：获取系统能力集合的字符串并显示。 4839 48408.系统参数：点击按钮分别实现设置一个系统参数、获取并展示系统参数功能。 4841 48429.电量信息：进入设备电量信息页面，页面主要显示电量信息，包括：当前设备是否支持电池或电池是否在位的查询、剩余电池电量百分比、充电状态、电池健康状态、充电器类型、电池电压、电池技术型号、电池温度、电量等级等信息。 4843 484410.设备基础信息：打开设备信息管理页面，展示基础信息。 4845 484611.组合按键：进入组合按键管理页面，包括显示组合按键信息，组合按键的订阅状态，在订阅状态下，组合按键被触发时显示组合按键的信息。 4847 484812.输入设备：进入设备输入管理页面，展示设备输入列表，可以查看输入设备详情，同时可以监听设备的热插拔状态。 4849 485013.输入事件：进入全屏监听页面，实现启动或取消全屏输入事件，在启动全屏输入事件监听时，可以查看当前触屏的详细信息，模拟注入返回事件，实现返回能力。 4851 485214.输入按键事件：进入输入按键事件管理页面，显示由外部设备如软键盘输入触发的消息。 4853 485415.鼠标指针：进入鼠标管理页面，实现鼠标状态、鼠标指针信息、设置鼠标速度和显示样式，启动鼠标事件监听时，可以查看鼠标在界面上操作的详细信息。 4855 4856##### 基本原理 4857 48581.首页菜单展示：使用一个module，menuitems完成菜单组件的实现，传入要展示的菜单的strarray类型的资源和菜单点击对应的组件即可。使用Navigation和NavRouter组件实现菜单点击进入功能界面，使用LocalStorage实现应用内Ability内数据共享，点击菜单时标记selectedLabel，在entry中的Capabilities组件中，通过selectedLabel显示对应的功能组件。 4859 48602.耗电统计：使用[@ohos.batteryStatistics.d.ts](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-batteryStatistics.md/) 4861接口获取硬件和应用的耗电量与百分比，使用[@ohos.bundle.bundleManager.d.ts](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md/) 4862接口获取系统已安装应用信息。 4863 48643.屏幕亮度：使用[@ohos.brightness.d.ts](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-brightness.md/) 4865实现屏幕亮度控制。 4866 48674.系统电源管理：使用[@ohos.power.d.ts](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-power.md/) 4868实现休眠、关机、重启、设置电源模式功能。 4869 48705.设置数据项名称：使用[@ohos.settings.d.ts](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-settings.md/) 4871实现将数据项名称及数据项的值保存到数据库中。 4872 48736.系统能力：使用[@ohos.systemCapability.d.ts](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-system-capability.md/) 4874实现获取系统能力集合的字符串并显示。 4875 48767.系统参数：使用[@ohos.systemParameterEnhance.d.ts](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/reference/apis/js-apis-system-parameterEnhance.md/) 4877实现设置一个系统参数、获取并展示系统参数功能。 4878 48798.电量信息：使用[@ohos.batteryInfo.d.ts](reference/apis/js-apis-battery-info.md)接口获取电池和充放电状态信息 4880 48819.设备信息：使用[@ohos.deviceInfo](reference/apis/js-apis-device-info.md)获取设备相关信息。 4882 488310.组合按键：使用[@ohos.multimodalInput.inputConsumer](reference/apis/js-apis-inputconsumer.md) 订阅组合按键，当组合按键被触发时展示组合按键回调信息。 4884 488511.输入设备：使用[@ohos.multimodalInput.inputDevice](reference/apis/js-apis-inputdevice.md) 获取输入设备列表，并显示输入设备信息，实现设备的热插拔监听。 4886 488712.输入事件：使用[@ohos.multimodalInput.inputMonitor](reference/apis/js-apis-inputmonitor.md)开启监听全局触屏事件，当触发触屏事件时显示触屏详情，使用[@ohos.multimodalInput.inputEventClient](reference/apis/js-apis-inputeventclient.md)模拟返回按键进行按键注入，实现返回功能，在column组件中添加[@ohos.multimodalInput.touchEvent](reference/apis/js-apis-touchevent.md)触摸事件，模拟按键被按下效果。 4888 488913.鼠标指针：使用[@ohos.multimodalInput.mouseEvent](reference/apis/js-apis-mouseevent.md)监听鼠标事件，并显示鼠标操作回调信息，使用[@ohos.multimodalInput.pointer](reference/apis/js-apis-pointer.md)实现鼠标指针的显示或隐藏状态，设置鼠标移动速度和显示样式。 4890 489114.输入按键事件：使用 [@ohos.multimodalInput.keyEvent (按键输入事件)](reference/apis/js-apis-keyevent.md)监听按键输入的信息。 4892 4893##### 约束与限制 4894 4895开发语言：ArkTS 4896 4897配套版本：API10版本SDK，版本号：4.0.9.6 4898 4899[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/DeviceManagementCollection) 4900 4901#### 屏幕属性 4902 4903##### 介绍 4904 4905本示例主要展示了屏幕管理相关的功能，使用[@ohos.display](reference/apis/js-apis-display.md)、[@ohos.screen](reference/apis/js-apis-screen.md)接口，[@ohos.display](reference/apis/js-apis-display.md)接口提供获取默认display对象、获取所有display对象，开启监听、关闭监听功能；[@ohos.screen](reference/apis/js-apis-screen.md)接口提供创建虚拟屏幕、销毁虚拟屏幕、扩展屏幕、镜像屏幕等功能。 4906 4907##### 使用 4908 49091.点击主页面前一个矩形，弹窗显示默认设备ID、设备名称、启用状态、设备状态、设备刷新率、屏幕旋转角度、设备宽度、设备高度、屏幕密度、屏幕方向、逻辑密度、缩放因子、xDPI(x方向中每英寸屏幕的确切物理像素值)、yDPI(y方向中每英寸屏幕的确切物理像素值)，点击任意区域关闭弹窗，点击第二个矩形，弹窗显示所有屏幕信息。 4910 49112.点击**增加屏幕**按钮，监听到屏幕增加，增加矩形代表新增屏幕（因界面空间有效，增加超过一个屏幕，页面总共只显示两个矩形）。 4912 49133.点击**移除屏幕**按钮，监听到屏幕销毁，减少矩形代表移除屏幕。 4914 4915##### 基本原理 4916 4917- 增加屏幕、移除屏幕的功能接口封装在DisplayModel: 4918 - 使用screen.createVirtualScreen来创建虚拟屏幕; 4919 - 使用screen.destroyVirtualScreen来销毁虚拟屏幕; 4920- 获取Display对象显示屏幕所有属性信息的功能封装在ShowInfo: 4921 - 使用display.Display来显示默认屏幕信息; 4922 - 使用display.Display[]来显示所有屏幕信息;； 4923 4924##### 约束与限制 4925 4926开发语言：ArkTS 4927 4928配套版本：API10版本SDK，版本号：4.0.9.6 4929 4930[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/Screen) 4931 4932#### 存储空间统计 4933 4934##### 介绍 4935 4936本示例使用[DataPanel组件](reference/arkui-ts/ts-basic-components-datapanel.md)展示不同种类的应用存储信息，通过[@ohos.bundle.bundleManager](reference/apis/js-apis-Bundle.md)模块来获取不同应用的包名与应用名等信息，使用应用空间统计[@ohos.file.storageStatistics](reference/apis/js-apis-file-storage-statistics.md)来查询当前设备的存储使用情况，使用卷管理[@ohos.file.volumeManager](reference/apis/js-apis-file-volumemanager.md)来查询可用卷存储使用情况。实现了查看当前设备存储空间信息、所有安装的应用的存储信息、所有可用卷的存储信息的功能。 4937 4938##### 使用 4939 49401. 主页面会展示当前设备存储使用的详细信息。 4941 49422. 点击“应用”，可以查看当前安装的所有应用的存储使用情况。 4943 49443. 当有可用的卷时，点击“查看可用卷信息”查看当前设备所有的可用卷的存储使用情况。 4945 4946##### 基本原理 4947 4948* 本示例使用DataPanel组件展示不同种类的应用存储信息，通过 Bundle模块来获取不同应用的包名与应用名等信息，使用应用空间统计来查询当前设备的存储使用情况，使用卷管理来查询可用卷存储使用情况。 4949* 接口参考：[DataPanel组件](reference/arkui-ts/ts-basic-components-datapanel.md)，[@ohos.bundle.bundleManager](reference/apis/js-apis-Bundle.md)，[@ohos.file.storageStatistics](reference/apis/js-apis-file-storage-statistics.md)，[@ohos.file.volumeManager](reference/apis/js-apis-file-volumemanager.md) 4950 4951##### 约束与限制 4952 4953开发语言：ArkTS 4954 4955配套版本：API10版本SDK，版本号：4.0.9.6 4956 4957[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/StorageStatistic) 4958 4959#### 多模输入 4960 4961##### 介绍 4962 4963本示例使用[鼠标指针](reference/apis/js-apis-pointer.md)，展示了多模输入鼠标外设的五种场景：鼠标样式资源切换、设置鼠标大小及颜色、设置鼠标动画光标样式、通过switch开关切换鼠标滚轮在非激活悬停窗口的滚动操作使能状态、通过switch开关切换鼠标主次键等功能。 4964 4965##### 使用 4966 49671.启动应用,首页展示鼠标外设的各种设置项。 4968 49692.选择主按钮中的下拉框可以切换鼠标主次键。 4970 49713.点击当悬停在非活动窗口上方时对其进行滚动右侧switch开关，可以切换鼠标滚轮在非激活悬停窗口的滚动操作使能状态。 4972 49734.鼠标指针大小中的滑动条可以设置鼠标指针大小。 4974 49755.点击鼠标指针颜色中的单选框，可以设置鼠标颜色。 4976 49776.点击鼠标指针动画样式中的静态或动态单选框，可以设置鼠标静态或动画光标样式。 4978 4979##### 基本原理 4980 4981* 本示例主要分为一个模块， 4982 * 鼠标外设模块 4983 * 主要展示了鼠标外设的五种功能设置场景 4984 * 接口参考：[@ohos.multimodalInput.pointer](reference/apis/js-apis-pointer.md) 4985 4986##### 约束与限制 4987 4988开发语言：ArkTS 4989 4990配套版本：API10版本SDK，版本号：4.0.11.5 4991 4992[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/Mouse) 4993 4994### 国际化 4995 4996#### 国际化 4997 4998##### 介绍 4999 5000本示例展示如何使用媒体查询，[@ohos.intl](reference/apis/js-apis-intl.md)模块包含国际化能力基础接口，[@ohos.i18n](reference/apis/js-apis-i18n.md)模块包含国际化能力增强接口，资源管理模块，根据当前configuration（语言，区域，横竖屏，mccmnc）和device capability（设备类型，分辨率）提供获取应用资源信息读取接口。三个结合一起实现语言地区设置、时区设置和国际化资源管理相关功能。 5001 5002##### 使用 5003 50041.启动应用，进入应用，首页分为三个按钮，点击**语言和地区**可以进入界面设置系统语言和地区。 5005 50062.点击**日期和时间**，可以进入界面设置系统时间和时区。 5007 50083.点击**区域格式示例**进入界面展示当前区域，当前系统语言下的时间、数字、货币、百分比、单复数、屏幕方向等信息的格式化显示。 5009 5010##### 基本原理 5011 5012* 本示例分为三个模块： 5013 * 语言和地区模块 5014 * 使用i18n接口中getDisplayCountry方法获取指定国家的本地化显示文本，getSystemRegion方法获取系统地区，getSystemLocale方法设置系统Locale，getSystemLanguage方法获取系统支持的语言列表，getPreferredLanguageList方法获取系统偏好语言列表，removePreferredLanguage方法删除系统偏好语言列表中指定位置的偏好语言。 5015 * 接口参考：[@ohos.i18n](reference/apis/js-apis-i18n.md)，[@ohos.intl](reference/apis/js-apis-intl.md) 5016 5017 * 日期和时间模块 5018 * 使用i18n接口中is24HourClock方法判断系统时间是否为24小时制，getTimeZone方法获取日历对象的时区，set24HourClock方法修改系统时间的24小时制设置，setTime方法设置系统时间，setDate方法设置系统日期，getTimezone方法获取系统时区。 5019 * 接口参考：[@ohos.i18n](reference/apis/js-apis-i18n.md)，[@ohos.systemTime](reference/apis/js-apis-system-time.md) 5020 5021 * 区域格式示例模块 5022 * 使用i18n接口中is24HourClock方法判断系统时间是否为24小时制，NumberFormat方法创建一个NumberFormat对象，getResourceManager方法获取当前应用的资源管理对。 5023 * 接口参考：[@ohos.i18n](reference/apis/js-apis-i18n.md)，[@ohos.intl](reference/apis/js-apis-intl.md)，[@ohos.resourceManager](reference/apis/js-apis-resource-manager.md) 5024 5025##### 约束与限制 5026 5027开发语言：ArkTS 5028 5029配套版本：API10版本SDK，版本号：4.0.7.5 5030 5031[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Internationalnation/International) 5032 5033### 媒体 5034 5035#### 相机和媒体库 5036 5037##### 介绍 5038 5039本示例使用[@ohos.multimedia.camera](reference/apis/js-apis-camera.md)接口实现相机示例的主要功能：拍照、录像、参数配置等。使用[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md) 接口实现对媒体文件的存储。同时支持拍照角度旋转以及录制分辨率选择。 5040 5041##### 使用 5042 50431.启动应用，在权限弹窗中授权后返回应用，进入相机界面。 5044 50452.相机界面默认是拍照模式，点击底部拍照按钮可以拍照，拍照完成会在底部左侧显示照片预览图。 5046 50473.点击**录像**或者左滑切换到录像模式，点击底部按钮开始录像，点击结束按钮结束录像，结束录像后底部左侧显示视频图标。 5048 50494.点击系统**Back**键或界面顶部**返回**按钮退出应用。 5050 50515.点击顶部右侧按钮进入设置界面，点击拍照旋转角度，选择0，90，180，270四个角度其中一个，返回至界面再次拍照，照片角度根据选择角度旋转。 5052 50536.点击顶部右侧按钮进入设置界面，点击录像分辨率，选择1920x1080，1280x720，800x600三个分辨率其中一个，返回至界面再次录像，视频分辨率根据选择分辨率设置。 5054 50557.返回相机界面点击底部左侧预览图可进入相册应用，可以在其中查看照片和录制的视频 5056 5057##### 基本原理 5058 50591.使用@ohos.multimedia.camera接口实现相机示例的主要功能：拍照、录像、参数配置等。 50602.使用@ohos.multimedia.mediaLibrary接口实现对媒体文件的存储。 50613.通过跳转至相册来访问设备上的照片和录制视频。 5062 5063##### 约束与限制 5064 5065开发语言：ArkTS 5066 5067配套版本：API10版本SDK，版本号：4.0.9.1 5068 5069[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/Camera) 5070 5071#### 录屏示例 5072 5073##### 介绍 5074 5075本示例使用[@ohos.screen](reference/apis/js-apis-screen.md)管理屏幕的一些基础能力，包括获取屏幕对象，监听屏幕变化，创建和销毁虚拟屏幕等。[@ohos.multimedia.media](reference/apis/js-apis-media.md)和[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)完成视频编码并保存到文件中。[@ohos.display](reference/apis/js-apis-display.md)捕捉屏幕显示图像帧，展示设备屏幕（含音频）录制功能。屏幕录制的主要工作是通过创建一个虚拟屏，捕获屏幕显示图形帧，完成视频编码并保存到文件中，帮助OEM设备厂家系统应用实现屏幕录制功能，也可以通过此应用抓取屏幕帧用于问题复现录制。 5076 5077##### 使用 5078 50791.启动应用，首次启动需要用户授予“**访问媒体和文件**”和“**麦克风**”的权限 5080 50812.点击**启动**按钮，启动屏幕录制。 5082 50833.启动录制后会弹出一个透明录制悬浮控件，并显示录制时间计时，此时可以操作屏幕，操作过程屏幕显示会被录制下来。 5084 50854.需要停止录屏时，点击悬浮半透明的红色按钮，屏幕录制停止。 5086 50875.打开图库应用，在图库中可以看到最新录屏的媒体文件，点击后可支持录屏回放。 5088 5089##### 基本原理 5090 5091* 该示例通过Screen方法获取屏幕实例，createVirtualScreen方法创建一个虚拟屏，getAllScreens方法获取获取所有的屏幕，makeMirror方法将屏幕设置为镜像模式，setVirtualScreenSurface方法设置虚拟屏幕的surface，display接口捕获屏幕显示图形帧，media，mediaLibrary接口完成视频编码并保存到文件中，帮助OEM设备厂家系统应用实现屏幕录制功能。 5092* 接口参考：[@ohos.screen](reference/apis/js-apis-screen.md)，[@ohos.multimedia.media](reference/apis/js-apis-media.md)，[@ohos.multimedia.mediaLibrary](reference/apis/js-apis-medialibrary.md)，[@ohos.display](reference/apis/js-apis-display.md) 5093 5094##### 约束与限制 5095 5096开发语言：ArkTS 5097 5098配套版本：API9版本SDK，版本号：3.2.11.9 5099 5100[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/ScreenRecorder) 5101 5102#### 截屏 5103 5104##### 介绍 5105 5106本示例使用[screenshot](reference/apis/js-apis-screenshot.md)模块实现屏幕截图 ，使用[window](reference/apis/js-apis-window.md#setwindowprivacymode9)模块实现隐私窗口切换，使用[display](reference/apis/js-apis-display.md#displayhasprivatewindow9)模块查询当前隐私窗口。展示全屏截图和屏幕局部截图。 5107 5108##### 使用 5109 51101. 点击右上角图标打开弹窗，选择截屏，展示全屏截图；选择局部截屏，选择截屏区域，点击右下角完成，展示局部截屏； 51112. 点击滑块切换窗口隐私模式，隐私模式下截屏会弹出提示，拒绝截屏。 5112 5113##### 基本原理 5114 5115* 本示例通过screenshot接口实现屏幕截图 ，通过window接口实现隐私窗口切换，通过display接口查询当前隐私窗口。 5116* 接口参考：[@ohos.screenshot](reference/apis/js-apis-screenshot.md)，[@ohos.window](reference/apis/js-apis-window.md#setwindowprivacymode9)，[@ohos.display](reference/apis/js-apis-display.md#displayhasprivatewindow9) 5117 5118##### 约束与限制 5119 5120开发语言：ArkTS 5121 5122配套版本：API9版本SDK，版本号：3.2.11.9 5123 5124[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/Screenshot) 5125 5126### 安全 5127 5128#### 访问权限控制 5129 5130##### 介绍 5131 5132本示例使用[@ohos.abilityAccessCtrl](reference/apis/js-apis-abilityAccessCtrl.md)接口中abilityAccessCtrl方法获取访问控制模块对象，GrantStatus.PERMISSION_GRANTED方法表示已授权状态，[@ohos.bundle.bundleManager](reference/apis/js-apis-bundleManager.md)接口中getApplicationInfo方法根据包名获取ApplicationInfo等展示应用申请权限场景 5133 5134##### 使用 5135 51361.打开应用，页面出现弹窗，点击 **取消** 按钮。 5137 51382.页面跳转显示 **检测权限** 按钮，点击检测权限，出现提示信息“权限未授予”。 5139 51403.关闭应用再次打开，页面出现弹窗，点击 **确认** 按钮。 5141 51424.页面跳转显示 **检测权限** 按钮，点击**检测权限** 按钮，出现提示信息“权限已授予”。 5143 51445.关闭应用再次打开，页面不出现弹窗，点击 **检测权限** 按钮，点击检测权限，出现提示信息“权限已授予”。 5145 5146##### 基本原理 5147 5148* 该示例使用abilityAccessCtrl接口中abilityAccessCtrl方法获取访问控制模块对象，GrantStatus.PERMISSION_GRANTED方法表示已授权状态，bundleManager接口中getApplicationInfo方法根据包名获取ApplicationInfo等展示应用申请权限场景 5149* 接口参考：[@ohos.abilityAccessCtrl](reference/apis/js-apis-abilityAccessCtrl.md)，[@ohos.bundle.bundleManager](reference/apis/js-apis-bundleManager.md) 5150 5151##### 约束与限制 5152 5153开发语言：ArkTS 5154 5155配套版本：API9版本SDK，版本号：3.2.11.9 5156 5157[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Security/AbilityAccessCtrl) 5158 5159### 窗口管理 5160 5161#### 窗口扩展应用 5162 5163##### 介绍 5164 5165本示例通过 [窗口扩展能力](reference/apis/js-apis-application-windowExtensionAbility.md) 设置不同Ability，使用 [AbilityComponent](reference/arkui-ts/ts-container-ability-component.md) 组件加载各个Ability。仿设置应用，实现点击设置菜单栏，跳转或加载详情页面。 5166 5167##### 使用 5168 51691.竖屏模式下点击左侧设置菜单栏，跳转详情页面。 5170 51712.横屏模式下点击左侧设置菜单栏，右侧显示详情页面。 5172 5173##### 基本原理 5174 5175* 本示例通过窗口扩展能力设置不同Ability，使用AbilityComponent组件加载各个Ability，matchMediaSync方法设置媒体查询的查询条件，RemoteObject方法实现远程对象。 5176* 接口参考：[@ohos.application.WindowExtensionAbility](reference/apis/js-apis-application-windowExtensionAbility.md)，[AbilityComponent](reference/arkui-ts/ts-container-ability-component.md)，[@ohos.rpc](reference/apis/js-apis-rpc.md)，[@ohos.mediaquery](reference/apis/js-apis-mediaquery.md) 5177 5178##### 约束与限制 5179 5180开发语言：ArkTS 5181 5182配套版本：API9版本SDK，版本号：3.2.11.9 5183 5184[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/WindowManagement/WindowExtAbility) 5185