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/apis-arkui/arkui-ts/ts-container-tabs.md) 搭建整体应用框架，每个 [TabContent内容视图](reference/apis-arkui/arkui-ts/ts-container-tabcontent.md) 使用 [List容器组件](reference/apis-arkui/arkui-ts/ts-container-list.md) 布局，在每个 [ListItem](reference/apis-arkui/arkui-ts/ts-container-listitem.md) 中使用 [循环渲染](quick-start/arkts-rendering-control-foreach.md) 加载此分类下分类导航数据，底部导航菜单使用 [TabContent中tabBar属性](reference/apis-arkui/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-arkui/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本示例通过使用[页面级的状态变量](quick-start/arkts-localstorage.md) 和[应用级的状态变量](quick-start/arkts-appstorage.md) 来实现应用的状态管理。展示内容包括修饰的对象类型、父子组件之间的状态同步、爷孙组件之间的状态同步以及兄弟组件之间的状态同步。 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/apis-arkui/arkui-ts/ts-container-list.md)布局：创建食物数据模型，ForEach循环渲染ListItem。 87 882.[Grid](reference/apis-arkui/arkui-ts/ts-container-grid.md)布局：展示食物分类信息，创建Tabs页签展示不同分类的食物。 89 903.路由机制：[@ohos.router](reference/apis-arkui/js-apis-router.md)接口、[Navigator](reference/apis-arkui/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## 基础特性 109 110### 应用模型 111 112#### Ability的启动模式 113##### 介绍 114本示例展示了在一个Stage模型中，实现standard、singleton、specified多种模式场景。 115##### 使用 1161、standard模式： 117 1181）进入首页，点击番茄，会新建一个番茄的Ability，展示番茄的详情； 119 1202）在番茄的详情界面，点击黄瓜，会新建一个黄瓜的Ability，展示黄瓜的详情； 121 1223）使用aa工具查看Ability信息，此时存在以下Ability：1个番茄的Ability、1个黄瓜的Ability、1个首页的Ability； 123 1242、singleton模式： 125 1261）进入首页，点击冰淇凌，会新建一个冰淇凌的Ability，展示冰淇凌的详情； 127 1282）在冰淇凌的详情界面，点击螃蟹，会复用冰淇凌的Ability，页面数据会刷新并展示螃蟹的详情； 129 1303）使用aa工具查看Ability信息，此时存在以下Ability：1个冰淇凌的Ability、1个首页Ability； 131 1323、specified模式： 133 1341）进入首页，点击核桃，会新建一个核桃的Ability，展示核桃的详情； 135 1362）在核桃的详情界面，点击蓝莓，会新建一个蓝莓的Ability，展示蓝莓的详情； 137 1383）在蓝莓的详情界面，点击核桃，会复用已存在的核桃的Ability，实现specified模式下的单实例特性，页面数据会刷新并展示核桃的详情； 139 1404）使用aa工具查看Ability信息，此时存在以下Ability：1个核桃的Ability、1个蓝莓的Ability、1个首页Ability； 141##### 基本原理 142本示例启动standard、singleton、specified三种模式的方法主要封装在Util当中。 143新建Ability：创建三个代表standard、singleton、specified模式的Ability，如工程目录中的SingletonAbility、SpecifiedAbility、StandardAbility，并在module.json文件中将launchType属性修改为对应的启动模式属性。 144启动指定Ability：通过Util中的startMode函数根据页面所传的abilityName，启动对应的ability并进入详情页面。 145specified多实例功能实现：specified模式则是根据MyAbilityStage中的onAcceptWant函数给用户返回一个ability标识，如果之前启动过标识的ability，不创建新的实例并拉回栈顶，否则创建新的实例并启动。 146##### 约束与限制 147开发语言：ArkTS 148 149配套版本：API9版本SDK，版本号：3.2.11.9 150 151[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/ApplicationModels/AbilityStartMode) 152 153#### 自定义分享 154##### 介绍 155自定义分享主要是发送方将文本，链接，图片三种类型分享给三方应用,同时能够在三方应用中展示。本示例使用[数据请求](reference/apis-network-kit/js-apis-http.md) 实现网络资源的获取，使用[屏幕截屏](reference/apis-arkui/js-apis-screenshot-sys.md) 实现屏幕的截取，使用[文件管理](reference/apis-core-file-kit/js-apis-fileio.md) 实现对文件，文件目录的管理，使用[相册管理](reference/apis-media-library-kit/js-apis-photoAccessHelper.md) 获取截取的图片，使用[弹窗](reference/apis-arkui/js-apis-promptAction.md) 进行信息的提示。 156##### 使用 157使用说明： 158 1591.启动Share应用，首页展示分享跳转页面，点击分享按钮出现自定义分享弹窗（三方APP的）。 160 1612.点击分享文本+链接，选择"Chat"图标，会拉起三方应用Chat ，此时选择聊天列表 中任意的朋友进行分享。 162 1633.点击生成海报，此时第一层弹窗消失并出现新的弹窗，点击截图并分享，会出现小提示"截图成功，分享加载中..." ,稍后会拉起三方应用Chat ，此时选择聊天列表 中任意的朋友进行分享。 164 1654.安装entry以及textShare两个module的hap包 ，点击分享文本+链接，选择"文本分享"图标，会拉起应用文本分享 ,此时选择"留在文本分享"可以进入文本页面 ,若选择"返回"，则会回到Share应用主页面。 166 1675.安装entry以及textEdit两个module的hap包 ，点击分享文本+链接，选择"文本编辑"图标，会拉起应用文本编辑 ,此时选择"留在文本编辑"可以进入文本编辑页面 ,若选择"返回"，则会回到Share应用主页面。 168##### 基本原理 169本示例分为链接分享，应用内文件分享，其它应用分享三个模块： 1701、文本+链接分享模块：ButtonDialogBuilder方法展示自定义分享弹窗，@ohos.abilityAccessCtrl接口获取访问控制权限，@ohos.net.http接口获取网络资源。 1712、应用内文件分享模块：使用弹窗，屏幕截屏(截取屏幕)，文件管理(管理文件和文件目录)和媒体库管理(获取截取的图片)接口进行图片、链接，视频的分享。 1723、其他应用分享模块：使用弹窗，屏幕截屏(截取屏幕)，文件管理(管理文件和文件目录)和媒体库管理(获取截取的图片)API，把图片，链接，文件在其他应用内分享。 173本示例还包含文本分享应用及文本编辑应用： 1741、在Index.ets中加载TemplateBuilder自定义组件并显示分享信息,在加载Index页面中，如果是被分享方拉起，则加载TemplateBuilder自定义组件。若不是被分享拉起，则显示Ability设置内容。 1752、TemplateBuilder组件内容封装在TemplateBuilder.ets中，在TemplateBuilder组件中包含ShareExtAbility组件、“返回Share”和“留在文本分享/留在文本编辑”按钮，可选择返回Share应用或留在当前（文本分享/文本编辑）应用。 176##### 约束与限制 177开发语言：ArkTS 178 179配套版本：API10版本SDK，版本号：4.0.10.1 180 181[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/CustomShare) 182 183#### Stage模型 184##### 介绍 185[Stage模型](reference/apis-ability-kit/js-apis-app-ability-abilityStage.md) 的设计，主要是为了解决FA模型无法解决的开发场景问题，基于应用的能力与系统总体功能和功耗的平衡、原生支持组件级的迁移和协同、支持多设备和多窗口形态的特点这三个出发点，从而让开发者更加方便地开发出分布式环境下的复杂应用。 186##### 使用 1871.点击DataShareExtAbility按钮，跳转到DataShareExtAbility页面； 188 189点击**+**，向rdb数据库中添加单个数据，界面显示添加的数据内容； 190 191点击删除按钮删除指定数据； 192 193点击数据列表，弹出dialog框，可对数据进行修改，点击确认按钮确认修改； 194 195点击返回键，返回首页。 196 1972.点击各个功能按钮测试各个接口。 198##### 基本原理 199本示例主要展示Stage模型与FA模型的区别，分别从AbilityContext、ServiceExtensionContext、 FormExtensionContext、DataShareExtensionAbility、FormExtension、Bundle、Window、abilityAccessCtrl等模块进行介绍。 2001、应用的能力与系统总体功能和功耗的平衡。 2012、原生支持组件级的迁移和协同。 2023、支持多设备和多窗口形态的特点。 203##### 约束与限制 204开发语言：ArkTS 205 206配套版本：API10版本SDK，版本号：4.0.9.6 207 208[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/StageModel) 209 210### 网络与连接 211 212#### 蓝牙 213##### 介绍 214本示例通过使用蓝牙低功耗心率服务，结合[bluetooth](reference/apis-connectivity-kit/js-apis-bluetooth.md) 来接收BLE心率设备发送的心率数据，并使用画布[Canvas](reference/apis-arkui/arkui-ts/ts-components-canvas-canvas.md) 来绘制实时心率图来展示蓝牙相关API用法。 215##### 使用 2161.启动应用后，弹出是否允许应用访问位置信息，点击允许后开始操作。 2172.点击界面中搜索设备，如未开启蓝牙会自动开启并搜索心率设备，如已开启直接搜索设备。 2183.点击连接按钮可以连接到对应的蓝牙心率设备。 2194.点击列表Item可以进入实时心率图查看页面。 2205.点击实时心率图页断开连接可以断开与当前心率设备的连接。 221##### 基本原理 2221.首页扫描蓝牙心率设备：使用bluetooth 来实现蓝牙的开启和BLE的扫描，然后再使用一个List显示扫描到BLE心率设备，点击连接按钮可以连接上对应的心率设备。 2232.实时心率图页：使用bluetooth 来接收心率设备发送的心率数据，并使用画布Canvas 来绘制实时心率图，点击断开连接可以断开与当前心率设备的连接。 224##### 约束与限制 225开发语言：ArkTS 226 227配套版本：API9版本SDK，版本号：3.2.12.1 228 229[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/Bluetooth) 230 231#### Http 232##### 介绍 233本示例通过[@ohos.net.http](reference/apis-network-kit/js-apis-http.md) 等接口，实现了根据URL地址和相关配置项发起http请求的功能。 234##### 使用 2351.启动应用可配置网络请求，设置网址、请求方式、请求参数； 236 2372.点击确认按钮，跳转请求结果页面； 238 2393.点击返回按钮，返回配置页面； 240 2414.支持将本示例中的http模块编译成tgz包。 242##### 基本原理 243本示例将发送http请求的接口封装在Http模块。 244发起请求：在MainPage.ets中通过TextInput组件获取参数，点击“确认”按钮后通过Http.request()方法调用http.createHttp().request()接口向指定的地址发送请求。 245##### 约束与限制 246开发语言：ArkTS 247 248配套版本：API10版本SDK，版本号：4.0.9.6 249 250[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/Http) 251 252#### RPC连接 253##### 介绍 254本示例使用[@ohos.rpc](reference/apis-ipc-kit/js-apis-rpc.md) 相关接口，实现了一个前台选择商品和数目，后台计算总价的功能，使用rpc进行前台和后台的通信。 255##### 使用 2561.点击商品种类的空白方框，弹出商品选择列表，选择点击对应的商品，空白方框显示相应内容。 257 2582.点击商品选择框后的 + 或 - 按钮，选择商品所对应的数量。 259 2603.点击 Confirm an order 按钮，根据相应的菜品数量与单价，计算出总价并显示。 261##### 基本原理 2621.发送数据：在首页的sortString()中通过rpc.MessageSequence.create()创建MessageSequence对象，然后通过MessageSequence.writeStringArray()将 我们的处理过的购物数据写入MessageSequence对象中，通过rpc.RemoteObject.sendMessageRequest()将我们得出总价所需要的参数发送到进程中; 263 2642.读取数据：处理MessageRequest请求的接口封装在ReceivedData里面，在这里接收传递来的数据，然后经过处理得出总价，并通过rpc.MessageParcel.writeInt()写入MessageParcel对象。 265##### 约束与限制 266开发语言：ArkTS 267 268配套版本：API9版本SDK，版本号：3.2.11.9 269 270[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/RPC) 271 272#### 网络管理-Socket连接（UDP） 273##### 介绍 274本示例主要使用面向非连接的协议UDP Socket，展示Socket在两端设备的连接验证、聊天通信方面的应用。 275##### 使用 2761.搭建服务器环境：修改服务器脚本中的服务端IP地址，与本机IP地址保持一致，修改完成后双击运行脚本（端口号不必修改，与客户端工程中的端口保持一致即可）。 2772.运行成功后为阻塞状态，等待客户端连接成功后会有相应提示。 2783.打开应用，点击用户选择框选择要登录的用户（不同客户端保持用户选择不一致），点击协议选择框选择通信协议（与运行的服务器一致），并输入另一个设备的IP地址(如果是TCP和TLS，则输入服务端IP地址)，点击登录按钮进入创建房间用户页面（两个设备都要依次执行此步骤）。 2794.在两台设备都成功连上服务器后，在其中一个设备上点击创建房间按钮，任意输入房间号，另一个设备会收到邀请进入房间的信息弹框，点击确定按钮后，两个设备进入聊天页面。 2805.在其中一个设备上输入聊天信息并点击发送按钮后，另一个设备的聊天页面会收到该聊天消息。 2816.点击顶部标题栏左侧的返回图标按钮，则返回创建房间页面。 2827.以上运行完成后如需再次创建房间请重启客户端和服务端进行调试。 283##### 基本原理 2841.UDP Socket：使用UDP Socket实现文本传输，无需搭建服务器，对端直接交流。 2852.TCP Socket：使用TCP Socket实现文本传输和公共通知事件转发，需要Python脚本搭建TCP服务器，公共通知用于来起音频通话应用。 2863.TLS Socket：使用TLS Socket实现文本传输，需要Python脚本搭建TLS服务器，服务器和客户端需要同一套证书文件。 287##### 约束与限制 288开发语言：ArkTS 289 290配套版本：API9版本SDK，版本号：3.2.11.9 291 292[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/Socket) 293 294#### 网络管理-Socket连接 295##### 介绍 296本示例主要设计三种协议方式：UDP Socket、TCP Socket以及TLS Socket，展示在使用不同协议时，Socket在两端设备的连接验证、聊天通信方面的应用。 297##### 使用 2981.打开应用，点击用户文本框选择要登录的用户，并输入另一个设备的IP地址，点击确定按钮进入已登录的用户页面（两个设备都要依次执行此步骤）。 299 3002.在其中一个设备上点击创建房间按钮，任意输入房间号，另一个设备会收到有房间号信息的弹框，点击确定按钮后，两个设备进入聊天页面。 301 3023.在其中一个设备上输入聊天信息并点击发送按钮后，另一个设备的聊天页面会收到该聊天消息。 303 3044.点击顶部标题栏右侧的退出图标按钮，则返回已登录的用户页面。 305 3065.点击聊天页面中的昵称栏，会弹出一个菜单，选择离线选项后，两端设备的状态图标都会切换为离线图标，并且昵称栏都会变成灰色，此时任何一端发送消息另一端都接收不到消息。 307 3086.当点击昵称栏再次切换为在线状态，则两端的己方账号状态会切换为在线图标，同时两端的昵称栏会显示蓝色，此时可正常收发消息。 309##### 基本原理 310本示例分为三个模块 3111.输入对端IP模块:使用wifi.getIpInfo()方法获取IP地址，constructUDPSocketInstance方法创建一个UDPSocket对象。 3122.创建房间模块：点击创建房间按钮，弹出创建房间框，输入房间号，点击确定，进入聊天页面。 3133.聊天模块：bindOption方法监听消息，设置在线与离线。 314##### 约束与限制 315开发语言：ArkTS 316 317配套版本：API9版本SDK，版本号：3.2.11.10 318 319[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/StageSocket) 320 321#### 上传和下载 322 323##### 介绍 324 325本示例使用[@ohos.request](reference/apis-basic-services-kit/js-apis-request.md)接口创建上传和下载任务，实现上传、下载功能，hfs作为服务器，实现了文件的上传和下载和任务的查询功能。 326 327##### 使用 3281.本示例功能需要先配置服务器环境后使用，具体配置见[上传下载服务配置](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/UploadAndDownLoad/environment)。 329 3302.首页展示上传和下载两个入口组件，点击进入对应的页面，如果要使用后台下载任务，请开启后台任务开关。 331 3323.上传页面： 333 334 点击 **+** ，**从相册选择**拉起图库选择照片，图片选择页面支持拍照，选择照片后点击**上传**进行上传。 335 336 可选的，点击缩略图，显示文件片段上传配置选项弹窗，可以配置上传起点和终点，取值为闭区间；起点默认为0，终点默认为文件结尾。点击**上传**进行选中文件片段以及后续文件全部内容上传。 337 338 点击**返回**键或片段上传配置选项弹窗外区域，取消片段上传。 339 340 在首页中打开后台任务开关后，上传页面开启的是后台上传任务，后台任务在应用退出到后台时可以在通知栏看到任务状态。 341 3424.下载页面： 343 344 点击文件列表选择要下载的文件后，点击**下载**选择指定路径后开始下载。 345 346 点击**查看下载文件**进入下载文件页面，点击文件夹查看文件夹内的文件。 347 348 在首页中打开后台任务开关后，下载页面开启的是后台下载任务，后台任务在应用退出到后台时可以在通知栏看到任务状态。 349 350 前台下载时只支持单文件下载，后台下载时支持选择多个文件下载。 351##### 基本原理 352 353* 该示例分为两个模块： 354 * 上传模块 355 * 使用[@ohos.request](reference/apis-basic-services-kit/js-apis-request.md)中API 10接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，失败的任务会调用查询接口获取失败原因并打印在日志中，支持多个文件上传及片段上传。 356 * 参考接口：[@ohos.request](reference/apis-basic-services-kit/js-apis-request.md)，[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md) 357 * 下载模块 358 * 使用[@ohos.request](reference/apis-basic-services-kit/js-apis-request.md)中API 10接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，失败的任务会调用查询接口获取失败原因并打印在日志中，前台下载任务只支持单个文件下载，后台下载任务支持多文件下载。使用[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md)完成指定路径的创建和查询已下载的文件。 359 * 参考接口：[@ohos.request](reference/apis-basic-services-kit/js-apis-request.md)，[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 360 361##### 约束与限制 362 363开发语言：ArkTS 364 365配套版本：API10版本SDK，版本号：4.0.8.5 366 367[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/UploadAndDownLoad) 368 369#### WebSocket 370 371##### 介绍 372 373本示例展示了[WebSocket](reference/apis-network-kit/js-apis-webSocket.md)的使用，包括客户端与服务端的连接和断开以及客户端数据的接收和发送。 374 375##### 使用 376 3771.输入服务器IP地址，点击**绑定服务器IP地址**按钮，即可绑定该IP并退出弹框，如果要解绑IP，重启应用即可。 378 3792.点击顶部栏的**连接**按钮，按钮颜色从灰色变为绿色，即可与服务器建立WebSocket连接，并开始监听服务器发来的消息。 380 3813.在底部消息输入框输入消息，点击**发送**按钮，即可收到来自服务端的消息回馈。 382 3834.再次点击顶部栏的**连接**按钮，按钮颜色从绿色重新变成灰色，即可与服务器断开连接，接收不到服务器发来的消息。 384 3855.重新连接需要退出应用重新绑定ip，再次点击连接才可以发送接收消息。 386 387##### 基本原理 388 389* 本示例分为两大模块 390 * 客户端与服务端的连接和断开模块 391 * BindServiceIP方法输入服务器IP地址，socket.connect方法绑定服务器，进入消息框页面，socket.on方法连接服务器，socket.off方法断开连接 392 * 接口参考：[@ohos.prompt](reference/apis-arkui/js-apis-promptAction.md)，[@ohos.net.webSocket](reference/apis-network-kit/js-apis-webSocket.md) 393 394 * 客户端数据的接收和发送模块 395 * TopBar组件搭建通讯页面，socket.send方法发送信息数据。 396 * 接口参考：[@ohos.prompt](reference/apis-arkui/js-apis-promptAction.md)，[@ohos.net.webSocket](reference/apis-network-kit/js-apis-webSocket.md) 397 398##### 约束与限制 399 400开发语言：ArkTS 401 402配套版本：API9版本SDK，版本号：3.2.12.1 403 404[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/WebSocket) 405 406#### VPN连接 407 408##### 介绍 409 410本示例使用@ohos.net.vpn接口演示了创建VPN隧道、建立VPN网络、VPN隧道保护、销毁VPN网络以及使用@ohos.net.vpnExtension接口创建三方VPN等功能。实现了使用VPN进行服务器连接，发送数据的功能。 411 412##### 使用 413 4141. 进入应用前请先安装[VPNFoundation](https://gitee.com/openharmony/applications_app_samples/blob/master/code/BasicFeature/Connectivity/VPN/lib/VPNFoundation-1.0.0.hap)。 415 4162. 进入应用后，主界面有启用VPN和停用VPN的选项,分别对应开启和关闭VPN功能。 417 4183. 在主界面，可以点击启用VPN来创建VPN连接。 419 4204. 在VPN启动界面，可以配置VPN服务器IP地址/隧道IP地址/使用VPN的应用程序。 421 4225. 在VPN启动界面，点击创建对象可以创建VPN隧道，点击隧道保护可以开启隧道保护，点击启动VPN可以进行网络连接。 423 4246. 在主界面，可以点击停用VPN来断开和关闭VPN连接。 425 4267. 以上演示系统VPN，如果使用三方VPN，点击启动vpnExt按钮，弹窗提示VPN使用许可，同意后三方VPN启动并自动连接，尝试用浏览器等hap包访问百度。 427 428##### 基本原理 429 430本示例应用所演示的功能主要封装在StartVpn.ets和StopVpn.ets。 431* 调用StartVpn.CreateTunnel()来创建VPN隧道。 432* 调用StartVpn.SetupVpn()来建立VPN网络。 433* 调用StopVpn.Destroy()来销毁VPN网络。 434* 调用StartVpn.Protect()来开启VPN隧道保护。 435 436##### 约束与限制 437 438开发语言：ArkTS 439 440配套版本：API11版本SDK，版本号：4.1.6.5 441 442[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/VPN) 443 444### DFX 445 446#### 应用故障恢复 447 448##### 介绍 449 450本示例展示了在应用中如何适配故障恢复相关接口。示例包括一下场景：单Ability自动恢复、多Ability自动恢复、多Ability主动恢复、Ability后台强制终止恢复。 451 452##### 使用 453 454一.单Ability自动恢复 \ 455点击首页点击``跳转到故障触发页面`` \ 456在故障触发页面点击按钮``点击``，再点击``保存当前Ability状态``以及``触发JsError``。 \ 457以上场景预期：\ 458能够回到``故障触发页面``页面，页面上的点击次数与触发保存状态时的一致。 459 460二.多Ability自动恢复 \ 461点击首页点击跳转到``故障触发页面`` \ 462在``故障触发页面``点击``启动SecondAbility`` 463点击首页点击``跳转到故障触发页面`` \ 464在故障触发页面点击按钮``点击``，再点击``保存当前Ability状态``以及``触发JsError``。 \ 465以上场景预期：\ 466立即回到SecondAbility的故障触发页面，并恢复页面的点击次数信息。\ 467从任务管理中将EntryAbility切回前台，预期能回到故障触发页面，页面上的点击次数与触发保存状态时的一致。 468 469三.多Ability主动恢复 \ 470点击首页点击跳转到``故障触发页面`` \ 471在``故障触发页面``点击``启动SecondAbility`` 472在SecondAbility的故障触发页面点击设置重启Ability。 \ 473在SecondAbility的故障触发页面点击``触发JsError``。 \ 474以上场景预期：\ 475重启时启动RecoveryAbility。 476 477四.Ability后台强制终止恢复 \ 478点击首页点击跳转到``故障触发页面`` \ 479在``故障触发页面``点击``启动SecondAbility`` 480在SecondAbility的故障触发页面点击Counter，点击``保存当前Ability状态``,并切入后台 \ 481使用kill命令强制终止当前应用 \ 482以上场景预期：\ 483从任务管理中将EntryAbility切回前台，预期能回到故障触发页面，并恢复页面上的点击次数信息。\ 484从任务管理中将SecondAbility切回前台，预期能回到故障触发页面，并恢复页面上的点击次数信息。 485 486为避免反复拉起，两次测试的间隔至少为60秒(自动拉起的间隔为60秒)。 487 488##### 基本原理 489 490* 使能应用恢复功能 491 * 在``onCreate``中 调用[appRecovery](dfx/apprecovery-guidelines.md)接口使能功能 492* 配置支持恢复的Ability 493 * 在``Ability``的节点中增加``recoverable``的配置，并设置为``true`` 494* 实现恢复功能 495 * 在``onSaveState``中保存用于恢复的数据 496 * 在``onCreate``的``want``参数中恢复所需要的数据 497 498##### 约束与限制 499 500开发语言：ArkTS 501 502配套版本：API10版本SDK，版本号：4.0.8.5 503 504[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/AppRecovery) 505 506#### Debug 507 508##### 介绍 509 510本示例通过使用[@ohos.hidebug](reference/apis-performance-analysis-kit/js-apis-hidebug.md) 接口来获取应用进程实际使用的物理内存大小、进程的共享脏内存大小、进程的私有脏内存大小等内存使用情况。 511 512##### 使用 513 5141.点击界面右上方Debug图标，弹出Debug信息界面，显示当前应用内存使用情况； 515 5162.再次点击右上方Debug图标，Debug信息界面消失。 517 518##### 基本原理 519 520* 本实例获取Debug信息的功能结主要封装在Index。 521 * 获取Debug信息：在Index页面中通过点击事件调用hidebug.getPss()、hidebug.getSharedDirty()、hidebug.getPrivateDirty()等方法能够获取应用进程实际使用的物理内存大小、进程的共享脏内存大小、进程的私有脏内存大小。 522 523##### 约束与限制 524 525开发语言：ArkTS 526 527配套版本：API9版本SDK，版本号：3.2.11.9 528 529[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/Debug) 530 531#### 测试打点 532 533##### 介绍 534 535本示例展示了在eTS中如何获取应用故障相关信息，测试打点包括应用打点与性能打点两部分，应用打点通过调用[@ohos.hiAppEvent](reference/apis-performance-analysis-kit/js-apis-hiappevent.md)接口来记录应用运行过程中发生的各种信息。 536 537##### 使用 538 5391.点击"事件写入"按钮，显示成功写入事件。 540 5412.打开"禁用应用打点"开关，再次点击"事件写入"按钮，显示事件写入失败。 542 5433.关闭"禁用应用打点"开关，再次点击"事件写入"按钮，显示事件写入成功。 544 545##### 基本原理 546 547* 该示例使用hiAppEvent接口中write方法将事件写入到当天的事件文件中，EventType方法枚举事件类型，configure方法去配置打点开关来实现测试打点。 548* 接口参考：[@ohos.hiAppEvent](reference/apis-performance-analysis-kit/js-apis-hiappevent.md) 549 550##### 约束与限制 551 552开发语言：ArkTS 553 554配套版本：API9版本SDK，版本号：3.2.11.9 555 556[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/DotTest) 557 558#### 故障日志获取 559 560##### 介绍 561 562本示例使用了[@ohos.faultLogger](reference/apis-performance-analysis-kit/js-apis-faultLogger.md)接口，展示在eTS中如何获取js_crash故障、cpp_crash故障、freeze_crash故障等不同场景下应用故障相关信息。 563 564##### 使用 565 5661. 启动应用后，点击**构造异常**按钮，在弹窗中选择故障类型，点击确定可以构造异常场景; 5672. 构造异常场景后，重新启动应用，点击下面不同的获取异常按钮可以获取到对应类型的异常日志并显示在页面文本框中。 568 569##### 基本原理 570 571+ 创造应用故障场景，故障类型枚举值参考[faultType](reference/apis-performance-analysis-kit/js-apis-faultLogger.md#faulttype)： 572 + js_crash故障：通过数组访问越界构造; 573 + cpp_crash故障：通过调用不存在的Api接口构造; 574 + freeze_crash故障：通过代码产生死循环构造; 575+ 获取上述异常故障日志,源码参考： 576 + 获取异常故障日志：使用faultLogger.query接口获取异常日志信息。 577 578##### 约束与限制 579 580开发语言：ArkTS 581 582配套版本：API9版本SDK，版本号：3.2.11.9 583 584[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/FaultLogger) 585 586#### 日志打印 587 588##### 介绍 589 590本示例使用[hilog日志系统](reference/apis-performance-analysis-kit/js-apis-hilog.md) ，提供日志打印类，使应用/服务可以按照指定级别、标识和格式字符串输出日志内容，帮助开发者了解应用/服务的运行状态，更好地调试程序。 591 592##### 使用 593 5941.进入应用会自动生成一个空的日志文件。 595 5962.点击log按钮即可输出日志，并将日志生成到日志文件当中。 597 598##### 基本原理 599 600+ 日志输出功能封装在Logger: 601 + 日志输出：Logger类根据Configure的types参数将日志分为三个类型，其中file类型会将日志写入本地文件，console类型调用ConsoleLoggerStrategy类输出，hilog类型调用HilogLoggerStrategy类输出; 602 + 日志文件写入本地：FileLoggerStrategy类使用[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 将日志写入本地文件中，本示例只是展示了文件写入文件操作的使用方法，在实战场景中，建议把耗时操作放入子线程中运行。 603 604##### 约束与限制 605 606开发语言：ArkTS 607 608配套版本：API9版本SDK，版本号：3.2.11.9 609 610[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DFX/Logger) 611 612### 数据管理 613 614#### 首选项 615 616##### 介绍 617 618本示例使用[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md) 接口，展示了使用首选项持久化存储数据的功能。 619 620##### 使用 621 6221.点击顶部titleBar的右侧**切换**按钮，弹出主题菜单，选择任意主题则切换相应的主题界面； 623 6242.退出应用再重新进入，显示上一次退出前的主题界面。 625 626##### 基本原理 627 628* 切换主题：在首页预先设置好几套主体数据，使用preferences.getPreferences获取使用Preferences对象，调用Preferences.get() 629读取缓存中的参数，得到当前应该展示哪一套主体。每次点击切换按钮都会调用Preferences.put()来重新修改参数，然后使用 630Preferences.flush()保存并刷新文件内容。 631 632##### 约束与限制 633 634开发语言：ArkTS 635 636配套版本：API9版本SDK，版本号：3.2.11.9 637 638[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DataManagement/Preferences) 639 640#### 标准化数据定义与描述 641 642##### 介绍 643 644 本示例主要使用[@ohos.data.uniformTypeDescriptor](reference/apis-arkdata/js-apis-data-uniformTypeDescriptor.md) 展示了标准化数据定义与描述的功能。在新增预置媒体文件后，支持对媒体文件的utd标准类型获取、utd类型归属类型查询、获取文件对应的utd类型的默认图标、自定义数据类型等功能。 实现过程中还使用到[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 、[@ohos.router](reference/apis-arkui/js-apis-router.md)等接口。 645 646##### 使用 647 6481. 在主界面，点击“Please select a media file”进入选择媒体类型的主页面。 649 6502. 在选择媒体类型界面，点击“下拉列表”，在展开的列表中可以选择一种媒体类型，如“Audios”，下面的列表中显示预置文件夹中所有归属于Audio的文件。 651 6523. 在选择媒体类型界面，点击文件列表中某个文件，跳转到“显示文件信息”界面，该界面中显示文件归属类型的图标和文件名。 653 6544. 在选择媒体类型界面，点击返回箭头图标，返回到“选择媒体类型”界面。 655 656##### 基本原理 657 658* 新增文件夹和媒体文件功能： 659 660 * 使用fs.accessSync来检查文件或文件夹是否已存在。 661 662 * 使用fs.mkdirSync创建文件夹，文件夹在应用的沙箱目录files下创建。 663 664 * 遍历文件名数组precastFiles，使用fs.accessSync检查文件是否已存在。 665 666 * 使用fs.openSync创建上一步检查结果为不存在的文件。 667 668* 查找文件归属类型的功能： 669 670 * 使用fs.listFileSync获取指定目录下的所有文件保存在数组中。 671 672 * 遍历数组中每个文件，调用函数lastIndexOf获取文件后缀位置，再使用接口substring获取文件的后缀。 673 674 * 使用getUniformDataTypeByFilenameExtension获取文件的utd。 675 676 * 使用getTypeDescriptor获取标准化数据类型。 677 678 * 使用接口belongsTo检查文件是否归属于选中的媒体类型，如果返回值为true，则将该文件名保存在显示数组中。 679 680 * 通过标准化数据类型的属性iconFile，获取标准化数据类型的默认图标资源ID。 681 682 * 上述接口的使用参考[@ohos.data.uniformTypeDescriptor](reference/apis-arkdata/js-apis-data-uniformTypeDescriptor.md)。 683 684##### 约束与限制 685 686开发语言：ArkTS 687 688配套版本：API1版本SDK，版本号：4.1.6.5 689 690[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DataManagement/UDMF/UniformTypeDescriptor/UTDType) 691 692### 设备管理 693 694#### 设备管理合集（非系统特性） 695 696##### 介绍 697 698本示例集合设备管理相关（非系统特性）不需要复杂功能展示的模块，展示了各个模块的基础功能，包含： 699 700- [@ohos.batteryInfo (电量信息)](reference/apis-basic-services-kit/js-apis-battery-info.md) 701- [@ohos.charger (充电类型)](reference/apis-basic-services-kit/js-apis-charger-sys.md) 702- [@ohos.deviceInfo (设备信息)](reference/apis-basic-services-kit/js-apis-device-info.md) 703- [@ohos.power (系统电源管理)](reference/apis-basic-services-kit/js-apis-power.md) 704- [@ohos.runningLock (Runninglock锁)](reference/apis-basic-services-kit/js-apis-runninglock.md) 705- [@ohos.settings (设置数据项名称)](reference/apis-basic-services-kit/js-apis-settings.md) 706- [@ohos.stationary (设备状态感知框架)](reference/apis-multimodalawareness-kit/js-apis-stationary.md) 707- [@ohos.thermal (热管理)](reference/apis-basic-services-kit/js-apis-thermal.md) 708- [@ohos.usbManager (USB管理)](reference/apis-basic-services-kit/js-apis-usbManager.md) 709- [@ohos.multimodalInput.inputConsumer (组合按键)](reference/apis-input-kit/js-apis-inputconsumer-sys.md) 710- [@ohos.multimodalInput.inputDevice (输入设备)](reference/apis-input-kit/js-apis-inputdevice.md) 711- [@ohos.multimodalInput.inputEvent (输入事件)](reference/apis-input-kit/js-apis-inputevent.md) 712- [@ohos.multimodalInput.inputEventClient (按键注入)](reference/apis-input-kit/js-apis-inputeventclient-sys.md) 713- [@ohos.multimodalInput.inputMonitor (输入监听)](reference/apis-input-kit/js-apis-inputmonitor-sys.md) 714- [@ohos.multimodalInput.keyCode (键值)](reference/apis-input-kit/js-apis-keycode.md) 715- [@ohos.multimodalInput.keyEvent (按键输入事件)](reference/apis-input-kit/js-apis-keyevent.md) 716- [@ohos.multimodalInput.mouseEvent (鼠标输入事件)](reference/apis-input-kit/js-apis-mouseevent.md) 717- [@ohos.multimodalInput.pointer (鼠标指针)](reference/apis-input-kit/js-apis-pointer.md) 718- [@ohos.multimodalInput.touchEvent (触摸输入事件)](reference/apis-input-kit/js-apis-touchevent.md) 719 720##### 使用 721 7221.首页展示语言基础类库各个子模块菜单，点击进入对应的模块页面。 723 7242.各个子模块界面中点击功能按钮完成各个功能。 725 7263.电量信息：进入电量信息页面，展示设备电量相关信息。 727 7284.RunningLock锁：点击按钮分别实现设备支持的休眠锁类型、设置屏幕休眠时间功能、设置是否通过接近或者远离状态来控制亮灭屏的锁功能。 729 7305.系统电源管理：点击按钮分别实现获取亮灭屏状态、获取电源模式功能。 731 7326.设置数据项名称：点击按钮分别实现获取数据项uri、开关飞行模式、检查应用是否能以悬浮形式显示功能。 733 7347.设备状态感知框架：点击按钮分别实现订阅设备状态服务、取消订阅设备状态服务、查询设备状态并显示功能。 735 7368.热管理：进入热管理页面，展示当前设备热档位信息、设备过热时提示用户。 737 7389.USB管理：打开监听开关后插入USB设备，会有提示并刷新设备列表，关闭监听后插入USB设备不会提示和自动刷新，下拉设备列表可以手动刷新设备列表。 739 740##### 基本原理 741 7421.首页菜单展示：使用一个module，menuitems完成菜单组件的实现，传入要展示的菜单的strarray类型的资源和菜单点击对应的组件即可。使用Navigation和NavRouter组件实现菜单点击进入功能界面，使用LocalStorage实现应用内Ability内数据共享，点击菜单时标记selectedLabel，在entry中的Capabilities组件中，通过selectedLabel显示对应的功能组件。 743 7442.电量信息：使用[@ohos.batteryInfo.d.ts](reference/apis-basic-services-kit/js-apis-battery-info.md) 745接口获取电池和充放电状态信息。 746 7473.RunningLock锁：使用[@ohos.runningLock.d.ts](reference/apis-basic-services-kit/js-apis-runninglock.md) 748实现对Runninglock锁的创建、查询、持锁、释放等操作。 749 7504.系统电源管理：使用[@ohos.power.d.ts](reference/apis-basic-services-kit/js-apis-power.md) 751实现获取亮灭屏状态、查询电源模式功能。 752 7535.设置数据项名称：使用[@ohos.settings.d.ts](reference/apis-basic-services-kit/js-apis-settings.md) 754实现获取获取数据项uri、开关飞行模式、检查应用是否能以悬浮窗形式显示功能。 755 7566.设备状态感知框架：使用[@ohos.stationary.d.ts](reference/apis-multimodalawareness-kit/js-apis-stationary.md) 757接口提供设备状态感知能力。 758 7597.热管理：使用[@ohos.thermal.d.ts](reference/apis-basic-services-kit/js-apis-thermal.md) 760提供热管理相关的接口，查询热档位以及注册温控等级回调。 761 7628.USB管理：使用[@ohos.usbManager.d.ts](reference/apis-basic-services-kit/js-apis-usbManager.md) 763实现usb设备列表的获取，使用[@ohos.commonEventManager.d.ts](reference/apis-basic-services-kit/js-apis-commonEventManager.md) 764订阅USB设备插入和拔出监听。 765 766##### 约束与限制 767 768开发语言：ArkTS 769 770配套版本：API10版本SDK，版本号：4.0.9.6 771 772[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/DeviceManagementCollection) 773 774#### 位置信息 775 776##### 介绍 777 778本示例使用 [geolocation](reference/apis-location-kit/js-apis-geolocation.md) 实现获取当前位置的经纬度，然后通过 [http](reference/apis-network-kit/js-apis-http.md) 将经纬度作为请求参数，获取到该经纬度所在的城市。通过 [AlphabetIndexer](reference/apis-arkui/arkui-ts/ts-container-alphabet-indexer.md) 容器组件实现按逻辑结构快速定位容器显示区域。 779 780##### 使用 781 7821. 进入主页，点击国内热门城市，配送地址会更新为选择的城市。点击右边字母索引条，可快速定位到想要选择的城市区域，点击该城市后若该城市还细化到区，继续点击该城市的区，配送地址会更新为城市/区，若未细化到区，则只选择城市。 7832. 若测试机支持GPS，点击国内热门城市上面的定位图标，应用会获取本机所在经纬度，然后根据经纬度获取所在城市，定位图标后的城市会进行刷新，当前城市数据为模拟数据。 784 785##### 基本原理 786 787+ 本示例展示获取定位的功能在页面中直接调用，使用geolocation.on方法获取当前位置的经纬度，然后监听经纬度变化发送request请求获取对应城市信息。 788 789##### 约束与限制 790 791开发语言：ArkTS 792 793配套版本：API9版本SDK，版本号：3.2.11.9 794 795[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/Location) 796 797#### 屏幕探测 798 799##### 介绍 800 801本示例实时监测连接的屏幕数量状态，支持创建至多5个虚拟屏幕，点击对应的屏幕矩形能显示该屏幕的相关属性。 802 803##### 使用 804 8051.第一步：进入开始界面 806 8072.第二步：点击右下方的“+”按钮，添加虚拟屏幕，连续点击后，至多创建5个虚拟屏幕。 808 8093.第三步：点击右下方的“-”按钮，移除虚拟屏幕，连续点击删除全部的虚拟屏幕后，再次点击会提示告警信息。 810 8114.第四步：点击屏幕矩形，展示相关屏幕的属性（首字母为R的为真实屏幕，首字母为V的为虚拟屏幕） 812 813##### 基本原理 814 815* 真实屏幕模块 816 * 首字母显示为R，且不能进行删除，点击跳转屏幕属性页面展示真实屏幕属性 817 * 接口参考：[@ohos.display](reference/apis-arkui/js-apis-display.md)，[@ohos.router](reference/apis-arkui/js-apis-system-router.md) 818 819* 新增和删除虚拟屏幕模块 820 * getAllDisplay获取当前所有的display对象，getDefaultDisplay获取当前默认的display对象,push方法新增虚拟屏幕，增加超过5个虚拟屏幕时，给出警告，pop方法删除虚拟屏幕，全部删除虚拟屏幕后，点击给出警告，点击虚拟屏幕展示虚拟屏幕属性 821 * 接口参考：[@ohos.display](reference/apis-arkui/js-apis-display.md)，[@ohos.router](reference/apis-arkui/js-apis-system-router.md) 822 823##### 约束与限制 824 825开发语言：ArkTS 826 827配套版本：API9版本SDK，版本号：3.2.11.9 828 829[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/ScreenDetector) 830 831#### 振动 832 833##### 介绍 834 835本示例模拟倒计时场景，通过[@ohos.vibrator](reference/apis-sensor-service-kit/js-apis-vibrator.md) 等接口来实现振动。 836 837##### 使用 838 8391.点击倒计时文本，弹出时间选择框，选择任意时间，点击**确认**，倒计时文本显示选择的时间。 840 8412.点击**start**，开始倒计时，圆形进度条和文本开始变化；倒计时结束，开始振动，进度条恢复初始状态并且弹出振动提示框，按照描述进行选择。 842 8433.点击**reset**，可以结束倒计时并使文本和进度条恢复初始状态。 844 845##### 基本原理 846 847* 本示例实现振动的方法主要封装在TextTimerComponent中。 848 * 设置倒计时间：Timepicker文件中通过TextPicker组件来设置倒计的时间，并将设定的时间数据双向绑定到TextTimerComponent组件当中。 849 * 启动倒计时：点击start按钮通过setInterval执行倒计时，每隔一段时间Process组件的进度值会被此代码this.progressValue += TOTAL / this.duration进行处理同步刷新。 850 * 触发振动：当时间为0的时候，则执行vibrator.vibrate()方法去触发振动效果。 851 * 初始化时间：点击reset按钮会将Process组件的value以及时间进行初始化，并清除定时器。 852 853##### 约束与限制 854 855开发语言：ArkTS 856 857配套版本：API9版本SDK，版本号：3.2.11.9 858 859[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/Vibrator/BasicVibration) 860 861#### 自定义振动 862 863##### 介绍 864 865本示例使用[Vibrator模块](reference/apis-sensor-service-kit/js-apis-vibrator.md)展示了振感定制化的基本功能，包括振感与音效、视频协同振动等。 866 867##### 使用 868 8691. 在"我的"界面中包含开发信息及基本设置，点击振动强度设置，可选择振动强度等级，本步骤可选，默认为低强度模式； 8702. 在"发现"界面，振效库中罗列了不同体验场景，可点击各条目享受音效与振动的协同感受； 8713. 在"发现"界面，触感效果视频可体验视频与振动的协同，点击视频预览图片进入全屏播放界面； 8724. "显示更多"中罗列了当前的振感视频列表。 873 874##### 基本原理 875 876+ 振动强度设置：可以选择振动的强度等级； 877+ 振效库：点击振效库中各项，会调用媒体库AVPlayer播放音效，并同时调用vibrator模块startVibration接口启动振动; 878+ 振感视频：使用Video控件全屏播放视频，在开始播放同时调用vibrator模块startVibration接口启动振动； 879+ 自定义振动：使用[Vibrator模块](reference/apis-sensor-service-kit/js-apis-vibrator.md)的startVibration方法播放应用内置的振动资源文件; 880 881##### 约束与限制 882 883开发语言：ArkTS 884 885配套版本：API10版本SDK，版本号：4.0.10.7 886 887[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/DeviceManagement/Vibrator/CustomHaptic) 888 889### 设备信息统计 890 891#### 设备使用信息统计 892 893##### 介绍 894 895本示例使用[bundleState](reference/apis-backgroundtasks-kit/js-apis-deviceUsageStatistics.md)相关接口完成设备中应用时长的统计功能。 896 897##### 使用 898 8991.顶部的数据面板展示了最常用的五个应用的使用时间占比情况。 900 9012.中部的竖向滑动栏展示了每个应用的使用总时长和最后一次使用的时间。 902 9033.底部的横向滑动栏展示了不常用应用列表。 904 905##### 基本原理 906 907* 该示例使用bundleState接口中isIdleState方法判断指定bundleName的应用当前是否是空闲状态来分类不常用应用列表，queryBundleStateInfos方法通过指定起始和结束时间查询应用使用时长统计信息来获得每个应用的使用总时长。 908* 接口参考：[@ohos.bundleState](reference/apis-backgroundtasks-kit/js-apis-deviceUsageStatistics.md) 909 910##### 约束与限制 911 912开发语言：ArkTS 913 914配套版本：API9版本SDK，版本号：3.2.11.9 915 916[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceUsageStatistics/DeviceUsageStatistics) 917 918### 文件管理 919 920#### 应用接入数据备份恢复 921 922##### 介绍 923 924本示例主要给备份流程提供应用，用于生成数据和显示数据。应用接入数据备份恢复需要通过配置BackupExtensionAbility实现。BackupExtensionAbility，是[Stage模型](application-models/stage-model-development-overview.md)中扩展组件[ExtensionAbility](application-models/extensionability-overview.md)的派生类。开发者可以通过修改配置文件定制备份恢复框架的行为，包括是否允许备份恢复，备份哪些文件等。 925 926##### 使用 927 9281. 点击按钮“生成文件数据”，应用会随机生成2个到10个txt文件，大小在1Byte到1024Byte之间，用于校验备份和恢复的数据为同一数据。 9292. 本应用仅适用于生成和显示数据，具体的备份和恢复的操作目前需要使用hdc shell命令操作。 9303. 具体操作方面，进入应用点击按钮生成文件数据后，进入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，提示成功后，重新打开应用可以看到备份的文件显示在列表里。 931 932##### 基本原理 933 9341. 在应用配置文件`module.json5`中注册`extensionAbilities`相关配置 9352. 新增元数据资源配置文件 9363. 使用应用生成数据 9374. 备份与恢复操作 938 939##### 约束与限制 940 941开发语言：ArkTS 942 943配套版本：API10版本SDK，版本号：4.0.8.5 944 945[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/FileBackupExtension) 946 947#### 文件管理 948 949##### 介绍 950 951本示例主要展示了文件管理相关的功能，使用[@ohos.filemanagement.userFileManager](reference/apis-core-file-kit/js-apis-userFileManager-sys.md) 、[@ohos.file.fileAccess](reference/apis-core-file-kit/js-apis-fileAccess-sys.md)、[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md) 、[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md)。 952 953等接口，实现了增添文件、删除文件、查找指定类型文件文件、复制并移动文件和预览图片、监听文件的功能。 954 955##### 使用 956 9571. 在主界面，可以点击图片、视频、文档、音频等按钮进入对应目录的文件列表浏览界面； 9582. 在文件列表浏览界面，点击“+”按钮，可以添加文件； 9593. 在文件列表浏览界面，长按列表项会出现删除图片，点击删除图标可以删除文件； 9604. 在图片文件列表界面，点击图片可以进入图片预览界面。 9615. 在主页点击“我的手机”，进入应用沙箱目录下。 9626. 在主页点击“监听文件”，进入文件监听页面。 963 964##### 基本原理 965 966* 增添文件、删除文件、查找指定类型文件文件和预览图片的功能接口封装在MediaLibraryManager。 967* MyPhone模块中的文件增删、复制移动、查找功能封装在FileSystem。 968* 在Library模块中通过封装FileManager向外提供功能接口，如MediaLibraryManager.getPixelMapByFileAsset()。 969* 监听文件模块中的文件增删、查找、修改、监听功能封装在MyWatcher 970 971 972##### 约束与限制 973 974开发语言：ArkTS 975 976配套版本：API10版本SDK，版本号：4.0.9.6 977 978[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/FileManagement/FileManager) 979 980#### 选择并查看文档与媒体文件 981 982##### 介绍 983 984应用使用[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md)、[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md)、[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 等接口，实现了picker拉起文档编辑保存、拉起系统相册图片查看、拉起视频并播放的功能。 985 986##### 使用 987 9881. 在首页，应用展示出最近打开过的文档信息，点击信息可以进入对应文档的查看界面。通过点击右上方的三个按钮，可以分别实现新建文档、选择图片或视频并打开预览、选择文档并打开的功能。 9892. 在查看文档界面，点击右上方左一按钮，可以实现当前文档另存为的功能；点击右上方中间的按钮，开启文档的编辑功能，textArea变成可编辑状态，用户输入数据后点击右上方第三个按钮，可以将当前文档内容进行保存操作。 9903. 在查看图片界面，picker拉起系统相册的图片，用户至多可选择三张图片查看，点击图片可以切换所显示的图片名及大小信息。 9914. 在查看视频界面，picker拉起系统相册的视频，用户至多可选择三个视频查看，点击视频播放并且可以显示的视频名及大小信息。 992 993##### 基本原理 994 995- 拉起picker选择文件、拉起picker保存文件、拉起picker选择图片或视频的功能封装在Index.ets 996 * 使用mediaLiabrary.getMediaLibrary来获取媒体库的实例，用于访问和修改用户等个人媒体数据信息（如视频、图片、文档等）；使用media.getFileAssets来获取文件资源；使用来fetchFileResult.getFirstObject获取文件检索结果中的头一个文件资产，接口参考：[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md) 997 * 使用new picker.DocumentViewPicker来创建文件picker实例，使用documentPicker.select来拉起picker选择文件，使用documentPicker.save来拉起picker保存文件，接口参考：[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md) 998 * 使用new picker.PhotoViewPicker来创建图库picker实例，使用photoPicker.select来拉起picker选择图片或视频，接口参考：[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md) 999 1000- 编辑文件并保存的功能封装在EditFile.ets 1001 * 使用fs.mkdirSync、fs.openSync、fs.writeSync、fs.readSync、fs.closeSync分别用来来创建文件夹、打开文件、写文件、读文件、关闭文件，接口参考：[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 1002 1003- 拉起图片或视频并查看的功能封装在ViewMedia.ets 1004 * 使用new picker.PhotoViewPicker来创建图库picker实例，使用photoPicker.save来拉起picker保存图片或视频，接口参考：[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md) 1005 * 使用mediaLiabrary.getMediaLibrary来获取媒体库的实例，用于访问和修改用户等个人媒体数据信息（如视频、图片、文档等），然后使用media.getFileAssets来获取文件资源再使用fileAsset.displayName来获取图片或视频的名称，接口参考：[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md) 1006 1007 1008##### 约束与限制 1009 1010开发语言：ArkTS 1011 1012配套版本：API10版本SDK，版本号：4.0.10.7 1013 1014[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/FileManagement/FileShare/Picker) 1015 1016#### 为应用之间分享和文件访问提供统一的入口能力 1017 1018##### 介绍 1019 1020本示例主要展示了沙箱文件分享相关的功能，使用 [@ohos.file.fileuri](reference/apis-core-file-kit/js-apis-file-fileuri.md) 、[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md)、[@ohos.ability.wantConstant](reference/apis-ability-kit/js-apis-ability-wantConstant.md)、[@ohos.application.Want](reference/apis-ability-kit/js-apis-app-ability-want.md) 等接口，实现了获取文件uri、创建沙箱文件、提供want中操作want常数和解释Flags说、应用组件间的信息传递的功能。 1021 1022##### 使用 1023 10241. 因本应用的功能依赖Picker应用，在使用本应用之前首先应安装[Picker](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/FileManagement/FileShare/Picker)应用; 10252. 在主界面，可以点击沙箱文件夹列出文件夹中的文件，同时也可以直接点击沙箱目录下的文件进入文件分享界面； 10263. 点击沙箱文件，进入文件分享界面，点击分享图标，文件将以picker方式打开文件，点击编辑图标，文件进入可编辑模式，在textArea中输入内容，然后点击保存，文件内容更新，返回沙箱应用首页，文件修改成功。 1027 1028##### 基本原理 1029 1030* 增添文件、查找指定类型文件、获取文件uri、传递want信息启动ability的功能接口封装在fileFs.ts 1031 1032 * 使用fs.mkdirSync、fs.openSync、fs.writeSync、fs.readSync、fs.closeSync分别用来来创建文件夹、打开文件、写文件、读文件、关闭文件，接口参考：[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 1033 1034 * 使用fileUri.getUriFromPath来获取文件uri，接口参考：[@ohos.file.fileuri](reference/apis-core-file-kit/js-apis-file-fileuri.md) 1035 1036 * 分享文件至picker应用打开并编辑： 1037 1038 调用 implicitStartAbility 方法传递want参数启动新的ability，接口参考：[@ohos.ability.wantConstant](reference/apis-ability-kit/js-apis-ability-wantConstant.md)、[@ohos.application.Want](reference/apis-ability-kit/js-apis-app-ability-want.md) 1039 1040 1041##### 约束与限制 1042 1043开发语言：ArkTS 1044 1045配套版本：API9版本SDK，版本号：3.2.12.2 1046 1047[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/FileManagement/FileShare/SandboxShare) 1048 1049#### 媒体管理合集 1050 1051##### 介绍 1052 1053本示例主要展示网络流播放能力、音视频播控能力、音量调节能力。 1054 1055##### 使用 1056 10571. 启动应用，点击音频或视频可以查看本地音视频资源。若本地没有音视频资源，可以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音视频资源。 10582. 进入首页，可以通过输入网络地址或点击音频，视频进行播放音视频。 10593. 音视频播放后，对于播控按键显示，点击播放、暂停可以播放、暂停音视频，点击循环图标可以在单曲循环和列表循环进行切换。 10604. 点击下一曲、上一曲可以切换音视频，拖动seek可以跳到指定位置播放，点击详细信息可以查看当前音视频信息，视频点击倍速可以开启倍速播放。 10615. 音视频列表左滑可以开启重命名、删除图标，点击对应图标可以进行音视频的重命名和删除。 1062 1063##### 基本原理 1064 1065* 获取音频模块 1066 * 使用媒体库接口进行音视频的扫描，获取音视频详细信息，重命名和删除操作，使用PixelMap方法读取或写入图像数据以及获取图像信息。 1067 * 接口参考：[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md)，[@ohos.prompt](reference/apis-arkui/js-apis-prompt.md) 1068 1069* 音频，视频操作模块 1070 * 使用媒体服务进行音视频播放，暂停，seek等操作，其中AudioPlayer方法播放音频，VideoPlayer方法播放视频。 1071 * 接口参考：[@ohos.multimedia.media](reference/apis-arkui/js-apis-display.md)，[@ohos.multimedia.audio](reference/apis-audio-kit/js-apis-audio.md) 1072 1073* 设备适配模块 1074 * 使用屏幕管理接口获取设备宽度进行适配。 1075 * 接口参考：[@ohos.display](reference/apis-arkui/js-apis-display.md) 1076 1077##### 约束与限制 1078 1079开发语言：ArkTS 1080 1081配套版本：API9版本SDK，版本号：3.2.12.5 1082 1083[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/FileManagement/MediaCollections) 1084 1085#### 相册 1086 1087##### 介绍 1088 1089本示例主要展示了相册相关的功能，使用[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper.md) 接口，实现了查看系统相册、创建用户相册、查看相册照片、用户相册文件添加和删除、以及预览图片、最近删除、收藏夹操作等功能。 1090 1091##### 使用 1092 10931. 主界面：查询显示所有照片、系统相册（相机/视频/截屏录屏/我的收藏/最近删除）、用户相册 10942. 主界面点击“+”，创建用户相册 10953. 创建用户相册时添加图片到用户相册 10964. 长按相册，删除相册 10975. 长按相册，重命名相册（不可重名） 10986. 长按相册，相册多选，批量删除 10997. 点击相册，查看相册中的图片列表 11008. 点击图片，查看单个图片大图 11019. 点击心形图标，收藏图片 110210. 点击心形图标，取消收藏 110311. 大图界面，重命名文件（可重名） 110412. 大图界面，删除文件（移动到最近删除相册） 110513. 从最近删除恢复照片 110614. 点击视频，查看视频并播放 110715. 点击图片页面右上角叹号，查看图片详情 110816. 长按图片批量操作：多选/全选、删除、恢复 110917. 相册内图片列表界面点击“+”，从已有相册添加照片 111018. 长按图片列表图片，更多菜单，从图片选择添加到已有相册 111119. 在相册图片列表界面，长按图片，选择图片，点击更多，可以将图片加入到其他相册（可多选） 111220. 在用户相册图片列表界面，长按图片，选择图片，点击更多，可以将图片从当前相册移除（可多选） 111321. 在用户相册图片列表界面，长按图片，选择图片，点击更多，可以查看图片详情（可多选） 1114 1115##### 基本原理 1116 1117在base模块中通过封装photoAccessHelper向外提供功能接口。 1118 1119##### 约束与限制 1120 1121开发语言：ArkTS 1122 1123配套版本：API10版本SDK，版本号：4.0.9.1 1124 1125[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/FileManagement/Photos) 1126 1127### IDL 1128 1129#### Ability与ServiceExtensionAbility通信 1130 1131##### 介绍 1132 1133本示例展示通过[IDL的方式](IDL/idl-guidelines.md#ts开发步骤) 和 [@ohos.rpc](reference/apis-ipc-kit/js-apis-rpc.md) 等接口实现了Ability与ServiceExtensionAbility之间的通信。 1134 1135##### 使用 1136 11371.启动应用后，首页展示城市的天气信息，当前温度每隔5S会刷新一次。 1138 1139##### 基本原理 1140 1141* Ability与ServiceExtensionAbility通信的方法主要封装在idl_weather_service_proxy、idl_weather_service_stub、HomeFeature、ServiceExtAbility中。 1142 * 建立服务器连接：通过HomeFeature中的this.context.connectAbility(want, this.options)方法来建立服务器连接； 1143 * 接收服务端实例并发送请求：连接成功时new IdlWeatherServiceProxy(proxy)来接收服务端实例，通过[@ohos.rpc](reference/apis-ipc-kit/js-apis-rpc.md) 接口来执行new rpc.MessageOption(0)、 new rpc.MessageParcel()、 new rpc.MessageParcel()获取 MessageParcel对象和请求的模式，调用idl_weather_service_proxy中的this.proxy.sendRequest()来发送请求； 1144 * 接收远程请求处理数据：在idl_weather_service_stub中接收远程请求并通过ServiceExtAbility中的updateWeather()函数来处理数据进行返回； 1145 * 获取数据：最后将获得的数据渲染到页面中去； 1146 * 断开连接：可以通过HomeFeature中的this.context.disconnectAbility(this.connection)方法来断开服务器连接，这里的this.connection是建立连接之后的返回值。 1147 1148##### 约束与限制 1149 1150开发语言：ArkTS 1151 1152配套版本：API9版本SDK，版本号：3.2.11.9 1153 1154[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/IDL/AbilityConnectServiceExtension) 1155 1156### 国际化 1157 1158#### 国际化 1159 1160##### 介绍 1161 1162本示例主要展示了国际化模块的相关功能，使用[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n.md) 接口，实现简单日历展示、字符类型判断、文本断点处理功能。 1163 1164##### 使用 1165 11661. 在主界面，可以点击日历、字符文本处理按钮进入对应功能界面； 11672. 在日历界面，点击“<” “>”按钮，可以查看上/下月公历信息； 11683. 在字符、文本处理界面，上方输入框输入一个字符，点击字符类型判断可以查看当前输入的字符类型，下方输入框输入长文本，点击文本断点可以查看文本断点结果，断点处用红色/标记； 1169 1170##### 基本原理 1171 11721. 日历功能使用[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n.md)模块中Calendar实现，全部逻辑处于Calendar。 11732. 字符类型判断功能使用[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n.md)模块中Unicode实现，全部逻辑处于TextProcessing。 11743. 文本断点功能使用[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n.md)模块中breakIterator实现，全部逻辑处于TextProcessing。 1175 1176##### 约束与限制 1177 1178开发语言：ArkTS 1179 1180配套版本：API9版本SDK，版本号：3.2.11.10 1181 1182[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/International/International) 1183 1184### 媒体 1185 1186#### 音视频录制 1187 1188##### 介绍 1189 1190本示例主要使用@ohos.multimedia.media中的AVRecorder接口实现了录制功能；另外辅助使用@ohos.multimedia.medialibrary接口，实现了创建录制文件功能，接口使用以及权限获取详见媒体库管理。使用@ohos.multimedia.camera接口，实现了相机预览及出流功能，接口使用以及权限获取详见[相机管理](reference/apis-camera-kit/js-apis-camera.md)。 1191 1192##### 使用 1193 11941. 在主界面，可以点击视频录制、音频录制进入对应功能界面； 11952. 点击视频录制页面，进入页面呈现摄像头预览画面，用户可以通过点击左上角的设置图标进行视频分辨率参数设置，点击”开始“”暂停“”恢复“”停止“等对应图标按钮进行视频录控相关操作。 11963. 点击音频录制页面，用户可以通过点击左上角的设置图标进行音频采样率参数设置，点击”开始“”暂停“”恢复“”停止“等对应图标按钮进行音频录控相关操作。 1197 1198##### 基本原理 1199 1200* 录控功能接口调用实现参考工程目录中的音频录制页面和视频录制页面 1201 * 调用create()、prepare()、getInputSurface()、start()、pause()、resume()、stop()、reset()、release()接口实现录制器的创建、准备、录控操作、重置、销毁实例等功能； 1202 * 视频录制调用Camera接口实现相机出流功能配合视频录制功能，相机的实现方法参考自相机接口[@ohos.multimedia.camera](reference/apis-camera-kit/js-apis-camera.md) 1203* 调用MediaLibrary实现创建录制，实现方法参考@ohos.multimedia.medialibrary接口说明 1204 1205##### 约束与限制 1206 1207开发语言：ArkTS 1208 1209配套版本：API9版本SDK，版本号：3.2.10.8 1210 1211[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AVRecorder) 1212 1213#### 媒体会话——控制方（仅对系统应用开放） 1214 1215##### 介绍 1216 1217本示例主要展示了媒体会话（媒体控制方）的相关功能，使用[@ohos.multimedia.avsession](reference/apis-avsession-kit/js-apis-avsession.md)等接口实现媒体提供方与媒体控制方自定义信息的交互功能。 1218 1219##### 使用 1220 12211. 打开媒体控制方示例应用，可以看到音乐应用的历史记录。 12222. 点击播放按钮，应用的播放状态发生变化。 12233. 点击暂停按钮，应用的播放状态开始变化。 12244. 点击上一首按钮，界面展示播放列表中的上一首歌曲的信息。 12255. 点击下一首按钮，界面展示播放列表中的下一首歌曲的信息。 12266. 点击歌词按钮，界面中出现歌词。 12277. 点击播放列表按钮，界面中出现播放列表。 12288. 点击播放列表中的歌曲，媒体提供方切换到对应的歌曲。 1229 1230##### 基本原理 1231 1232* 界面相关的实现都封装在pages/Index.ets下 1233 * 使用`@StorageLink`来设置与逻辑代码同步更新的变量，当逻辑代码中对应的变量更新时，界面会同步的刷新。 1234 * 通过引入逻辑代码对应的类，创建出对象，实现对onClick事件的响应 1235 1236* 逻辑相关的实现都封装在feature/MediaController.ets下 1237 1238 应用的初始化相关操作 1239 1240 * 链接变量 1241 1242 通过`AppStorage.SetAndLink()`将逻辑代码中的变量与界面代码中使用`@StorageLink`声明的变量连接起来，通过`set()`与`get()`操作来修改或获取变量的值 1243 * 获取当前设备中会话并创建Controller 1244 1245 通过接口`getAllSessionDescriptors()`获取当前设备中的媒体会话； 1246 通过接口`createController()`创建媒体会话对应的控制器； 1247 通过接口`getHistoricalSessionDescriptors()`获取当前设备中的媒体会话历史记录； 1248 通过接口`on(metadataChange | playbackStateChange | queueItemsChange | queueTitleChange | sessionEvent)`开启对媒体提供方发送事件的监听，对媒体提供方的事件进行处理； 1249 1250 应用在运行中相关的操作 1251 1252 * 发送基础控制命令到媒体提供方 1253 1254 基础控制命令可以通过接口`sendControlCommand()`发送。本示例中，从媒体控制方到媒体提供方的基础控制命令主要包括`play, pause, playPrevious, playNext` 1255 1256 * 获取自定义会话数据 1257 1258 媒体控制方可以使用接口`sendCommonCommand()`发送自定义控制命令，当媒体会话提供方接收到命令后，会通过接口`dispatchSessionEvent()`与接口`setExtras()`将歌词信息发送给媒体会话控制方。（此部分请参见媒体会话提供方Sample） 1259 1260 * 获取当前会话信息 1261 通过接口`getAVQueueItems()`获取当前歌曲列表信息； 1262 通过接口`getAVQueueTitle()`获取当前歌曲列表名称信息； 1263 通过接口`getAVPlaybackState()`获取当前歌曲播放状态信息； 1264 通过接口`getAVMetadata()`获取当前歌曲媒体会话元数据信息； 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/SystemFeature/Media/AVSession/MediaController) 1273 1274#### 媒体会话——提供方 1275 1276##### 介绍 1277 1278本示例主要展示了媒体会话（媒体提供方）的相关功能，使用[@ohos.multimedia.avsession](reference/apis-avsession-kit/js-apis-avsession.md)等接口实现媒体提供方与媒体控制方自定义信息的交互功能。 1279 1280##### 使用 1281 12821. 打开媒体提供方示例应用。 12832. 点击播放按钮，应用的播放状态发生变化，歌词开始更新。 12843. 点击暂停按钮，应用的播放状态开始变化，歌词停止更新。 12854. 点击上一首按钮，应用界面展示播放列表中的上一首歌曲的信息。 12865. 点击下一首按钮，应用界面展示播放列表中的下一首歌曲的信息。 1287 1288##### 基本原理 1289 1290* 界面相关的实现都封装在pages/Index.ets下 1291 * 使用`@StorageLink`来设置与逻辑代码同步更新的变量，当逻辑代码中对应的变量更新时，界面会同步的刷新。 1292 1293 * 通过引入逻辑代码对应的类，创建出对象，实现对onClick事件的响应 1294 1295* 逻辑相关的实现都封装在feature/ProviderFeature.ets下 1296 1297 应用的初始化相关操作 1298 1299 * 链接变量 1300 1301 通过`AppStorage.SetAndLink()`将逻辑代码中的变量与界面代码中使用`@StorageLink`声明的变量连接起来，通过`set()`与`get()`操作来修改或获取变量的值 1302 1303 * 创建并设置媒体会话 1304 1305 通过接口`createAVSession()`创建媒体会话； 1306 通过接口`activate()`激活媒体会话； 1307 通过接口`setAVQueueItems()`设置播放列表，设置后媒体控制方可以读取使用该信息； 1308 通过接口`setAVQueueTitle()`设置播放列表标题，设置后媒体控制方可以读取使用该信息； 1309 通过接口`setAVMetadata()`设置当前媒体的元数据，设置后媒体控制方可以读取使用此信息； 1310 通过接口`on()`开启对媒体控制方控制命令的监听，对媒体控制方的命令进行处理； 1311 1312 应用在运行中相关的操作 1313 1314 * 切换歌曲 1315 1316 在切换歌曲时，除了需要设置媒体提供方自身的状态，还需要使用接口`setAVPlaybackState()`与接口`setAVMetadata()`将当前播放状态与元数据同步给媒体控制方。 1317 1318 * 发送自定义数据包 1319 1320 媒体提供方可以使用接口`dispatchSessionEvent()`与接口`setExtras()`来发送自定义数据包。 1321 1322##### 约束与限制 1323 1324开发语言：ArkTS 1325 1326配套版本：API10版本SDK，版本号：4.0.9.6 1327 1328[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AVSession/MediaProvider) 1329 1330#### 音频管理 1331 1332##### 介绍 1333 1334本示例主要展示了音频的相关功能，使用[@ohos.multimedia.audio](reference/apis-audio-kit/js-apis-audio.md)等接口实现音频的发声设备的切换与查询、音频焦点、音效的查询与设置以及音频录制等功能。 1335 1336##### 使用 1337 1338注意：6，7，8是连续的串行操作，不是并行的 1339 13401. 弹出麦克风权限访问提示框，点击“允许” 13412. 在主界面点击“发声设备查询与选择”按钮，进入发声设备查询与选择页面 13423. 在发声设备查询与选择页面界面，展示当前发声设备类型名称 13434. 在发声设备查询与选择页面界面，当设备存在“插入耳机”、“拔掉耳机”、“连接蓝牙”、“断开蓝牙”等操作行为时，当前发声设备类型名称会随之切换 13445. 在发声设备查询与选择页面界面，点击“返回”按钮，回到主页 13456. 在主界面点击“音频焦点”按钮，进入音频焦点页面 13467. 在音频焦点页面，点击音乐播放器，音乐开始播放 13478. 在音频焦点页面，点击铃声播放器，铃声开始播放，同时音乐被暂停 13489. 在音频焦点页面，点击铃声播放器，停止铃声播放，音乐恢复播放 134910. 在音频焦点页面，点击“返回”按钮，回到主页 135011. 在主界面点击“音效管理”按钮，进入预置音效查询页面 135112. 在预置音效查询页面，选择内容类型和场景后，点击“查询”按钮，预置音效模式会显示在下方查询结果中 135213. 在预置音效查询页面，重新修改内容类型和场景，查询结果会重置 135314. 在预置音效查询页面，点击右下方”实时音效设置“按钮，进入实时音效设置页面 135415. 在实时音效设置页面，选择内容类型和场景后，点击播放按钮，音频流开始播放，同时内容类型和场景选择框被置灰 135516. 在实时音效设置页面，点击”查询“按钮，当前音频流音效模式会显示在下方的查询结果中 135617. 在实时音效设置页面，点击暂停按钮，音频流暂停，内容类型和场景选择框使能 135718. 在实时音效设置页面，修改内容类型与场景选择，查询结果被重置 135819. 在实时音效设置页面，再次点击播放按钮，音频流开始播放，点击”查询“按钮，结果显示在查询结果内 135920. 在实时音效设置页面，在”音频流音效模式设置“选择框中选择另一种与上次查询结果不同的音效模式，可以听到音频流出现变化 136021. 在实时音效设置页面，再次点击”查询“按钮，查询结果与上一步设置的模式相同 136122. 在实时音效设置页面，点击左上方返回图标，回到主页 136223. 在实时音效设置页面，点击左下方”预置音效查询“按钮，回到预置音效查询页面 136324. 在主界面点击“音频录制”，进入音频录制界面，音频录制界面默认是普通录制界面 136425. 在普通录制界面，点击录制按钮，开始录制，录音时间开始计时，5s内不允许结束 136526. 在普通录制界面，点击暂停按钮，暂停录制，录音时间也停止计时 136627. 在普通录制界面，点击继续按钮，继续录制，录音时间继续计时 136728. 在普通录制界面，点击停止录制按钮，停止录制，也可以不停止录制，应用设置了30s的超时后，自动停止录制 136829. 停止录制后，会生成录制结果，界面上有一个录制成功的音频播放器，点击播放可听到录制的音频 136930. 点击并行录制按钮，可切换到并行录制界面 137031. 在并行录制界面中，点击音乐播放器，播放音乐 137132. 在并行录制界面中，点击录制按钮，开始录制，同时开启麦克风录制和屏幕录制，5s内不允许结束 137233. 在并行录制界面中，点击停止录制按钮，停止录制，或者超时30s会自动停止录制，停止后按钮点成不可点击状态 137334. 在并行录制界面中，录制停止后，会生成两个音频播放器，一个是麦克风的录音结果，一个是屏幕录制的结果，点击进行播放，暂停，播放结束自动停止 137435. 点击返回按钮回到主页 1375 1376##### 基本原理 1377 1378* 发声设备查询与切换功能都封装在PreferOutputDevice。 1379* 音频焦点功能都封装Focus。 1380* 预置音效查询功能都封装在PresetEffect。 1381* 音频录制-普通录制功能都封装在NormalCapturer。 1382* 音频录制-并行录制功能都封装在ParallelCapturer。 1383 1384##### 约束与限制 1385 1386开发语言：ArkTS 1387 1388配套版本：API10版本SDK，版本号：4.0.9.6 1389 1390[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Audio) 1391 1392#### 拼图 1393 1394##### 介绍 1395 1396该示例通过[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md)和[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md)接口实现获取图片，以及图片裁剪分割的功能。 1397 1398##### 使用 1399 14001. 使用预置相机拍照后启动应用，应用首页会读取设备内的图片文件并展示获取到的第一个图片，没有图片时图片位置显示空白； 14012. 点击Start开始后，时间开始倒计时，在规定时间内未完成拼图则游戏结束。在游戏中，玩家点击Restart进行游戏重置； 14023. 点击开始游戏后，玩家可以根据上方的大图，点击灰格周围的图片移动，点击后图片和灰格交换位置,最终拼成完整的图片； 14034. 不在游戏中时，玩家可以点击上方大图，选择自定义图片来进行拼图游戏。 1404 1405##### 基本原理 1406 1407+ 游戏中图片裁剪分割的效果实现在ImageModel中: 1408 + 获取本地图片：首先使用getMediaLibrary获取媒体库实例，然后使用getFileAssets方法获取文件资源，最后使用getAllObject获取检索结果中的所有文件资产方便展示； 1409 + 裁剪图片准备：裁剪图片需要使用[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md)接口，裁剪前需要申请图片编辑权限，使用[requestPermissionsFromUser](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md#requestpermissionsfromuser9)申请; 1410 + 图片编辑：首先使用createImagePacker创建ImagePacker实例，然后使用fileAsset.open打开文件，调用createImageSource接口创建图片源实例方便操作图片，接下来使用getImageInfo方法获取图片大小便于分割，最后使用createPixelMap方法传入每一份的尺寸参数完成图片裁剪。 1411 1412##### 约束与限制 1413 1414开发语言：ArkTS 1415 1416配套版本：API10版本SDK，版本号：4.0.10.18 1417 1418[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/GamePuzzle) 1419 1420#### 图片编辑 1421 1422##### 介绍 1423 1424本示例使用 [TextArea](reference/apis-arkui/arkui-ts/ts-basic-components-textarea.md) 实现多文本输入，使用 [@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md) 依赖系统的图库引用，实现在相册中获取图片，使用 [@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md) 生成pixelMap，使用pixelMap的scale()，crop()，rotate()接口实现对图片的缩放，裁剪，旋转功能。 使用[@ohos.effectKit](reference/apis-arkgraphics2d/js-apis-effectKit.md) 生成effectKit,使用effectKit.getHighestSaturationColor() 接口实现对图片的高亮调节。添加文字/贴纸，利用组件的组合编辑素材大小和位置，再使用OffscreenCanvasRenderingContext2D进行离屏绘制保存。 1425 1426##### 使用 1427 14281. 发表评价页面点击添加图片/照片，页面跳转到图片选择页面； 14292. 进入图片选择页面后，选择需要显示的图片； 14303. 选中图片后，页面会跳转到发表评价页面，点击图片跳转到图片编辑删除页面，点击编辑进入到编辑功能页； 14314. 调整菜单有裁剪、缩放、旋转、调色功能； 14325. 标记菜单有添加文字、添加贴纸功能； 14336. 编辑完成后，点击撤回按钮图片会还原到上一个编辑状态； 14347. 图片编辑完成后，点击保存，页面会跳转到发表评价页面，显示相关照片； 14358. 点击返回按钮，退出应用。 1436 1437##### 基本原理 1438 1439+ 图片选择功能在GetPictures中实现: 1440 + 图片选择：首先使用startAbilityForResult()启动系统图库应用，然后将选择的图片用select数组保存路径，展示到页面便于选择，选择完跳转到首页，点击一张图片，进入到编辑删除界面。 1441+ 图片编辑功能在EditImage中实现: 1442 + 图片编辑：图片编辑权限需要使用[requestPermissionsFromUser](reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md) 1443 申请 1444 ，首先根据选择图片获取到的uri打开图片文件，fileAsset.open选择‘rw'读写模式，然后使用image.createImageSource创建图片源实例，接下来使用createPixelMap创建PixelMap对象，便于处理图片，最后使用crop对图像进行裁剪处理，使用scale对图像进行缩放处理，rotate进行旋转处理。亮度调节使用effectKit.getHighestSaturationColor() 1445 接口实现对图片的高亮调节。添加文字/贴纸，编辑模式下，使用组件组合（Image、Shape、Text）进行交互完成素材大小和位置选择；编辑确认后，再使用OffscreenCanvasRenderingContext2D进行离屏绘制，保存为新的pixelMap。 1446 1447##### 约束与限制 1448 1449开发语言：ArkTS 1450 1451配套版本：API10版本SDK，版本号：4.0.9.6 1452 1453[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Image) 1454 1455#### 图片显示 1456 1457##### 介绍 1458 1459本示例使用 [TextArea](reference/apis-arkui/arkui-ts/ts-basic-components-textarea.md) 组件实现多文本输入，使用 [mediaLibrary](reference/apis-arkui/js-apis-mediaquery.md) 实现从相册选择图片展示在商品评价页面。 1460 1461##### 使用 1462 14631.点击添加图片/照片，页面跳转到图片选择页面。 1464 14652.进入图片选择页面后，选择需要显示的图片，选择的图片数量会显示在右上方，选择的图片会显示在下方。最多选择6张图片。 1466 14673.选定图片后点击下一步，页面会跳转回主页面，图片显示在主页。若不确定选择，点击添加图片/照片进行重新选择。 1468 14694.图片选择后，点击文本输入框，可以对商品进行评价。 1470 14715.点击返回按钮，退出应用。 1472 1473##### 基本原理 1474 1475* 本示例分为三个模块： 1476 * 发表评价页面模块： 1477 * 使用scroll，TextArea，Grid等组件开发发表评价页面 1478 * 参考接口：[@ohos.router](reference/apis-arkui/js-apis-router.md) 1479 1480 * 选择图片/照片模块 1481 * 调用依赖中ChoicePhotos方法打开相册，mediaquery媒体查询相册，getMediaLibrary获取媒体库的实例，访问用户等个人媒体数据信息并选中图片 1482 * 参考接口：[@ohos.router](reference/apis-arkui/js-apis-router.md)，[@ohos.promptAction](reference/apis-arkui/js-apis-promptAction.md)，[@ohos.mediaquery](reference/apis-arkui/js-apis-system-mediaquery.md)，[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md)，[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md) 1483 1484 * 提交模块 1485 * 选中图片后点击下一步按钮，回到发表评价页面，点击提交按钮进行提交 1486 * 参考接口：[@ohos.router](reference/apis-arkui/js-apis-router.md) 1487 1488##### 约束与限制 1489 1490开发语言：ArkTS 1491 1492配套版本：API9版本SDK，版本号：3.2.11.9 1493 1494[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/ImageShow) 1495 1496#### 二维码扫描 1497 1498##### 介绍 1499 1500本示例使用[相册管理](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md)、[相机管理](reference/apis-camera-kit/js-apis-camera.md)、[图片处理](reference/apis-image-kit/js-apis-image.md)、[文件管理](reference/apis-core-file-kit/js-apis-fileio.md)展示二维码扫描功能，包括相机扫描解析二维码和从相册中选择二维码图片解析。 1501 1502##### 使用 1503 15041. 启动应用，授予权限。 15052. 自动识别二维码图片。 15063. 点击右上角图片图标，在相册中选择对应的二维码图片，会返回首页展示结果。 1507 1508##### 基本原理 1509 1510+ 相机功能在CameraServices中 1511 + 获取相机实例：首先使用getCameraManager方法获取相机管理器，然后使用getSupportedCameras方法得到设备列表； 1512 + 打开相机：使用createCameraInput方法创建CameraInput实例，调用open方法打开相机； 1513 + 获取相机输出流：使用getSupportedOutputCapability查询相机设备在模式下支持的输出能力，然后使用createPreviewOutput创建相机输出流，使用[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md#getreceivingsurfaceid9)接口的createPhotoOutput方法创建相片输出流； 1514 + 获取相片输出：首先使用createCaptureSession方法创建**捕获会话**的实例，然后使用beginConfig方法配置会话，接下来使用addInput方法添加一个摄像头输入流，使用addOutput添加一个摄像头和相机照片的输出流，使用commitConfig方法提交会话配置后，调用start方法开始捕获相片输出。 1515+ 二维码解析功能在QRCodeParser中 1516 + 拍照获取图片：使用( 1517 cameraService.imageReceiver.on)[reference/apis-image-kit/js-apis-image.md#on9]接收图片时注册回调，然后调用readNextImage获取处理图片的操作，然后使用getComponent方法根据图像的组件类型从图像中获取组件缓存，然后将获取到的ArrayBuffer写入指定文件中，返回文件uri，然后通过[ImageBitmap](reference/apis-arkui/arkui-ts/ts-components-canvas-imagebitmap.md)将uri转化为ImageBitMap格式，具体文件写入方式参考[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md)。 1518 + 打开相册选取图片：首先需要使用[startAbilityForResult](reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartabilityforresult)启动相册，将选到的图片通过ImageBitmap转化为ImageBitmap格式。 1519 + 图片解析：使用[CanvasRenderingContext2D](reference/apis-arkui/arkui-ts/ts-canvasrenderingcontext2d.md)的getImageData方法创建ImageData对象将相册中获取到的图片转化为util8格式的图片，然后调用jsQR库解析图片中的二维码。 1520 1521##### 约束与限制 1522 1523开发语言：ArkTS 1524 1525配套版本：API9版本SDK，版本号：3.2.11.9 1526 1527[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/QRCodeScan) 1528 1529#### 录音机 1530 1531##### 介绍 1532 1533本示例使用[audio](reference/apis-audio-kit/js-apis-audio.md)相关接口实现音频录制和播放的功能，使用[@ohos.filemanagement.userFileManager](reference/apis-core-file-kit/js-apis-userFileManager-sys.md)实现音频文件的管理。 1534 1535##### 使用 1536 15371.启动应用，点击首页底部**录制**按钮跳转到录制界面开始录制音频，录制过程中可以点击右下角的**暂停**按钮暂停录制，点击顶部**返回键**或红色的**停止**按钮停止录音并返回首页，首页中展示录制好的音频文件。 1538 15392.点击**音频文件**可以播放该文件，播放界面可以点击按钮进行暂停和继续播放。 1540 15413.长按音频文件进入多选状态，可以选择音频文件，选择后可以点击底部的按钮进行重命名和删除操作。 1542 15434.左滑音频文件，可以滑出重命名和删除按钮，点击可以对该音频文件进行重命名和删除操作。 1544 1545##### 基本原理 1546 1547* 本示例分为三个模块： 1548 * 录音页面模块 1549 * 使用FileAsset提供封装文件属性的方法，createAudioPlayer同步方式创建音频播放实例实现录音，暂停录音功能 1550 * 参考接口：[audio](reference/apis-audio-kit/js-apis-audio.md)，[@ohos.router](reference/apis-arkui/js-apis-router.md)，[@ohos.filemanagement.userFileManager](reference/apis-core-file-kit/js-apis-userFileManager-sys.md)，[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)，[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md)，[@ohos.window](reference/apis-arkui/js-apis-window.md)，[@ohos.promptAction](reference/apis-arkui/js-apis-promptAction.md)，[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md) 1551 1552 * 录音列表模块 1553 * getMediaLibraryAPI访问媒体数据信息，renameCallBack，renameDialogController方法对录音进行重命名，deleteFile，deleteDialogShow方法删除某条录音。 1554 * 参考接口：[@ohos.router](reference/apis-arkui/js-apis-router.md)，[@ohos.filemanagement.userFileManager](reference/apis-core-file-kit/js-apis-userFileManager-sys.md)，[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)，[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md)，[@ohos.window](reference/apis-arkui/js-apis-window.md)，[@ohos.promptAction](reference/apis-arkui/js-apis-promptAction.md)，[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md) 1555 1556 * 播放模块 1557 * createAudioPlayer方法创建音频播放实例，onPageShow方法播放音频，onPageHide方法暂停播放音频。 1558 * 参考接口：[@ohos.router](reference/apis-arkui/js-apis-router.md)，[@ohos.filemanagement.userFileManager](reference/apis-core-file-kit/js-apis-userFileManager-sys.md)，[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)，[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md) 1559 1560##### 约束与限制 1561 1562开发语言：ArkTS 1563 1564配套版本：API11版本SDK，版本号：4.1.5.1 1565 1566[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/Recorder) 1567 1568#### 视频播放 1569 1570##### 介绍 1571 1572视频播放的主要工作是将视频数据转码并输出到设备进行播放，同时管理播放任务。本文将对视频播放全流程、视频切换、视频循环播放等场景开发进行介绍说明。 本示例主要展示了播放本地视频和网络视频相关功能,使用 [@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md#bufferinginfotype8),[@ohos.resourceManager](reference/apis-localization-kit/js-apis-resource-manager.md),[@ohos.wifiManager](reference/apis-connectivity-kit/js-apis-wifiManager.md)等接口,实现了视频播放、暂停、调节倍速、切换视频的功能。 1573 1574##### 使用 1575 15761.点击视频界面，唤起视频操作面板，再次点击操作面板消失，如果不做任何操作操作界面会5s自动消失; 1577 15782.点击暂停/播放按钮，控制视频暂停播放; 1579 15803.滑动视频进度条，视频跳转到指定位置,在视频中间会出现时间进度方便用户查看视频进度; 1581 15824.点击倍速，可以选择1.0、1.25、1.75、2.0进行倍速调节; 1583 15845.点击下方视频名称，可以选择视频进行切换。注意：network是网络视频，检测到没有连接网络会退出应用，有网络能在本地视频和网络视频进行切换; 1585 15866.点击左上角退出箭头，退出应用。 1587 1588##### 基本原理 1589 1590+ 视频倍速切换、暂停、播放、切换视频、视频跳转的功能接口都封装在AvPlayManager.ts; 1591+ 使用media.createAVPlayer()来获取AVPlayer对象; 1592+ 倍速切换：选择不同的倍速时调用avPlayer.setSpeed(speed: PlaybackSpeed); 1593+ 暂停、播放：点击暂停、播放时调用avPlayer.pause()、avPlayer.play(); 1594+ 切换视频：在切换视频前要先调用avPlayer.reset()重置资源，再通过avPlayer.fdSrc为fdSrc赋值触发initialized状态机上报; 1595+ 视频跳转：在拖动滑动条时调用avPlayer.seek() 1596 1597##### 约束与限制 1598 1599开发语言：ArkTS 1600 1601配套版本：API9版本SDK，版本号：3.2.11.10 1602 1603[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/VideoPlay) 1604 1605#### 媒体库视频 1606 1607##### 介绍 1608 1609本示例使用[Video组件](reference/apis-arkui/arkui-ts/ts-media-components-video.md)展示了视频组件的基本功能，包括视频组件化，全屏化，窗口化，上下轮播视频等。 1610 1611##### 使用 1612 16131. 进入首页点击播放按键； 16142. 点击视频播放按钮，视频开始播放,再次点击视频进入视频全屏页； 16153. 首页下滑500vp后，视频小窗口化； 16164. 点击直播按钮进入直播页，上下滑动视频。 1617 1618##### 基本原理 1619 1620 + 视频播放：start方法视频开始播放； 1621 + 全屏播放：再次点击视频进入全屏播放页面，使用setCurrentTime参数设定当前播放时间，pause方法停止播放; 1622 + 小窗口播放：记录当前播放时间，小窗口页面渲染之前设置视频当前播放时间，页面滚动到固定距离开始展示组件； 1623 + 直播：使用[http](reference/apis-network-kit/js-apis-http.md)接口的request方法获取直播数据; 1624 1625##### 约束与限制 1626 1627开发语言：ArkTS 1628 1629配套版本：API9版本SDK，版本号：3.2.11.9 1630 1631[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/VideoShow) 1632 1633#### 音频通话示例 1634 1635##### 介绍 1636 1637本示例主要展示了音频通话相关的功能，使用[@ohos.multimedia.audio](reference/apis-audio-kit/js-apis-audio.md) 、[@ohos.net.socket](reference/apis-network-kit/js-apis-socket.md) 等接口，实现音频录制和渲染，音频数据网络传输等功能。 1638 1639##### 使用 1640 16411.语音通话需要运行服务端代码模拟启动流媒体服务端，连接成功后服务端会在终端打印client连接数： 1642 16432.服务端和两台设备在局域网内组成socket网络，运行时需要注意修改ip地址： 1644 1645- 服务端地址在socket.js 1646- 客户端地址在BufferModel.ets，将serverIp替换为服务端IP地址即可 1647 16483.仅体验语音通话功能时，可以两台设备都手动启动语音通话应用，分别点击接听按钮进入通话页面 1649 16504.体验场景所有功能时，需要两台设备启动[聊天应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Connectivity/StageSocket),通过左下方语音按钮发起语音通话 1651 16525.一方发起语音通话请求，对方选择同意或拒绝 1653 16546.对方同意后，进行通话 1655 16567.通话页或请求通话页可以选择关闭麦克风或扬声器 1657 16588.对方拒接或同意后挂断，则返回聊天页面 1659 1660##### 基本原理 1661 1662+ TCP socket模拟音频流网络传输： 1663 1664 + 使用@ohos.net.socket 的constructTCPSocketInstance创建TCP socket连接，模拟实现音频流网络传输 1665 + 3s一次检查网络状态和尝试连接，实现网络异常时的处理逻辑 1666+ 音频录制： 1667 + 使用@ohos.multimedia.audio.AudioCapturer完成音频采集 [具体使用参考](media/audio/using-audiocapturer-for-recording.md) 1668+ 音频播放： 1669 + 使用@ohos.multimedia.audio.AudioRenderer完成音频播放 [具体使用参考](media/audio/using-audiorenderer-for-playback.md) 1670+ 麦克风与扬声器以及通话场景控制： 1671 + 使用@ohos.multimedia.audio.AudioManager的setAudioScene接口切换通话场景 1672 + 使用@ohos.multimedia.audio.AudioVolumeGroupManager的setMicrophoneMute接口切换麦克风 1673 + 使用@ohos.multimedia.audio.AudioRoutingManager的setCommunicationDevice接口切换扬声器 1674 1675##### 约束与限制 1676 1677开发语言：ArkTS 1678 1679配套版本：API9版本SDK，版本号：3.2.11.10 1680 1681[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/VoiceCallDemo) 1682 1683#### 相机示例 1684 1685##### 介绍 1686 1687本示例主要展示了相机的相关功能，利用相关接口实现了相机的预览、拍照、录像、前后置摄像头切换进行拍照、录像，以及闪光灯、变焦、对焦、曝光等控制类功能。 1688 1689##### 使用 1690 1691(因RK3568设备硬件能力，现仅支持验证1、2、3、9、10、13) 1692 16931. 弹出是否允许应用使用相机？点击“允许”。弹出是否允许应用使用麦克风？点击“允许”。弹出是否允许应用访问文件？点击“允许”。 1694 16952. 进入预览界面，预览正常，滑动变焦按钮，同一画面远近变焦效果明显。 1696 16973. 进入预览界面，预览正常，点击画面模糊处，点击处画面会变得清晰，对焦效果明显。 1698 16994. 进入预览界面，预览正常，上下滑动屏幕，屏幕场景亮度发生变化，曝光效果明显。 1700 17015. 进入预览界面，预览正常，点击闪光灯按钮，打开闪光灯，闪光灯正常打开。 1702 17036. 进入预览界面，预览正常，点击闪光灯按钮，关闭闪光灯，闪光灯关闭。 1704 17057. 进入预览界面，预览正常，进入拍照模式，点击拍照按钮，拍照正常。点击左下角生成的缩略图能够跳转到图库，打开图片显示正常。 1706 17078. 进入预览界面，预览正常，切换到录像模式，点击开始录像，再点击停止录像按钮，录像成功。点击左下角生成的缩略图能够跳转到图库，播放录像文件正常。 1708 17099. 进入预览界面，预览正常，切换到前置摄像头，点击拍照按钮，拍照正常。点击左下角生成的照片缩略图能够跳转到图库，打开图片显示正常。 1710 171110. 进入预览界面，预览正常，切换到前置摄像头，切换到录像模式，点击开始录像，再点击停止录像按钮，录像成功。点击左下角生成的缩略图能够跳转到图库，播放录像文件正常。 1712 171311. 点击设置按钮，会弹出设置页面，仅验证UI。 1714 1715##### 基本原理 1716 1717 * 拍照功能相关接口封装在StartPhoto接口中，主要包含以下流程： 1718 * 调用SessionStop关闭session。 1719 * 调用SessionBegin做session的一个预置动作。 1720 * 调用CreatePhotoOutput创建相机输出。 1721 * 调用OH_CaptureSession_AddPhotoOutput将hotoOutput添加至session中。 1722 * 调用SessionCommitConfig提交session。然后调用SessionStart开启session。 1723 * 调用调用TakePicture接口开启拍照动作。 1724 1725 * 录像功能相关接口封装在StartVideo接口中，主要包含以下流程： 1726 * 调用SessionStop关闭session。 1727 * 调用SessionBegin做session的一个预置动作。 1728 * 调用OH_CaptureSession_RemovePhotoOutput移除相机拍照输出。 1729 * 调用CreatePhotoOutput创建相机输出。 1730 * 调用AddPhotoOutput将相机输出添加至session中。然后CreateVideoOutput创建录像输出。 1731 * 调用AddVideoOutput将录像输出添加至session中。然后SessionCommitConfig、SessionStart对session进行提交和开启。 1732 * 调用VideoOutputRegisterCallback对VideoOutput注册回调。 1733 1734 * 变焦功能相关接口封装在setZoomRatioFn接口中，主要包含以下流程： 1735 * 调用OH_CaptureSession_GetZoomRatioRange获取支持的变焦范围。 1736 * 调用OH_CaptureSession_SetZoomRatio设置变焦。 1737 * 调用OH_CaptureSession_GetZoomRatio获取当前设备的变焦值。 1738 1739##### 约束与限制 1740 1741开发语言：ArkTS 1742 1743配套版本：API10版本SDK，版本号：4.0.10.15 1744 1745[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Camera) 1746 1747#### 音振协同 1748 1749##### 介绍 1750 1751本示例主要展示了音频播放和振动效果相互协同的能力，使用[@ohos.multimedia.audioHaptic](reference/apis-audio-kit/js-apis-audioHaptic.md)等接口完成播放音频同时伴随振动的功能，可用于同时需要声音与振动的场景。 1752 1753##### 使用 1754 1755注意：当选择任意一种类型开始播放时，其它按钮均不可点击 1756 17571. 在主界面点击“音振协同”按钮，进入音振协同播放类型选择页面。 1758 17592. 在音振协同播放类型选择页面，展示音振协同播放类型。 1760 17613. 在音振协同播放类型选择页面，点击通知类型播放器，通知类型开始播放并振动。 1762 17634. 在音振协同播放类型选择页面，点击铃声类型播放器，铃声类型开始播放并振动。 1764 17655. 在音振协同播放类型选择页面，点击闹钟类型播放器，闹钟类型开始播放并振动。 1766 17676. 在音振协同播放类型选择页面，点击“音频静音”（未点击振动静音），选择铃声类型播放器进行播放，铃声类型开始音频静音同时振动播放，直至播放自动结束，恢复暂停状态。 1768 17697. 在音振协同播放类型选择页面，点击“振动静音”（未点击音频静音），选择铃声类型播放器进行播放，铃声类型开始无振动同时有声播放，直至播放自动结束，恢复暂停状态。 1770 17718. 在音振协同播放类型选择页面，点击“振动静音”，点击“音频静音”，选择铃声类型播放器进行播放，铃声类型开始无振动同时无声播放，直至播放自动结束，恢复暂停状态。 1772 17739. 振协同播放选择页面，点击“返回”按钮，可返回主页。 1774 1775##### 基本原理 1776 1777* 音振协同功能的具体实现： 1778 * 使用audioHaptic.getAudioHapticManager()接口获取音振管理器。 1779 * 使用audioHapticManager.registerSource(audioUri, hapticUri)接口注册音频和振动资源的Uri，返回注册资源的source id。 1780 * 使用使用audioHapticManager.setStreamUsage()接口给指定source id设置音频使用类型。 1781 * 使用audioHapticManager.createPlayer(id, options)创建不同类型资源的音振播放器。 1782 * 使用audioHapticManager.setStreamUsage(id, streamUsage)分别设置通知类型、铃声类型和闹钟类型的使用类型。 1783 * 对每个player对象都监听AudioHapticPlayer.on('endOfStream'),收到回调时,说明当前类型资源播放结束，恢复暂停播放状态，据此更新UI状态。 1784 * 使用audioHapticManager.start()方法进行对指定类型音频开始播放处理。 1785 * 使用audioHapticManager.stop()进行指定类型音频的停止播放处理。 1786 1787##### 约束与限制 1788 1789开发语言：ArkTS 1790 1791配套版本：API11版本SDK，版本号：4.1.6.5 1792 1793[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AudioHaptic) 1794 1795#### 视频播放 1796 1797##### 介绍 1798 1799本示例主要展示了网络视频播放的相关功能。使用[@ohos.multimedia.avsession](reference/apis-avsession-kit/js-apis-avsession.md)等接口实现视频播放的功能。 1800 1801##### 使用 1802 18031. 点击播放按钮，视频开始播放。 1804 18052. 点击暂停按钮，视频暂停播放。 1806 18073. 点击上一个按钮，界面展示播放列表中的上一个视频的信息。 1808 18094. 点击下一下按钮，界面展示播放列表中的下一个视频的信息。 1810 1811##### 基本原理 1812 1813* 界面相关的实现都封装在pages/Index.ets下： 1814 * 使用`@State`来设置与逻辑代码同步更新的变量，当逻辑代码中对应的变量更新时，界面会同步的刷新。 1815 1816 * 通过引入逻辑代码对应的类，创建出对象，实现对onClick事件的响应，关键代码段： 1817 ```js 1818 1819 import media from '@ohos.multimedia.media'; // 引入 1820 1821 this.avPlayer = await media.createAVPlayer(); // 创建对象 1822 1823 this.controller = await this.session.getController(); // 通过类的对象来调用逻辑代码 1824 1825 ``` 1826 1827* 逻辑相关的实现都封装在common/MediaController.ets下： 1828 1829 应用的初始化相关操作 1830 1831 * 链接变量 1832 1833 使用`@State`来设置与逻辑代码同步更新，关键代码段： 1834 1835 ```ets 1836 @State session: avSession.AVSession = null; 1837 @State controller: avSession.AVSessionController = null; 1838 private avPlayer: media.AVPlayer; 1839 @State @Watch('playInfoUpdated') currentPlayInfo: avSession.AVMediaDescription = undefined; 1840 this.currentPlayInfo = temp; 1841 this.avPlayer = await this.audioUtils.init(); 1842 ``` 1843 1844 * 获取当前设备中会话并创建Controller 1845 1846 通过接口`audioUtils.init()`获取当前设备中的媒体会话； 1847 1848 通过接口`session.getController()`创建媒体会话对应的控制器； 1849 1850 通过接口`on(play | pause | stop | playNext | playPrevious | seek)`开启对远程以及播控中心提供方发送事件的监听，对事件进行处理； 1851 1852 应用在运行中相关的操作 1853 1854 * 从远程以及播控中心获取基础控制命令 1855 1856 基础控制命令可以通过监听事件`setListenerForMesFromController()`。本示例中，从媒体控制方到媒体提供方的基础控制命令主要包括`play, pause, playPrevious, playNext`。发送命令的参考代码如下： 1857 ```ets 1858 let command : AVSessionManager.AVControlCommand = { 1859 command : 'play', 1860 parameter : undefined 1861 } // 构造AVControlCommand参数 1862 async setListenerForMesFromController(); // 媒体会话控制器与媒体会话一一对应 1863 ``` 1864 1865 * 获取自定义会话数据（以获取视频为例） 1866 1867 > 说明： 1868 > 1869 > 本示例中，用户点击“下一个视频”的命令，会在将视频信息更新。 1870 1871 视频使用接口`switchToNextByLoopMode()`更新视频信息，示例代码如下： 1872 ```ets 1873 this.currentIndex = this.currentIndex === this.songList.length - 1 ? 0 : this.currentIndex + 1; 1874 this.updateCurrentPlayInfo(this.songList[this.currentIndex], this.audioType); 1875 ``` 1876 1877##### 约束与限制 1878 1879开发语言：ArkTS 1880 1881配套版本：API11版本SDK，版本号：4.1.6.5 1882 1883[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/AVSession/VideoPlayer) 1884 1885### Native 1886 1887#### 获取Rawfile资源 1888 1889##### 介绍 1890 1891本示例中主要介绍开发者如何使用Native Rawfile接口操作Rawfile目录和文件。功能包括文件列表遍历、文件打开、搜索、读取和关闭Rawfile。 1892 1893##### 使用 1894 1895应用界面中展示了Rawfile相关的接口调用，包括获取resources/rawfile目录下的文件及目录结构、对应的rawfile文件内容、对应rawfile文件的descriptor。其中使用到的功能包括文件列表遍历、文件打开、搜索、读取和关闭Rawfile。 1896 1897##### 基本原理 1898 1899通过在IDE中创建Native c++ 工程，在c++代码中定义对外接口为getFileList、getRawFileContent、getRawFileDescriptor，映射C++接口分别为GetFileList、GetRawFileContent、GetRawFileDescriptor。 1900通过获取Js的资源对象，并转为Native的资源对象，即可调用资源的Native接口，获取rawfile列表、rawfile文件内容以及rawfile描述符{fd, offset, length}。 1901在Js侧导入"libentry.so"，通过getContext().resourceManager获取资源管理对象。调用src/main/cpp/types/libentry/index.d.ts中声明的接口，传入js的资源对象和相关参数获取对于rawfile相关资源信息。 1902 1903##### 约束与限制 1904 1905开发语言：ArkTS 1906 1907配套版本：API10版本SDK，版本号：4.0.10.5 1908 1909[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkRawfile) 1910 1911#### Native XComponent 1912 1913##### 介绍 1914 1915本示例中主要介绍开发者如何使用Native XComponent接口来获取NativeWindow实例、获取布局/事件信息、注册事件回调并通过OpenGL/EGL实现在页面上绘制形状。功能主要包括点击按钮绘制一个五角星，并可以通过点击XComponent区域改变五角星的颜色。 1916 1917##### 使用 1918 19191. 安装编译生成的hap包，并打开应用。 1920 19212. 点击页面底部“Draw Star”按钮，页面将绘制一个五角星。 1922 19233. 点击XComponent组件区域（页面中灰色区域）改变五角星颜色。 1924 1925##### 基本原理 1926 1927通过在IDE中创建Native c++ 工程，在c++代码中定义对外接口为drawPattern，在js侧调用该接口可在页面上绘制出一个三角形。 1928 1929在XComponent的OnSurfaceCreated回调中获取NativeWindow实例并初始化EGL环境。调用OH_NativeXComponent_GetXComponentSize接口获取XComponent的宽高，并以此为输入调用EGL相关的绘制接口在NativeWindow上绘制出一个五角星。在DispatchTouchEvent回调中再次调用EGL相关的绘制接口在NativeWindow上绘制出一个大小相同、颜色不同的五角星，以达到点击后改变颜色的目的。 1930 1931##### 约束与限制 1932 1933开发语言：ArkTS 1934 1935配套版本：API10版本SDK，版本号：4.0.8.2 1936 1937[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkXComponent) 1938 1939#### OpenGL三棱椎 1940 1941##### 介绍 1942 1943本示例展示了XComponent相关控件的使用，及采用OpenGL (OpenGL ES)相关标准API绘制3D图形（三棱锥，3D渲染的光源用的是简单的线性光源）。此外，可在屏幕触摸滑动，以使三棱锥进行旋转，其中主要采用了napi接口来更新3D图形的旋转角度。 1944 1945##### 使用 1946 1947应用界面中展示了XComponent相关控件的使用，及采用OpenGL (OpenGL ES)相关标准API绘制3D图形（三棱锥，3D渲染的光源用的是简单的线性光源）。此外，可在屏幕触摸滑动，以使三棱锥进行旋转，其中主要采用了napi接口来更新3D图形的旋转角度。 1948 1949##### 基本原理 1950 1951通过在IDE中创建Native C++工程，在C++代码中定义接口为Init和Update用于3D图形绘制环境的初始化和图形渲染更新，并映射NAPI相关接口UpdateAngle。ArkTS侧主要利用XComponent控件实现Index.ets，C++侧主要采用OpenGL ES相关标准API实现三棱锥的绘制流程相关代码，并可与ArkTS进行交互。 1952 1953应用启动时，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接口更新三棱锥旋转角度。 1954 1955##### 约束与限制 1956 1957开发语言：ArkTS 1958 1959配套版本：API10版本SDK，版本号：4.0.9.6 1960 1961[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkOpenGL) 1962 1963#### 音频管理 1964 1965##### 介绍 1966 1967本示例主要展示了音频低时延录制和播放的相关功能：<br> 1968 1. [低时延录制](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/media/audio/using-ohaudio-for-recording.md)。<br> 1969 2. [低时延播放](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/media/audio/using-ohaudio-for-playback.md)。 1970 1971##### 使用 1972 19731. 弹出麦克风权限访问提示框，点击“允许”，如果点击"禁止"则不可进行录制，需要用户去设置页面给应用授权后方可正常录制。 1974 19752. 在主界面点击“录制和播放”，进入音频录制界面，音频录制界面默认是普通录制界面，打开低时延录制开关可进行低时延录制。 1976 19773. 点击录制按钮，开始录制，开始录制后低时延录制开关变为不可点击状态，录音时间开始计时，5s内不允许结束，30s后会自动结束录制。 1978 19794. 点击暂停按钮，暂停录制，录音时间也停止计时。 1980 19815. 点击继续按钮，继续录制，录音时间继续计时。 1982 19836. 停止录制后，会生成录制结果，界面上有一个低时延播放开关和录制成功的音频播放器。点击低时延播放开关可打开低时延播放功能，点击播放可听到录制的音频，播放未结束之前低时延播放开关为不可点击状态。 1984 19857. 点击返回按钮回到主页。 1986 1987##### 基本原理 1988 1989音频录制和播放使用到了OHAudio开发音频录制功能。OHAudio是OpenHarmony在API version 10中引入的一套全新Naitve API，此API在设计上实现归一，同时支持普通音频通路和低时延通路。 1990 1991相关API使用可参考以下开发文档： 1992 * [低时延录制开发指导文档](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/media/audio/using-ohaudio-for-recording.md) 1993 * [低时延播放开发指导文档](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/media/audio/using-ohaudio-for-playback.md) 1994 * [低时延录制开发示例](https://gitee.com/openharmony/multimedia_audio_framework/blob/master/frameworks/native/ohaudio/test/example/oh_audio_capturer_test.cpp) 1995 * [低时延播放开发示例](https://gitee.com/openharmony/multimedia_audio_framework/blob/master/frameworks/native/ohaudio/test/example/oh_audio_renderer_test.cpp) 1996 1997##### 约束与限制 1998 1999开发语言：ArkTS 2000 2001配套版本：API10版本SDK，版本号：4.0.10.13 2002 2003[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/Audio) 2004 2005#### Native Drawing 2006 2007##### 介绍 2008 2009本示例中主要介绍开发者在利用Native XComponent来获取NativeWindow实例、获取布局/事件信息、注册事件回调并通过Drawing API实现在页面上绘制形状。功能主要包括点击按钮绘制一个五角星和“Hello World Drawing”文字。 2010 2011##### 使用 2012 20131.安装编译生成的hap包，并打开应用。 2014 20152.点击页面底部“Draw Path”按钮，页面将绘制一个五角星。 2016 20173.点击页面底部“Draw Text”按钮，页面将绘制“Hello World Drawing”。 2018 2019##### 基本原理 2020 2021通过在IDE中创建Native c++ 工程，在c++代码中定义对外接口为drawPattern和drawText，在js侧调用该接口可在页面上绘制出一个五角星和“Hello World Drawing”文字。 2022 2023在XComponent的OnSurfaceCreated回调中获取NativeWindow实例并初始化NativeWindow环境。调用OH_NativeXComponent_GetXComponentSize接口获取XComponent的宽高，并以此为输入调用Drawing相关的绘制接口在NativeWindow上绘制出一个五角星和文字。 2024 2025##### 约束与限制 2026 2027开发语言：ArkTS 2028 2029配套版本：API10版本SDK，版本号：4.0.10.13 2030 2031[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkDrawing) 2032 2033#### Native Window 2034 2035##### 介绍 2036 2037本示例中主要介绍开发者在利用[Native XComponent](reference/apis-arkui/native__interface__xcomponent_8h.md)来获取[NativeWindow](reference/apis-arkgraphics2d/_native_window.md)实例，通过数据填充改变矩形框颜色。并提供从[NativeImage](reference/apis-arkgraphics2d/_o_h___native_image.md)中获取NativeWindow进行buffer轮转的案例，通过NativeWindow生产buffer来触发NativeImage的可用帧回调。 2038 2039##### 使用 2040 20411. 安装编译生成的hap包，并打开应用。 2042 20432. 点击页面底部“Chaneg Color”按钮，矩形框填充区域将改变颜色，黄蓝切换。 2044 20453. 点击页面底部“produce buffer”按钮，NativeWindow将生产数据并发送给NativeImage，页面展示了生产buffer的次数。 2046 20474. 点击页面底部“update available buffer count”按钮，将展示NativeImage收到的可用帧回调次数。 2048 2049##### 基本原理 2050 20511. 通过在IDE中创建Native c++ 工程，在c++代码中定义对外接口为DrawColor，在js侧调用该接口可改变窗口颜色。 20522. 从NativeImage中创建NativeWindow，在c++代码中定义对外接口为ProduceBuffer，js调用该接口后，NativeWindow会生产buffer并将该buffer flush给NativeImage。 20533. NativeImage将收到可用帧的回调，js侧调用GetAvailableCount接口，可以获取回调触发次数，并展示在界面上；正常情况下FlushBuffer的次数和可用帧回调触发次数一致。 2054 2055##### 约束与限制 2056 2057开发语言：ArkTS 2058 2059配套版本：API11版本SDK，版本号：4.1.3.3 2060 2061[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/NdkNativeWindow) 2062 2063#### XComponent3D 2064 2065##### 介绍 2066 2067基于XComponent组件调用Native API来创建EGL/GLES环境，从而使用标准OpenGL ES进行图形渲染。本项目实现了两个示例： 2068 20691. 使用OpenGL实现2D的图形绘制和动画。 2070 20712. 使用OpenGL实现了在主页面绘制两个立方体，光源可以在当前场景中移动，并实现了光照效果。 2072 2073##### 使用 2074 20751. 安装编译生成的hap包，进入主页面（在主页面，默认展示的是3D图形绘制效果）。 2076 20772. 点击DrawTransform可以切换展示2D图形绘制效果。 2078 20793. 点击DrawCube可以切换展示3D图形绘制效果。 2080 2081##### 基本原理 2082 2083* 在主页面显示了一个XComponent控件，默认显示立方体。通过用户点击，触发ChangeShape事件，opengl_draw收到事件，完成绘制内容变更。首页启动时，会触发一个定时器，每40ms触发一次，当opengl_draw收到事件时，进行动画更新。 2084 2085* 在XComponent初始化完成时，OnSurfaceCreated回调里面，会自动开始图形绘制。源码参考[opengl_draw.cpp](https://gitee.com/openharmony/applications_app_samples/blob/master/code/BasicFeature/Native/XComponent3D/entry/src/main/cpp/opengl_draw.cpp) 。在opengl_draw.cpp里面Init方法会创建EglWindow和EGLSurface，然后创建上下文EGLContext，完成baseShape的初始化，默认使用Cube进行初始化。 2086 2087* 绘制2D图形：rectangle.cpp的Init方法，完成Shader的初始化。Update方法主要是绘制两个图形，一个进行旋转，一个进行缩放。 2088 2089* 绘制3D物体：cube.cpp的Init方法，完成Shader的初始化，相机的初始化。Update方法绘制了两个立方体，一个在屏幕中间，另一个会围绕中间的物体进行圆周运动。并且设置运动的物体为发光源，在中间物体展示不同角度的光照效果。 2090 2091##### 约束与限制 2092 2093开发语言：ArkTS 2094 2095配套版本：API10版本SDK，版本号：4.0.10.13 2096 2097[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Native/XComponent3D) 2098 2099### 通知 2100 2101#### 公共事件的订阅和发布 2102 2103##### 介绍 2104 2105本示例主要展示了公共事件相关的功能，实现了一个检测用户部分行为的应用。具体而言实现了如下几点功能： 2106 21071.通过订阅系统公共事件，实现对用户操作行为（亮灭屏、锁屏和解锁屏幕、断联网）的监测； 2108 21092.通过在用户主动停止监测行为时发布自定义有序公共事件，实现对用户主动触发监听行为的持久化记录； 2110 21113.通过在用户设置对某一事件的监听状态时发布粘性事件，记录下本次应用运行期间允许监听的事件列表，同时在应用退出时将临时允许的修改为不允许。 2112 2113##### 使用 2114 21151.安装编译生成的hap包，依赖包hap，桌面上显示应用图标，点击图标即可进入应用。 2116 21172.进入应用显示菜单页，可选择“进入”，“历史”，“设置”及“关于”几个选项。 2118 21193.点击“进入”后跳转至主页面，点击主页面“开始监控”按钮，将开始监听系统公共事件，并进行计时，此时按钮内容变更为“停止监听”；点击停止监听按钮，页面上将显示本次监听时长及监听期间收到的干扰信息汇总，并在页面右下角显示“查看详情”按钮，点击按钮将跳转至详情页，显示监听期间收到的干扰信息，应用当前仅监听了亮灭屏、锁屏和解锁屏幕、断联网等用户可操作的系统公共事件，后续可根据需求快速扩展。 2120 21214.返回至应用菜单页面，点击“历史”可查看用户操作监听的历史记录，当前支持每次运行期间最多存储10条历史记录，超过10条后将删除历史数据。 2122 21235.返回至应用菜单页面，点击“设置”可进行具体系统事件的监听配置，应用提供了“一直”、“仅本次”及“从不”三个选项，其中“仅本次”选项是指本次应用运行期间将监听特定系统公共事件，应用退出后该选项将自动调整为“从不”。 2124 21256.在设置页面，点击“自定义事件定向订阅”进入订阅页面， 2126 21277.返回至应用菜单页面，点击“关于”可查看应用版本信息及本示例的说明。 2128 2129##### 基本原理 2130 2131* 该示例entry部分分为五个模块： 2132 * 进入模块 2133 * 使用到应用文上下文，createSubscriber方法创建订阅者，getCurrentTime获取获取自Unix纪元以来经过的时间进行对用户操作行为的监测功能页面开发。 2134 * 参考接口：[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md)，[@ohos.commonEventManager](reference/apis-basic-services-kit/js-apis-commonEventManager.md)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md)，[@ohos.commonEvent](reference/apis-basic-services-kit/js-apis-commonEvent.md)，[@ohos.router](reference/apis-arkui/js-apis-router.md)，[@ohos.systemTime](reference/apis-basic-services-kit/js-apis-system-timer-sys.md) 2135 2136 * 历史模块 2137 * 使用到应用文上下文，getPreferences方法获取Preferences实例，组件Header进行历史页面开发。 2138 * 参考接口：[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md) 2139 2140 * 设置模块 2141 * 本模块分为三个事件，分别为记录联网事件，记录灭屏事件，记录亮屏事件，进行锁屏事件、进行解锁屏幕事件，每一个事件都可进行一直，仅本次和从不的单项选择，使用到应用文上下文吗，CommonEvent.publish发布公共事件，getPreferences方法获取Preferences实例进行功能页面开发。 2142 * 参考接口：[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md)，[@ohos.commonEvent](reference/apis-basic-services-kit/js-apis-commonEvent.md),[@ohos.router](reference/apis-arkui/js-apis-router.md)，[@ohos.commonEvent](reference/apis-basic-services-kit/js-apis-commonEvent.md) 2143 2144 * 关于模块 2145 * 该模块开发主要介绍了本示例的功能作用以及说明了什么情况下不能使用。 2146 2147 - 设置中订阅事件模块 2148 - 本模块主要支持指定应用订阅自定义事件。subScribeInfo新增可选属性publisherBundleName,创建订阅对象时可指定PublisherBundlerName，事件发布时，获取订阅者信息，增加校验bundleName是否等于publisherBundlerName，相等则加入事件回调方，达成只接收指定发布方发布的事件的效果。 2149 - 参考接口：[@ohos.commonEventManager](reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md)，[@ohos.hilog](reference/apis-performance-analysis-kit/js-apis-hilog.md)，[@ohos.app.form.formInfo](reference/apis-form-kit/js-apis-app-form-formInfo.md)，[@ohos.app.form.formBindingData](reference/apis-form-kit/js-apis-app-form-formBindingData.md)，[@ohos.app.form.FormExtensionAbility](reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md) 2150 2151##### 约束与限制 2152 2153开发语言：ArkTS 2154 2155配套版本：API10版本SDK，版本号：4.0.9.6 2156 2157[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomCommonEvent) 2158 2159#### 自定义Emitter 2160 2161##### 介绍 2162 2163本示例使用[Emitter](reference/apis-basic-services-kit/js-apis-emitter.md)实现事件的订阅和发布，使用[自定义弹窗](reference/apis-arkui/arkui-ts/ts-methods-custom-dialog-box.md)设置广告信息。 2164 2165##### 使用 2166 21671. 进入首页后弹出广告弹窗，点击即可关闭。 21682. 点击商品列表中的一个商品可以跳转到商品详情页。 21693. 在商品详情页点击首页可以返回到商品列表页，点击购物车可以跳转到购物车页面，点击加入购物车可以在购物车页面添加一条商品信息，点击立即购买可以增加一次已购物数量显示在购物车页面。 21704. 在购物车页面点击购物车列表内商品的减号图标，可以将此商品信息从购物车列表内删除，点击清空购买数量可以将已购物数量清空、显示为0。 2171 2172##### 基本原理 2173 2174+ 订阅事件通知在CustomEmitter中实现 2175 + 广告弹窗：使用Emitter的事件单次订阅emitter.once(eventId,call)，eventId为number类型，单次订阅CustomDialogController弹窗事件，弹窗触发后自动取消订阅。 2176 + 关闭广告弹窗：使用Emitter的事件单次订阅emitter.once(eventId,call)，eventId为string类型，单次订阅CustomDialogController弹窗事件，弹窗关闭后自动取消订阅。 2177 + 购物车添加商品：使用Emitter.on持续订阅商品添加事件，eventId为number类型，添加商品时更新购物车商品列表。 2178 + 购物车删除商品：使用Emitter.on持续订阅商品删除事件，eventId为string类型，删除商品时更新购物车商品列表。 2179 + 购物数量：使用Emitter.getListenerCount获取购买事件订阅者数量，进入购物车页面显示数量结果，清空时取消订阅，结果为0。 2180 2181##### 约束与限制 2182 2183开发语言：ArkTS 2184 2185配套版本：API9版本SDK，版本号：3.2.11.9 2186 2187[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomEmitter) 2188 2189#### 自定义通知 2190 2191##### 介绍 2192 2193本示例使用[@ohos.notificationManager](reference/apis-notification-kit/js-apis-notificationManager.md) 等接口，展示了如何初始化不同类型通知的通知内容以及通知的发布、取消及桌面角标的设置，通知类型包括基本类型、长文本类型、多行文本类型、图片类型、带按钮的通知、点击可跳转到应用的通知。 2194 2195##### 使用 2196 21971.启动应用后，弹出是否允许发送通知的弹窗，点击允许后开始操作； 2198 21992.点击界面中对应的按钮发布不同类型的通知，下拉状态栏，在通知栏可以看到发布的通知； 2200 22013.打开提示音和震动效果开关后，再点击对应按钮发布不同类型的通知，在通知的同时会伴有提示音或震动效果； 2202 22034.点击消息列表Tab页，可以查看到刚才发送的消息，消息右边会显示数量，点击相应的消息可进行消息读取，取消相应通知； 2204 22055.回到仿桌面，可以看到角标数量，对应消息数量（使用前需安装并启动[仿桌面应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/Launcher)）； 2206 22076.点击取消所有通知，可以取消本应用发布的所有通知； 2208 2209##### 基本原理 2210 2211* 允许发送通知、发送通知、取消通知的功能接口封装在NotificationUtil 2212 * 允许发送通知：在进入Index.ets前 2213 通过notificationUtil.enableNotification()调用notification.requestEnableNotification()接口向用户请求发送通知； 2214 * 发送通知：通过publishNotification()封装发布通知的接口； 2215 * 取消通知：Index.ets 页面中通过点击事件调用cancelAllNotifications()取消所有的通知或者通过cancelNotificationById()取消指定id的通知； 2216 2217* 获取应用所有消息通知、取消相关类型通知，角标管理接口封装在NotificationManagementUtil 2218 * 获取应用所有消息通知：在constructor() 2219 构造函数中调用@ohos.notificationManager中的getActiveNotifications接口获取所有通知及相应类型通知数量，通过封装getAllNotifications() 2220 对外提供接口获取当前消息及消息数量。 2221 * 取消相关类型通知：通过cancelNotificationType()封装取消相关通知类型的接口； 2222 * 角标管理接口：通过setBadgeNumber()封装设置应用角标数量的接口，通过getBadgeNumber()封装获取当前应用角标数量的接口。 2223 * 添加一条通知：通过addNotification()封装接口添加一条通知到消息管理器，当发送通知的时候进行调用。 2224 2225* NotificationOperations向外提供接口，在页面中调用它们来实现功能 2226 * 发布通知： 2227 页面中通过点击事件调用NotificationOperations中封装的对应的方法，然后从NotificationContentUtil中获取对应的主体内容content， 2228 将content传递给NotificationRequestUtil得到完整的发布信息，最后调用NotificationUtil.publishNotification()发布内容； 2229 2230* 播放提示音、马达震动的功能在NotificationUtil调用发布通知的接口处进行判断是否开启 2231 * 发布通知： 2232 通过publishNotification()封装发布通知的接口的同时，根据NotificationUtil类中对应变量的值判断是否开启了提示音或马达，若已开启，则执行对应代码段； 2233 * 控制提示音或马达的开关， 2234 通过调用NotificationUtil类两个方法对NotificationUtil类中对应变量进行更改，开启为true，关闭为false； 2235 2236* 自动化测试，对应用接口或系统接口进行单元测试，并且对基于UI操作进行UI自动化测试 2237 * 模拟点击：在Index.test.ets的beforeAll中调用startAbility()拉起应用并进入首页， 2238 然后通过Driver的assertComponentExist、findComponent和findWindow等获取到对应组件的位置， 2239 最后通过click()模拟出人工点击对应组件的效果； 2240 * 模拟各种操作流程：在Index.test.ets 2241 的每个it里面，按一定逻辑顺序排好点击组件的顺序，从而模拟出人为操作的过程，最终，所有的it组成了整一个应用的自动化测试。 2242 2243##### 约束与限制 2244 2245开发语言：ArkTS 2246 2247配套版本：API10版本SDK，版本号：4.0.7.5 2248 2249[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomNotification) 2250 2251#### 自定义通知角标 2252 2253##### 介绍 2254 2255本示例主要展示了设定应用的桌面图标角标的功能，使用[@ohos.notificationManager](reference/apis-notification-kit/js-apis-notificationManager.md) 接口，进行桌面角标的设置，通知的发送，获取等。 2256 2257##### 使用 2258 22591. 在使用本应用时，需安装并启动[仿桌面应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/Launcher)； 22602. 在主界面，可以看到当前应用的所有消息通知； 22613. 点击右下角Tab页签进入通知发送页面，点击对应的通知即可发送相应类型的通知，点击几次发送几条； 22624. 点击左下角Tab页签进入消息列表，可以查看刚才发送的消息，消息右边会显示消息数量，点击相应的消息可进行消息读取，取消相应通知； 22635. 回到仿桌面，可以看到角标数量，对应消息数量。 2264 2265##### 基本原理 2266 2267* 允许发送通知，发送通知的功能接口封装在NotificationUtil 2268 * 允许发送通知： 2269 前通过notificationUtil.enableNotification()调用notification.requestEnableNotification()接口向用户请求发送通知； 2270 * 发送通知：通过publishNotification()封装发布通知的接口； 2271 2272* 获取应用所有消息通知、取消相关类型通知，角标管理接口封装在NotificationManagementUtil 2273 * 获取应用所有消息通知：在constructor()构造函数中调用@ohos.notificationManager中的getActiveNotifications接口获取所有通知及相应类型通知数量，通过封装getAllNotifications()对外提供接口获取当前消息及消息数量。 2274 * 取消相关类型通知：通过cancelNotificationType()封装取消相关通知类型的接口； 2275 * 角标管理接口：通过setBadgeNumber()封装设置应用角标数量的接口，通过getBadgeNumber()封装获取当前应用角标数量的接口。 2276 * 添加一条通知：通过addNotification()封装接口添加一条通知到消息管理器，当发送通知的时候进行调用。 2277 2278* NotificationOperations向外提供接口，在页面中调用它们来实现功能 2279 * 发布通知： 2280 页面中进入发送通知Tab页签，通过点击事件调用NotificationOperations中封装的对应的方法，然后从NotificationContentUtil中获取对应的主体内容content，将 2281 content传递给NotificationRequestUtil得到完整的发布信息，最后调用NotificationUtil.publishNotification()发布内容，并调用NotificationManagementUtil的addNotification()添加一条消息； 2282 2283##### 约束与限制 2284 2285开发语言：ArkTS 2286 2287配套版本：API10版本SDK，版本号：4.0.7.5 2288 2289[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomNotificationBadge) 2290 2291#### 自定义通知推送 2292 2293##### 介绍 2294 2295本示例主要展示了通知过滤回调管理的功能，使用[@ohos.notificationManager](reference/apis-notification-kit/js-apis-notificationManager.md) 接口，进行通知监听回调，决定应用通知是否发送。 2296 2297##### 使用 2298 22991. 在使用本应用时，需安装[自定义通知角标应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Notification/CustomNotificationBadge)； 23002. 在主界面，进行通知过滤的开启及关闭； 23013. 开启通知过滤后，可以选择允许通知的类型，去勾选后，相应类型的通知将不会发送出现通知栏； 23024. 打开自定义通知角标应用应用，进行通知的发送，查看是否发送成功； 23035. 发送通知的应用必须为普通应用才能进行通知过滤，系统应用默认所有通知都能发送。 2304 2305##### 基本原理 2306 2307* 允许通知过滤、指定通知类型过滤的功能接口封装在NotificationFilterUtil 2308 * 允许通知过滤： 2309 页面中通过Toggle状态改变事件调用setNotificationEnableFilter()接口开启通知监听并设置通知过滤回调管理； 2310 * 指定类型通知过滤： 2311 页面中，开启通知过滤后，勾选或取消勾选指定通知类型调用接口setContentTypeEnable()接口设置通知类型是否允许发送； 2312 2313##### 约束与限制 2314 2315开发语言：ArkTS 2316 2317配套版本：API10版本SDK，版本号：4.0.7.5 2318 2319[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Notification/CustomNotificationPush) 2320 2321### 资源 2322 2323#### 资源管理器 2324 2325##### 介绍 2326 2327本工程使用[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md) 接口中的AbilityContext类，获取资源管理器resourceManager，使用[@ohos.resourceManager.d.ts](reference/apis-localization-kit/js-apis-resource-manager.md) 中的接口，展示了格式化字符串查询、基于指定屏幕分辨率查询媒体资源、获取系统资源管理对象等基础功能，以及展示了资源静态overlay以及运行时overlay的特性功能。 2328 2329##### 使用 2330 2331此界面为主页面，其中展示了资源管理API各类接口的调用以及特性Overlay场景功能。其作用有： 2332 23331、点击资源API调用示例按钮，可跳转到资源API示例页面 2334 23352、点击Overlay使用示例，可以跳转到Overlay的使用示例界面。 2336 2337##### 基本原理 2338 2339此页面展示静态overlay功能，功能使用如下： 2340 23411、静态overlay是默认使能的，当前显示的是静态overlay中的字符串和图标。 2342 23432、点击Disable可以触发去使能，重启应用可以恢复显示应用的字符串和图标。 2344 23453、点击enable可以触发使能，重启应用可以再次显示overlay中的字符串和图标。 2346 2347##### 约束与限制 2348 2349开发语言：ArkTS 2350 2351配套版本：API10版本SDK，版本号：4.0.9.6 2352 2353[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Resource/ResourceManager) 2354 2355### 安全 2356 2357#### 应用账号管理 2358 2359##### 介绍 2360 2361本示例选择应用进行注册/登录，并设置账号相关信息，简要说明应用账号管理相关功能。 2362 2363##### 使用 2364 23651.首页面选择想要进入的应用，首次进入该应用需要进行注册，如已注册账号则直接登录。 2366 23672.注册页面可设置账号名、邮箱、个性签名、密码（带*号为必填信息），注册完成后返回登录页面使用注册的账号进行登录。 2368 23693.登录后进入账号详情界面，点击**修改信息**按钮可跳转至账号信息修改页面重新设置账号信息。 2370 23714.点击**切换应用**按钮则退出该账号并返回首页面。重新选择想要进入的应用。 2372 23735.点击**删除账号**按钮则会删除该账号所有相关信息。 2374 2375##### 基本原理 2376 2377* 本示例分为音乐，视频，地图三个模块 2378 * 音乐模块 2379 * 使用Navigation,Button，Text,TextInput组件开发注册，登录，修改信息和切换应用页面， createAppAccountManager方法创建应用账号管理器对象 2380 * 接口参考：[@ohos.account.appAccount](reference/apis-basic-services-kit/js-apis-appAccount.md#appaccountcreateappaccountmanager)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md)，[@ohos.router](reference/apis-arkui/js-apis-system-router.md) 2381 2382 * 视频模块 2383 * 使用Navigation,Button，Text,TextInput组件开发注册，登录，修改信息和切换应用页面，createAppAccountManager方法创建应用账号管理器对象 2384 * 接口参考：[@ohos.account.appAccount](reference/apis-basic-services-kit/js-apis-appAccount.md#appaccountcreateappaccountmanager)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md)，[@ohos.router](reference/apis-arkui/js-apis-system-router.md) 2385 2386 * 地图模块 2387 * 使用Navigation,Button，Text,TextInput组件开发注册，登录，修改信息和切换应用页面，createAppAccountManager方法创建应用账号管理器对象 2388 * 接口参考：[@ohos.account.appAccount](reference/apis-basic-services-kit/js-apis-appAccount.md#appaccountcreateappaccountmanager)，[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md)，[@ohos.router](reference/apis-arkui/js-apis-system-router.md) 2389 2390##### 约束与限制 2391 2392开发语言：ArkTS 2393 2394配套版本：API9版本SDK，版本号：3.2.11.9 2395 2396[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/AppAccountManager) 2397 2398#### 证书算法库框架 2399 2400##### 介绍 2401 2402本示例使用了[@ohos.security.cert](reference/apis-device-certificate-kit/js-apis-cert.md)相关接口实现了对签名数据进行校验的功能。 2403 2404实现场景如下： 2405 24061）使用**正确**的原始数据和签名数据进行签名校验场景：模拟服务端通过客户端证书获取公钥，利用公钥对签名数据进行校验，验证客户端身份和原始数据完整性。 2407 24082）使用**错误**的原始数据或签名数据进行签名校验场景：模拟攻击者修改原始数据或签名数据，服务端在利用公钥进行签名校验时，攻击者身份不可信或原始数据不完整，验证失败。 2409 2410##### 使用 2411 24121、点击**数据展示**按钮，页面文本框中分别显示正确的证书、原始和签名数据内容。 2413 24142、点击**签名校验**按钮，页面弹出弹窗，提示**校验通过**。 2415 24163、点击**修改原始数据**按钮，页面显示修改后的原始数据和正确的证书、签名数据；点击签名校验按钮，页面弹出弹窗，提示**校验失败**。 2417 24184、点击**修改签名数据**按钮，页面显示修改后的签名数据和正确的证书、原始数据；点击签名校验按钮，页面弹出弹窗，提示**校验失败**。 2419 24205、点击**数据展示**按钮，页面恢复正确证书、原始和签名数据的展示；点击**签名校验**按钮，页面弹出弹窗，提示**校验通过**。 2421 2422##### 基本原理 2423 2424* 使用证书公钥实现签名校验的功能接口Verify封装在CertFrameworkModel中 2425 * 获取证书公钥：首先调用[cert.createX509Cert](reference/apis-device-certificate-kit/js-apis-cert.md#certcreatex509cert)接口生成证书对象certObject，使用certObject对象的[getPublicKey](reference/apis-device-certificate-kit/js-apis-cert.md#getpublickey)能力获取公钥pubKey；然后调用[cryptoFramework.createAsyKeyGenerator](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreateasykeygenerator)接口创建密钥生成器keyGenerator，使用keyGenerator的[convertKey](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#convertkey)能力将公钥pubKey转换为正确的格式。 2426 * 使用公钥校验签名：首先调用[cryptoFramework.createVerify](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreateverify)接口创建验签对象verifier，使用公钥pubKey对验签对象verifier进行初始化[verifier.init](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#init-6)；然后使用验签对象verifier的[verify](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#verify)能力对签名进行校验。 2427 2428##### 约束与限制 2429 2430##### 介绍 2431 2432开发语言：ArkTS 2433 2434配套版本：API9版本SDK，版本号：3.2.12.2 2435 2436[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Security/CertificateFramework) 2437 2438#### 加解密 2439 2440##### 介绍 2441 2442本示例使用[cipher](reference/apis-crypto-architecture-kit/js-apis-system-cipher.md)相关接口实现了字符串加解密算法，包括RSA加密算法与AES加密算法。 2443 2444##### 使用 2445 24461.点击主页面的**加密**按钮，在加密界面中点击**Encryption Algorithm**下拉选择加密算法，在输入框中输入待加密的内容，点击**加密** 2447按钮，下方文本框中显示加密后内容。 2448 24492.点击**重置**按钮，清除文本框中内容。 2450 24513.点击主页面的**解密**按钮，在解密界面中点击**Decrypt Algorithm**下拉选择解密算法，在输入框中输入待解密的内容，点击**解密** 2452按钮，下方文本框中显示解密后内容。 2453 24544.点击**重置**按钮，清除文本框中内容。 2455 2456##### 基本原理 2457 2458* 本示例分成加密与解密两个模块 2459 * 加密模块 2460 * 使用到rsaEncrypt(RSA算法加密)与aesEncrypt(AES算法加密)两种加密方法进行加密操作。 2461 * 接口参考：[@system.cipher](reference/apis-crypto-architecture-kit/js-apis-system-cipher.md)，[@ohos.prompt](reference/apis-arkui/js-apis-promptAction.md)，[@system.router](reference/apis-arkui/js-apis-system-router.md) 2462 2463 * 解密模块 2464 * 使用到rsaDecrypt(RSA算法解密)与aesDecrypt(AES算法解密)两种解密方法进行解密操作。 2465 * 接口参考：[@system.cipher](reference/apis-crypto-architecture-kit/js-apis-system-cipher.md)，[@ohos.prompt](reference/apis-arkui/js-apis-promptAction.md)，[@system.router](reference/apis-arkui/js-apis-system-router.md) 2466 2467##### 约束与限制 2468 2469开发语言：ArkTS 2470 2471配套版本：API9版本SDK，版本号：3.2.11.9 2472 2473[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/Cipher) 2474 2475#### 通用密钥库系统（cryptoFramework） 2476 2477##### 介绍 2478 2479本示例使用[@ohos.security.cryptoFramework](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md) 相关接口实现了对文本文件的加解密、签名验签操作。 2480 2481实现场景如下： 2482 24831）软件需要加密存储本地文本文件，需要调用加解密算法库框架选择密钥文本文件，对本地文本文件进行加密，其中密钥文本文件可由加解密算法库生成。 2484 24852）软件需要解密存储本地文本文件，需要调用加解密算法库框架选择密钥文本文件，对本地文本文件进行解密，其中密钥文本文件可由加解密算法库生成。 2486 24873）软件需要对存储本地文本文件签名，调用加解密算法库框架选择密钥文本文件，对本地文本文件进行完整性签名，其中密钥文本文件可由加解密算法库生成。 2488 24894）软件需要验证存储本地文本文件的签名完整性，需要调用加解密算法库框架选择密钥文本文件与签名文件，对文件进行验签，其中密钥文本文件可由加解密算法库生成。 2490 2491##### 使用 2492 24931.点击主页面tab栏的**加密**，在加密界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回加密界面， 2494其内容显示在**文件内容**文本框中， 2495点击**选择密钥**，选择密钥文件，如果没有密钥文件，可以通过在加密界面点击**随机生成AES密钥**，生成并通过文件选择器保存密钥文件。 2496选择完文本文件和密钥文件后，点击**加密**按钮，完成加密，并通过文件选择器保存密文文件。 2497下方**加密内容**文本框中显示加密后的消息内容。 2498 24992.点击主页面tab栏的**解密**，在解密界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回解密界面， 2500其内容显示在**文件内容**文本框中， 2501点击**选择密钥**，选择和**加密相同**的密钥文件。 2502选择完文本文件和密钥文件后，点击**解密**按钮，完成解密，并通过文件选择器保存明文文件。 2503下方**解密内容**文本框中显示解密后的消息内容。 2504 25053.点击主页面tab栏的**签名**，在签名界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回签名界面， 2506其内容显示在**文件内容**文本框中， 2507点击**选择密钥**，选择密钥文件，如果没有密钥文件，可以通过在签名界面点击**随机生成RSA密钥**，生成并通过文件选择器保存密钥文件，注意RSA密钥生成耗时较长。 2508选择完文本文件和密钥文件后，点击**签名**按钮，完成完整性签名，并通过文件选择器保存签名文件。 2509 25104.点击主页面tab栏的**验签**，在验签界面点击**打开文件**，通过文件选择器选择文本文件，选择完毕自动返回验签界面， 2511其内容显示在**文件内容**文本框中， 2512点击**选择密钥**，选择和签名一致的密钥文件。点击**选择签名文件**，通过文件选择器选择签名时保存的签名文件， 2513选择完文本文件、密钥文件和签名文件后，点击**验签**按钮，完成验签。 2514 2515##### 基本原理 2516 2517* 进行对文本文件进行加解密、签名验签的功能接口封装在CryptoOperation中 2518 2519* 对文本文件加密： 2520 文件中依次点击打开文件、选择密钥，通过filePicker选择明文文本文件和密钥文件，点击加密按钮，调用加密函数实现对文本内容进行加密，并将密文文件通过filePicker保存。 2521 需要生成密钥文本文件时，可以点击随机生成AES密钥，通过调用[cryptoFramework.symKeyGenerator](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#symkeygenerator) 2522 生成用于加密的AES密钥，并通过filePicker保存密钥文本文件。 2523 对消息加密的过程中采用[cryptoFramework.Cipher](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cipher) 2524 完成加密操作。 2525* 对文本文件解密： 2526 文件中依次点击打开文件、选择密钥，通过filePicker选择密文文本文件和密钥文件，点击解密按钮，调用解密函数实现对文本内容进行解密，并将明文文件通过filePicker保存。 2527 对消息解密的过程中采用[cryptoFramework.Cipher](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cipher) 2528 完成解密操作。 2529* 对文本文件签名： 2530 文件中依次点击打开文件、选择密钥，通过filePicker选择待签名文本文件和密钥文件，点击签名按钮，调用签名函数实现对文本内容进行加密，并将签名文件通过filePicker保存。 2531 需要生成密钥文本文件时，可以点击随机生成RSA密钥，通过调用[cryptoFramework.asyKeyGenerator](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#asykeygenerator) 2532 生成用于签名的RSA密钥，并通过filePicker保存密钥文本文件。 2533 对消息签名的过程中采用[cryptoFramework.Sign](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#sign) 2534 完成加密操作。 2535* 对文本文件验签： 2536 文件中依次点击打开文件、选择密钥、选择签名文件，通过filePicker选择密文文本文件、密钥文件和签名文件，点击验签按钮，调用验签函数实现对文本内容进行验签，并显示验签结果。 2537 对消息验签的过程中采用[cryptoFramework.Verify](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#verify) 2538 完成验签操作。 2539 2540##### 约束与限制 2541 2542开发语言：ArkTS 2543 2544配套版本：API9版本SDK，版本号：3.2.12.2 2545 2546[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/CryptoFramework) 2547 2548#### 通用密钥库系统（huks） 2549 2550##### 介绍 2551 2552本示例使用[@ohos.security.huks](reference/apis-universal-keystore-kit/js-apis-huks.md)相关接口实现了对任意输入内容进行加密和解密的功能。 2553 2554实现场景如下： 2555 25561）使用新密钥进行消息加解密传输：使用HUKS的生成密钥接口在本地生成一个新密钥，模拟设备对发送的消息进行加密和对接收的消息进行解密场景。 2557 25582）使用旧密钥进行消息加解密传输：使用HUKS的导入密钥接口导入一个旧密钥，模拟在旧设备上对发送的消息进行加密，在新设备上对接收的消息进行解密的场景。 2559 2560##### 使用 2561 25621.点击主页面的**新密钥**按钮，在新密钥界面的输入框中输入待发送的消息内容，点击**发送消息** 2563按钮，下方文本框中显示加密后的消息内容，然后点击**接收消息**按钮，下方文本框中显示解密后的消息内容。 2564 25652.点击主页面的**旧密钥**按钮，在旧密钥界面的输入框中输入待发送的消息内容，点击**发送消息** 2566按钮，下方文本框中显示加密后的消息内容，首先点击**导入密钥**按钮，弹窗提示导入密钥成功，然后点击**接收消息**按钮，下方文本框中显示解密后的消息内容。 2567 25683.点击主页面的**低安访问控制**按钮，在新密钥界面的输入框中输入待保存的密码内容，点击**保存密码** 2569按钮，下方文本框中显示加密后的密码内容，录入锁屏密码， 然后点击**读取密码**按钮，在输入PIN码（锁屏密码，需要预先录入）之后，下方文本框中显示解密后的消息内容。 2570 2571##### 基本原理 2572 2573* 使用新密钥、旧密钥与低安访问控制进行消息的加密和解密的功能接口封装在HuksModel中 2574 * 使用新密钥加密：在NewKey.ets文件中通过HuksModel.encryptData方式调用加密函数实现对发送的消息内容进行加密，设置好生成密钥和解密密钥的密钥属性信息，加密前会先调用生成密钥接口 2575 [huks.generateKeyItem](reference/apis-universal-keystore-kit/js-apis-huks.md#huksgeneratekeyitem9-1) 2576 生成用于加密的AES密钥，对消息加密的过程中采用三段式接口[huks.initSession,huks.updateSession,huks.finishSession](reference/apis-universal-keystore-kit/js-apis-huks.md#huksinitsession9-1) 2577 完成加密操作。 2578 * 使用新密钥解密：NewKey.ets文件中通过HuksModel.decryptData方式调用解密函数实现对发送消息的解密，设置好解密密钥的密钥属性信息，使用加密时的密钥对消息进行解密，仍然是采用三段式接口完成解密操作，解密动作完成后调用删除密钥接口 2579 [huks.deleteKeyItem](reference/apis-universal-keystore-kit/js-apis-huks.md#huksdeletekeyitem9-1)清除本地保存的密钥。 2580 * 使用旧密钥加密：在OldKey.ets文件中通过HuksModel.encryptDataUserOldKey方式调用加密函数对发送的消息内容进行加密，设置好加密密钥的密钥属性信息，采用三段式接口使用本地已保存的旧密钥完成加密操作。 2581 * 使用旧密钥解密：在OldKey.ets文件中通过HuksModel.decryptDataUserOldKey方式调用解密函数对发送的消息内容进行解密，首先模拟在新设备上导入旧设备的加密密钥，同样采用三段式接口完成解密操作，解密完成后删除密钥。 2582 * 使用低安访问控制管理密码：在MinAccessControl.ets文件中通过 huksModel.encryptDataUseSm2 方式生成SM2密钥并调用加密函数对发送的消息内容进行加密，设置好加密密钥的密钥属性信息，采用两段式接口使用本地已保存的旧密钥完成加密操作。读取密码时（需先设定系统锁屏密码）调用IAM的PIN码（锁屏密码）接口进行验证。 2583 2584##### 约束与限制 2585 2586开发语言：ArkTS 2587 2588配套版本：API10版本SDK，版本号：4.0.10.1 2589 2590[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/Huks) 2591 2592#### 支付 2593 2594##### 介绍 2595 2596本示例主要展示了加解密算法库框架的相关功能，使用[@ohos.security.cryptoFramework](reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md) 接口，利用RSA非对称加密、ECC数字签名模拟选购支付功能。 2597 2598##### 使用 2599 26001. 在选购首页，点击任意商品进入对支付主面； 26012. 在支付主面，点击立即支付按钮，弹出密码输入框； 26023. 输入密码满6位后得到支付结果，支付成功会进入支付成功界面，3s后自动回到选购首页； 2603 2604##### 基本原理 2605 26061. 选购页面通过商家云获取商品信息，选定商品通过商家云生成订单。 26072. 商家云通过RSA非对称加密，使用支付云公钥，将商品信息传输给支付云SDK。 26083. 支付云通过支付云私钥解密获得消息后生成订单明文orderString返回商家云。 26094. 商家云通过ECC进行数字签名，添加到明文orderString后，形成完整的orderString返回给选购端。 26105. 支付SDK通过RSA非对称加密，使用支付SDK公钥，将支付账号密码信息传输给支付云SDK，并携带完整的orderString。 26116. 支付云通过支付SDK私钥解密账号密码信息，并通过商家云公钥进行验签。 2612 2613- 商家云可用接口封装在cloud模块MerchantServer，提供商品获取，生成订单功能 2614- 支付云可用接口封装在cloud模块PayServer，提供生成支付订单，支付转账功能 2615- 支付SDK为单独feature，需要支付时拉起此hap,提供输入密码进行支付功能。逻辑位于PaySDK模块index 2616 2617##### 约束与限制 2618 2619开发语言：ArkTS 2620 2621配套版本：API9版本SDK，版本号：3.2.11.10 2622 2623[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/PaySecurely) 2624 2625#### 证书管理 2626 2627##### 介绍 2628 2629本示例使用了[@ohos.security.certManager](reference/apis-device-certificate-kit/js-apis-certManager.md)相关接口实现了对签名数据进行校验的功能。 2630 2631##### 使用 2632 26331. 点击**安装**按钮，页面弹出弹窗，提示**安装成功**。 26342. 点击**数据展示**按钮，页面文本框中分别显示正确的证书、原始数据内容。 26353. 点击**数据展示**按钮，页面文本框中分别显示正确的证书、原始数据内容。 26364. 点击**修改原始数据**按钮，页面显示修改后的原始数据和正确的证书、签名数据；点击校验按钮，页面弹出弹窗，提示**校验失败**。 26375. 点击**修改签名数据**按钮，页面显示修改后的签名数据和正确的证书、原始数据；点击校验按钮，页面弹出弹窗，提示**校验失败**。 26386. 点击**校验**按钮，页面弹出弹窗，提示**校验通过**。 2639 2640##### 基本原理 2641 2642* 签名校验的功能接口Verify封装在Model中 2643 * 安装私有凭据：调用[certificateManager.installPrivateCertificate](reference/apis-device-certificate-kit/js-apis-certManager.md#certificatemanagerinstallprivatecertificate)接口安装证书，并获取返回结果cmResult。 2644 * 使用凭据进行签名、验签的初始化操作：调用[certificateManager.init](reference/apis-device-certificate-kit/js-apis-certManager.md#certificatemanagerinit)接口进行初始化，并获取返回结果signHandle。 2645 * 填充源数据：调用[certificateManager.update](reference/apis-device-certificate-kit/js-apis-certManager.md#certificatemanagerupdate)接口填充源数据。 2646 * 完成签名的操作：调用[certificateManager.finish](reference/apis-device-certificate-kit/js-apis-certManager.md#certificatemanagerfinish)接口完成签名，并获取签名结果signResult。 2647 * 完成验签的操作：同上，再依次调用[certificateManager.init](reference/apis-device-certificate-kit/js-apis-certManager.md#certificatemanagerinit)接口，[certificateManager.update](reference/apis-device-certificate-kit/js-apis-certManager.md#certificatemanagerupdate)接口，[certificateManager.finish](reference/apis-device-certificate-kit/js-apis-certManager.md#certificatemanagerfinish-1)接口完成验签操作，最终获取验签结果verifyResult。 2648 2649##### 约束与限制 2650 2651开发语言：ArkTS 2652 2653配套版本：API11版本SDK，版本号：4.1.5.3 2654 2655[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Security/CertManager) 2656 2657#### DLPManager 2658 2659##### 介绍 2660 2661本示例主要展示了DLP文件管理相关的功能，使用[@ohos.dlpPermission](reference/apis-data-protection-kit/js-apis-dlppermission.md)、[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md)、[@ohos.file.fileAccess](reference/apis-core-file-kit/js-apis-fileAccess-sys.md)、[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md)、[@ohos.app.ability.Want](reference/apis-ability-kit/js-apis-app-ability-want.md)等接口，实现了生成和打开DLP文件、查看原始应用沙箱目录的原始文件打开列表、编辑保存文件、拉取文件夹、查看文件权限和监听DLP文件的功能。 2662 2663##### 使用 2664 26651. 进入界面，显示原始应用沙箱目录获取原始文件打开列表。 26662. 点击右上角的图标，可以设置沙箱保留信息。 26673. 点击右下角的加号图标，可以跳转进入文件夹。 26684. 点击某个文件，可以显示其文件内容。 26695. 在文件显示页面，可以点击下面的编辑图标对文件内容进行编辑，编辑后点击保存图标进行保存；点击更多可以文件另存为，查看权限。 2670 2671##### 基本原理 2672 2673* 获取DLP文件和普通文件列表的功能： 2674 * 在Index页面中通过onPageShow()调用fs.listFile()、fs.stat()等方法能够查看应用沙箱路径下的原始文件列表，获取列表信息。 2675 * 通过context.startAbility(want)对DLP文件进行生成和打开，通过dlpPermission的接口查看DLP文件的权限。 2676 2677##### 约束与限制 2678 2679开发语言：ArkTS 2680 2681配套版本：API11版本SDK，版本号：4.1.3.3 2682 2683[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Security/DLPManager) 2684 2685### 任务管理 2686 2687#### 长时任务 2688 2689##### 介绍 2690 2691本示例展示后台任务的长时任务。通过使用[@ohos.resourceschedule.backgroundTaskManager](reference/apis-backgroundtasks-kit/js-apis-resourceschedule-backgroundTaskManager.md)实现后台播放音乐时避免进入挂起（Suspend）状态。 2692 2693##### 使用 2694 26951.进入应用，点击播放，退出音乐界面推送至后台执行，当任务在后台开始执行时下拉菜单栏会有通知提醒； 2696 26972.再次进入应用，音乐播放进度条显示正常； 2698 26993.点击暂停播放，取消长时任务。 2700 2701##### 基本原理 2702 2703* 该示例使用startBackgroundRunning方法向系统申请长时任务，stopBackgroundRunning方法向系统申请取消长时任务，getWantAgent方法创建一个WantAgent，createAudioPlayer方法创建一个视频播放实例，createAVSession方法创建一个会话对象，fileIo.open方法打开文件等接口实现后台音乐播放。 2704* 接口参考：[@ohos.resourceschedule.backgroundTaskManager](reference/apis-backgroundtasks-kit/js-apis-resourceschedule-backgroundTaskManager.md)，[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)，[@ohos.multimedia.avsession](reference/apis-avsession-kit/js-apis-avsession.md)，[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md)，[@ohos.app.ability.wantAgent](reference/apis-ability-kit/js-apis-app-ability-wantAgent.md) 2705 2706##### 约束与限制 2707 2708开发语言：ArkTS 2709 2710配套版本：API9版本SDK，版本号：3.2.11.9 2711 2712[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/TaskManagement/ContinuousTask) 2713 2714#### 小鸟避障游戏 2715 2716##### 介绍 2717 2718本示例使用[@ohos.app.ability.ServiceExtensionAbility](reference/apis-ability-kit/js-apis-app-ability-serviceExtensionAbility-sys.md)的ServiceExtension接口验证提供的Stage模型， [Canvas组件](reference/apis-arkui/arkui-ts/ts-components-canvas-canvas.md)绘制小游戏，[@ohos.resourceschedule.usageStatistics](reference/apis-backgroundtasks-kit/js-apis-resourceschedule-deviceUsageStatistics-sys.md)的queryBundleStatsInfos接口通过指定起始和结束时间查询应用使用时长统计信息来统计展示游戏在线时长，[@ohos.backgroundTaskManager](reference/apis-backgroundtasks-kit/js-apis-backgroundTaskManager.md)的requestSuspendDelay接口申请后台应用延迟挂起来验证短时任务API能否正常执行，[@ohos.rpc](reference/apis-ipc-kit/js-apis-rpc.md)提供进程间通信能力，[@ohos.wantAgent](reference/apis-ability-kit/js-apis-wantAgent.md)验证系统能力。 2719 2720##### 使用 2721 27221.点击**ConnectService**按钮，创建一个ServiceAbility并连接。 2723 27242.点击**DisconenctService**按钮，断开ServiceAbility。 2725 27263.点击**set game alarm**按钮，利用闹钟提醒代理API，验证游戏进程在收到闹铃通知时不被拉起。 2727 27284.点击**set game calendar**按钮，利用日历提醒代理API，验证游戏进程在收到日历通知时不被拉起。 2729 27305.点击**start game**按钮，选择对应的游戏难度1-5关玩游戏，游戏玩的过程中会利用后台信息统计API统计展示游戏在线时长。 2731 27326.点**home**按钮后，应用生命周期为onInactive, 在此回调中起一个短时任务，验证短时任务API能否正常执行。 2733 2734##### 基本原理 2735 2736* 该示例使用ServiceExtension接口验证提供的Stage模型，Canvas组件绘制小游戏，queryBundleStatsInfos接口通过指定起始和结束时间查询应用使用时长统计信息来统计展示游戏在线时长，requestSuspendDelay接口申请后台应用延迟挂起来验证短时任务API能否正常执行，rpc接口提供进程间通信能力，wantAgent接口验证系统能力。 2737 2738* 接口参考[@ohos.resourceschedule.usageStatistics](reference/apis-backgroundtasks-kit/js-apis-resourceschedule-deviceUsageStatistics-sys.md)，[@ohos.backgroundTaskManager](reference/apis-backgroundtasks-kit/js-apis-backgroundTaskManager.md)，[@ohos.wantAgent](reference/apis-ability-kit/js-apis-wantAgent.md)，[@ohos.app.ability.ServiceExtensionAbility](reference/apis-ability-kit/js-apis-app-ability-serviceExtensionAbility-sys.md)，[@ohos.rpc](reference/apis-ipc-kit/js-apis-rpc.md) 2739 2740##### 约束与限制 2741 2742开发语言：ArkTS 2743 2744配套版本：API9版本SDK，版本号：3.2.11.9 2745 2746[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/TaskManagement/Flybird) 2747 2748#### 后台代理提醒 2749 2750##### 介绍 2751 2752本示例使用 [Tabs组件](reference/apis-arkui/arkui-ts/ts-container-tabs.md) 进行应用布局，使用 [Canvas组件](reference/apis-arkui/arkui-ts/ts-components-canvas-canvas.md) 绘制时钟、倒计时，使用 [后台代理提醒](reference/apis-backgroundtasks-kit/js-apis-reminderAgentManager.md) 发布后台代理提醒，使用 [振动](reference/apis-sensor-service-kit/js-apis-vibrator.md) 设置振动效果。保证应用被冻结或退出时，计时和弹出提醒的功能可以被后台系统服务代理。 2753 2754##### 使用 2755 27561.点击**闹钟**、**日历**、**计时器**三个按钮切换不同视图。 2757 27582.1.点击闹钟页面右上角**+**按钮选择闹钟提醒时间添加闹钟提醒。 2759 27602.2.点击闹钟列表中可设置闹钟重复日期、延迟次数、延迟时长、是否震动、响铃音乐。 2761 27622.3.点击闹钟列表右侧开关按钮，可关闭或打开当前提醒。 2763 27642.4.右滑当前闹钟列表可选择删除当前提醒。 2765 27663.1.点击点击日历页面右上角**+**按钮选择日期提醒时间添加日期提醒。 2767 27683.2.点击日期列表中可设置日历提醒当天具体提醒时间、是否振动、是否响铃。 2769 27703.3.点击日历列表右侧开关按钮，可关闭或打开当前提醒。 2771 27723.4.右滑当前日历列表可选择删除当前提醒。 2773 27744.1.滑动计时器时间选项设置计时器时间。 2775 27764.2.点击**开始**按钮，开始当前计时器并设置倒计时后台提醒。 2777 27784.3.点击**重置**按钮，取消当前计时器提醒并重新设置计时器。 2779 27804.4.点击**暂停**按钮，暂停当前计时器提醒与倒计时；再次点击按钮恢复计时器提醒与计时器计时。 2781 2782##### 基本原理 2783 2784* 该示例分为闹钟，日历，计时器三个模块 2785 * 闹钟模块 2786 * 使用Canvas组件绘制一个闹钟，SlotType方法获取对应的系统能力内容类型，addNotificationSlot方法添加一个NotificationSlot，ReminderRequestAlarm方法获取闹钟实例对象，用于设置提醒的时间，ReminderType方法设置提醒的类型，ActionButtonType方法设置按钮的类型，VibratorStopMode方法停止的振动。 2787 * 接口参考：[@ohos.notification](reference/apis-notification-kit/js-apis-notification.md)，[@ohos.reminderAgent](reference/apis-backgroundtasks-kit/js-apis-reminderAgent.md)，[@ohos.vibrator](reference/apis-sensor-service-kit/js-apis-vibrator.md) 2788 2789 * 日历模块 2790 * 使用SlotType方法获取对应的系统能力内容类型，ReminderRequestCalendar方法获取日历实例对象，用于设置提醒的时间，ReminderType方法设置提醒的类型，ActionButtonType方法设置按钮的类型，VibratorStopMode方法停止的振动。 2791 * 接口参考：[@ohos.notification](reference/apis-notification-kit/js-apis-notification.md)，[@ohos.reminderAgent](reference/apis-backgroundtasks-kit/js-apis-reminderAgent.md)，[@ohos.vibrator](reference/apis-sensor-service-kit/js-apis-vibrator.md) 2792 2793 * 计时器模块 2794 * 使用SlotType方法获取对应的系统能力内容类型，addNotificationSlot方法添加一个NotificationSlot，ReminderRequestTimer方法获取倒计时实例对象，用于设置提醒的时间，ReminderType方法设置提醒的类型，ActionButtonType方法设置按钮的类型，VibratorStopMode方法停止的振动。 2795 * 接口参考：[@ohos.notification](reference/apis-notification-kit/js-apis-notification.md)，[@ohos.reminderAgent](reference/apis-backgroundtasks-kit/js-apis-reminderAgent.md)，[@ohos.vibrator](reference/apis-sensor-service-kit/js-apis-vibrator.md) 2796 2797##### 约束与限制 2798 2799开发语言：ArkTS 2800 2801配套版本：API9版本SDK，版本号：3.2.11.9 2802 2803[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/TaskManagement/ReminderAgentManager) 2804 2805#### 短时任务 2806 2807##### 介绍 2808 2809本示例主要展示后台任务中的短时任务。 2810 2811通过[@ohos.resourceschedule.backgroundTaskManager](reference/apis-backgroundtasks-kit/js-apis-resourceschedule-backgroundTaskManager.md) ，[@ohos.app.ability.quickFixManager](reference/apis-ability-kit/js-apis-app-ability-quickFixManager-sys.md) 等接口实现应用热更新的方式去展现短时任务机制。 2812 2813##### 使用 2814 28151.安装本应用之前，先编译好未签名的应用包，然后在终端执行工程里的脚本b_sign_hap_release.bat去生成签名的应用包，再将此签名应用包进行安装即可； 2816 28172.进入应用，点击检查更新按钮，点击弹出框更新按钮会进行下载补丁包； 2818 28193.将应用退出到后台后关闭； 2820 28214.再次进入应用，页面版本信息由3.1.7.5更新为3.2.8.3； 2822 2823##### 基本原理 2824 2825* 该示例使用cancelSuspendDelay方法取消延迟挂起，applyQuickFix方法快速修复补丁，createHttp方法创建一个HTTP请求，openSync方法同步打开文件，writeSync方法同步将数据写入文件，closeSync方法同步关闭文件流等接口实现应用热更新的方式去展现短时任务机制。 2826 2827* 接口参考：[@ohos.backgroundTaskManager](reference/apis-backgroundtasks-kit/js-apis-backgroundTaskManager.md)，[@ohos.app.ability.quickFixManager](reference/apis-ability-kit/js-apis-app-ability-quickFixManager-sys.md)，[@ohos.net.http](reference/apis-network-kit/js-apis-http.md)，[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md) 2828 2829##### 约束与限制 2830 2831开发语言：ArkTS 2832 2833配套版本：API9版本SDK，版本号：3.2.11.9 2834 2835[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/TaskManagement/TransientTask) 2836 2837#### 任务延时调度 2838 2839##### 介绍 2840 2841本示例使用[@ohos.WorkSchedulerExtensionAbility](reference/apis-backgroundtasks-kit/js-apis-WorkSchedulerExtensionAbility.md) 、[@ohos.net.http](reference/apis-network-kit/js-apis-http.md) 、[@ohos.notification](reference/apis-notification-kit/js-apis-notification.md) 、[@ohos.bundle](reference/apis-ability-kit/js-apis-Bundle.md) 、[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md) 等接口，实现了设置后台任务、下载更新包 、保存更新包、发送通知 、安装更新包实现升级的功能。 2842 2843##### 使用 2844 28451. 安装本应用之前，先编译好未签名的应用包，然后在终端执行工程里的脚本，目录为：WorkScheduler/signTool/b_sign_hap_release.bat； 28462. 未连接wifi状态下进入应用； 28473. 进入首页后连接wifi； 28484. 后台判断版本号后会下载新的升级包，并在页面中给出弹窗询问是否安装，点击“确定”按钮； 28495. 应用会安装已经下载的升级包，实现版本更新，安装后会回到设备桌面，此时点击应用图标，可以看到版本已经是新版本了。 28506. 运行自动化测试用例时，必须使用命令行装包，不能使用ide自动装包，安装自动化测试包之前，先编译好未签名的测试包， 2851然后在终端执行工程里的脚本，目录为：WorkScheduler/signTool/a_sign_hap_release.bat； 28527. 运行自动化测试应用时需要使用如下命令： 2853``` 2854hdc shell aa test -b ohos.samples.workschedulerextensionability -m entry_test -s unittest OpenHarmonyTestRunner -s class ActsAbilityTest -s timeout 150000 2855``` 2856 2857##### 基本原理 2858 2859* 设置延时任务、下载更新包、保存更新包、发送通知、安装更新包的功能接口都封装在WorkSchedulerSystem中 2860 * 设置延时任务：在运行示例时会通过WorkSchedulerSystem.startUpdateSample()方法调用workScheduler.startWork()建立任务； 2861 * 下载更新包：当任务条件满足后，会通过WorkSchedulerSystem.getNewHap()方法调用http.createHttp().request()接口下载需要的文件； 2862 * 保存更新包：通过WorkSchedulerSystem.saveFile()来实现，受限调用fileio.openSync()创建文件，然后调用fileio.writeSync()将下载的内容写入指定文件内； 2863 * 发送通知：通过WorkSchedulerSystem.publishNotification()方法，调用Notification.publish()接口发送指定内容的信息； 2864 * 接收通知：通过WorkSchedulerSystem.handleNotification()方法调用Notification.subscribe()接口获取信息，根据信息内容决定是否提示用户升级； 2865 * 安装更新包：通过WorkSchedulerSystem.installBundle()方法实现，首先调用bundle.getBundleInstaller()获取Installer对象，然后调用bundleInstall.install()接口实现装包，完成升级。 2866 2867##### 约束与限制 2868 2869开发语言：ArkTS 2870 2871配套版本：API9版本SDK，版本号：3.2.12.5 2872 2873[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/TaskManagement/WorkScheduler) 2874 2875### 电话服务 2876 2877#### 拨打电话 2878 2879##### 介绍 2880 2881本示例使用[call](reference/apis-telephony-kit/js-apis-call.md)相关接口实现了拨打电话并显示电话相关信息的功能。主要展示拨打电话功能，dial方法拨打电话，可设置通话参数，hasCall方法判断是否存在通话，getCallState方法获取当前通话状态，isEmergencyPhoneNumber方法判断是否是紧急电话号码，formatPhoneNumber方法格式化电话号码，formatPhoneNumberToE164方法将电话号码格式化为E.164表示形式。 2882 2883##### 使用 2884 28851.输入电话号码后，点击**电话**按钮，进行拨打电话。 2886 28872.拨打电话后文本框会显示拨打是否成功，是否存在通话，通话状态，是否紧急号码，格式化后的电话号码。 2888 2889##### 基本原理 2890 2891* 该示例展示拨打电话功能，dial方法拨打电话，可设置通话参数，hasCall方法判断是否存在通话，getCallState方法获取当前通话状态，isEmergencyPhoneNumber方法判断是否是紧急电话号码，formatPhoneNumber方法格式化电话号码，formatPhoneNumberToE164方法将电话号码格式化为E.164表示形式。 2892* 接口参考：[@ohos.telephony.call](reference/apis-telephony-kit/js-apis-call.md) 2893 2894##### 约束与限制 2895 2896开发语言：ArkTS 2897 2898配套版本：API9版本SDK，版本号：3.2.11.9 2899 2900[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Telephony/Call) 2901 2902#### 联系人 2903 2904##### 介绍 2905 2906本示例使用[@ohos.contact](reference/apis-contacts-kit/js-apis-contact.md) 接口，实现了对联系人的增删查改功能。 2907 2908##### 使用 2909 29101.点击 **+** 按钮，跳转添加联系人界面，输入联系人信息，点击 **√**，确认添加联系人，并返回首页； 29112.点击联系人列表跳转页面查看详细信息，并且可以编辑或删除联系人信息； 29123.在搜索栏输入号码或邮箱可查询对应的联系人。 2913 2914##### 基本原理 2915 2916* 本示例的主要逻辑功能和源码在下列相关类中： 2917 * 查询所有联系人：调用contact.queryContacts()查询所有的联系人； 2918 * 新建联系人：检验数据格式后通过contact.addContact()创建新的联系人； 2919 * 搜索联系人：调用contact.queryContactsByPhoneNumber()通过电话号码查询联系人或者调用contact.queryContactsByEmail()通过邮箱查询联系人； 2920 * 删除联系人：调用contact.deleteContact()删除指定的联系人； 2921 * 修改联系人：页面调用contact.updateContact()。 2922 2923##### 约束与限制 2924 2925开发语言：ArkTS 2926 2927配套版本：API9版本SDK，版本号：3.2.11.9 2928 2929[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/Contact) 2930 2931#### 短信服务 2932 2933##### 介绍 2934 2935本示例使用[@ohos.telephony.sms](reference/apis-telephony-kit/js-apis-sms.md) 接口展示了电话服务中发送短信的功能。 2936 2937##### 使用 2938 29391. 首页点击**创建联系人**，弹框输入联系人姓名和电话，点击确定按钮后，联系人列表中添加该联系人; 29402. 点击**管理**，该按钮变成**取消**，联系人列表出现删除x按钮，点击x按钮可删除联系人，点击**取消**，按钮变成**管理**; 29413. 联系人列表中每个联系人右侧有**发送短信**图标按钮，点击该图标按钮跳转到发送短信页面; 29424. 发送短信页面，输入短信点击向上箭头的**发送**按钮，可以发送短信; 29435. 需授予短信发送权限且插入SIM卡才可成功发送短信，有预置短信内容，每次退出应用数据会清空，未添加存储功能，发送短信为默认卡发送。 2944 2945##### 基本原理 2946 2947+ 发送短信功能在SmsModel中: 2948 + 发送短信：发送短信首先需要使用createMessage方法创建短信实例，然后获取基本参数，getDefaultSmsSlotId可以获取发短信默认卡槽id，getSmscAddr获取短信发送地址，然后调用sms.sendMessage方法发送短信。 2949 2950##### 约束与限制 2951 2952开发语言：ArkTS 2953 2954配套版本：API9版本SDK，版本号：3.2.11.9 2955 2956[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Telephony/Message) 2957 2958#### 蜂窝数据 2959 2960##### 介绍 2961 2962本示例使用 [SystemCapability.Telephony.CellularData系统能力](reference/apis-telephony-kit/js-apis-telephony-data.md) 获取SIM卡信息及网络信息。使用 [@Builder](quick-start/arkts-builder.md) 在一个自定义组件内快速生成多个布局内容。通过获取SIM卡相关信息，展示打开本应用时网络信息。 2963 2964##### 使用 2965 29661.默认移动数据的SIM卡背景色显示为蓝色。 29672.若已经开启移动数据，则显示开启，否则显示为关闭。 29683.若已经开启漫游服务，则显示开启，否则显示为关闭。 29694.显示打开本应用时数据流类型及连接状态。 2970 2971##### 基本原理 2972 2973* 该示例使用蜂窝数据接口，getDefaultCellularDataSlotId方法获取默认移动数据的SIM卡，isCellularDataEnabled方法检查蜂窝数据业务是否启用，isCellularDataRoamingEnabled方法检查蜂窝数据业务是否启用漫游，getCellularDataFlowType方法获取蜂窝数据业务的上下行状态，getCellularDataState方法获取分组交换域（PS域）的连接状态等方法获取SIM卡相关信息，展示打开本应用时网络信息。 2974* 接口参考：[@ohos.telephony.data](reference/apis-telephony-kit/js-apis-telephony-data.md) 2975 2976##### 约束与限制 2977 2978开发语言：ArkTS 2979 2980配套版本：API9版本SDK，版本号：3.2.11.9 2981 2982[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/MobileNetwork) 2983 2984#### 事件订阅 2985 2986##### 介绍 2987 2988本示例通过[@ohos.telephony.radio](reference/apis-telephony-kit/js-apis-radio.md)，[@ohos.telephony.call](reference/apis-telephony-kit/js-apis-call.md)，[@ohos.telephony.data](reference/apis-telephony-kit/js-apis-telephony-data.md)，[@ohos.telephony.observer](reference/apis-telephony-kit/js-apis-observer.md)订阅网络状态、信号状态、通话状态、蜂窝数据、sim状态等事件，并获取状态变化返回的结果。 2989 2990##### 使用 2991 29921.打开应用，开启所有订阅事件开关。 29932.开关一次网络，触发网络状态变化。 29943.拨打一次电话，触发通话状态变化。 29954.插拔一次sim卡，触发sim卡状态变化和信号状态变化。 29965.点击**查看详情**按钮，跳转详情页，显示监听到的数据结果。 2997 2998##### 基本原理 2999 3000* 该示例使用NetworkState方法获取网络注册状态，SignalInformation方法获取网络信号强度信息，RadioTechnology方法获取无线接入技术，CallState方法获取通话状态码，DataConnectState方法描述蜂窝数据链路连接状态，DataFlowType方法描述蜂窝数据流类型，SimStateData方法获取SIM卡类型和状态等方法提供订阅管理功能。 3001* 接口参考：[@ohos.telephony.radio](reference/apis-telephony-kit/js-apis-radio.md)，[@ohos.telephony.call](reference/apis-telephony-kit/js-apis-call.md)，[@ohos.telephony.data](reference/apis-telephony-kit/js-apis-telephony-data.md)，[@ohos.telephony.observer](reference/apis-telephony-kit/js-apis-observer.md) 3002 3003##### 约束与限制 3004 3005开发语言：ArkTS 3006 3007配套版本：API9版本SDK，版本号：3.2.11.9 3008 3009[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/Observer) 3010 3011#### 网络搜索 3012 3013##### 介绍 3014 3015本示例通过[@ohos.telephony.sim](reference/apis-telephony-kit/js-apis-sim.md) 、[@ohos.telephony.radio](reference/apis-telephony-kit/js-apis-radio.md) 等接口来展示电话服务中网络搜索功能，包含无线接入技术、网络状态、选网模式、ISO国家码、信号强度信息列表及Radio是否打开。 3016 3017##### 使用 3018 30191.点击**SIM1 status**，弹出面板显示卡1的无线接入技术、注册网络信号强度信息列表、选网模式、ISO国家码， 3020再次点击面板消失， 点击**SIM2 status**显示同理； 30212.**NetworkState**显示网络状态相关信息； 30223.**IsRadioOn**显示Radio是否打开，true为打开，false为关闭。 3023 3024##### 基本原理 3025 3026* 网络搜索功能的实现主要封装在RadioStatus: 3027 * 获取网络状态以及服务商名称：打开应用触发RadioStatus中的getNetworkState()函数调用radio.getNetworkState()方法来获取网络状态，getRadioOn()函数调用radio.isRadioOn()方法判断指定卡槽位的Radio是否打开，RadioStatus中的getSimSpn()函数调用sim.getSimSpn(slotId)方法来获取指定卡槽SIM卡的服务提供商名称（Service Provider Name，SPN）。 3028 * 显示SIM卡信息：点击SIM status，弹出面板显示卡1的无线接入技术、注册网络信号强度信息列表、选网模式、ISO国家码。 3029 * 获取无线接入技术：RadioStatus中的getRadioTech(this.slotId)函数来调用radio.getRadioTech(slotId)方法来获取当前接入的CS域和PS域无线接入技术， 3030 * 获取指定SIM卡网络强度信息：getSignalInformation(this.slotId)函数来调用radio.getSignalInformation(slotId)方法来获取指定SIM卡槽对应的注册网络信号强度信息列表。 3031 * 获取选网模式：getNetworkSelectionMode(this.slotId)函数来调用radio.getNetworkSelectionMode(slotId)方法来获取当前选网模式。 3032 * 获取ISO国家码：getISOCountryCodeForNetwork(this.slotId)函数来调用radio.getISOCountryCodeForNetwork(slotId)方法来获取注册网络所在国家的ISO国家码。 3033 3034##### 约束与限制 3035 3036开发语言：ArkTS 3037 3038配套版本：API9版本SDK，版本号：3.2.11.9 3039 3040[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/RadioTech) 3041 3042#### SIM卡管理 3043 3044##### 介绍 3045 3046本示例使用[sim](reference/apis-telephony-kit/js-apis-sim.md)相关接口，展示了电话服务中SIM卡相关功能，包含SIM卡的服务提供商、ISO国家码、归属PLMN号信息，以及默认语音卡功能。 3047 3048##### 使用 3049 30501.若SIM卡槽1插入SIM卡则SIM卡1区域显示为蓝色，否则默认为白色。 30512.点击SIM卡1区域，弹窗显示SIM卡1的相关信息，再次点击面板消失。 30523.默认拨号的SIM卡其按钮背景色为蓝色，目前只展示默认拨号的SIM卡，更改默认拨号卡功能暂不支持。 30534.呼叫转移界面功能暂不支持，故点击按钮无实际操作。 3054 3055##### 基本原理 3056 3057* 该示例主要通过hasSimCard方法获取指定卡槽SIM卡是否插卡，getSimState方法获取指定卡槽的SIM卡状态，SimState方法判断SIM卡状态，isSimActive方法获取指定卡槽SIM卡是否激活，getSimSpn方法获取指定卡槽SIM卡的服务提供商名称，getISOCountryCodeForSim方法获取指定卡槽SIM卡的ISO国家码，getSimOperatorNumeric方法获取指定卡槽SIM卡的归属PLMN号，getDefaultVoiceSlotId方法获取默认语音业务的卡槽ID等开发电话服务的相关功能。 3058* 接口参考：[@ohos.telephony.sim](reference/apis-telephony-kit/js-apis-sim.md) 3059 3060##### 约束与限制 3061 3062开发语言：ArkTS 3063 3064配套版本：API9版本SDK，版本号：3.2.11.9 3065 3066[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Telephony/SimManager) 3067 3068### Web 3069 3070#### 浏览器 3071 3072##### 介绍 3073 3074本示例使用[@ohos.systemparameter](reference/apis-basic-services-kit/js-apis-system-parameter-sys.md)接口和[Web组件](reference/apis-arkweb/ts-basic-components-web.md)展示了一个浏览器的基本功能,展示网页，根据页面历史栈前进回退等。 3075 3076##### 使用 3077 30781. 连接Wifi，启动应用，展示默认页面内容; 30792. 点击默认页面的图标跳转到对应网页，或者在输入框输入网址，点击右侧跳转按钮跳转到对应网页; 30803. 点击输入框左侧向右向左按钮进行页面的前进后退; 30814. 点击主页图标回到主页，点击加号按钮新建一个页面。 3082 3083##### 基本原理 3084 3085+ Web展示与历史栈操作功能在Browser中: 3086 + 加载网页及刷新：使用WebController提供的loadUrl可以加载目标网址内容，使用refresh方法刷新页面; 3087 + 页面前进后退功能：页面在前进或者后退前使用accessForward/accessBackward查询是否有历史记录,然后调用forward/backward进行前进/后退操作。 3088 3089##### 约束与限制 3090 3091开发语言：ArkTS 3092 3093配套版本：API9版本SDK，版本号：3.2.11.9 3094 3095[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Web/Browser) 3096 3097#### JS注入与执行 3098 3099##### 介绍 3100 3101本示例基于H5游戏，通过arkui的[Button](reference/apis-arkui/arkui-ts/ts-basic-components-button.md)实现对游戏实现基本控制，展示[@ohos.web.webview](reference/apis-arkweb/js-apis-webview.md)的JS注入与执行能力，及native应用与H5的通信能力。 3102 3103##### 使用 3104 31051. 设备连接热点，可访问互联网。 31062. 打开应用，通过界面中按钮进行游戏控制。 3107 3108##### 基本原理 3109 3110* 本示例分成一个模块 3111 * 通过button实现对游戏的基本控制，WebviewController方法控制Web组件各种行为，使用webview注入JS与执行能力。 3112 * 接口参考：[@ohos.window](reference/apis-arkui/js-apis-window.md)，[@ohos.web.webview](reference/apis-arkweb/js-apis-webview.md) 3113 3114##### 约束与限制 3115 3116开发语言：ArkTS 3117 3118配套版本：API9版本SDK，版本号：3.2.11.9 3119 3120[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Web/RunJsInWeb) 3121 3122### 窗口管理 3123 3124#### 窗口 3125 3126##### 介绍 3127 3128本实例使用[窗口管理](reference/apis-arkui/js-apis-window.md)，展示了在应用主窗口中创建和拉起子窗口，并对子窗口设置窗口相关属性，以及设置窗口规避区域、窗口沉浸式和小窗口等功能。 3129 3130##### 使用 3131 31321. 启动应用,首页展示窗口沉浸式以及设置状态栏和任务栏属性,点击窗口视频跳转到播放页。 31332. 点击视频屏幕可以拉起小窗口播放视频，小窗口可以拖拽，再次点击视频可以关闭小窗口。 31343. 点击全屏播放并切换窗口方向按钮可以全屏播放视频并且改变窗口方向。 31354. 点击视频屏幕拉起小窗口播放视频, 界面显示小窗口状态为“获焦状态”; 再次点击视频关闭小窗口, 界面显示小窗口状态为“失焦状态” 31365. 点击视频屏幕拉起小窗口视频，再点击小窗口中的“拉起悬浮应用”按钮，成功拉起WindowRatio悬浮应用 3137 3138##### 基本原理 3139 3140* 本示例主要分为三个模块 3141 * 首页入口模块 3142 * 使用WindowStage实例化一个窗口，引入WindowManger方法设置一个主窗口与子窗口 3143 * 接口参考：[@ohos.window](reference/apis-arkui/js-apis-window.md)，[@ohos.events.emitter](reference/apis-basic-services-kit/js-apis-emitter.md)，[@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md)，[@ohos.router](reference/apis-arkui/js-apis-router.md) 3144 3145 * 窗口视频模块 3146 * 这里用到依赖window-components中WindowComponent方法来进行视频的播放 3147 3148 * 全屏播放窗口并切换窗口方向模块 3149 * 通过EventPriority方法表示事件被发送的优先级，emitter.emit方法发送指定的事件进行全屏播放和切换窗口方向 3150 * 参考接口：[@ohos.events.emitter](reference/apis-basic-services-kit/js-apis-emitter.md) 3151 3152##### 约束与限制 3153 3154开发语言：ArkTS 3155 3156配套版本：API10版本SDK，版本号：4.0.9.6 3157 3158[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/WindowManagement/WindowManage) 3159 3160#### 悬浮窗 3161 3162##### 介绍 3163 3164本示例使用[@ohos.window](reference/apis-arkui/js-apis-window.md)，主要展示了在子窗口中以悬浮窗模式拉起悬浮应用，并对新的应用设置窗口缩放比例，窗口以设置的比例进行缩放，并在界面显示窗口当前的宽度和高度。 3165 3166##### 使用 3167 31681. 安装[WindowRatio](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/WindowManagement/WindowRatio)工程hap包(即本示例)和[WindowManage](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/WindowManagement/WindowManage)工程hap包 31692. 打开WindowManage应用sample，点击**窗口预览**进入视频播放页面，点击主窗口后拉起子窗口。 31703. 点击**拉起悬浮应用**按钮后，将以悬浮窗模式拉起应用WindowRatio 。 31714. 点击悬浮应用中的下拉框，选择窗口缩放比例，点击**确定**按钮，以新的宽度/比例计算得到窗口宽高，监听到窗口缩放比例发生变化，窗口以设置的比例改变大小，窗口监听到大小发生变化，在页面上显示当前窗口的宽度和高度。另外，窗口不具备记忆之前位置大小的能力，当前sample所调用的接口展示结果不居中，若要使得窗口居中，则需调用resize接口指定成想要的大小。 3172 3173##### 基本原理 3174 3175- 设置窗口缩放比例的功能接口封装在Index: 3176 - 使用windows.setAspectRatio来设置窗口缩放比例; 3177- 设置以悬浮窗模式显示窗口和设置监听窗口大小接口的功能封装在MainAbility; 3178 - 使用windows.setWindowMode来设置窗口为悬浮窗模式; 3179 - 使用windows.on('windowSizeChange', (data))来监听窗口大小信息； 3180 3181##### 约束与限制 3182 3183开发语言：ArkTS 3184 3185配套版本：API10版本SDK，版本号：4.0.8.2 3186 3187[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/WindowManagement/WindowRatio) 3188 3189 3190 3191## 语言基础类库 3192 3193#### 多线程任务 3194 3195##### 介绍 3196 3197本示例通过[@ohos.taskpool](reference/apis-arkts/js-apis-taskpool.md) 和[@ohos.worker](reference/apis-arkts/js-apis-worker.md) 接口，展示了如何启动worker线程和taskpool线程。 3198 3199##### 使用 3200 32011. 在主界面，可以点击**字符串排序**和**拷贝文件**按钮进入对应的界面； 3202 32032. 点击**字符串排序**按钮进入多线程界面： 3204 3205 worker： 3206 3207 1. 选择**Worker**页签，输入待排序的字符串，并以逗号分割。 3208 3209 2. 点击**字符串排序**按钮，会将排序前的字符串发送给worker线程，在worker线程实现字符串排序，然后将排序后的字符串发送给主线程，主线程中显示排序后的字符串。 3210 3211 3. 点击**清除**按钮，清除字符串。 3212 3213 taskpool： 3214 3215 1. 选择**TaskPool**页签，输入待排序的字符串，并以逗号分割。 3216 3217 2. 选择**添加至任务组**按钮，将当前字符串的排序任务添加至任务组。 3218 3219 3. 点击**立即执行**按钮，如之前有添加至任务组操作则任务组执行完成后将排序后的字符串显示出来；如没有上述操作则执行当前任务完成，将排序后的字符串显示出来。 3220 3221 4. 点击**超时3s执行**按钮，任务延迟3s后执行，执行完成后将排序后的字符串显示出来。 3222 3223 5. 点击**函数任务**按钮，直接调用执行操作，执行完成后将排序后的字符串显示出来。需要注意的是，通过**函数任务**创建的task任务不支持取消。 3224 3225 6. 点击**取消任务**按钮，会取消最后一个未执行的task任务。需要注意的是，只有当任务数大于最大线程数且任务未开始执行时才可以取消成功。 3226 3227 7. 点击**清除**按钮，清除字符串。 3228 32293. 点击**拷贝文件**按钮进入文件拷贝界面： 3230 3231 选择需要拷贝的文件，然后点击**拷贝文件**按钮，文件拷贝成功，触发事件日志显示沙箱下文件个数以及显示部分拷贝成功的文件名。 3232 3233##### 基本原理 3234 3235* worker页签的实现在字符串排序页面调用: 3236 * 字符串排序：通过调用executeWorkerFunc()创建一个worker线程，把待排序字符串发送给worker线程，等worker线程排序完成后再把结果返回。 3237 * 清除：把字符串输入框和结果都清除。 3238 3239* taskpool页签的实现在字符串排序页面调用: 3240 * 立即执行：如没有添加至任务组操作，通过调用executeImmediately()创建一个task任务，这个任务是立即执行字符串排序；如先进行了添加至任务组操作，则通过调用executeImmediately()将任务组执行完毕。 3241 * 超时3s执行：通过调用executeDelay()创建一个task任务，这个任务是延迟3s后执行字符串排序。 3242 * 函数任务：调用executeFunc()接口，不创建task任务，直接调用taskpool.execute()执行字符串排序。 3243 * 取消任务：调用cancelTask()接口，取消最后一个未执行的task任务。 3244 * 清除：把字符串输入框和结果都清除。 3245 * 添加至任务组：调用addTask()接口，将当前任务添加至任务组。 3246 3247* 批量拷贝文件的功能封装在MyWorker: 3248 * 拷贝文件：调用MyWorker.WorkToCopyFiles()，在WorkToCopyFiles方法中向worker03线程发消息，并在worker03线程中批量拷贝，拷贝完成后将结果返回。 3249 3250##### 约束与限制 3251 3252开发语言：ArkTS 3253 3254配套版本：API9版本SDK，版本号：3.2.12.2 3255 3256[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/LaunguageBaseClassLibrary/ConcurrentModule) 3257 3258#### 语言基础类库 3259 3260##### 介绍 3261 3262本示例集合语言基础类库的各个子模块，展示了各个模块的基础功能，包含： 3263 3264- [@ohos.buffer (Buffer)](reference/apis-arkts/js-apis-buffer.md) 3265- [@ohos.convertxml (xml转换JavaScript)](reference/apis-arkts/js-apis-convertxml.md) 3266- [@ohos.process (获取进程相关的信息)](reference/apis-arkts/js-apis-process.md) 3267- [@ohos.taskpool (启动任务池)](reference/apis-arkts/js-apis-taskpool.md) 3268- [@ohos.uri (URI字符串解析)](reference/apis-arkts/js-apis-uri.md) 3269- [@ohos.url (URL字符串解析)](reference/apis-arkts/js-apis-url.md) 3270- [@ohos.util (util工具函数)](reference/apis-arkts/js-apis-util.md) 3271- [@ohos.util.ArrayList (线性容器ArrayList)](reference/apis-arkts/js-apis-arraylist.md) 3272- [@ohos.util.Deque (线性容器Deque)](reference/apis-arkts/js-apis-deque.md) 3273- [@ohos.util.HashMap (非线性容器HashMap)](reference/apis-arkts/js-apis-hashmap.md) 3274- [@ohos.util.HashSet (非线性容器HashSet)](reference/apis-arkts/js-apis-hashset.md) 3275- [@ohos.util.LightWeightMap (非线性容器LightWeightMap)](reference/apis-arkts/js-apis-lightweightmap.md) 3276- [@ohos.util.LightWeightSet (非线性容器LightWeightSet)](reference/apis-arkts/js-apis-lightweightset.md) 3277- [@ohos.util.LinkedList (线性容器LinkedList)](reference/apis-arkts/js-apis-linkedlist.md) 3278- [@ohos.util.List (线性容器List)](reference/apis-arkts/js-apis-list.md) 3279- [@ohos.util.PlainArray (非线性容器PlainArray)](reference/apis-arkts/js-apis-plainarray.md) 3280- [@ohos.util.Queue (线性容器Queue)](reference/apis-arkts/js-apis-queue.md) 3281- [@ohos.util.Stack (线性容器Stack)](reference/apis-arkts/js-apis-stack.md) 3282- [@ohos.util.TreeMap (非线性容器TreeMap)](reference/apis-arkts/js-apis-treemap.md) 3283- [@ohos.util.TreeSet (非线性容器TreeSet)](reference/apis-arkts/js-apis-treeset.md) 3284- [@ohos.util.Vector (线性容器Vector)](reference/apis-arkts/js-apis-vector.md) 3285- [@ohos.xml (xml解析与生成)](reference/apis-arkts/js-apis-xml.md) 3286 3287##### 使用 3288 32891. 首页展示语言基础类库各个子模块菜单，点击进入对应的模块页面。 32902. 各个子模块界面中点击功能按钮完成各个功能。 32913. Util中有二级菜单，点击进入对应的二级界面，包含： 3292 * StringCode：字符串编解码，点击功能按钮完成各个功能。 3293 * RationnalNumber：有理数比较，点击功能按钮完成各个功能。 3294 * LRUCache：LRU缓冲区，点击功能按钮完成各个功能。 3295 * ScopeHelper：范围判断，点击功能按钮完成各个功能。 3296 * Base64Helper：Base64编解码，点击功能按钮完成各个功能。 3297 * TypeCheck：类型检查，点击功能按钮完成各个功能。 32984. TaskPool界面中，点击Execute task执行任务，点击Cancel task取消任务。 32995. ArrayList界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 33006. Deque界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 33017. HashMap界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 33028. HashSet界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 33039. LightWeightMap界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 330410. LightWeightSet界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 330511. LinkedList界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 330612. List界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 330713. PlainArray界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 330814. Queue界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 330915. Stack界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 331016. TreeMap界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 331117. TreeSet界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 331218. Vector界面中，点击+号添加数据后展示数据，点击删除按钮删除对应的一条数据。 3313 3314##### 基本原理 3315 33161. 首页菜单展示：使用一个module，menuitems完成菜单组件的实现，传入要展示的菜单的strarray类型的资源和菜单点击对应的组件即可。使用Navigation和NavRouter组件实现菜单点击进入功能界面，使用LocalStorage实现应用内Ability内数据共享，点击菜单时标记selectedLabel，在entry中的Capabilities组件中，通过selectedLabel显示对应的功能组件。 33172. Xml & ConvertXml：使用[xml](reference/apis-arkts/js-apis-xml.md) 和[convertxml](reference/apis-arkts/js-apis-convertxml.md) 实现xml的解析和生成以及xml转换为js对象，点击按钮实现对应的功能。 33183. Process：使用[process](reference/apis-arkts/js-apis-process.md) 实现获取进程相关信息的功能，点击按钮实现对应的功能。 33194. TaskPool：使用[taskpool](reference/apis-arkts/js-apis-taskpool.md) 实现创建后台任务（Task），并对所创建的任务进行如任务执行、任务取消的操作。 33205. Url：使用[URL](reference/apis-arkts/js-apis-url.md) 对URL字符串的查找参数进行了增删改查的一系列操作，使得读者对URL的结构用途更加明了，点击按钮实现对应的功能。 33216. Util，使用util中不同的功能函数实现以下功能： 3322 * StringCode：字符串编解码。 3323 * RationnalNumber：有理数比较。 3324 * LRUCache：LRU缓冲区。 3325 * ScopeHelper：范围判断。 3326 * Base64Helper：Base64编解码。 3327 * TypeCheck：类型检查。 33287. ArrayList：展示线性容器ArrayList的数据类型的使用，包括添加、删除。 33298. Deque：展示线性容器Deque的数据类型的使用，包括头部插入、头部删除、尾部删除。 33309. HashMap：展示非线性容器HashMap的数据类型的使用，包括添加键值对、删除键值对。 333110. HashSet：展示非线性容器HashSet的数据类型的使用，包括添加、删除。 333211. LightWeightMap：展示非线性容器LightWeightMap的数据类型的使用，包括添加键值对、删除键值对。 333312. LightWeightSet：展示非线性容器LightWeightSet的数据类型的使用，包括添加、删除。 333413. LinkedList：展示线性容器LinkedList的数据类型的使用，包括尾部添加、头部删除、尾部删除。 333514. List：展示线性容器List的数据类型的使用，包括添加、删除。 333615. PlainArray：展示非线性容器PlainArray的数据类型的使用，包括添加、删除。 333716. Queue：展示线性容器Queue的数据类型的使用，包括尾部添加、头部删除。 333817. Stack：展示线性容器Stack的数据类型的使用，包括尾部添加、尾部删除。 333918. TreeMap：展示非线性容器TreeMap的数据类型的使用，包括添加键值对、删除键值对。 334019. TreeSet：展示非线性容器TreeSet的数据类型的使用，包括添加、删除。 334120. Vector：展示线性容器Vector的数据类型的使用，包括添加、删除。 3342 3343##### 约束与限制 3344 3345开发语言：ArkTS 3346 3347配套版本：API10版本SDK，版本号：4.0.8.3 3348 3349[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/LaunguageBaseClassLibrary/LanguageBaseClassLibrary) 3350 3351#### 压缩与解压 3352 3353##### 介绍 3354 3355本示例通过[@ohos.zlib](reference/apis-basic-services-kit/js-apis-zlib.md) 和[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md) 接口，实现添加文件、解压和压缩文件场景。 3356 3357##### 使用 3358 33591. 点击屏幕右上角 **+** 按钮，弹出创建文件窗口； 33602. 输入文件名称、文件内容，并点击 **确定** 按钮来创建文件； 33613. 文件创建成功后，文件名称自动追加.txt后缀并在主页面列表会显示，同时文件的物理地址为/data/app/el2/100/base/ohos.samples.ziplib/haps/entry/files/，点击 **压缩** 按钮，提示“文件压缩成功”，并会在文件列表创建一个相同名称的.zip文件； 33624. 点击压缩文件后的 **解压** 按钮，提示“文件解压成功”，并会再次在文件列表创建一个同名文件夹。 3363 3364##### 基本原理 3365 3366* 添加文件、解压和压缩文件的接口都在首页调用: 3367 * 添加文件：通过调用fileio.openSync()创建文件并调用fileio.writeSync()向文件中写入内容； 3368 * 压缩文件：通过调用zlib.zipFile()压缩文件； 3369 * 解压文件：通过zlib.unzipFile解压文件。 3370 3371##### 约束与限制 3372 3373开发语言：ArkTS 3374 3375配套版本：API9版本SDK，版本号：3.2.11.9 3376 3377[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/LaunguageBaseClassLibrary/ZipLib) 3378 3379 3380 3381## Performance 3382 3383### ArkRuntime 3384 3385#### N-Body模拟程序 3386 3387##### 介绍 3388 3389本示例使用[@ohos.taskpool](reference/apis-arkts/js-apis-taskpool.md)和[@ohos.worker](reference/apis-arkts/js-apis-worker.md) 接口，使用ArkTS编程语言开发了业界编程语言基准测试项目[Benchmarks Game](https://gitee.com/link?target=https%3A//salsa.debian.org/benchmarksgame-team/benchmarksgame)中的[N体问题模拟程序](https://gitee.com/link?target=https%3A//benchmarksgame-team.pages.debian.net/benchmarksgame/description/nbody.html%23nbody)，实现类木星体轨道计算。 3390 3391##### 使用 3392 33931.点击按钮Calculate By TaskPool，会从任务池创建一个任务，进行N-Body计算。 3394 33952.点击按钮Calculate By Worker，会创建一个Worker，进行N-Body计算。 3396 3397##### 基本原理 3398 3399- 使用TaskPool开启子线程运行，计算500万次时间推移天体运行轨道: 3400 - 通过调用computeNBodyByTaskPool()创建一个task任务，并向taskpool线程池派发子线程任务。 3401 - 等待子线程执行任务computeTask()，计算完成后再把结果返回主线程。 3402- 使用Worker开启子线程运行，计算5000万次时间推计算移天体运行轨道 3403 - 通过调用computeNBodyByWorker()创建一个worker线程，把要计算的时间推移量发送给worker线程。 3404 - 等待worker线程调用computeTask()计算完成后再把结果返回主线程。 3405- computeTask()完成具体计算任务 3406 - offsetMomentum() 建立孤立系统的动量守恒。 3407 - advance() 更新天体在按指定的时间变化后的位置信息。 3408 - energy() 判断系统计算前后机械能守恒。 3409 3410##### 约束与限制 3411 3412开发语言：ArkTS 3413 3414配套版本：API10版本SDK，版本号：4.0.9.6 3415 3416[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Performance/ArkRuntime/NBody) 3417 3418#### 性能示例 3419 3420##### 介绍 3421 3422本示例集成了条件渲染、动态加载以及HiDumper等场景来介绍如何提升应用性能。 3423 3424##### 使用 3425 34261. 点击性能示例主页的**HiDumper**按钮，进入**HiDumper查看组件信息**场景页。 3427 34282. 点击HiDumper查看组件信息场景页的**查看应用组件树**进入场景页。 3429 34303. 点击HiDumper查看组件信息场景页的**查看if/else组件**按钮，在场景中点击**显隐切换**按钮，查看图片显示隐藏。 3431 34324. 点击HiDumper查看组件信息场景页的**查看visibility属性**按钮，在场景中依次点击**Visible**、**Hidden**、**Visible**、**None**，查看图片显示和隐藏。 3433 3434##### 基本原理 3435 3436* HiDumper场景模块 3437 3438 * 查看应用组件树 3439 * 在页面上添加Grid，每个GridItem嵌套多个Stack，然后通过HiDumper抓取组件树信息。 3440 3441 * 查看if/else组件 3442 * 在页面上添加**显隐切换**按钮，添加一张图片，点击按钮后通过HiDumper抓取组件树信息。 3443 3444 * 查看visibility属性 3445 * 在页面上添加**Visible**、**Hidden**、**None**按钮，添加一张图片，点击按钮后通过HiDumper抓取组件树信息。 3446 3447* Navigation常规加载页面模块 3448 3449 * 在Navigation组件加载内容页时，使用`import`常规加载子页面。 3450 3451* Navigation动态加载页面模块 3452 3453 * 在Navigation组件加载内容页时，使用`await import`实现动态按需加载。 3454 3455##### 约束与限制 3456 3457开发语言：ArkTS 3458 3459配套版本：API10版本SDK，版本号：4.0.9.6 3460 3461[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Performance/PerformanceLibrary) 3462 3463#### 性能示例（renderGroup接口） 3464 3465##### 介绍 3466 3467本示例使用renderGroup接口实现了在单一页面上存在大量应用动效的组件时，使用renderGroup方法来解决卡顿问题，从而提升绘制能力。 3468 3469##### 使用 3470 34711. 点击性能示例主页面的**RenderGroup**按钮，在场景界面中点击**正例场景示例**，进入正例场景页，可以点击renderGroup开关按钮，可以通过Profiler分析性能数据。 3472 34732. 点击性能示例主页面的**RenderGroup**按钮，在场景界面中点击**反例场景示例**，进入反例场景页，可以点击renderGroup开关按钮，可以通过Profiler分析性能数据。 3474 3475##### 基本原理 3476 3477首次绘制组件时，若组件被标记为启用renderGroup状态，将对组件和其子组件进行离屏绘制，将绘制结果进行缓存。以后当需要重新绘制组件时，就会优先使用缓存而不必重新绘制了，从而降低绘制负载，优化渲染性能。 3478* 本示例分成正例场景与反例场景两个模块 3479 3480 * 正例场景 3481 3482 * 在ProfitScene的IconItem上添加动画，在IconView上使用到renderGroup接口(renderGroup(value: boolean): T)得到收益。 3483 3484 * 反例场景 3485 3486 * 在IconView的Image上添加动画，在NonIconView上使用到renderGroup接口(renderGroup(value: boolean): T)得到负收益。 3487 3488##### 约束与限制 3489 3490开发语言：ArkTS 3491 3492配套版本：API10版本SDK，版本号：4.0.9.6 3493 3494[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Performance/renderGroup) 3495 3496## 工程 3497 3498### 应用程序包 3499 3500#### 多HAP 3501 3502##### 介绍 3503 3504本示例使用应用上下文Context接口 [@ohos.app.ability.common](reference/apis-ability-kit/js-apis-app-ability-common.md)和媒体服务接口[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)，展示多HAP开发，简单介绍了多HAP的使用场景，应用包含了一个entry HAP和两个feature HAP，两个feature HAP分别提供了音频和视频播放组件，entry中使用了音频和视频播放组件。 三个模块需要安装三个hap包，最终会在设备上安装一个主entry的hap包。 3505 3506##### 使用 3507 35081.第一步：选择entry模块，运行生成entry模块的hap包 3509 35102.第二步：安装audioFeature和videoFeature的hap包：打开cmd执行hdc install hdc-path。例如audioFeature模块中hdc-path为：绝对路径/audioFeature/build/default/outputs/default/entry/audioFeature-entry-default-signed.hap 3511 35123.第三步：安装完三个模块hap包后重新运行entry模块 3513 35144.第四步：安装应用，点击桌面MultiHap图标，进入应用：点击audio，进入audio播放页面，点击PlayAudio按钮，播放音频 3515 35165.第五步：点击video，进入video播放页面，可点击播放按钮播放视频 3517 3518##### 基本原理 3519 3520* 新创建两个Module作为将被跳转的hap，分别命名为videoFeature，audioFeature。 3521 * 配置每个hap的type：把entry文件夹下的module.json5中"type": "entry",videoFeature和audioFeature文件夹下的module.json5中"type": "feature"； 3522 * 使用Want跳转到其他的Ability：在entry模块的index.ets中通过common.UIAbilityContext()配置Want，作为多hap间信息传递的载体，用于应用组件间的信息传递； 3523 * want的配置：通过指定bundleName和abilityName可以唯一确定一个Ability。 3524 * 新hap的跳转：在entry模块index.ets首页中，在按钮.onclick()事件内，通过Want配置显式拉起一个新的指定的Ability。 3525 3526##### 约束与限制 3527 3528开发语言：ArkTS 3529 3530配套版本：API9版本SDK，版本号：3.2.11.9 3531 3532[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Project/ApplicationHap/MultiHap) 3533 3534### 资源配置 3535 3536#### 应用主题切换 3537 3538##### 介绍 3539 3540本示例使用[@ohos.application.abilityManager](reference/apis-ability-kit/js-apis-application-abilityManager-sys.md) 能力，对Ability状态进行修改：其中AbilityManager.updateConfiguration()通过修改colorMode属性来更新配置系统主题颜色，展示多种应用主题切换。通过创建 base 同级资源文件夹 dark 和 light 完成深色浅色主题相关资源配置，实现深色浅色主题切换，在 ThemeConst 文件中配置自定义主题文件，通过控制变量实现多主题切换。 3541 3542##### 使用 3543 35441. 点击头部切换主题按钮，选择想要切换的主题。 35452. 系统深浅模式切换，应用主题自动跟随切换深浅模式。 3546 3547##### 基本原理 3548 3549* 三种模式资源统一放在ThemeConst内，在ThemeGet中定义全局变量theme控制主题模式(0:黑夜 1：白天 3：自定义主题)，步骤如下， 3550 * 1）整理主题资源：例如创建系统主题dark,light和自定义主题custom相关目录，并完善需要切换的资源比如icon、color等，系统主题下的相同资源，资源名称必须相同，比如dark下title.icon和light下title.icon 3551 * 2）定义资源池函数引用需要切换的主题资源，需要主题切换的资源通过getTheme(this.theme).资源名，实现组件对资源的动态引用和动态渲染。 3552 * 3）定义全局变量@storagelink('theme') 3553 * 4）定义事件修改变量theme的值，如果是系统主题（dark，light），调用AbilityManager.updateConfiguration()，通过修改colorMode属性来更新配置系统主题颜色（0：深夜 1：白天） 3554 * 5）自定义主题无须修改系统配置，只需修改theme全局变量的值，全局变量会通过@storagelink双向绑定机制，自动重新渲染绑定了theme值的组件 3555 3556##### 约束与限制 3557 3558开发语言：ArkTS 3559 3560配套版本：API9版本SDK，版本号：3.2.12.5 3561 3562[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ResourceAllocation/ApplicationThemeSwitch) 3563 3564### 测试框架 3565 3566##### 介绍 3567 3568本示例展示[测试框架](https://gitee.com/openharmony/testfwk_arkxtest)的使用示例，主要介绍了 jsunit单元测试框架和uitestUI测试框架的使用示例。 3569 3570##### 使用 3571 3572- 将jsunit或uitest目录下的项目工程整体导入到DevEco Studio开发工具中。 3573- 查看ohostest目录下的测试代码实现。 3574- 在DevEco Studio中执行测试用例代码查看执行效果，执行方式请[参考](https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ohos-openharmony-test-framework-0000001263160453)。 3575 3576##### 基本原理 3577 35781. jsunit单元测试框架示例内容 35792. uitestUI测试框架示例内容 3580 3581##### 约束与限制 3582 3583开发语言：ArkTS 3584 3585配套版本：API9版本SDK，版本号：3.2.11.9 3586 3587[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Project/Test) 3588 3589### 流水线预测试工具 3590 3591##### 介绍 3592 3593本示例主要展示了流水线预测试工具的使用示例，主要介绍了自动化构建及测试的实现原理。 3594 3595##### 使用 3596 35971. 打开浏览器访问127.0.0.1:3000/swagger。 3598 35992. 在`/sn`下点击`Try it out`，再点击`Execute`，即可获得`/sn`接口返回的连接开发板的sn号。 3600 36013. 在`/hap-build/{PRId}`下点击`Try it out`，输入想要构建、测试的PRId，再点击`Execute`等待构建、测试任务结束可以看到接口返回构建和测试的结果，同时在PR下方的评论区也会有评论。 3602 3603##### 基本原理 3604 36051. 执行hdc命令`hdc list targets`获取当前连接开发板sn号，[源码参考](https://gitee.com/openharmony/applications_app_samples/blob/master/code/Project/HapBuild/ci/src/app.controller.ts)。 3606 36072. 使用gitee官方web hook读取PR修改文件列表并将修改写入本地sample仓中，再根据修改文件路径找出对应的项目，使用[编译工具](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Project/HapBuild/compile-tool)中`compile-ohpm-ci.sh`脚本编译项目中的`entry`及`ohostest`包。 3608 36093. [InstallAndTestSpecial_ci.py](https://gitee.com/openharmony/applications_app_samples/blob/master/code/Project/HapBuild/test-tool/InstallAndTestSpecial_ci.py)脚本来安装entry包、ohosTest测试包以及拉起自动化测试用例。 3610 3611##### 约束与限制 3612 3613开发语言：TypeScript 3614 3615[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Project/HapBuild) 3616 3617## 行业解决方案 3618 3619### 游戏 3620 3621#### 分布式五子棋 3622 3623##### 介绍 3624 3625本示例使用使用分布式设备管理能力[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md)、分布式数据管理[@ohos.data.distributedData](reference/apis-arkdata/js-apis-distributed-data.md)等接口，结合[Canvas组件](reference/apis-arkui/arkui-ts/ts-components-canvas-canvas.md) 实现棋盘、棋子的绘制，使用[分布式数据管理](reference/apis-arkdata/js-apis-distributed-data.md) 实现两台设备间数据的同步。 3626 3627##### 使用 3628 36291.启动应用，同一个网络下两台设备都确认权限后，一台设备退出。点击右上角流转按钮，选择需要拉起的远程设备，点击后拉起远程设备，第一次拉起设备时，若未进行认证，输入认证码进行认证，认证成功后拉起远程设备。 3630 36312.游戏过程中，本地设备的用户可以重开，悔棋，远程设备无此功能。下子时，在棋盘某位置点击第一次时预下子，若确定下在该位置，继续点击该位置，若不确定，点击其他位置即可。若远程设备因特殊原因退出或者掉线，本地设备可重新拉起远程设备，拉起后，本地设备点击棋盘任意位置，数据会同步到远程设备，继续进行未完成的游戏。 3632 3633##### 基本原理 3634 3635* 管理分布式设备（节点） 3636 1、创建设备管理对象，并指定参数kvstore应用包deviceManager.createDeviceManager("ohos.samples.distributeddatagobang", (error, value) => {})。 3637 2、获取可信设备列表"this.deviceManager.getTrustedDeviceListSync()"。 3638 3、监听设备状态"this.deviceManager.on('deviceStateChange', (data) => {})"。 3639* 分布式数据管理 3640 1、页面初始化时获取此应用所需能力，引入@ohos.data.distributedData初始化分布式数据库，并使用kvstore.on对数据change进行监听，通过appstorge判断获取相应的key判断是否是分布式节点。 3641 2、如果是分布式节点，如果数据发生变化处理数据，使用this.kvManager.getKVStore()通过指定Options和storeId，创建并获取KVStore数据库。以及添加键值对到数据库this.kvStore.put(key, value)。 3642 3、页面通过kvStore对象进行增删改查会触发其他已连接设备的kvStore.on监听。 3643* 游戏规则编写 3644 1、init()函数初始化游戏规则，通过canvas组件绘制棋盘背景和棋子，游戏状态为开始，共计回合为0，并生成棋盘。 3645 2、触发onClick函数，每click一次，清除一次canvas，数组中添加当前棋子，重绘。 3646 3、当在A盘，且步长是偶数，表示B下的棋子会在A盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'A' && this.distributedData.step % 2 === 0; 3647 4、当在B盘，且步长是奇数，表示A下的棋子会在B盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'B' && this.distributedData.step % 2 !== 0; 3648 5、如果A盘重开(isRestart=true)，那B盘就要清空棋子;不重开(isRestart=false)时，B盘正常显示。 3649 3650##### 约束与限制 3651 3652开发语言：ArkTS 3653 3654配套版本：API9版本SDK，版本号：3.2.11.9 3655 3656[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Game/DistributedDataGobang) 3657 3658#### 游戏2048 3659 3660##### 介绍 3661 3662本示例使用用户首选项[ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md) 以及屏幕属性[@ohos.display](reference/apis-arkui/js-apis-display.md#displaygetdefaultdisplaydeprecated) 等接口，结合[Grid](reference/apis-arkui/arkui-ts/ts-container-grid.md)组件，实现了2048小游戏功能。 3663 3664##### 使用 3665 36661.启动应用，同一个网络下两台设备都确认权限后，一台设备退出。点击右上角流转按钮，选择需要拉起的远程设备，点击后拉起远程设备，第一次拉起设备时，若未进行认证，输入认证码进行认证，认证成功后拉起远程设备。 3667 36682.游戏过程中，本地设备的用户可以重开，悔棋，远程设备无此功能。下子时，在棋盘某位置点击第一次时预下子，若确定下在该位置，继续点击该位置，若不确定，点击其他位置即可。若远程设备因特殊原因退出或者掉线，本地设备可重新拉起远程设备，拉起后，本地设备点击棋盘任意位置，数据会同步到远程设备，继续进行未完成的游戏。 3669 3670##### 基本原理 3671 3672* 管理分布式设备（节点） 3673 1、创建设备管理对象，并指定参数kvstore应用包deviceManager.createDeviceManager("ohos.samples.distributeddatagobang", (error, value) => {})。 3674 2、获取可信设备列表"this.deviceManager.getTrustedDeviceListSync()"。 3675 3、监听设备状态"this.deviceManager.on('deviceStateChange', (data) => {})"。 3676* 分布式数据管理 3677 1、页面初始化时获取此应用所需能力，引入@ohos.data.distributedData初始化分布式数据库，并使用kvstore.on对数据change进行监听，通过appstorge判断获取相应的key判断是否是分布式节点。 3678 2、如果是分布式节点，如果数据发生变化处理数据，使用this.kvManager.getKVStore()通过指定Options和storeId，创建并获取KVStore数据库。以及添加键值对到数据库this.kvStore.put(key, value)。 3679 3、页面通过kvStore对象进行增删改查会触发其他已连接设备的kvStore.on监听。 3680* 游戏规则编写 3681 1、init()函数初始化游戏规则，通过canvas组件绘制棋盘背景和棋子，游戏状态为开始，共计回合为0，并生成棋盘。 3682 2、触发onClick函数，每click一次，清除一次canvas，数组中添加当前棋子，重绘。 3683 3、当在A盘，且步长是偶数，表示B下的棋子会在A盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'A' && this.distributedData.step % 2 === 0; 3684 4、当在B盘，且步长是奇数，表示A下的棋子会在B盘显示，绘制确定好的棋子，例如：this.deviceFlag === 'B' && this.distributedData.step % 2 !== 0; 3685 5、如果A盘重开(isRestart=true)，那B盘就要清空棋子;不重开(isRestart=false)时，B盘正常显示。 3686 3687##### 约束与限制 3688 3689开发语言：ArkTS 3690 3691配套版本：API9版本SDK，版本号：3.2.11.9 3692 3693[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Game/Game2048) 3694 3695#### Lottie动画 3696 3697##### 介绍 3698 3699本示例展示了lottie对动画的操作功能。引入[Lottie模块](https://gitee.com/openharmony-tpc/lottieETS)，实现控制动画的播放、暂停、倍速播放、播放顺序、播放到指定帧停止或从指定帧开始播放、侦听事件等功能，动画资源路径必须是json格式。 3700 3701##### 使用 3702 37031. 进入页面默认开始2016动画，点击**请选择**进行选择动画资源; 37042. 上面部分播放暂停是对两个动画进行控制，下面部分播放暂停功能是对grunt动画控制; 37053. 点击销毁动画功能之后需要重新选择动画资源才可以进行其余功能操作。 3706 3707##### 基本原理 3708 3709* 页面中使用了Lottie对象控制动画的一系列操作: 3710 * 初始化动画：在canvas的onReady里使用loadAnimation加载动画，须提前声明Animator(‘__lottie_ets’)对象，并在Canvas完成布局后调用； 3711 * Lottie动画操作：lottie.play播放动画，lottie.pause暂停播放，lottie.setDirection设置播放顺序 3712 3713##### 约束与限制 3714 3715开发语言：ArkTS 3716 3717配套版本：API9版本SDK，版本号：3.2.11.9 3718 3719[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Game/Lottie) 3720 3721### 即时通信 3722 3723#### 聊天实例应用 3724 3725##### 介绍 3726 3727本示例使用图片处理能力接口[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md)以及文件存储管理能力接口[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md) 。展示一个仿聊天类应用，使用静态布局搭建了不同的页面。为了优化内存与性能体验，在部分list场景使用了懒加载。 3728 3729##### 使用 3730 37311. 应用包含“聊天”、”通讯录“、”发现“、”我“四个主页面，使用Tabs组件实现模块的切换，“聊天”和“通讯录”模块使用了LazyForEach懒加载功能。 3732 37332. 二级及以上页面左上角都有一个返回按钮。 3734 37353. 聊天内容页面的下方输入框点击可以输入内容，表情的图标点击可以发送图片。 3736 37374. “发现”页面的“朋友圈”点击会进入“朋友圈”页面。 3738 3739##### 基本原理 3740 3741懒加载：开发框架提供数据懒加载（LazyForEach组件）从提供的数据源中按需迭代数据，并在每次迭代过程中创建相应的组件。 3742 3743多线程：开发框架提供[多线程并发能力](performance/multi_thread_capability.md)，允许在同一时间段内同时执行多段代码，进行大量或调度点较分散的任务开发和处理。 3744 3745##### 约束与限制 3746 3747开发语言：ArkTS 3748 3749配套版本：API10版本SDK，版本号：4.0.9.6 3750 3751[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/IM/Chat) 3752 3753### 输入法 3754 3755#### 自绘编辑框 3756 3757##### 介绍 3758 3759本示例通过输入法框架实现自绘编辑框，可以绑定输入法应用，从输入法应用输入内容，显示和隐藏输入法。 3760 3761##### 使用 3762 37631. 点击编辑框可以绑定并拉起输入法，可以从输入法键盘输入内容到编辑框。 3764 37652. 可以点击**attach**/**dettach**、**show**/**hide**、**on**/**off**按钮来绑定/解绑、显示/隐藏、开启监听/关闭监听。 3766 37673. 输入光标信息后点击**updateCursor**向输入法应用发送光标信息，发送成功会右toast提示。 3768 37694. 输入选中文本的开始和结束位置，点击**changeSelection**可以选中文本。 3770 37715. 选择文本输入类型和Enter键类型后，点击**updateAttribute**可以更新拉起的输入法的输入类型和Enter键类型，依赖输入法应用是否适配。 3772 3773##### 基本原理 3774 3775* 自绘编辑框 3776 * 使用输入法框架实现组件绑定输入法应用，监听输入法事件，显示和隐藏输入法，发送光标和编辑框属性到输入法应用功能。 3777 * 参考接口：[@ohos.inputMethod](reference/apis-ime-kit/js-apis-inputmethod.md) 3778 3779##### 约束与限制 3780 3781开发语言：ArkTS 3782 3783配套版本：API10版本SDK，版本号：4.0.7.2 3784 3785[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/InputMethod/CustomInputText) 3786 3787#### 轻量级输入法 3788 3789##### 介绍 3790 3791本示例使用@ohos.application.InputMethodExtensionAbility系统权限的系统接口，展示一个轻量级的输入法应用，支持在运行OpenHarmony OS的智能终端上。 3792 3793##### 使用 3794 37951. 点击编辑框可以绑定并拉起输入法，可以从输入法键盘输入内容到编辑框。 3796 3797##### 基本原理 3798 3799* 参考接口：@ohos.application.InputMethodExtensionAbility 3800 3801##### 约束与限制 3802 3803开发语言：ArkTS 3804 3805配套版本：API9版本SDK，版本号：3.2.12.5 3806 3807[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/InputMethod/KikaInput) 3808 3809#### Kika输入法应用 3810 3811##### 介绍 3812 3813本示例使用[inputMethodEngine](reference/apis-ime-kit/js-apis-inputmethodengine.md)实现一个轻量级输入法应用kikaInput，支持在运行OpenHarmony OS的智能终端上。 3814 3815##### 使用 3816 38171.使用hdc shell aa start ability -a InputMethod -b cn.openharmony.inputmethodchoosedialog命令拉起切换输入法弹窗，点击kikainput切换输入法到当前应用。 3818 38192.点击应用中的编辑框，拉起输入法键盘。 3820 38213.点击键盘可以在编辑框中输入内容，点击回退键可以删除文本。 3822 38234.点击左上角的键盘图标可以进入二级菜单，当前只有编辑菜单。 3824 38255.点击编辑可以进入编辑状态，点击方向键可以移动光标。 3826 38276.编辑状态点击选择按钮，进入选择状态，点击方向键可以选中文本。 3828 3829##### 基本原理 3830 3831* 该示例分为两个模块： 3832 * 键盘布局 3833 * 在Index中完成键盘的总体布局。在components中自定不同的按键组件。 3834 * 参考接口：[ArkTs声明式开发范式](ui/Readme-CN.md) 3835 * 输入法控制 3836 * 使用[@ohos.request](reference/apis-basic-services-kit/js-apis-request.md)中API 10接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，前台任务只支持单文件下载，后台任务支持多文件下载。使用[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md)完成指定路径的创建和查询已下载的文件。 3837 * 参考接口：[@ohos.inputMethodEngine](reference/apis-ime-kit/js-apis-inputmethodengine.md) 3838##### 约束与限制 3839 3840开发语言：ArkTS 3841 3842配套版本：API10版本SDK，版本号：4.0.7.2 3843 3844[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/InputMethod/KikaInputMethod) 3845 3846### 媒体 3847 3848#### 相机和媒体库 3849 3850##### 介绍 3851 3852本示例使用权限管理能力[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)、相机模块能力接口[@ohos.multimedia.camera](reference/apis-camera-kit/js-apis-camera.md)、图片处理接口[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md)、音视频相关媒体业务能力接口[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)、用户数据管理接口[@ohos.filemanagement.userFileManager](reference/apis-core-file-kit/js-apis-userFileManager-sys.md)、设备信息能力接口[@ohos.deviceInfo](reference/apis-basic-services-kit/js-apis-device-info.md)、文件存储管理能力接口[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md)、弹窗能力接口[@ohos.prompt](reference/apis-arkui/js-apis-prompt.md)，展示如何在eTS中调用相机拍照和录像，以及如何使用媒体库接口进行媒体文件的增、删、改、查操作。 3853 3854##### 使用 3855 38561.启动应用，在权限弹窗中授权后返回应用，首页显示当前设备的相册信息，首页监听相册变化会刷新相册列表。 3857 38582.点击 **+** 按钮，弹出相机、录音、文本文件三个图标。 3859 38603.点击**相机**图标，进入相机界面，默认是拍照模式，点击底部拍照按钮可以拍照，拍照完成会在底部左侧显示照片预览图。点击**录像**切换到录像模式，点击底部按钮开始录像，点击结束按钮结束录像，结束录像后底部左侧显示视频图标。点击系统**Back**键或界面顶部**返回**按钮返回首页。 3861 38624.点击**录音**图标进入录音界面，点击右侧**开始**按钮开始录音，按钮变为暂停按钮，点击可以暂停和继续录音，点击左侧**结束**按钮结束录音返回首页。 3863 38645.点击**文本**图标进入文本编辑界面，输入文本内容后点击**Save**按钮，会创建并写入文本文件，完成后返回首页。 3865 38666.点击相册进入文件列表界面，展示相册内的文件，列表中有**删除**和**重命名**按钮，点击可以删除文件和重命名文件。 3867 38687.安装视频播放VideoPlayer应用后，点击视频文件可以调起视频播放界面播放该视频。 3869 3870##### 基本原理 3871 3872* 布局原理：定义@ObjectLink 装饰的数组变量album存放资源文件，使用list()组件中ListItem()循环数组展示，加号Button()，点击后触发 animateTo({ duration: 500, curve: Curve.Ease })控制动画展示。 3873* 获取资源文件：通过引入媒体库实例（入口）接口@ohos.multimedia.medialibrary，例如通过this.getFileAssetsFromType(mediaLibrary.MediaType.FILE)获取FILE类型的文件资源，并通过albums.push()添加至album数组中。 3874* 展示系统资源文件：当album内的值被修改时，只会让用 @ObjectLink 装饰的变量album所在的组件被刷新，当前组件不会刷新。 3875* 录音功能：通过引入音视频接口@ohos.multimedia.media，例如通过media.createAudioRecorder()创建音频录制的实例来控制音频的录制，通过this.audioRecorder.on('prepare', () => {this.audioRecorder.start()})异步方式开始音频录制。 3876* 拍照录像功能：通过引入相机模块接口@ohos.multimedia.camera，例如通过this.cameraManager.createCaptureSession()创建相机入口的实例来控制拍照和录像，通过this.captureSession.start()开始会话工作。 3877 3878##### 约束与限制 3879 3880开发语言：ArkTS 3881 3882配套版本：API9版本SDK，版本号：3.2.11.9 3883 3884[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Media/MultiMedia) 3885 3886### 电商 3887 3888#### 购物示例应用 3889 3890##### 介绍 3891 3892本示例使用延迟任务回调能力接口[@ohos.WorkSchedulerExtensionAbility](reference/apis-backgroundtasks-kit/js-apis-WorkSchedulerExtensionAbility.md) 、通知管理的能力接口[@ohos.notification](reference/apis-notification-kit/js-apis-notification.md) 、HTTP数据请求能力接口[@ohos.net.http](reference/apis-network-kit/js-apis-http.md) 、媒体查询接口[@system.mediaquery](reference/apis-arkui/js-apis-system-mediaquery.md) 、管理窗口能力接口[@ohos.window](reference/apis-arkui/js-apis-window.md) 。实现在进场时加载进场动画，使用[Tabs容器](reference/apis-arkui/arkui-ts/ts-container-tabs.md) 实现通过页签进行内容视图切换。使用[自定义弹窗](reference/apis-arkui/arkui-ts/ts-methods-custom-dialog-box.md) 设置位置信息。使用[Swiper](reference/apis-arkui/arkui-ts/ts-container-swiper.md) 组件实现页面展示图轮播。使用[Grid](reference/apis-arkui/arkui-ts/ts-container-list.md) 容器组件设置展示的商品信息。 3893 3894##### 使用 3895 38961、启动应用进入进场动画，然后进入首页的时候会有升级弹窗的提示，判断应用需不需要升级，整个应用分四部分，首页、新品、购物车、我的。可以点击进行切换。 3897 38982、“首页”页面具有扫一扫功能、搜索框、轮播图、tabs、商品列表。 3899 39003、“首页”页面的扫一扫点击可以进行二维码扫描，点击商品可以跳转到详情页。 3901 39024、“商品详情页”上部分是视频，点击视频进行播放，也可以点击进入全屏模式，向下滑动详情页视频可以变成小窗口模式。点击右侧悬浮的直播按钮，可进入直播页面，直播页面可进行视频播放。 3903 39045.“商品详情页”有个分享功能，点击可进行分享。点击选择收货地址可弹出选择地址的选项，可进行选择地址。 3905 39066.断开网络链接，“商品详情页”中点击降价通知后，重新连接网络后通知栏有降价通知。 3907 39087.新品、购物车、我的目前是静态页面。 3909 3910##### 基本原理 3911 39121.应用创建时进行必要的权限判断：在app.json5文件中对```"requestPermission"```对象进行权限匹配。如果有如果权限列表中有-1，说明用户拒绝了授权。 3913 39142.配置Module信息 3915 39163.Navigation的使用 3917 39184.动态加载的使用 3919 39205.hsp包的创建与使用 3921 3922##### 约束与限制 3923 3924开发语言：ArkTS 3925 3926配套版本：API9版本SDK，版本号：3.2.11.9 3927 3928[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Shopping/OrangeShopping) 3929 3930### 工具 3931 3932#### ArkTS时钟 3933 3934##### 介绍 3935 3936本示例通过添加setInterval定时器启动时钟，使用[Canvas组件](reference/apis-arkui/arkui-ts/ts-components-canvas-canvas.md)绘制时钟，通过[CanvasRenderingContext2D](reference/apis-arkui/arkui-ts/ts-canvasrenderingcontext2d.md) 来画表盘背景、时针、分针、秒针、圆心以及表盘下方文本，结合[@ohos.display](reference/apis-arkui/js-apis-display.md) 接口来实现一个简单的时钟应用。 3937 3938##### 使用 3939 39401.界面通过setInterval实现周期性实时刷新时间，使用Canvas绘制时钟，指针旋转角度通过计算得出。 3941 3942##### 基本原理 3943 3944* 本示例展示简单时钟的方法主要封装在Index中。 3945 * 设置表盘大小：通过Index中的display.getDefaultDisplay()方法来获取设备宽高计算表盘大小； 3946 * 获取当前时间：调用updateTime函数，执行new Date().getHours()、new Date().getMinutes()、new Date().getSeconds()获取当前时间。 3947 * 绘制表盘内容：通过[CanvasRenderingContext2D](reference/apis-arkui/arkui-ts/ts-canvasrenderingcontext2d.md) 来画表盘背景、时针、分针、秒针、圆心以及表盘下方文本； 3948 * 启动时钟：添加setInterval定时器，每隔1s执行一次updateTime函数。 3949 3950##### 约束与限制 3951 3952开发语言：ArkTS 3953 3954配套版本：API9版本SDK，版本号：3.2.11.9 3955 3956[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/ArkTSClock) 3957 3958#### 翻页时钟 3959 3960##### 介绍 3961 3962本示例集中展示了时钟、闹钟、倒计时、设置屏幕亮度相关的场景， 39631、使用[@ohos.reminderAgentManager](reference/apis-backgroundtasks-kit/js-apis-reminderAgentManager.md)完成闹钟的相关功能， 39642、使用animateTo完成翻页时钟动画，使用[@ohos.runningLock](reference/apis-basic-services-kit/js-apis-runninglock.md)完成屏幕常亮功能， 39653、设置屏幕亮度，使用[@ohos.brightness](reference/apis-basic-services-kit/js-apis-brightness-sys.md)系统能力调节屏幕亮度， 39664、后台消息提醒，使用[@ohos.notificationManager](reference/apis-notification-kit/js-apis-notificationManager.md)系统能力做后台代理提醒。 39675、需要系统存储信息，使用用户首选项接口[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md)。 3968 3969##### 使用 3970 39711.主页面有四个底部标签栏，时钟页面展示了数字翻页时钟功能。 3972 39732.闹钟功能点击**+**号可以创建一个闹钟，等闹钟时间到了会进行提醒。 3974 39753.倒计时功能。 3976 39774.设置里边实现的功能有全屏、调节屏幕亮度和不熄屏。 3978 3979##### 基本原理 3980 3981* 在entry/pages/index.ets中通过tabArray.TabType.num的值来加载每个TabContent()的资源，num:[0,1,2,3]分别加载翻页时钟，闹钟，倒计时，设置组件。 3982* 页面编写步骤： 3983 1、定义以下四个页面组件 FlipClock()//翻转时钟 AlarmClock()// 闹钟CountDown()// 倒计时Setting()//设置 3984 2、使用tabs()标签，将四个组件封装。 3985* 组件逻辑实现 3986 1、时钟： 通过aboutToAppear()中new date()获取当前时间，通过获取date的时、分、秒，10位数通过math.floor()取整，个位数通过对10取余，从而实现对时间格式化，使用box标签，对获取到的数据进行渲染。 3987 2、闹钟： 3988 * a) 使用自定义对话控制器CustomDialogController，定义时间选择器，使用data.preferences存储设置的闹钟，并使用reminderAgentManager将其添加到系统中。 3989 import data_preferences from '@ohos.data.preferences' 3990 import reminderAgentManager from '@ohos.reminderAgentManager' 3991 * b) 页面从data.preferences获取添加的闹钟数据，通过Scroll()标签渲染，在标签row内，设置delete按钮，如果删除就调用以下函数取消系统时钟 3992 import reminderAgentManager from '@ohos.reminderAgentManager' 3993 reminderAgentManager.cancelReminder 3994 3、倒计时 3995 * a) 使用aboutToAppear()初始化界面布局，通过this.listener.on('change', portraitFunc)添加监听， 3996 * b) 点击开始按钮触发以下函数开始计时，并修改按钮的样式为暂停，并将running=true，触发canvas样式 3997 * c) 点击暂停按钮，时间暂停，并将按钮样式修改为开始 3998 * d) 点击reset计时重置，将所有数据初始化 3999 4000##### 约束与限制 4001 4002开发语言：ArkTS 4003 4004配套版本：API9版本SDK，版本号：3.2.11.9 4005 4006[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/FlipClock) 4007 4008#### JS时钟 4009 4010##### 介绍 4011 4012本示例使用JS语言编写示例，设置一个定时器（timer），捕捉用户动作，当用户离开首页时（onHide事件）定时器注销（clearInverval）定时器，当用户回到小程序首页时（onShow事件），重新设置一个定时器（timer）setInterval，使用[transform](reference/apis-arkui/arkui-js/js-components-svg-animatetransform.md)设置平移/旋转/缩放的属性，实现一个简单时钟应用。 4013 4014##### 使用 4015 40161.安装hap包。 4017 40182.在桌面上找到hap包打开。 4019 40203.展示时钟页面。 4021 4022##### 基本原理 4023 40241、在首页设置一个定时器（timer），定时调用接口从index.js刷新最新消息通知，更新首页通知列表; 4025 40262、捕捉用户动作，当用户离开首页时（onHide事件）定时器注销（clearInverval）定时器; 4027 40283、当用户回到小程序首页时（onShow事件），重新设置一个定时器（timer）setInterval，定时从index.js刷新最新消息通知。 4029 40304、实现动画样式：通过transform设置平移/旋转/缩放的属性。时钟的指针使用rotate设置x轴和y轴两个维度参数，rotate可以传入具体角度值。指针旋转角度通过计算得出。 4031例如："transform : rotate\(\{\{ second \* 6 \}\}deg\)", 秒针1秒转动6度。 4032 4033##### 约束与限制 4034 4035开发语言：JS 4036 4037配套版本：API9版本SDK，版本号：3.2.11.9 4038 4039[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/JsClock) 4040 4041#### 图案密码锁组件 4042 4043##### 介绍 4044 4045本示例使用用户首选项接口[@ohos.data.preferences](reference/apis-arkdata/js-apis-data-preferences.md) 异步获取用户设定过的密码，以宫格图案的方式输入密码，用于密码验证。手指触碰图案密码锁时开始进入输入状态，手指离开屏幕时结束输入状态并向应用返回输入的密码。展示图案密码锁组件的使用，实现了密码设置、验证和重置功能。 4046 4047##### 使用 4048 40491.首次进入时需要设置密码，需要两次输入密码相同后点击**设置密码**进行设置，如果第二次输入密码和第一次输入密码不同，会提示重新输入。 4050 40512.设置密码后，需要输入密码解锁，退出应用后重新进入应用，需要再次输入密码验证，密码验证成功进入主页。 4052 40533.设置密码后，在输入密码界面有**重置密码**按钮，点击后需要输入旧密码，旧密码验证成功后开始设置新的密码。 4054 4055##### 基本原理 4056 4057* 在pages/Home.ets中定义密码锁组件，通过定义两个变量isHasPass：是否已经设过密码;isReset：是否需要重置密码; 4058* 密码验证分为几种情况： 4059 1. 首次进入页面， 通过aboutToAppear()初始化调用preferences.getPreferences()获取密码，此时defaultPassword='null'，isHassPass=false，需设置密码并确认密码； 4060 2. 已经设过密码： 通过aboutToAppear()初始化调用preferences.getPreferences()获取密码，此时defaultPassword='oldPassword'，isHassPass=true，页面渲染重置密码text()。 4061 需输入密码和defaultPassword比较，正确后跳转相应页面，若失败提示密码错误，需重新输入密码。 4062 3. 点击重置密码，此时组件清除旧密码，即defaultPassword='null'，此时无密码，走首次无密码流程。 4063* 在pages/index.ets中定义密码通过后的首页页面。 4064 4065##### 约束与限制 4066 4067开发语言：ArkTS 4068 4069配套版本：API9版本SDK，版本号：3.2.11.9 4070 4071[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/Solutions/Tools/PatternLock) 4072 4073 4074 4075## 关键特性 4076 4077### 分布式 4078 4079#### ArkTS分布式计算器 4080 4081##### 介绍 4082 4083本示例使用分布式数据管理接口[@ohos.data.distributedData](reference/apis-arkdata/js-apis-distributed-data.md)、媒体查询接口[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md)，实现设备之间的kvStore对象的数据传输交互。通过StartAbility实现远端应用的拉起以及DistributedDataKit分布式数据框架实现异端应用的数据同步，实现一个简单的计算器应用，可以进行简单的数值计算，支持远程拉起另一个设备的计算器应用，两个计算器应用进行协同计算。 4084 4085##### 使用 4086 40871.点击桌面应用图标，启动应用。 4088 40892.点击应用右上角按钮，或者在界面任意位置滑动（上下左右滑动皆可）即可弹出设备选择框。 4090 40913.在设备选择框中点击对端设备名称，拉起对端应用。 4092 40934.对端应用启动后，可在任意一端中操作应用，两端应用可实现数据实时同步。 4094 40955.在设备选择框中选中本机即可关闭对端应用。 4096 4097##### 基本原理 4098 4099在分布式计算器应用中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 4100首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 4101#### 分布式设备搜索 4102通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见startDeviceDiscovery(){}模块。 4103#### 分布式设备列表弹窗 4104使用@CustomDialog装饰器来装饰分布式设备列表弹窗。 4105#### 远端设备拉起 4106通过startAbility(deviceId)方法拉起远端设备的包。 4107#### 分布式数据管理 4108(1) 管理分布式数据库 4109创建一个KVManager对象实例，用于管理分布式数据库对象。通过distributedData.createKVManager(config)，并通过指定Options和storeId，创建并获取KVStore数据库，并通过Promise方式返回，此方法为异步方法，例如this.kvManager.getKVStore(STORE_ID, options).then((store) => {})。 4110(2) 订阅分布式数据变化 4111通过订阅分布式数据库所有（本地及远端）数据变化实现数据协同。 4112 4113##### 约束与限制 4114 4115开发语言：ArkTS 4116 4117配套版本：API10版本SDK，版本号：4.0.10.7 4118 4119[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/ArkTSDistributedCalc) 4120 4121#### ArkTS分布式音乐播放 4122 4123##### 介绍 4124 4125本示例使用与用户进行交互的Ability的能力接口[@ohos.ability.featureAbility](reference/apis-ability-kit/js-apis-ability-featureAbility.md)、文件存储管理能力接口[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md)、屏幕属性接口[@ohos.display](reference/apis-arkui/js-apis-display.md)、媒体查询接口[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md)、分布式数据管理接口[@ohos.data.distributedData](reference/apis-arkdata/js-apis-distributed-data.md)、音视频相关媒体业务能力接口[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md)，实现设备之间的kvStore对象的数据传输交互。通过AudioPlayer实现音频播放能力，调用分布式数据各个接口，应用程序可将数据保存到分布式数据库中，并可对分布式数据库中的数据进行增/删/改/查等各项操作。 4126 4127##### 使用 4128 41291.**音乐播放**，点击**播放**、**暂停**、上**一曲**、下**一曲**按钮可以对音乐进行操作。 4130 41312.**跨设备分享**，组网并且双端均已授权条件下，点击**分享**按钮，选择设备，拉起对端设备上的音乐，并将本端的播放状态同步到对端上。 4132 41333.**跨设备停止分享**，分享成功前提条件下，点击**停止分享**按钮，将对端设备拉起的音乐应用停止退出。 4134 4135##### 基本原理 4136 4137在分布式音乐播放器中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 4138首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 4139#### 分布式设备搜索 4140通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见registerDeviceListCallback(callback) {}模块。 4141#### 分布式设备列表弹窗 4142使用@CustomDialog弹出分布式设备列表弹窗，参考首页。 4143#### 远端设备拉起 4144通过startAbility(deviceId)方法拉起远端设备的包。 4145#### 分布式数据管理 4146(1) 管理分布式数据库 4147创建一个KVManager对象实例，用于管理分布式数据库对象。通过distributedData.createKVManager(config)，并通过指定Options和storeId，创建并获取KVStore数据库，并通过Promise方式返回，此方法为异步方法，例如this.kvManager.getKVStore(STORE_ID, options).then((store) => {}) 4148(2) 订阅分布式数据变化 4149通过订阅分布式数据库所有（本地及远端）数据变化实现数据协同。 4150 4151##### 约束与限制 4152 4153开发语言：ArkTS 4154 4155配套版本：API9版本SDK，版本号：3.2.11.9 4156 4157[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/ArkTSDistributedMusicPlayer) 4158 4159#### JS分布式计算器 4160 4161##### 介绍 4162 4163本示例使用分布式数据管理接口[@ohos.data.distributedData](reference/apis-arkdata/js-apis-distributed-data.md)、媒体查询接口[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md)，实现设备之间的kvStore对象的数据传输交互。通过StartAbility实现远端应用的拉起以及DistributedDataKit分布式数据框架实现异端应用的数据同步，实现一个简单的计算器应用，可以进行简单的数值计算，支持远程拉起另一个设备的计算器应用，两个计算器应用进行协同计算。 4164 4165##### 使用 4166 41671.点击桌面应用图标，启动应用。 4168 41692.点击应用右上角按钮，或者在界面任意位置滑动（上下左右滑动皆可）即可弹出设备选择框。 4170 41713.在设备选择框中点击对端设备名称，拉起对端应用。 4172 41734.对端应用启动后，可在任意一端中操作应用，两端应用可实现数据实时同步。 4174 41755.在设备选择框中选中本机即可关闭对端应用。 4176 4177##### 基本原理 4178 4179在分布式计算器应用中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 4180首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 4181#### 分布式设备搜索 4182通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见startDeviceDiscovery(){}模块 4183#### 分布式设备列表弹窗 4184使用calc-select-device-dialog渲染分布式设备列表弹窗 4185#### 远端设备拉起 4186selectDevice()发起远程设备调用，featureAbility.startAbility()方法拉起远端设备的包，调用dataChange(key, value)改变kvstore的值。 4187#### 分布式数据管理 4188(1) 管理分布式数据库 4189创建一个KVManager对象实例，用于管理分布式数据库对象。通过distributedData.createKVManager(config)，并通过指定Options和storeId，创建并获取KVStore数据库，并通过Promise方式返回，此方法为异步方法，例如this.kvManager.getKVStore(STORE_ID, options).then((store) => {})。 4190(2) 订阅分布式数据变化 4191通过订阅分布式数据库所有（本地及远端）数据变化实现数据协同。 4192 4193##### 约束与限制 4194 4195开发语言：JS 4196 4197配套版本：API10版本SDK，版本号：4.0.9.6 4198 4199[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributeCalc) 4200 4201#### 分布式账号 4202 4203##### 介绍 4204 4205本示例主要展示了分布式账号相关的功能，使用[@ohos.account.distributedAccount](reference/apis-basic-services-kit/js-apis-distributed-account.md)、[@ohos.account.osAccount](reference/apis-basic-services-kit/js-apis-osAccount.md)等接口，实现了绑定分布式账号、解绑分布式账号、更新分布式账号信息和管理分布式账号的功能。 4206 4207##### 使用 4208 42091. 首次进入应用会根据分布式账号绑定状态进行页面跳转，若账号已绑定，则直接跳转至账号列表界面；若账号未绑定，则需要在首页进行绑定； 42101. 首页输入分布式账号名（必填）、昵称，选择头像（需先使用hdc命令将图片推到storage/media/100/local/files/Pictures/路径下并重启），选择绑定的系统账号，点击**绑定**，绑定成功跳转至账号列表界面； 42112. 在账号列表界面，可对所有可解绑分布式账号进行管理，点击选择分布式账号，跳转至对应的账号信息界面； 42123. 在账号信息界面，点击**解绑**，可解绑该分布式账号； 42133. 在账号解绑之后，可对分布式账号信息进行更新，在首页直接进行输入后点击绑定即可。 4214 4215##### 基本原理 4216 4217* 绑定、解绑、查询、更新分布式账号的功能接口封装在DistributedAccountModel： 4218 * 使用distributedAccount.getDistributedAccountAbility()获取分布式账号单实例对象accountAbility; 4219 * 绑定、解绑和更新分布式账号：使用accountAbility.setOsAccountDistributedInfoByLocalId(); 4220 * 查询分布式账号信息：使用accountAbility.getOsAccountDistributedInfo()和accountAbility.getOsAccountDistributedInfoByLocalId; 4221 4222##### 约束与限制 4223 4224开发语言：ArkTS 4225 4226配套版本：API10版本SDK，版本号：4.0.7.5 4227 4228[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DistributedAppDev/DistributedAccount) 4229 4230#### 设备管理 4231 4232##### 介绍 4233 4234本示例主要展示了设备管理相关的功能，使用[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md) 等接口，实现了包括获取本机设备信息，获取授信设备列表，根据过滤条件扫描设备，设备认证，设备状态订阅，导入凭据，控制设备是否允许被发现等功能。 4235 4236##### 使用 4237 42381. 进入应用会自动获取本机设备信息，并且注册设备状态监听，在有设备上下线的时候，刷新可信设备列表 42392. 在主界面，可以点击允许被发现开关控制本机是否允许被发现； 42403. 在主界面，可以点击刷新，刷新可信设备列表，点击已认证，解除认证关系； 42414. 在主界面，可以点击过滤条件，选择对应的过滤条件，在发现设备时进行过滤； 42425. 在主界面，可以点击发现，发现周边的设备，并点击发现的设备，进行PIN码认证； 4243 4244##### 基本原理 4245 4246获取本机设备信息，获取授信设备列表，根据过滤条件扫描设备，设备认证，设备状态订阅，控制设备是否允许被发现等功能，接口封装在RemoteDeviceModel： 4247 4248 * 使用RemoteDeviceModel.createDeviceManager()来获取DeviceManager对象； 4249 * 获取本机设备信息：调用RemoteDeviceModel.getLocalDeviceInfo()来获取本机设备信息； 4250 * 注册设备状态监听：调用RemoteDeviceModel.registerDeviceStateListener()，来注册设备状态监听; 4251 * 获取可信设备列表：调用RemoteDeviceModel.getTrustedDeviceList()来获取可信设备列表; 4252 * 发布设备：调用RemoteDeviceModel.setIsSupportRange()设置是否上报距离，然后调用deviceManager.publishDeviceDiscovery()发布设备; 4253 * 停止发布设备：调用RemoteDeviceModel.unAuthenticateDevice()停止发布; 4254 * 发现和停止发现设备：调用RemoteDeviceModel.startDeviceDiscovery()发现设备，调用RemoteDeviceModel.stopDeviceDiscovery()停止发现设备; 4255 * 认证和取消认证设备：调用RemoteDeviceModel.authenticateDevice()认证，调用RemoteDeviceModel.unAuthenticateDevice()取消认证设备; 4256 4257##### 约束与限制 4258 4259开发语言：ArkTS 4260 4261配套版本：API10版本SDK，版本号：4.0.9.6 4262 4263[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DistributedAppDev/DistributedAuthentication) 4264 4265#### 分布式备忘录 4266 4267##### 介绍 4268 4269本示例使用分布式数据管理接口[@ohos.data.distributedData](reference/apis-arkdata/js-apis-distributed-data.md)、权限管理能力[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)、分布式数据对象接口[@ohos.data.distributedDataObject](reference/apis-arkdata/js-apis-data-distributedobject.md)以及分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md)，实现设备之间的distributedDataObject对象的数据传输交互，展示在eTS中如何使用分布式数据对象实现一个简单的分布式备忘录。 4270 4271##### 使用 4272 42731. 启动应用，选择允许授权后，选择不同的分布式对象进入，如选择distributiedNote，则进入笔记界面： 4274 1. 点击右上角按钮可以连接组网设备，选择设备后进行连接，连接成功后两个设备上首页状态均显示绿色，每次连接其他设备，界面会清空备忘录内容。 4275 2. 点击**添加**按钮进入添加界面，可以编辑标题、内容、标记颜色，点击**提交**按钮添加备忘录。 4276 3. 点击**清除**按钮清除所有备忘录内容。 4277 4. 点击已经添加的备忘录可以进入编辑界面更新备忘录内容，编辑完成后点击**提交**按钮更新备忘录。 4278 5. 两台设备连接成功后步骤2、3、4的操作会同步到另一台设备上。 42792. 如选择distributiedCanvas，则进入画布界面： 4280 1. 点击右上角按钮可以连接组网设备，选择设备后进行连接，连接成功后两个设备上首页状态均显示绿色。 4281 2. 点击ellipse或者rect按钮，则进行绘制对应的图形。 4282 3. 点击delete，则删除所有绘制的图形。 4283 4. 两台设备连接成功后步骤2、3的操作会同步到另一台设备上。 4284 5. 点击back按钮，则回退到选择分布式对象的首页。 4285 4286##### 基本原理 4287 4288在分布式笔记应用中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 4289首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 4290#### 分布式设备搜索 4291通过SUBSCRIBE_ID搜索分布式组网内的设备，详见startDeviceDiscovery(){}模块。 4292#### 分布式设备列表弹窗 4293使用@CustomDialog装饰器来装饰分布式设备列表弹窗。 4294#### 远端设备拉起 4295通过startAbility(deviceId)方法拉起远端设备的包。 4296#### 分布式数据管理 4297(1) 管理分布式数据库 4298创建一个distributedObject分布式数据对象实例，用于管理分布式数据对象。详见distributedObject.createDistributedObject()。 4299(2) 订阅分布式数据变化 4300通过this.distributedObject.on('status', this.statusCallback)监听分布式数据对象的变更。 4301#### 笔记 4302(1)UIAbility拉起弹框请求用户授权:在onCreate()时通过abilityAccessCtrl.createAtManager.requestPermissionsFromUser(this.context, ['ohos.permission.DISTRIBUTED_DATASYNC']).then((data)=> {})获取不同设备间的数据交换权限。 4303(2)将sessionID存在应用全局的UI状态存储AppStorage内：在onCreate(want, launchParam) {}时拿到sessionId并存储在AppStorage内，并把同时把sessionId绑定到@StorageLink上实现双向数据绑定。 4304(3)对笔记内容进行存储在dataArray:note[]中：通过this.noteDataSource['dataArray'] = this.globalObject.distributedObject.documents。 4305(4)笔记内容更新：通过绑定Button的onClick事件指定this.globalObject.update(index, this.note.title, this.note.content, this.note.mark)进行笔记内容和状态更新。 4306(5)实现分布式数据自动同步：通过this.globalObject.distributedObject.setSessionId(this.sessionId)，从而实现当可信组网中有多个设备时，多个设备间的对象如果设置为同一个sessionId的笔记数据自动同步，并将其封装在share()函数内。 4307(6)在首页的onPageShow()钩子中，调用share()实现首页在分布式设备上同步渲染组件。 4308 4309##### 约束与限制 4310 4311开发语言：ArkTS 4312 4313配套版本：API10版本SDK，版本号：4.0.9.1 4314 4315[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedNote) 4316 4317#### 分布式关系型数据库 4318 4319##### 介绍 4320 4321本示例使用[@ohos.data.relationalStore](reference/apis-arkdata/js-apis-data-relationalStore.md) 接口和[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md) 接口展示了在eTS中分布式关系型数据库的使用，在增、删、改、查的基本操作外，还包括分布式数据库的数据同步同能。 4322 4323##### 使用 4324 43251. 启动应用后点击“**+**”按钮可以添加联系人; 43262. 点击联系人可以进入编辑界面编辑联系人信息; 43273. 长按联系人进入多选状态，底部有“**全选**”、“**取消**”、“**删除**”、“**退出**”按钮，点击退出可以退出多选状态; 43284. 点击右上角更多按钮，点击“**连接设备**”，选择要同步数据的设备，连接成功后可以开始将本端数据同步到对端; 43295. 点击右上角更多按钮，点击“**设置**”可以进入设置界面设置数据同步方式，包括自动同步和手动同步。 4330 4331##### 基本原理 4332 4333+ 数据库的增、删、改、查操作都在RdbModel中，: 4334 + 数据库操作：使用[@ohos.data.relationalStore](reference/apis-arkdata/js-apis-data-relationalStore.md) 接口的getRdbStore获得一个相关的操作型关系数据库RdbStore，通过这个RdbStore调用相关接口进行增删改查，RdbStore.insert数据插入,RdbStore.delete数据删除，RdbStore.update更新数据，RdbStore.query根据条件查询数据; 4335 + 数据同步：RdbStore.on注册数据库观察者，使用RdbStore.obtainDistributedTableName根据本地表名获取指定远程设备的分布式表名，数据发生变动时通过RdbStore.sync同步数据，不需要用时删除指定观察者使用RdbStore.off。 4336+ 连接设备管理在RemoteDeviceModel中: 4337 + 设备同步：设备同步数据需要[ohos.permission.DISTRIBUTED_DATASYNC](security/AccessToken/permissions-for-all-user.md#ohospermissiondistributed_datasync) 权限，在页面渲染前申请权限,使用[@ohos.distributedDeviceManager](reference/apis-distributedservice-kit/js-apis-distributedDeviceManager.md) 接口，首先通过createDeviceManager创建设备管理器实例，然后通过getTrustedDeviceListSync同步获取所有可信设备列表； 4338 + 设备连接：首先通过on方法注册设备状态，例如发现设备，设备连接失败，然后通过startDeviceDiscovery方法发现周边设备，然后选择连接设备，再启动连接设备的应用。 4339 4340##### 约束与限制 4341 4342开发语言：ArkTS 4343 4344配套版本：API10版本SDK，版本号：4.0.9.6 4345 4346[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedRdb) 4347 4348#### JS分布式音乐播放 4349 4350##### 介绍 4351 4352本示例使用与用户进行交互的Ability的能力接口[@ohos.ability.featureAbility](reference/apis-ability-kit/js-apis-ability-featureAbility.md)、文件存储管理能力接口[@ohos.fileio](reference/apis-core-file-kit/js-apis-fileio.md)、屏幕属性接口[@ohos.display](reference/apis-arkui/js-apis-display.md)、媒体查询接口[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md)、分布式数据管理接口[@ohos.data.distributedData](reference/apis-arkdata/js-apis-distributed-data.md)、音视频相关媒体业务能力接口[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)、分布式设备管理能力接口(设备管理)[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md)，实现设备之间的kvStore对象的数据传输交互。通过AudioPlayer实现音频播放能力，调用分布式数据各个接口，应用程序可将数据保存到分布式数据库中，并可对分布式数据库中的数据进行增/删/改/查等各项操作。 4353 4354##### 使用 4355 43561.**音乐播放**，点击**播放**、**暂停**、上**一曲**、下**一曲**按钮可以对音乐进行操作。 4357 43582.**跨设备迁移播放**，组网条件下，点击**流转**按钮，选择设备，拉起对端设备上的音乐，本端退出。 4359 4360##### 基本原理 4361 4362在分布式音乐播放器中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 4363首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 4364###### 分布式设备搜索 4365通过SUBSCRIBE_ID搜索分布式组网内的远端设备，详见registerDeviceListCallback_(callback) {}模块。 4366###### 分布式设备列表弹窗 4367使用continueAbilityDialog弹出分布式设备列表弹窗，参考首页。 4368###### 远端设备拉起 4369通过startAbility(deviceId)方法拉起远端设备的包。 4370 4371##### 约束与限制 4372 4373开发语言：JS 4374 4375配套版本：API10版本SDK，版本号：4.0.9.6 4376 4377[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/JsDistributedMusicPlayer) 4378 4379#### 分布式数据管理 4380 4381##### 介绍 4382 4383本示例展示了在eTS中分布式数据管理的使用，包括KVManager对象实例的创建和KVStore数据流转的使用。 4384 4385通过设备管理接口[@ohos.distributedHardware.deviceManager](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md) ，实现设备之间的kvStore对象的数据传输交互，该对象拥有以下能力[详见](reference/apis-distributedservice-kit/js-apis-device-manager-sys.md) ; 43861、注册和解除注册设备上下线变化监听 43872、发现周边不可信设备 43883、认证和取消认证设备 43894、查询可信设备列表 43905、查询本地设备信息，包括设备名称，设备类型和设备标识 43916、发布设备发现 4392 4393##### 使用 4394 43951.两台设备组网。 4396 43972.在一台界面中点击右上角的流转按钮，在弹窗中选择对端设备拉起对端设备上的应用。 4398 43993.拉起对端设备后，在界面中点击"+"按钮新增笔记卡片，点击每个卡片右上角的"X"按钮可以删除此卡片，可以看到对端设备和当前设备界面数据保持一致。 4400 44014.操作对端设备，当前设备界面也会保持和对端设备界面显示一致。 4402 4403##### 基本原理 4404 44051、页面初始化时获取此应用所需能力：引入@ohos.data.distributedKVStore初始化kvstore数据库并对使用kvstore.on数据change进行监听，通过appstorge判断获取相应的key判断是否是分布式节点。 44062、如果是分布式节点，如果数据发生变化，处理数据并使用.noteDataSource()进行reload数据。 44073、页面通过kvStore对象进行增删改查会触发其他已连接设备的kvStore.on监听。 4408 4409 4410##### 约束与限制 4411 4412开发语言：ArkTS 4413 4414配套版本：API9版本SDK，版本号：3.2.11.9 4415 4416[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/Kvstore) 4417 4418#### 分布式文件管理 4419 4420##### 介绍 4421 4422本示例使用分布式能力实现了一个分布式的文件管理，可以进行文件的跨设备拷贝。 4423 4424##### 使用 4425 44261. 两台设备A、B组网成功。 4427 44282. A设备上长按列表出现复选框，选择文件(夹)后点击下方的“复制”按钮。 4429 44303. B设备上进入要复制的文件夹目录，点击右上角的“粘贴”图标。 4431 44324. A设备上的文件成功拷贝至B设备。 4433 4434##### 基本原理 4435 4436本示例用到了文件管理接口[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md)。 4437 4438分布式数据对象接口[@ohos.data.distributedDataObject](reference/apis-arkdata/js-apis-data-distributedobject.md)。 4439 4440允许系统应用获取分布式设备的认证组网能力：[ohos.permission.ACCESS_SERVICE_DM](security/AccessToken/permissions-for-system-apps.md#ohospermissionACCESS_SERVICE_DM) 4441 4442##### 约束与限制 4443 4444开发语言：ArkTS 4445 4446配套版本：API11版本SDK，版本号：4.1.3.3 4447 4448[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedFilemanager) 4449 4450#### 跨端迁移随手记 4451 4452##### 介绍 4453 4454本示例主要展示了应用数据跨端迁移的能力，通过跨端迁移的能力实现了一个简单的随手记应用，可以响应系统迁移事件，控制应用的迁移能力、是否迁移页面栈以及迁移后是否退出源端等。同时实现了数据迁移以及ArkUI控件的迁移。 4455 4456本示例使用了权限管理接口[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)、分布式数据对象接口[@ohos.data.distributedDataObject](reference/apis-arkdata/js-apis-data-distributedobject.md)、基础文件操作接口[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 、相册管理模块接口[@ohos.file.photoAccessHelper](reference/apis-core-file-kit/js-apis-fileAccess-sys.md)、图片处理接口[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md)等接口，通过分布式数据对象以及分布式文件两种方式实现了图片数据的流转迁移。 4457 4458##### 使用 4459 44601. 启动应用，进入欢迎页，点击允许授权。 4461 44622. 进入主页，点击右上角设置图标进入迁移设置页面，可以设置当前应用是否具备迁移能力、是否迁移页面栈以及迁移后是否退出源端。 4463 44643. 进入主页，可以点击笔记页、待办事项、图片墙等按钮进入对应页面。 4465 44664. 在笔记页，可以编辑笔记标题、笔记内容、选择图片，在打开迁移能力和迁移页面栈的情况下，所编辑的内容和选择的图片可以同步迁移到对端设备。 4467 44685. 在待办事项页，勾选多选框，在打开迁移能力和迁移页面栈的情况下，可以迁移当前的勾选状态。 4469 44706. 在图片墙页，滑动页面到某个位置，在打开迁移能力和迁移页面栈的情况下，可以迁移当前的瀑布流控件索引位置。 4471 4472##### 基本原理 4473 4474* 在跨端迁移随手记应用里，迁移设置的功能在Setting.ets和entryability中的onContinue()实现： 4475 4476 * 通过[UIAbilityContext](reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md)的[setMissionContinueState](reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextsetmissioncontinuestate10)可以设置当前应用任务流转的状态，控制当前应用是否具有迁移能力。 4477 4478 * 通过设置wantConstant.Params.SUPPORT_CONTINUE_PAGE_STACK_KEY和wantConstant.Params.SUPPORT_CONTINUE_SOURCE_EXIT_KEY的值可以控制当前应用是否迁移页面栈以及迁移后源端是否退出。 4479 4480* 笔记页通过分布式数据对象和分布式文件在Notes.ets中实现大文件（100KB以上）数据的迁移。通过分布式文件的[跨设备文件访问](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/file-management/file-access-across-devices.md)实现了图片的迁移。 4481 4482* 从图库中选择图片，使用选择器接口[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md)的PhotoViewPicker图库选择器对象选择一张图片并通过writeSrcToDistributedFile(this.uris)将选择的图片的uri写入分布式文件路径filePath。接口参考：[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 4483 4484* 使用getImage()方法获取从图库中选择的图片资源PixelMap类型，首先使用photoAccessHelper.getPhotoAccessHelper(context)获取相册管理模块的实例，使用phAccessHelper.getAssets()获取图片资源,使用photoAsset.getThumbnail()获取所选的图片的PixelMap类型数据。接口参考：[ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper.md) 4485 4486* 在对端设备上迁移显示笔记页内容时，在aboutToAppear()钩子中调用readFromDistributedFile()读取分布式路径里存储的图片文件。首先以同步方法fs.accessSync(filePath)检查分布式路径下文件是否存在，通过image.createImageSource(filePath)传入的uri创建图片源实例imageSourceApi,通过imageSourceApi.createPixelMap()来创建PixelMap 并负责流转后展示。接口参考：[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md) 4487 4488##### 约束与限制 4489 4490开发语言：ArkTS 4491 4492配套版本：API11版本SDK，版本号：4.1.5.5 4493 4494[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/DistributedAppDev/DistributedJotNote) 4495 4496### 一次开发多端部署 4497 4498#### ArkTS多设备自适应能力 4499 4500##### 介绍 4501 4502本示例是[《一次开发，多端部署》](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)，包括自适应布局、响应式布局、典型布局场景以及资源文件使用。 4503 4504| 名称 | 简介 | 4505| ------------ | ------------------------------------------------------------ | 4506| 自适应布局 | 当外部容器大小发生变化时，元素可以**根据相对关系自动变化**以适应外部容器变化的布局能力。 | 4507| 响应式布局 | 当外部容器大小发生变化时，元素可以**根据断点或特定的媒体特征（如屏幕方向、窗口宽高等）自动变化**以适应外部容器变化的布局能力。 | 4508| 典型布局场景 | 应用开发中的典型场景，包括运行横幅、网格、侧边栏等。 | 4509| 资源文件使用 | 根据当前的设备特征（如设备类型、屏幕密度等）或应用场景（如语言、国家、地区等），从resources目录下不同的资源限定词目录中获取相应的资源值。 | 4510 4511##### 使用 4512 45131. 启动应用，首页展示了自适应布局、响应式布局、典型布局场景和资源文件使用四个按钮。 4514 45152. 点击"自适应布局"进入新页面，分别展示拉伸能力、缩放能力、隐藏能力、折行能力、均分能力、占比能力和延伸能力共7种自适应布局能力。 4516 45173. 点击"响应式布局"进入新页面，分别展示断点、媒体查询和栅格布局3种响应式布局能力。 4518 45194. 点击"典型布局场景"进入新页面，展示了如何通过自适应布局能力和响应式布局能力，实现应用开发中的典型场景。 4520 45215. 点击"资源文件使用"进入新页面，展示字符串和图片资源的使用。 4522 4523##### 基本原理 4524 4525* 该示例使用了路由跳转接口，实现了各个不同布局之间的页面跳转，通过MediaQueryListener方法查询媒体，matchMediaSync方法设置媒体查询的查询条件。 4526* 接口参考：[@ohos.router](reference/apis-arkui/js-apis-system-router.md)，[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md) 4527 4528##### 约束与限制 4529 4530开发语言：ArkTS 4531 4532配套版本：API10版本SDK，版本号：4.0.9.6 4533 4534[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/AdaptiveCapabilities) 4535 4536#### 一多应用市场首页 4537 4538##### 介绍 4539 4540本示例使用媒体查询接口[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md)，结合[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示，展示应用市场首页，页面中包括Tab栏、运营横幅、精品应用、精品游戏等。 4541 4542##### 使用 4543 45441. 启动应用，可以查看本应用在全屏状态下的显示效果。 4545 45462. 在应用顶部，下滑出现窗口操作按钮。（建议通过外接鼠标操作，接入鼠标只需要将鼠标移动至顶部即可出现窗口） 4547 45483. 点击悬浮图标，将应用悬浮在其它界面上显示。 4549 45504. 拖动应用悬浮窗口的边框，改变窗口尺寸，触发应用刷新，即可查看应用在不同窗口下的显示效果。 4551 45525. 改变窗口尺寸的过程中，窗口尺寸可能超出屏幕尺寸。此时在屏幕中只能看到应用部分区域的显示，但可以通过移动窗口位置，查看应用其它区域的显示。 4553 4554##### 基本原理 4555 4556本示例介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口，将页面分拆为5个部分。 4557##### 底部/侧边导航栏 45581、在sm和md断点下，导航栏在底部；在lg断点下，导航栏在左侧。 45592、通过Tab组件的barPosition和vertical属性控制TabBar的位置在主轴方向起始或结尾位置和水平或垂直方向，同时还可以通过barWidth和barHeight属性控制TabBar的尺寸。 4560 4561##### 约束与限制 4562 4563开发语言：ArkTS 4564 4565配套版本：API9版本SDK，版本号：3.2.11.9 4566 4567[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/AppMarket) 4568 4569#### 健康饮食 4570 4571##### 介绍 4572 4573本示例使用了路由跳转[@ohos.router](reference/apis-arkui/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-arkui/js-apis-mediaquery.md)的MediaQueryListener方法查询媒体，matchMediaSync方法设置媒体查询的查询条件，[@ohos.curves](reference/apis-arkui/js-apis-curve.md)的cubicBezierCurve方法构造三阶贝塞尔曲线对象。 4574 4575##### 使用 4576 45771. 本应用一共有“启动动画页面”、“首页”和“食物详情”三个主页面； 45782. 启动应用，进入“启动动画页面”，动画播放完成自动进入主页； 45793. 首页，使用Tabs组件把首页分为两个页签：“主页”页签和“记录”页签。“主页”页签展示所有食物，支持通过Tab子页签展示的食物分类网格布局和字母排序列表两种方式查看，点击食物项可进入相应的食物详情页面，查看食物详情。食物“记录”页签，展示饮食记录，通过卡片展示不同时间段的饮食信息，卡片信息包含有食物的种类、重量、卡路里值以及用餐时间；以柱状图的形式展示每一餐所有食物的热量值和包含的营养元素含量；可以在卡片里面通过使用加减按钮来修改食物的重量，同时会重新统计相应用餐时间的总热量值、总蛋白质、总脂肪和总碳水值，并且柱状图的数据会及时更新; 45805. 食物详情页面，使用滑动组件展示食物的详细信息，包括使用画布组件展示单位重量的食物各个营养元素的的占比,使用进度条组件展示当前食物是否为高热食物，以及展示单位重量的食物所包含的热量、脂肪、蛋白质、碳水以及维他命C值；并且点击记录按钮可以弹出记录饮食的弹窗，包括记录食物的种类、重量以及用餐时间，可以通过点击完成添加饮食，同时添加的饮食信息会在“记录”Tab页签做展示。 4581 4582##### 基本原理 4583 4584* 本实例使用了路由跳转，比如点击食物，可以跳转至相应的食物详情页面，通过一次开发多端部署，使用其中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示，使用MediaQueryListener方法查询媒体，matchMediaSync方法设置媒体查询的查询条件，cubicBezierCurve方法构造三阶贝塞尔曲线对象。 4585* 接口参考：[@ohos.router](reference/apis-arkui/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-arkui/js-apis-curve.md)，[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md) 4586 4587##### 约束与限制 4588 4589开发语言：ArkTS 4590 4591配套版本：API9版本SDK，版本号：3.2.11.9 4592 4593[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/HealthyDiet) 4594 4595#### JS多设备自适应能力 4596 4597##### 介绍 4598 4599此Demo展示在JS中的多设备自适应能力，包括资源限定词、原子布局和响应式布局。 4600 4601##### 使用 4602 46031.本示例中的资源限定词和响应式布局针对常见设备类型做了适配，可以在预览器中开启"Multi-profile preview"进行多设备预览。 4604 46052.本示例中的原子布局提供了滑动条（slider），通过拖动滑动条更改父容器尺寸可以更直观的查看原子布局的效果。为了突出重点以及易于理解，此部分的代码做了一定精简，建议通过IDE预置的MatePadPro预览器查看此部分效果。 4606 46073.启动应用，首页展示了**资源限定词**、**原子布局**和**响应式布局**三个按钮。 4608 46094.点击**资源限定词**进入新界面，展示字符串和图片资源的使用。 4610 46115.点击**原子布局**进入新界面，分别展示原子布局的拉伸能力、缩放能力、隐藏能力、折行能力、均分能力、占比能力、延伸能力。 4612 46136.点击**响应式布局**进入新界面，展示媒体查询、栅格布局、典型场景三类响应式布局能力。 4614 4615##### 基本原理 4616 46171、index下定义三个box，分别资源限定词resourceQualifier、原子布局atomicLayoutCapability、响应式布局responsiveLayout，并通过onclick路由到各自的组件。 46182、资源限定词组件： 在MainAbility.resource下定义需要访问的资源，在资源限定词resourceQualifier组件中，使用$r('')即可实现不同形态和规格访问到不同的资源。 46193、原子布局atomicLayoutCapability组件：该布局下，通过slide滑动控制样式的展示比率rate,例如下面这个样例。 46204、响应式布局responsiveLayout ：该布局下需要相对应的媒体资源，比如sm、md、lg，然后监听媒体的变化，从而对资源进行响应式的调整。 例如栅格布局。本案例定义了xs、sm、md、lg下的栅格宽度，根据系统的规格自动选择相应的属性。 46215、使用mediaQuery对规格进行监听，判断当前系统的横竖屏，从而加载相应的资源。 4622 4623##### 约束与限制 4624 4625开发语言：JS 4626 4627配套版本：API9版本SDK，版本号：3.2.11.9 4628 4629[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/JsAdaptiveCapabilities) 4630 4631#### 一多分栏控件 4632 4633##### 介绍 4634 4635本示例分别展示了多场景下，一多分栏控件的响应式变化效果。分别用到了[SideBarContainer](reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md)组件与[Navigation](reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md)组件，对应使用场景如下： 4636 4637- A+B+C：即SideBarContainer组件组合Navigation组件 4638 1. 预览器窗口宽度>840vp时，显示A、B、C三列，放大缩小时，优先变化C列 4639 2. 预览器窗口宽度<=840vp并且>600vp时，显示B、C两列，放大缩小时，优先变化C列 4640 3. 预览器窗口宽度<=600vp并且>360vp时，仅显示C列 4641- A+C：SideBarContainer组件 4642 1. 预览器窗口宽度>600vp时，显示A、C三列，放大缩小时，优先变化C列 4643 2. 预览器窗口宽度<=600vp并且>360vp时，仅显示C三列 4644- B+C：Navigation组件 4645 1. 预览器窗口宽度>600vp时，显示B、C三列，放大缩小时，优先变化C列 4646 2. 预览器窗口宽度<=600并且>360vp时，仅显示C三列 4647 4648##### 使用 4649 46501.在预览器中查看页面效果 4651 46522.在预览器中开启窗口拖拽模式，拖动窗口变化，可以查看组件的响应式变化 4653 4654##### 基本原理 4655 4656* [SideBarContainer](reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md)组件，自动隐藏侧边栏的功能是由minContentWidth与minSideBarWidth属性实现的。当设置[SideBarContainer](reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md)组件组件的显示类型为SideBarContainerType.Embed,并且窗口宽度达到minContentWidth + minSideBarWidth的边界值时，侧边栏自动隐藏。 4657 4658* [Navigation](reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md)组件，自动隐藏侧边栏的功能是由minContentWidth属性实现的。当[Navigation](reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md)的内容区域达到minContentWidth设置的值时，navBar自动隐藏。 4659 4660##### 约束与限制 4661 4662开发语言：ArkTS 4663 4664配套版本：API10版本SDK，版本号：4.0.9.2 4665 4666[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/MultiColumns) 4667 4668#### 一多导航栏 4669 4670##### 介绍 4671 4672本示例展示了导航组件在不同设备形态下的样式。 4673 4674- 在sm设备上，以tabs形式展示，内容、导航为上下样式布局，通过点击底部tabs切换内容； 4675- 在md/lg设备上，以[SideBarContainer](reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md)形式展示，内容、导航为左右布局，通过点击侧边一二级菜单进行内容切换。 4676 4677本示例使用[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev) 中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，主要通过组件提供窗口断点事件，保证应用在不同设备或不同窗口尺寸下可以正常显示。 4678 4679##### 使用 4680 46811. 打开首页，在IDE编辑器中打开预览器查看预览效果。 46822. 在预览器中开启窗口拖拽模式，拖动窗口变化，可以查看组件的响应式变化。 46833. 手动自由拖拽窗口，将应用窗口在sm/md/lg三种设备形态下进行切换并查看预览效果。 46844. 在sm/lg窗口下，点击左上角图标进行侧边栏样式切换。 4685 4686##### 基本原理 4687 4688本示例介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口,将页面分拆为2部分。 4689 4690**整体布局:** 4691 46921.通过GridRow组件提供的断点事件，获取到当前窗口的断点，通过visibility属性将[Tabs](reference/apis-arkui/arkui-ts/ts-container-tabs.md)组件与[SideBarContainer](reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md)组件分别在sm/(md、lg) 4693形态下展示/隐藏。 4694 46952.同时通过断点，对组件设置不同的样式属性，以最优的效果展示。 4696 4697**侧边栏SideBar/底部TabsController:** 4698 46991.侧边栏内容布局通过Flex容器分别在sm/(md、lg)形态下进行横竖展示。 4700 47012.内容区域通过不同的窗口断点进行选择显隐。 4702 47033.md、lg形态侧边栏一级菜单对应sm形态最外层的TabsController组件、二级菜单对应里层的TabsController组件。 4704 47054.侧边栏同时存在两种形态list/tabs，通过侧边栏左上角图标切换，list模式下内容区域较小，根据窗口断点只显示图标/图标+文字，tabs模式下内容区域较大，显示图标+文字。 4706 4707**内容区域:** 4708 47091.Swiper组件通过获取窗口断点，设置displayCount属性，在不同窗口下显示不同数量的图片。 4710 47112.Gird组件通过获取窗口断点，设置columnsTemplate与rowsTemplate属性，在不同窗口下显示不同数量的Item。 4712 47133.内容浏览的连续性，进行窗口切换时，内容区域的浏览进度可以保持，不会进行重新刷新。 4714 4715##### 约束与限制 4716 4717开发语言：ArkTS 4718 4719配套版本：API10版本SDK，版本号：4.0.8.2 4720 4721[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/MultiNavBar) 4722 4723#### 一多音乐专辑主页 4724 4725##### 介绍 4726 4727本示例使用媒体查询接口[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md)，[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示，展示音乐专辑主页。 4728 4729- 头部返回栏: 因元素单一、位置固定在顶部，因此适合采用自适应拉伸，充分利用顶部区域。 4730- 专辑封面: 使用栅格组件控制占比，在小尺寸屏幕下封面图与歌单描述在同一行。 4731- 歌曲列表: 使用栅格组件控制宽度，在小尺寸屏幕下宽度为屏幕的100%，中尺寸屏幕下宽度为屏幕的50%，大尺寸屏幕下宽度为屏幕的75%。 4732- 播放器: 采用自适应拉伸，充分使用底部区域。 4733 4734##### 使用 4735 47361.启动应用，查看本应用在全屏状态下的效果。 4737 47382.在应用顶部，下滑出现窗口操作按钮。（建议通过外接鼠标操作，接入鼠标只需要将鼠标移动至顶部即可出现窗口） 4739 47403.点击悬浮图标，将应用悬浮在其他界面上显示。 4741 47424.拖动应用悬浮窗口的四个顶角，改变窗口尺寸，触发应用显示刷新。改变窗口尺寸的过程中，窗口尺寸可能超出屏幕尺寸，此时在屏幕中只能看到应用部分区域的显示。可以通过移动窗口位置，查看应用其它区域的显示。 4743 4744##### 基本原理 4745 4746本示例介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口，将页面分拆为4个部分。 4747###### 标题栏 4748由于在不同断点下，标题栏始终只显示“返回按钮”、“歌单”以及“更多按钮”，但“歌单”与“更多按钮”之间的间距不同。 4749通过栅格实现：将标题栏划分为“返回按钮及歌单”和“更多按钮”两部分，这两部分在不同断点下占据的列数不同。 4750###### 歌单封面 4751通过栅格实现歌单封面，它由封面图片、歌单介绍及常用操作三部分组成这三部分的布局在md和lg断点下完全相同，但在sm断点下有较大差异。 47521、在sm断点下，封面图片和歌单介绍占满12列，常用操作此时会自动换行显示。 47532、在lg和md断点下，封面图片，歌单和常用操作各占一行中显示。 4754###### 歌单列表 4755通过List组件的lanes属性实现：在不同断点下，歌单列表的样式一致，但sm和md断点下是歌单列表是单列显示，lg断点下是双列显示。 4756###### 播放控制栏 4757通过Blank组件实现拉伸能力：在不同断点下，播放控制栏显示的内容完全一致，唯一的区别是歌曲信息与播放控制按钮之间的间距有差异。 4758###### 总体运行效果 4759通过在首页Column()中引用上述各组件后，可实现首页的组件整合渲染，即可完成整体页面开发。 4760 4761##### 约束与限制 4762 4763开发语言：ArkTS 4764 4765配套版本：API9版本SDK，版本号：3.2.11.9 4766 4767[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/MusicAlbum) 4768 4769#### 一多设置典型页面 4770 4771##### 介绍 4772 4773本示例使用[Navigation组件](reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md)，实现小窗口单栏显示、大窗口双栏显示的效果，结合[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，保证应用在不同设备或不同窗口尺寸下可以正常显示。 实现单/双栏的显示效果、 实现点击跳转或刷新、 实现多级跳转。展示设置应用的典型页面，其在小窗口和大窗口有不同的显示效果，体现一次开发、多端部署的能力。 4774 4775##### 使用 4776 47771. 启动应用，查看应用在全屏状态下的显示效果。 47782. 依次点击`WLAN` -> `更多WLAN设置`，查看应用的显示效果。 47793. 依次点击`更多连接`->`NFC`，查看应用的显示效果。 47804. 在应用顶部，下滑出现窗口操作按钮。（建议通过外接鼠标操作，接入鼠标只需要将鼠标移动至顶部即可出现窗口） 47815. 点击悬浮图标，将应用悬浮在桌面上显示。 47826. 拖动应用悬浮窗口改变窗口尺寸，触发应用显示刷新。改变窗口尺寸的过程中，窗口尺寸可能超出屏幕尺寸，此时在屏幕中只能看到应用部分区域的显示。可以通过移动窗口位置，查看应用其它区域的显示。 47837. 重复步骤2和3，查看应用在不同窗口尺寸下的显示效果。 4784 4785##### 基本原理 4786 4787本示例介绍如何实现不同断点下存在单栏和双栏设计的场景，主要有以下三方面： 4788###### 实现单/双栏的显示效果 4789通过Navigation组件实现单/双栏展示，由Navbar(设置主页面)和Content(跳转子页面)两部分区域组成，Navigation组件支持Stack、Split以及Auto三种模式。 47901、stack模式：导航栏与内容区独立显示，相当于多个页面。展示效果：从Navbar(设置主页面)跳转到Content1(WLAN页面)跳转到Content2(更多WLAN模式)。 47912、Split模式：导航栏与内容区分两栏显示。展示效果：Navbar+Content1。 47923、auto模式：Navigation组件可以根据应用窗口尺寸，自动选择合适的模式：窗口宽度小于520vp时，采用Stack模式显示；窗口宽度大于等于520vp时，采用Split模式显示。当窗口尺寸发生改变时，Navigation组件也会自动在Stack模式和Split模式之间切换。 4793 4794###### 实现点击跳转或刷新 4795Navigation组件通常搭配NavRouter组件以及NavDestination组件一起使用： 4796* NavRouter组件用于控制Navigation组件Content区域的显示和刷新逻辑：其必须包含两个孩子节点。 47971、容器类组件-直接控制NavRouter的显示效果。 47982、NavDestination组件：刷新Navigation组件Content区域的显示。 47993、NavRouter组件通过onStateChange回调事件，用于通知开发者NavRouter的状态：用户点击NavRouter，激活NavRouter并加载对应的NavDestination子组件时，回调onStateChange(true)； 48004、NavRouter对应的NavDestination子组件不再显示时，回调onStateChange(false)。 4801* NavDestination组件用于实际刷新Navigation组件Content区域的显示。 4802* 例如：在本示例中wlan功能项为NavRouter的第一个孩子节点，跳转的子页面WLAN为NavRouter的第二个孩子节点。 4803 4804###### 实现多级跳转 4805Navigation组件支持自动切换单栏和双栏的显示效果，同时可以根据当前状态自动添加返回键及响应系统的返回键事件。 48061、通过激活SettingList中的WLANSettingItem，可以加载及显示WlanSetting。 48072、激活WlanSetting中的WlanMoreSettingItem，可以加载及显示WlanMoreSetting。 4808 4809##### 约束与限制 4810 4811开发语言：ArkTS 4812 4813配套版本：API9版本SDK，版本号：3.2.11.9 4814 4815[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/Settings) 4816 4817#### 一多天气 4818 4819##### 介绍 4820 4821本示例使用[SideBarContainer](reference/apis-arkui/arkui-ts/ts-container-sidebarcontainer.md)实现侧边栏功能，[栅格容器组件](reference/apis-arkui/arkui-ts/ts-container-gridrow.md)实现界面内容的分割和展示，[Canvas组件](reference/apis-arkui/arkui-ts/ts-components-canvas-canvas.md)和[CanvasRenderingContext2D](reference/apis-arkui/arkui-ts/ts-canvasrenderingcontext2d.md) 完成空气质量和日出月落图的曲线绘制，再结合[一次开发，多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)的指导中响应式布局的栅格断点系统实现在不同尺寸窗口界面上不同的显示效果。展示一个天气应用界面，包括首页、城市管理、添加城市、更新时间弹窗，体现一次开发，多端部署的能力。 4822 4823##### 使用 4824 48251.启动应用后，首页展示已添加城市的天气信息，默认展示2个城市，左右滑动可以切换城市，在LG设备上，默认显示侧边栏，侧边栏显示时，右侧内容区占2/3，侧边栏隐藏时，内容区自动铺满界面。 4826 48272.在支持窗口自由拖拽的设备上，拖拽窗口大小，可以分别实现拖动到最大窗口侧边栏显示（点击侧边栏控制按钮可以隐藏和显示侧边栏），拖动窗口缩小到MD大小时侧边栏和侧边栏控制按钮隐藏。 4828 48293.在支持窗口自由拖拽的设备上，拖拽窗口大小，天气内容区跟随窗口大小会自动换行显示。 4830 48314.点击右上角菜单按钮，在菜单中点击**更新时间**，弹出更新时间弹窗，没有功能，此处只做展示，在平板设备上显示2列，在小屏设备上显示一列。 4832 48335.点击右上角菜单按钮，在菜单中点击**管理城市**，进入管理城市界面，展示已添加的城市，在平板设备上显示2列，在小屏设备上显示一列。 4834 48356.点击管理城市界面的**添加城市**，进入添加城市界面，已添加的城市不可点击，未添加的城市点击可以添加并返回管理城市界面显示。 4836 4837##### 基本原理 4838 48391、home.ets中引入SideContent()和homeContent()。 48402、定义showSideBar来判断是否展示侧边栏，定义mediaquery.MediaQueryListener媒体监听器smListener、mdListener、lgListener。 48413、在aboutToAppear调用mediaquery对界面进行监听。 48424、监听到当前屏幕大小，调用this.isBreakpoint断点，对curBp、showSideBar进行赋值。 4843 4844##### 约束与限制 4845 4846开发语言：ArkTS 4847 4848配套版本：API9版本SDK，版本号：3.2.11.9 4849 4850[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/Weather) 4851 4852#### 一多音乐典型场景 4853 4854##### 介绍 4855 4856本示例使用[一次开发多端部署](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/key-features/multi-device-app-dev)中介绍的自适应布局能力和响应式布局能力进行多设备（或多窗口尺寸）适配，展示了一个典型音乐场景示例。通过使用Grid组件提供窗口断点事件，保证音乐应用在不同设备或不同窗口尺寸下可以正常显示。 4857 4858##### 使用 4859 48601. 打开首页，在IDE编辑器中打开预览器查看预览效果。 4861 48622. 在预览器中开启窗口拖拽模式，拖动窗口变化，可以查看组件的响应式变化。 4863 48643. 手动自由拖拽窗口，将应用窗口在sm/md/lg三种设备形态下进行切换并查看预览效果。 4865 4866##### 基本原理 4867 4868**标题栏** 4869 4870不同容器尺寸下，元素位置不固定，采用[GridRow](reference/apis-arkui/arkui-ts/ts-container-gridrow.md)组件进行栅格布局。在sm/md断点下，标题栏所有元素占两行，在lg断点下，所有元素只占一行。 4871 4872**轮播图** 4873 4874使用[Swiper](reference/apis-arkui/arkui-ts/ts-container-swiper.md)组件，通过动态设置[displaycount](reference/apis-arkui/arkui-ts/ts-container-swiper.md#属性)属性，显示图片数量根据[窗口断点](reference/apis-arkui/arkui-ts/ts-container-gridrow.md#gridrowdirection枚举说明)进行自适应变化。在sm断点下显示一张图片，在md断点下显示两张图片，lg断点下通过if关键字切换成[Row](reference/apis-arkui/arkui-ts/ts-container-row.md)容器进行布局。 4875 4876**音乐分类** 4877 4878使用List组件的自带延伸布局能力，元素随容器组件尺寸变化显示或隐藏。 4879 4880**歌单列表/我的歌单** 4881 4882使用[Grid](reference/apis-arkui/arkui-ts/ts-container-grid.md)组件进行响应式布局，元素数量根据[窗口断点](reference/apis-arkui/arkui-ts/ts-container-gridrow.md#gridrowdirection枚举说明)进行自适应变化。 4883 4884##### 约束与限制 4885 4886开发语言：ArkTS 4887 4888配套版本：API10版本SDK，版本号：4.0.10.10 4889 4890[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/MultiDeviceAppDev/Weather) 4891 4892### 卡片 4893 4894#### JS多设备自适应服务卡片 4895 4896##### 介绍 4897 4898本示例使用卡片扩展模块接口[@ohos.app.form.FormExtensionAbility](reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md) 、卡片信息和状态等相关类型和枚举接口[@ohos.app.form.formInfo](reference/apis-form-kit/js-apis-app-form-formInfo.md) 、卡片数据绑定的能力接口[@ohos.app.form.formBindingData](reference/apis-form-kit/js-apis-app-form-formBindingData.md) 。展示Js工程中服务卡片的布局和使用，其中卡片内容显示使用了一次开发，多端部署的能力实现多设备自适应。 4899 4900##### 使用 4901 4902长按示例应用，等待出现服务卡片字样，点击后可左右滑动选择需要的卡片尺寸，添加到屏幕。 4903 4904##### 基本原理 4905 49061、在module.json5文件添加拓展能力，类型为卡片，并设置卡片入口srcEntrance和卡片元数据metadata。例如："metadata": [ 4907{ 4908"name": "ohos.extension.form", 4909"resource": "$profile:form_config" 4910}。 49112、初始化卡片：通过实现@ohos.app.form.FormExtensionAbility卡片操作类，在卡片对象首次被创建时，初始化卡片绑定数据为空，并将卡片状态设置为就绪状态READY。 例如：onCreate(){ 4912formBindingData.createFormBindingData({}) onAcquireFormState(want) { 4913return formInfo.FormState.READY }。 49143、配置卡片：用js编写相应的卡片，将卡片配置到resources/base/profile/form_config。 4915 4916##### 约束与限制 4917 4918开发语言：JS 4919 4920配套版本：API9版本SDK，版本号：3.2.11.9 4921 4922[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/AdaptiveServiceWidget) 4923 4924#### ArkTS卡片 4925 4926##### ArkTS卡片计算器 4927 4928##### 介绍 4929 4930本示例展示了使用ArkTS卡片开发的计算器模型。部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 4931 4932##### 使用 4933 49341.部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 4935 4936##### 基本原理 4937 4938不涉及 4939 4940##### 约束与限制 4941 4942开发语言：ArkTS 4943 4944配套版本：API9版本SDK，版本号：3.2.12.5 4945 4946[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/ArkTSCard/Calculator) 4947 4948##### ArkTS卡片Canvas小游戏 4949 4950##### 介绍 4951 4952本示例展示了如何通过ArkTS卡片的Canvas自定义绘制能力实现一个简单的五子棋游戏卡片。 4953 4954- 使用Canvas绘制棋盘和黑白棋子的落子。 4955- 通过卡片支持的[点击事件](reference/apis-arkui/arkui-ts/ts-universal-events-click.md)进行交互，让用户在棋盘上进行黑白棋子的对局。 4956- 通过TS的逻辑代码实现五子棋输赢判定、回退等逻辑计算，整个游戏过程无需拉起FormExtensionAbility。 4957 4958##### 使用 4959 49601.部分设备的桌面不支持卡片，可以通过自己开发的卡片使用方，进行卡片的创建、更新和删除等操作。 4961 49622.安装应用，并在桌面上长按本应用的桌面图标，长按后弹出选项列表。 4963 49643.点击弹出列表中的**服务卡片**选项进入卡片预览界面。 4965 49664.点击正下方的**添加到桌面**按钮，卡片就会出现在桌面上。 4967 49685.卡片添加到桌面后就可以在桌面进行五子棋游戏，包含黑白棋子的落子、重新开始、悔棋等操作。 4969 4970##### 基本原理 4971 4972- 界面绘制：通过Canvas画布组件进行绘制，在Canvas组件收到onReady回调时取出context的width和height作为画布的大小。 4973- 逻辑处理：通过注册Canvas画布onClick点击事件，并取出回调中的ClickEvent入参，这个对象中包含了点击的x轴和y轴坐标，通过坐标信息进行点击位子匹配就可以实现黑白棋子的落子。 4974 4975##### 约束与限制 4976 4977开发语言：ArkTS 4978 4979配套版本：API9版本SDK，版本号：3.2.12.5 4980 4981[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/ArkTSCard/CanvasGame) 4982 4983##### ArkTS音乐卡片 4984 4985##### 介绍 4986 4987本示例展示了如何通过ArkTS卡片实现一个简单的音乐卡片。 4988 4989##### 使用 4990 49911.安装应用，并在桌面上长按本应用的桌面图标，长按后弹出选项列表。 4992 49932.点击弹出列表中的服务卡片选项进入卡片添加界面。 4994 49953.点击正下方的添加到桌面按钮，卡片就会出现在桌面上。 4996 4997##### 基本原理 4998 4999不涉及。 5000 5001##### 约束与限制 5002 5003开发语言：ArkTS 5004 5005配套版本：API9版本SDK，版本号：3.2.12.5 5006 5007[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/ArkTSCard/MusicControl) 5008 5009#### Stage模型卡片 5010 5011##### 介绍 5012 5013本示例使用卡片扩展模块接口[@ohos.app.form.FormExtensionAbility](reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md) 、卡片信息和状态等相关类型和枚举接口[@ohos.app.form.formInfo](reference/apis-form-kit/js-apis-app-form-formInfo.md) 、卡片提供方相关接口的能力接口[@ohos.app.form.formProvider](reference/apis-form-kit/js-apis-app-form-formProvider.md) 、应用组件间的信息传递接口[@ohos.app.ability.Want](reference/apis-ability-kit/js-apis-app-ability-want.md) 。展示了Stage模型卡片提供方的创建与使用。 5014 5015##### 使用 5016 50171.部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 5018 50192.卡片的样式如"添加卡片"所示。当卡片更新时，卡片上的温度和时间会产生变化。 5020 50213.安装[卡片应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Widget/FormExtAbility/processProxyForm)或[formProvider应用](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Widget/FormExtAbility/persistentProxyForm)，长按卡片应用图标或formProvider应用图标弹出菜单，点击"服务卡片"选项可以添加服务卡片至桌面（第3张，第4张卡片为formProvider应用卡片；第5张，第6张为卡片应用卡片）； 5022 50234.长按数据卡片弹出菜单，点击"移除"可以将已添加至桌面的数据卡片从桌面上移除； 5024 50255.点击打开卡片应用图标或formProvider应用图标，点击"修改订阅条件"按键，界面将跳转至修改订阅条件界面，对应选择想要发布的数据完成对订阅条件的修改，离开页面或退出应用后再次打开修改订阅条件页面，页面单选框会显示当前订阅的城市； 5026 50276.在卡片应用或formProvider应用应用中点击"发布数据"按键，界面将跳转至数据发布界面，对应选择想要发布的数据并点击"发布数据"完成数据发布(若选择发布的城市与当前订阅城市不一致，则不能将数据更新至卡片)； 5028 5029##### 基本原理 50301、在module.json5文件添加拓展能力，类型为卡片，并设置卡片入口srcEntrance和卡片元数据metadata。 50312、初始化卡片：通过实现@ohos.app.form.FormExtensionAbility卡片操作类，在卡片对象首次被创建时，初始化卡片绑定数据为空，并将卡片状态设置为就绪状态READY。 50323、配置卡片：用js编写相应的卡片，将卡片配置到resources/base/profile/form_config。 5033 5034##### 约束与限制 5035 5036开发语言：ArkTS 5037 5038配套版本：API10版本SDK，版本号：4.0.10.7 5039 5040[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Widget/FormExtAbility) 5041 5042#### Stage模型卡片小游戏 5043 5044##### 介绍 5045 5046本示例展示了如何通过Stage模型实现一个简单的游戏卡片。 5047 5048- 通过卡片支持的[点击事件](reference/apis-arkui/js-service-widget-ui/js-service-widget-common-events.md)进行交互，让用户通过点击的先后顺序把一个乱序的成语排列成正确的成语。 5049- 使用了C++和TS的混合编程方式，将获取随机数的能力下沉到C++实现，并通过[NAPI](napi/napi-guidelines.md)的能力将C++实现的能力暴露到TS中。 5050- 用到了卡片扩展模块接口，[@ohos.app.form.FormExtensionAbility](reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md) 。 5051 5052##### 使用 5053 50541.部分设备的桌面不支持卡片，可以通过自己的开发卡片使用方，进行卡片的创建、更新和删除等操作。 5055 50562.安装应用，并在桌面上长按本应用的桌面图标，长按后弹出选项列表。 5057 50583.点击弹出列表中的**服务卡片**选项进入卡片添加界面。 5059 50604.点击正下方的**添加到桌面**按钮，卡片就会出现在桌面上。 5061 5062##### 基本原理 5063 50641、在module.json5文件添加拓展能力，类型为卡片，并设置卡片入口srcEntrance和卡片元数据metadata。 50652、配置卡片：用js编写相应的卡片，将卡片配置到resources/base/profile/form_config。 50663、定义小游戏逻辑：实现FormExtensionAbility中addform时初始化数据(本sample中使用的是mock数据)，并将数据存储到dataStore，通过调用c++随机数，将成语顺序打乱显示， 50674、监听卡片变化：通过onformEvent()监听卡片事件，更新已选择的成语数据，并随机替换成语待选列表的已被选掉的word。 5068 5069##### 约束与限制 5070 5071开发语言：ArkTS 5072 5073配套版本：API9版本SDK，版本号：3.2.11.9 5074 5075[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SuperFeature/Widget/FormGame) 5076 5077#### 应用主动添加数据代理卡片到桌面 5078 5079##### 介绍 5080 5081本示例主要展示了使用[@ohos.app.form.formBindingData](reference/apis-form-kit/js-apis-app-form-formBindingData.md)、[@ohos.app.form.formProvider](reference/apis-form-kit/js-apis-app-form-formProvider.md)等接口，实现了在com.ohos.hag.famanager应用上，主动添加数据代理卡片到桌面的功能。 5082 5083##### 使用 5084 50851. 点击桌面上AppStore应用图标，打开com.ohos.hag.famanager应用。 5086 50872. 点击按钮<添加ArkTs卡片到桌面>或<添加Js卡片到桌面>按钮，AppStore应用自动切到后台并且开始将数据代理卡片添加到桌面。 5088 50893. 桌面切到前台显示后，刷新组件并将添加的数据代理卡片显示到页面上。 5090 5091##### 基本原理 5092 5093- 发布ArkTs数据代理卡片到桌面 5094 - 使用requestPublishForm接口，将应用内的ArkTs数据代理卡片主动添加到桌面上，接口参考：[@ohos.app.form.formProvider](reference/apis-form-kit/js-apis-app-form-formProvider.md) 5095- 发布Js数据代理卡片到桌面 5096 - 使用requestPublishForm接口，将应用内的Js数据代理卡片主动添加到桌面上，接口参考：[@ohos.app.form.formProvider](reference/apis-form-kit/js-apis-app-form-formProvider.md) 5097 5098##### 约束与限制 5099 5100开发语言：ArkTS 5101 5102配套版本：API10版本SDK，版本号：4.0.8.5 5103 5104[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Widget/RequestAddForm) 5105 5106 5107 5108## 系统特性 5109 5110### 应用模型 5111 5112#### AccessibilityExtensionAbility示例 5113 5114##### 介绍 5115 5116本示例展示了[AccessibilityExtensionAbility](accessibility/accessibilityextensionability.md)的简单应用，使用多个辅助功能接口，启动或关闭无障碍扩展服务，实现了一些快捷的交互方式。 5117 5118##### 使用 5119 51201. 在启动无障碍扩展服务前，需退出当前应用保证界面节点正常生成； 51212. 启动关闭无障碍扩展服务可参考[AccessibilityExtensionAbility开发指南](accessibility/accessibilityextensionability.md), 服务连接状态将显示在屏幕上; 51223. 启动无障碍扩展服务后，在设备屏幕上绘画右划后再下划的手势`rightThenDown`获取当前界面全部节点，之后绘画左划后再下划的手势`leftThenDown`打印所有节点的指定信息； 51234. 在设备屏幕上绘画左划手势`left`对按钮`获焦`进行聚焦，之后可通过绘画右划手势`right`取消对按钮聚焦； 51245. 在设备屏幕上绘画下划手势`down`，触发对按钮`未点击/已点击`的点击动作。 5125 5126##### 基本原理 5127 5128* 获取界面元素、查询元素指定信息、通过text查找元素和获取元素执行指定动作的功能封装在AccessibilityManager： 5129 * 使用 [getWindowRootElement()](reference/apis-accessibility-kit/js-apis-inner-application-accessibilityExtensionContext.md#accessibilityextensioncontextgetwindowrootelement) 获取界面根节点； 5130 * 获取元素属性值：使用AccessibilityUtils.getAttributeValue()； 5131 * 获取界面所有元素：基于获取的根元素，使用AccessibilityUtils.createElementArray()获取界面所有元素； 5132 * 打印界面元素指定信息：使用AccessibilityUtils.getElementWantedInfo()获取元素指定的信息； 5133 * 寻找指定元素：使用AccessibilityUtils.findElementByKey()。 5134 5135##### 约束与限制 5136 5137开发语言：ArkTS 5138 5139配套版本：API9版本SDK，版本号：3.2.11.9 5140 5141[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/AccessibilityExtAbility) 5142 5143#### EnterpriseAdminExtensionAbility的创建与使用 5144 5145##### 介绍 5146 5147本示例通过[@ohos.enterprise.EnterpriseAdminExtensionAbility](reference/apis-mdm-kit/js-apis-EnterpriseAdminExtensionAbility.md)接口实现了系统管理状态变化通知功能，[@ohos.enterprise.adminManager](reference/apis-mdm-kit/js-apis-enterprise-adminManager-sys.md)接口中enableAdmin方法去激活当前用户下的指定设备管理员应用，disableSuperAdmin方法去根据bundleName将管理员用户下的超级管理员应用去激活，subscribeManagedEvent方法去指定设备管理员应用订阅系统管理事件，unsubscribeManagedEvent方法去指定设备管理员应用取消订阅系统管理事件来实现应用激活、去激活、应用安装、卸载事件。 5148 5149##### 使用 5150 51511.启动应用后，点击激活设备管理器，会显示激活成功。由企业管理员或者员工部署MDM应用，激活设备管理器，系统通知MDM应用已激活DeviceAdmin权限。MDM应用可在onAdminEnable回调函数中进行初始化策略设置。 5152 51532.点击去激活设备管理器，会显示去激活成功。系统或者员工去激活设备管理器，应用可以通知企业管理员设备已脱管。 5154 51553.点击订阅应用安装卸载事件，会显示订阅成功。企业应用管理场景下，企业管理员订阅应用安装卸载事件，端侧应用安装和卸载事件通知MDM应用，MDM应用可以在回调函数中进行事件上报，通知企业管理员。 5156 51574.点击取消订阅应用安装卸载事件，会显示取消订阅成功。企业应用管理场景下，企业管理员取消订阅应用安装卸载事件。 5158 5159##### 基本原理 5160 5161* 该示例通过EnterpriseAdminExtensionAbility接口实现了系统管理状态变化通知功能，adminManager接口中enableAdmin方法去激活当前用户下的指定设备管理员应用，disableSuperAdmin方法去根据bundleName将管理员用户下的超级管理员应用去激活，subscribeManagedEvent方法去指定设备管理员应用订阅系统管理事件，unsubscribeManagedEvent方法去指定设备管理员应用取消订阅系统管理事件来实现应用激活、去激活、应用安装、卸载事件。 5162* 接口参考：[@ohos.enterprise.EnterpriseAdminExtensionAbility](reference/apis-mdm-kit/js-apis-EnterpriseAdminExtensionAbility.md)，[@ohos.enterprise.adminManager](reference/apis-mdm-kit/js-apis-enterprise-adminManager-sys.md)，[@ohos.app.ability.Want](reference/apis-ability-kit/js-apis-app-ability-want.md) 5163 5164##### 约束与限制 5165 5166开发语言：ArkTS 5167 5168配套版本：API9版本SDK，版本号：3.2.11.9 5169 5170[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/EnterpriseAdminExtensionAbility) 5171 5172#### 仿桌面应用 5173 5174##### 介绍 5175 5176本示例使用[@ohos.bundle.launcherBundleManager](reference/apis-ability-kit/js-apis-launcherBundleManager-sys.md)模块接口，获取所有应用信息和给定包名获取应用信息，实现桌面展示所有安装的应用。使用[@ohos.bundle](reference/apis-ability-kit/js-apis-Bundle-sys.md)的getBundleInstaller接口获取到，调用uninstall接口实现应用卸载功能。使用[@ohos.app.form.formHost](reference/apis-form-kit/js-apis-app-form-formHost-sys.md)接口，获取应用卡片信息，使用FormComponent组件展示卡片内容，从而实现添加卡片到桌面的功能。使用关系型数据库[@ohos.data.relationalStore](reference/apis-arkdata/js-apis-data-relationalStore.md)接口，实现桌面数据持久化存储，存储应用的位置信息，卡片信息。使用[@ohos.application.missionManager](reference/apis-ability-kit/js-apis-application-missionManager-sys.md)接口，获取最近任务信息，并实现加锁、解锁、清理后台任务的功能。使用[@ohos.app.ability.ServiceExtensionAbility](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.app.ability.ServiceExtensionAbility.d.ts)的startRecentAbility接口，拉起最近任务至前台显示，若应用Ability未启动时，则拉起新创建的应用Ability显示到前台。实现了一个简单桌面应用，概括为以下几点： 5177 51781.展示了系统安装的应用，实现点击启动、应用上滑弹出卡片、卡片添加到桌面、卡片移除功能。 5179 51802.实现桌面数据持久化存储，应用支持卸载、监听应用卸载和安装并显示。 5181 51823.实现最近任务管理功能，包括任务卡片加锁、解锁、清理和清理所有任务功能。 5183 51844.通过点击应用图标或点击由长按图标弹出的菜单栏中的打开按钮的方式打开应用，是以打开最近任务方式拉起应用Ability。 5185 5186##### 使用 5187 51881.安装编译的hap包，使用hdc shell aa start -b ohos.samples.launcher -a MainAbility命令启动应用，应用启动后显示系统安装的应用。 5189 51902.点击应用主界面上的应用图标可以启动应用，长按弹出菜单，点击打开可以正常启动应用。 5191 51923.图库等支持卡片的应用，长按菜单中有服务卡片，点击进入卡片预览界面，在卡片预览界面点击**添加到桌面**，返回到桌面并且卡片成功添加到桌面。 5193 51944.上滑图库等支持卡片的应用，可以弹出默认上滑卡片，点击上滑卡片右上角的**+**图标，可以添加卡片到桌面。 5195 51965.应用在桌面界面，使用hdc install安装一个应用，桌面可以监听到应用安装，并显示新安装的应用到桌面上。 5197 51986.应用在桌面界面，使用hdc uninstall 卸载第5步安装的应用，桌面可以监听到卸载，并移除桌面上的应用。 5199 52007.在桌面空白处上滑，可以进入最近任务管理界面，下滑任务卡片可以加锁/解锁，上滑卡片可以清理该后台任务，点击垃圾桶可以清除所有后台任务（加锁的应用不会被清理掉）。 5201 5202##### 基本原理 5203 5204* 获取应用功能模块 5205 * 使用launcherBundleManager模块接口（系统能力：SystemCapability.BundleManager.BundleFramework），获取所有应用信息和给定包名获取应用信息，实现桌面展示所有安装的应用。使用on接口监听应用的安装和卸载从而实现应用安装和卸载刷新桌面。 5206 * 接口参考：[@ohos.bundle.launcherBundleManager](reference/apis-ability-kit/js-apis-launcherBundleManager-sys.md) 5207 5208* 应用卸载功能模块 5209 * 使用bundle模块的getBundleInstaller接口获取到BundleInstaller（系统能力：SystemCapability.BundleManager.BundleFramework），调用uninstall接口实现应用卸载功能。 5210 * 接口参考：[@ohos.bundle](reference/apis-ability-kit/js-apis-Bundle-sys.md) 5211 5212* 添加卡片功能模块 5213 * 使用formHost接口（系统能力：SystemCapability.Ability.Form），获取应用卡片信息，使用FormComponent组件展示卡片内容，从而实现添加卡片到桌面的功能。 5214 * 接口参考：[@ohos.app.form.formHost](reference/apis-form-kit/js-apis-app-form-formHost-sys.md) 5215 5216* 桌面数据持久化存储功能模块 5217 * 使用关系型数据库rdb接口（系统能力：SystemCapability.DistributedDataManager.RelationalStore.Core），实现桌面数据持久化存储，存储应用的位置信息，卡片信息。 5218 * 接口参考：[@ohos.data.relationalStore](reference/apis-arkdata/js-apis-data-relationalStore.md) 5219 5220* 加锁、解锁、清理后台任务功能模块 5221 * 使用missionManager模块接口（系统能力：SystemCapability.Ability.AbilityRuntime.Mission），获取最近任务信息，并实现加锁、解锁、清理后台任务的功能。 5222 * 接口参考：[@ohos.application.missionManager](reference/apis-ability-kit/js-apis-application-missionManager-sys.md) 5223 5224* 点击桌面应用拉起最近任务至前台功能模块 5225 * 使用ServiceExtensionContext模块的startRecentAbility接口（系统能力：SystemCapability.Ability.AbilityRuntime.Core），拉起最近任务至前台显示，若应用Ability未启动时，则拉起新创建的应用Ability显示到前台。 5226 * 接口参考：[@ohos.app.ability.ServiceExtensionAbility](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.app.ability.ServiceExtensionAbility.d.ts) 5227 5228##### 约束与限制 5229 5230开发语言：ArkTS 5231 5232配套版本：API10版本SDK，版本号：4.0.9.6 5233 5234[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/Launcher) 5235 5236#### 系统任务管理 5237 5238##### 介绍 5239 5240本示例通过调用系统任务管理的能力，使用[@ohos.application.missionManager](reference/apis-ability-kit/js-apis-application-missionManager-sys.md) 、[@ohos.multimedia.image](reference/apis-image-kit/js-apis-image.md) 等接口完成对系统任务执行锁定、解锁、清理、切换到前台等操作。 5241 5242##### 使用 5243 52441.下拉“**获取系统任务信息**”，获取当前系统任务的包名、运行状态、锁定状态、任务是否支持迁移、任务快照等信息列表，且最多可获取10条任务； 5245 52462.左滑任务列表，点击“**锁定**”，即可锁定指定的任务； 5247 52483.若当前任务已锁定，可点击“**解锁**”，即可解锁指定的任务； 5249 52504.点击“**删除**”，即可删除指定的任务； 5251 52525.点击“**移动**”，即可将指定的任务移动到前台执行。 5253 5254##### 基本原理 5255 5256* 任务执行锁定、解锁、清理、切换到前台等操作的功能结构主要封装在Index、MissionInfoComponent 5257 * 获取任务信息：在Index页面中通过missionManager.getMissionInfos()方法来获取所有的mission； 5258 * 执行或者解锁锁定任务：在MissionInfoComponent组件当中可以通过missionManager.lockMission(missionId)方法来锁定指定的mission，而missionManager.unlockMission(missionId)用来解锁mission; 5259 * 移动指定的任务：将指定的任务移动到前台执行可以使用missionManager.moveMissionToFront(missionId)方法； 5260 * 删除指定的任务：删除指定的任务可以通过missionManager.clearMission(missionId)方法实现。 5261 5262##### 约束与限制 5263 5264开发语言：ArkTS 5265 5266配套版本：API9版本SDK，版本号：3.2.12.5 5267 5268[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/MissionManager) 5269 5270#### 静态订阅 5271 5272##### 介绍 5273 5274本示例主要展示了静态订阅的创建与使用，以及静态订阅的使能和去使能。通过[CommonEventManager](reference/apis-basic-services-kit/js-apis-commonEventManager.md)发布自定义事件，使能和去使能静态订阅。通过[StaticSubscriberExtensionAbility](reference/apis-basic-services-kit/js-apis-application-staticSubscriberExtensionAbility-sys.md)、[NotificationManager](reference/apis-notification-kit/js-apis-notificationManager.md)静态订阅已发布的自定义事件，订阅后即可自动收到该事件，收到该事件后，发送通知将自定义事件数据显示在通知栏。 5275 5276##### 使用 5277 52781. 在entry/src/main/resources/base/profile/subscribe.json中添加需要订阅的目标事件。 5279 52802. 修改系统配置文件/system/etc/app/install_list_capability.json，将应用的包名添加至该json文件中。 5281 52823. 本示例编译后共有两个hap包，包括静态订阅hap包和自定义事件发布hap包，需要全部安装。静态订阅hap包需要签名成系统应用并安装才可实现对目标事件的静态订阅，安装后即默认订阅了目标事件；自定义事件发布hap包直接安装即可，发布事件后即可被静态订阅方收到。 5283 52844. 点击关闭静态订阅按钮将不再进行静态订阅，不会收到相关通知，点击开启静态订阅会重新恢复。 5285 5286##### 基本原理 5287 5288* 通过CommonEventManager.publish方法发布自定义事件，该自定义事件为数据传输事件。 5289 5290* 接口参考：[@ohos.commonEventManager](reference/apis-basic-services-kit/js-apis-commonEventManager.md) 5291 5292* 通过CommonEventManager.setStaticSubscriberState方法为当前应用设置静态订阅事件使能或去使能状态。 5293 5294* 接口参考：[@ohos.commonEventManager](reference/apis-basic-services-kit/js-apis-commonEventManager.md) 5295 5296* 通过StaticSubscriberExtensionAbility接口静态订阅已发布的自定义事件，订阅后即可自动收到该事件，收到该事件后，setNotificationEnable，ContentType方法发送通知将自定义事件数据显示在通知栏。 5297 5298* 接口参考：[@ohos.application.StaticSubscriberExtensionAbility](reference/apis-basic-services-kit/js-apis-application-staticSubscriberExtensionAbility-sys.md)，[@ohos.notificationManager](reference/apis-notification-kit/js-apis-notificationManager.md) 5299 5300##### 约束与限制 5301 5302开发语言：ArkTS 5303 5304配套版本：API10版本SDK，版本号：4.0.9.6 5305 5306[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/StaticSubscriber) 5307 5308#### 测试依赖 5309 5310##### 跨任务链返回 5311 5312##### 介绍 5313 5314本示例为一个仿桌面应用测试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），实现了跨任务链返回的功能。 5315 5316##### 使用 5317 53181.基于CrossChainBack工程（com.acts.abilityabacktoabilityb），对该工程编译产生的hap包进行手动签名。（仅CrossChainBack工程可实现跨任务链返回功能）。 5319 53202.安装签名成功后的hap包，启动仿桌面（Launcher）。 5321 53223.点击应用主界面上的应用图标，可以启动应用。 5323 53244.长按应用图标弹出菜单，点击打开，可以正常启动应用。 5325 53265.本应用包含：EntryAbility页面（页面中显示有"EntryAbility"文本）和SecondAbility页面（页面中显示有"SecondAbility"文本）。 5327 53286.在EntryAbility页面上点击StartSecondAbility按钮，打开SecondAbility，此时点击返回键，回到EntryAbility页面而不是桌面。 5329 5330##### 基本原理 5331 5332- 拉起任务至前台显示的功能接口封装在LauncherAbilityManager。 5333 - 跨任务链返回：在ServiceExtensionAbility，使用ServiceExtensionContext.startRecentAbility(),将Want中将"ABILITY_BACK_TO_OTHER_MISSION_STACK"(返回当前任务链字段)设置为"true",以实现返回至打开ServiceExtensionAbility的ability的功能。 5334 - 接口参考：[@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) 5335 5336##### 约束与限制 5337 5338开发语言：ArkTS 5339 5340配套版本：API9版本SDK，版本号：3.2.11.9 5341 5342[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/TestRely/LauncherTest/CrossChainBack) 5343 5344##### 启动上一次的组件实例 5345 5346##### 介绍 5347 5348本示例为一个仿桌面应用测试demo，测试的功能为：点击仿桌面应用上的应用图标，若应用未启动则启动应用，若应用已经被启动并创建多个实例则启动上一次拉起的实例。 5349 5350##### 使用 5351 53521.基于StartRecentAbility工程（com.acts.startrecentability），对该工程编译产生的hap包进行手动签名。（仅StartRecentAbility工程可实现启动上一次的组件实例功能）。 5353 53542.安装签名成功后的hap包，启动仿桌面（Launcher）。 5355 53563.点击应用主界面上的应用图标，可以启动应用。 5357 53584.长按应用图标弹出菜单，点击打开，可以正常启动应用。 5359 53605.打开EntryAbility页面，页面中会有时间戳显示，点击"StartEntryAbility"按钮，新建一个EntryAbility实例，会有一个新的时间戳显示，此时点击home键回到桌面，点击应用图标打开应用，会看到时间戳显示为第二个时间戳。 5361 53626.打开EntryAbility页面，会有时间戳显示，点击"startSingletonAbility"按钮，打开单实例的SecondAbility（页面中显示"SingletonAbility"），当打开SecondAbility后，点击home键回到桌面，点击应用图标打开应用，显示为EntryAbility且时间戳内容未改变。 5363 5364##### 基本原理 5365 5366- 应用启动的功能接口封装在LauncherAbilityManager： 5367 - 启动上次打开的的组件实例：拉起上次打开的任务至前台显示，若应用Ability未启动时，则拉起新创建的应用Ability显示到前台。 5368 5369##### 约束与限制 5370 5371开发语言：ArkTS 5372 5373配套版本：API9版本SDK，版本号：3.2.11.9 5374 5375[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/ApplicationModels/TestRely/LauncherTest/StartRecentAbility) 5376 5377### 网络与连接 5378 5379#### 蓝牙 5380 5381##### 介绍 5382 5383本示例通过[@ohos.bluetooth](reference/apis-connectivity-kit/js-apis-bluetooth.md) 接口实现蓝牙设备发现、配对、取消配对功能。 5384 5385##### 使用 5386 53871.启动应用，若蓝牙本来就打开的，系统会直接搜索周围可配对的设备，若蓝牙未打开，打开开关。 5388 53892.搜索到附近的设备后，选择需要配对的设备，点击该设备，会跳出匹配弹窗，若确定匹配，点击**匹配**按钮，否则点击**取消**按钮。 5390 53913.匹配后，若想删除匹配的设备，点击已配对的设备列表中的设备，会跳出断开连接弹窗，若确定删除该设备，点击**确定**，否则点击**取消**。 5392 5393##### 基本原理 5394 5395* 蓝牙设备发现、配对、取消配对等操作的功能结构主要封装在Index、PinDialog： 5396 * 启动和关闭蓝牙：在Index页面中通过Toggle组件的onChange函数来控制蓝牙的开关，开关打开的情况下会执行initBluetooth函数，关闭的情况下执行bluetooth.disableBluetooth()方法来断开蓝牙； 5397 * 验证蓝牙是否处于连接状态：蓝牙打开的时候通过bluetooth.on('stateChange')方法来监听蓝牙连接状态改变事件，确认已打开，则执行foundDevices()函数来查找设备接口，确认已关闭则执行bluetooth.stopBluetoothDiscovery()方法来停止查询接口。 5398 * 发现设备：在foundDevices()函数中通过bluetooth.on('bluetoothDeviceFind')方法来监听设备发现事件，并且通过bluetooth.getPairedDevices()方法来更新已配对蓝牙地址，然后通过bluetooth.startBluetoothDiscovery()方法开启蓝牙扫描，去发现远端设备，并且通过bluetooth.setBluetoothScanMode()方法来被远端设备发现。 5399 * 蓝牙配对：通过bluetooth.on('pinRequired')方法来监听远端蓝牙设备的配对请求事件，点击配对执行bluetooth.setDevicePairingConfirmation(this.data.deviceId, true)方法，点击取消执行bluetooth.setDevicePairingConfirmation(this.data.deviceId, false)方法。 5400 * 取消配对：最后通过bluetooth.cancelPairedDevice()来断开指定的远端设备连接。 5401 5402##### 约束与限制 5403 5404开发语言：ArkTS 5405 5406配套版本：API9版本SDK，版本号：3.2.12.5 5407 5408[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Connectivity/Bluetooth) 5409 5410#### WLAN 5411 5412##### 介绍 5413 5414本示例通过[@ohos.wifiManager](reference/apis-connectivity-kit/js-apis-wifiManager-sys.md) 相关API实现wlan激活和关闭、扫描和连接WIFI等功能。 5415 5416##### 使用 5417 54181. 启动应用后会判断WLAN是否激活，如果是激活状态，会扫描并展示可用WiFi列表，同时获取已连接WiFi信息并展示； 5419 54202. 点击界面的Switch开关可以禁用和激活WLAN，界面会监听WLAN状态扫描可用WiFi列表，也会监听WiFi连接状态展示已连接WiFi； 5421 54223. 点击可用WLAN列表中的WLAN信息，可以连接WiFi，如果是加密类型，会弹窗输入密码后连接； 5423 54244. 点击首页右上角的**关于**图标，进入关于界面，展示获取的IP信息、国家码和支持WLAN相关特性信息。 5425 5426##### 基本原理 5427 5428* wlan激活和关闭功能：点击首页的切换按钮，如果是打开，使用wifi.enableWifi()开启wifi；如果是关闭，则使用wifi.disconnect()断开wifi，然后使用wifi.disableWifi()关闭wifi， 5429 5430* wifi的连接、扫描、获取详细信息等功能封装在WifiModel模块中。 5431 * wifi的连接功能：点击wifi列表中加密的wifi，并在弹窗中输入密码后，通过WifiModule.connectNetwork()调用wifi.connectToDevice()连接wifi。 5432 * wifi的扫描功能：进入后就会间歇性的调用wifi.scan()开启扫描，然后通过WifiModel模块中的getScanInfos()调用wifi.getScanResults()来获取扫描的结果。 5433 * 获取wifi的详细信息：通过WiFiModel中的getIpInfo()、getCountryCode()、getFeatureSupport()分别调用wifi.getIpInfo()、wifi.getCountryCode()、wifi.isFeatureSupported()来获取对应信息。 5434 5435##### 约束与限制 5436 5437开发语言：ArkTS 5438 5439配套版本：API9版本SDK，版本号：3.2.11.9 5440 5441[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Connectivity/Wlan) 5442 5443### 数据管理 5444 5445#### 跨应用数据共享 5446 5447##### 介绍 5448 5449本示例使用数据共享扩展能力[@ohos.data.DataShareResultSet](reference/apis-arkdata/js-apis-application-dataShareExtensionAbility-sys.md)，关系型数据库[@ohos.data.relationalStore](reference/apis-arkdata/js-apis-data-dataShare-sys.md)，[@ohos.data.rdb](reference/apis-arkdata/js-apis-data-rdb.md)实现了一个跨应用数据共享实例，分为联系人（数据提供方）和联系人助手（数据使用方）两部分：联系人支持联系人数据的增、删、改、查等功能；联系人助手支持同步联系人数据，当联系人与联系人助手数据不一致时，支持合并重复数据。 5450 5451##### 使用 5452 54531. 联系人应用，首页中点击**+**按钮可以添加联系人，在首页展示联系人列表。 54542. 联系人应用首页点击搜索框可以搜索联系人，点击联系人进入详情页，详情页提供编辑和删除功能入口。 54553. 联系人助手应用，点击同步联系人可以同步联系人应用的数据到联系人助手，同步后可以点击联系人进入详情页，详情页提供编辑和删除功能。 54564. 联系人助手首页点击**+**按钮，可以新增联系人。 54575. 联系人助手设置页面可以设置同步策略，根据不同的同步策略，每次点击首页的同步联系人按钮会同步一次联系人数据，默认使用联系人覆盖联系人助手策略。 5458 5459##### 基本原理 5460 5461* 使用DataShareExtensionAbility实现数据共享，关系型数据库实现数据的增、删、改、查接口，DataShare管理和访问数据库数据变化。 5462* 接口参考：[@ohos.data.DataShareResultSet](reference/apis-arkdata/js-apis-application-dataShareExtensionAbility-sys.md)，[@ohos.data.relationalStore](reference/apis-arkdata/js-apis-data-dataShare-sys.md)，[@ohos.data.rdb](reference/apis-arkdata/js-apis-data-rdb.md) 5463 5464##### 约束与限制 5465 5466开发语言：ArkTS 5467 5468配套版本：API9版本SDK，版本号：3.2.11.9 5469 5470[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DataManagement/CrossAppDataShare) 5471 5472### 设备管理 5473 5474#### 设备管理合集(系统特性) 5475 5476##### 介绍 5477 5478本示例集合设备管理相关(系统特性)不需要复杂功能展示的模块，展示了各个模块的基础功能，包含： 5479 5480- [@ohos.batteryStatistics (耗电统计)](reference/apis-basic-services-kit/js-apis-batteryStatistics-sys.md) 5481- [@ohos.brightness (屏幕亮度)](reference/apis-basic-services-kit/js-apis-brightness-sys.md) 5482- [@ohos.power (系统电源管理)](reference/apis-basic-services-kit/js-apis-power-sys.md) 5483- [@ohos.settings (设置数据项名称)](reference/apis-basic-services-kit/js-apis-settings.md) 5484- [@ohos.systemCapability (系统能力)](reference/apis-basic-services-kit/js-apis-system-capability-sys.md) 5485- [@ohos.systemParameterEnhance (系统参数)](reference/apis-basic-services-kit/js-apis-system-parameterEnhance-sys.md) 5486- [@ohos.batteryInfo (电量信息)](reference/apis-basic-services-kit/js-apis-battery-info-sys.md) 5487- [@ohos.deviceInfo (设备信息)](reference/apis-basic-services-kit/js-apis-device-info.md) 5488- [@ohos.multimodalInput.inputConsumer (组合按键)](reference/apis-input-kit/js-apis-inputconsumer-sys.md) 5489- [@ohos.multimodalInput.inputDevice (输入设备)](reference/apis-input-kit/js-apis-inputdevice.md) 5490- [@ohos.multimodalInput.inputEvent (输入事件)](reference/apis-input-kit/js-apis-inputevent.md) 5491- [@ohos.multimodalInput.inputEventClient (按键注入)](reference/apis-input-kit/js-apis-inputeventclient-sys.md) 5492- [@ohos.multimodalInput.inputMonitor (输入监听)](reference/apis-input-kit/js-apis-inputmonitor-sys.md) 5493- [@ohos.multimodalInput.keyCode (键值)](reference/apis-input-kit/js-apis-keycode.md) 5494- [@ohos.multimodalInput.keyEvent (按键输入事件)](reference/apis-input-kit/js-apis-keyevent.md) 5495- [@ohos.multimodalInput.mouseEvent (鼠标输入事件)](reference/apis-input-kit/js-apis-mouseevent.md) 5496- [@ohos.multimodalInput.pointer (鼠标指针)](reference/apis-input-kit/js-apis-pointer.md) 5497- [@ohos.multimodalInput.touchEvent (触摸输入事件)](reference/apis-input-kit/js-apis-touchevent.md) 5498 5499##### 使用 5500 55011.首页展示语言基础类库各个子模块菜单，点击进入对应的模块页面。 5502 55032.各个子模块界面中点击功能按钮完成各个功能。 5504 55053.耗电统计：进入耗电统计页面，展示软硬件耗电排行。 5506 55074.屏幕亮度：获取当前屏幕亮度，设置屏幕亮度。 5508 55095.系统电源管理：点击按钮分别实现休眠、关机、重启、设置电源模式功能。 5510 55116.设置数据项名称：将数据项名称及数据项的值保存到数据库中。 5512 55137.系统能力：获取系统能力集合的字符串并显示。 5514 55158.系统参数：点击按钮分别实现设置一个系统参数、获取并展示系统参数功能。 5516 55179.电量信息：进入设备电量信息页面，页面主要显示电量信息，包括：当前设备是否支持电池或电池是否在位的查询、剩余电池电量百分比、充电状态、电池健康状态、充电器类型、电池电压、电池技术型号、电池温度、电量等级等信息。 5518 551910.设备基础信息：打开设备信息管理页面，展示基础信息。 5520 552111.组合按键：进入组合按键管理页面，包括显示组合按键信息，组合按键的订阅状态，在订阅状态下，组合按键被触发时显示组合按键的信息。 5522 552312.输入设备：进入设备输入管理页面，展示设备输入列表，可以查看输入设备详情，同时可以监听设备的热插拔状态。 5524 552513.输入事件：进入全屏监听页面，实现启动或取消全屏输入事件，在启动全屏输入事件监听时，可以查看当前触屏的详细信息，模拟注入返回事件，实现返回能力。 5526 552714.输入按键事件：进入输入按键事件管理页面，显示由外部设备如软键盘输入触发的消息。 5528 552915.鼠标指针：进入鼠标管理页面，实现鼠标状态、鼠标指针信息、设置鼠标速度和显示样式，启动鼠标事件监听时，可以查看鼠标在界面上操作的详细信息。 5530 5531##### 基本原理 5532 55331.首页菜单展示：使用一个module，menuitems完成菜单组件的实现，传入要展示的菜单的strarray类型的资源和菜单点击对应的组件即可。使用Navigation和NavRouter组件实现菜单点击进入功能界面，使用LocalStorage实现应用内Ability内数据共享，点击菜单时标记selectedLabel，在entry中的Capabilities组件中，通过selectedLabel显示对应的功能组件。 5534 55352.耗电统计：使用[@ohos.batteryStatistics.d.ts](reference/apis-basic-services-kit/js-apis-batteryStatistics-sys.md) 5536接口获取硬件和应用的耗电量与百分比，使用[@ohos.bundle.bundleManager.d.ts](reference/apis-ability-kit/js-apis-bundleManager.md) 5537接口获取系统已安装应用信息。 5538 55393.屏幕亮度：使用[@ohos.brightness.d.ts](reference/apis-basic-services-kit/js-apis-brightness-sys.md) 5540实现屏幕亮度控制。 5541 55424.系统电源管理：使用[@ohos.power.d.ts](reference/apis-basic-services-kit/js-apis-power-sys.md) 5543实现休眠、关机、重启、设置电源模式功能。 5544 55455.设置数据项名称：使用[@ohos.settings.d.ts](reference/apis-basic-services-kit/js-apis-settings.md) 5546实现将数据项名称及数据项的值保存到数据库中。 5547 55486.系统能力：使用[@ohos.systemCapability.d.ts](reference/apis-basic-services-kit/js-apis-system-capability-sys.md) 5549实现获取系统能力集合的字符串并显示。 5550 55517.系统参数：使用[@ohos.systemParameterEnhance.d.ts](reference/apis-basic-services-kit/js-apis-system-parameterEnhance-sys.md) 5552实现设置一个系统参数、获取并展示系统参数功能。 5553 55548.电量信息：使用[@ohos.batteryInfo.d.ts](reference/apis-basic-services-kit/js-apis-battery-info-sys.md)接口获取电池和充放电状态信息 5555 55569.设备信息：使用[@ohos.deviceInfo](reference/apis-basic-services-kit/js-apis-device-info.md)获取设备相关信息。 5557 555810.组合按键：使用[@ohos.multimodalInput.inputConsumer](reference/apis-input-kit/js-apis-inputconsumer-sys.md) 订阅组合按键，当组合按键被触发时展示组合按键回调信息。 5559 556011.输入设备：使用[@ohos.multimodalInput.inputDevice](reference/apis-input-kit/js-apis-inputdevice.md) 获取输入设备列表，并显示输入设备信息，实现设备的热插拔监听。 5561 556212.输入事件：使用[@ohos.multimodalInput.inputMonitor](reference/apis-input-kit/js-apis-inputmonitor-sys.md)开启监听全局触屏事件，当触发触屏事件时显示触屏详情，使用[@ohos.multimodalInput.inputEventClient](reference/apis-input-kit/js-apis-inputeventclient-sys.md)模拟返回按键进行按键注入，实现返回功能，在column组件中添加[@ohos.multimodalInput.touchEvent](reference/apis-input-kit/js-apis-touchevent.md)触摸事件，模拟按键被按下效果。 5563 556413.鼠标指针：使用[@ohos.multimodalInput.mouseEvent](reference/apis-input-kit/js-apis-mouseevent.md)监听鼠标事件，并显示鼠标操作回调信息，使用[@ohos.multimodalInput.pointer](reference/apis-input-kit/js-apis-pointer.md)实现鼠标指针的显示或隐藏状态，设置鼠标移动速度和显示样式。 5565 556614.输入按键事件：使用 [@ohos.multimodalInput.keyEvent (按键输入事件)](reference/apis-input-kit/js-apis-keyevent.md)监听按键输入的信息。 5567 5568##### 约束与限制 5569 5570开发语言：ArkTS 5571 5572配套版本：API10版本SDK，版本号：4.0.9.6 5573 5574[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/DeviceManagementCollection) 5575 5576#### 屏幕属性 5577 5578##### 介绍 5579 5580本示例主要展示了屏幕管理相关的功能，使用[@ohos.display](reference/apis-arkui/js-apis-display.md)、[@ohos.screen](reference/apis-arkui/js-apis-screen-sys.md)接口，[@ohos.display](reference/apis-arkui/js-apis-display.md)接口提供获取默认display对象、获取所有display对象，开启监听、关闭监听功能；[@ohos.screen](reference/apis-arkui/js-apis-screen-sys.md)接口提供创建虚拟屏幕、销毁虚拟屏幕、扩展屏幕、镜像屏幕等功能。 5581 5582##### 使用 5583 55841.点击主页面前一个矩形，弹窗显示默认设备ID、设备名称、启用状态、设备状态、设备刷新率、屏幕旋转角度、设备宽度、设备高度、屏幕密度、屏幕方向、逻辑密度、缩放因子、xDPI(x方向中每英寸屏幕的确切物理像素值)、yDPI(y方向中每英寸屏幕的确切物理像素值)，点击任意区域关闭弹窗，点击第二个矩形，弹窗显示所有屏幕信息。 5585 55862.点击**增加屏幕**按钮，监听到屏幕增加，增加矩形代表新增屏幕（因界面空间有效，增加超过一个屏幕，页面总共只显示两个矩形）。 5587 55883.点击**移除屏幕**按钮，监听到屏幕销毁，减少矩形代表移除屏幕。 5589 5590##### 基本原理 5591 5592- 增加屏幕、移除屏幕的功能接口封装在DisplayModel: 5593 - 使用screen.createVirtualScreen来创建虚拟屏幕; 5594 - 使用screen.destroyVirtualScreen来销毁虚拟屏幕; 5595- 获取Display对象显示屏幕所有属性信息的功能封装在ShowInfo: 5596 - 使用display.Display来显示默认屏幕信息; 5597 - 使用display.Display[]来显示所有屏幕信息;； 5598 5599##### 约束与限制 5600 5601开发语言：ArkTS 5602 5603配套版本：API10版本SDK，版本号：4.0.9.6 5604 5605[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/Screen) 5606 5607#### 存储空间统计 5608 5609##### 介绍 5610 5611本示例使用[DataPanel组件](reference/apis-arkui/arkui-ts/ts-basic-components-datapanel.md)展示不同种类的应用存储信息，通过[@ohos.bundle.bundleManager](reference/apis-ability-kit/js-apis-Bundle-sys.md)模块来获取不同应用的包名与应用名等信息，使用应用空间统计[@ohos.file.storageStatistics](reference/apis-core-file-kit/js-apis-file-storage-statistics.md)来查询当前设备的存储使用情况，使用卷管理[@ohos.file.volumeManager](reference/apis-core-file-kit/js-apis-file-volumemanager-sys.md)来查询可用卷存储使用情况。实现了查看当前设备存储空间信息、所有安装的应用的存储信息、所有可用卷的存储信息的功能。 5612 5613##### 使用 5614 56151. 主页面会展示当前设备存储使用的详细信息。 5616 56172. 点击“应用”，可以查看当前安装的所有应用的存储使用情况。 5618 56193. 当有可用的卷时，点击“查看可用卷信息”查看当前设备所有的可用卷的存储使用情况。 5620 5621##### 基本原理 5622 5623* 本示例使用DataPanel组件展示不同种类的应用存储信息，通过 Bundle模块来获取不同应用的包名与应用名等信息，使用应用空间统计来查询当前设备的存储使用情况，使用卷管理来查询可用卷存储使用情况。 5624* 接口参考：[DataPanel组件](reference/apis-arkui/arkui-ts/ts-basic-components-datapanel.md)，[@ohos.bundle.bundleManager](reference/apis-ability-kit/js-apis-Bundle-sys.md)，[@ohos.file.storageStatistics](reference/apis-core-file-kit/js-apis-file-storage-statistics.md)，[@ohos.file.volumeManager](reference/apis-core-file-kit/js-apis-file-volumemanager-sys.md) 5625 5626##### 约束与限制 5627 5628开发语言：ArkTS 5629 5630配套版本：API10版本SDK，版本号：4.0.9.6 5631 5632[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/StorageStatistic) 5633 5634#### 多模输入 5635 5636##### 介绍 5637 5638本示例使用[鼠标指针](reference/apis-input-kit/js-apis-pointer.md)，展示了多模输入鼠标外设的五种场景：鼠标样式资源切换、设置鼠标大小及颜色、设置鼠标动画光标样式、通过switch开关切换鼠标滚轮在非激活悬停窗口的滚动操作使能状态、通过switch开关切换鼠标主次键等功能。 5639 5640##### 使用 5641 56421.启动应用,首页展示鼠标外设的各种设置项。 5643 56442.选择主按钮中的下拉框可以切换鼠标主次键。 5645 56463.点击当悬停在非活动窗口上方时对其进行滚动右侧switch开关，可以切换鼠标滚轮在非激活悬停窗口的滚动操作使能状态。 5647 56484.鼠标指针大小中的滑动条可以设置鼠标指针大小。 5649 56505.点击鼠标指针颜色中的单选框，可以设置鼠标颜色。 5651 56526.点击鼠标指针动画样式中的静态或动态单选框，可以设置鼠标静态或动画光标样式。 5653 5654##### 基本原理 5655 5656* 本示例主要分为一个模块， 5657 * 鼠标外设模块 5658 * 主要展示了鼠标外设的五种功能设置场景 5659 * 接口参考：[@ohos.multimodalInput.pointer](reference/apis-input-kit/js-apis-pointer.md) 5660 5661##### 约束与限制 5662 5663开发语言：ArkTS 5664 5665配套版本：API10版本SDK，版本号：4.0.11.5 5666 5667[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/DeviceManagement/Mouse) 5668 5669### 国际化 5670 5671#### 国际化 5672 5673##### 介绍 5674 5675本示例展示如何使用媒体查询，[@ohos.intl](reference/apis-localization-kit/js-apis-intl.md)模块包含国际化能力基础接口，[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n-sys.md)模块包含国际化能力增强接口，资源管理模块，根据当前configuration（语言，区域，横竖屏，mccmnc）和device capability（设备类型，分辨率）提供获取应用资源信息读取接口。三个结合一起实现语言地区设置、时区设置和国际化资源管理相关功能。 5676 5677##### 使用 5678 56791.启动应用，进入应用，首页分为三个按钮，点击**语言和地区**可以进入界面设置系统语言和地区。 5680 56812.点击**日期和时间**，可以进入界面设置系统时间和时区。 5682 56833.点击**区域格式示例**进入界面展示当前区域，当前系统语言下的时间、数字、货币、百分比、单复数、屏幕方向等信息的格式化显示。 5684 5685##### 基本原理 5686 5687* 本示例分为三个模块： 5688 * 语言和地区模块 5689 * 使用i18n接口中getDisplayCountry方法获取指定国家的本地化显示文本，getSystemRegion方法获取系统地区，getSystemLocale方法设置系统Locale，getSystemLanguage方法获取系统支持的语言列表，getPreferredLanguageList方法获取系统偏好语言列表，removePreferredLanguage方法删除系统偏好语言列表中指定位置的偏好语言。 5690 * 接口参考：[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n-sys.md)，[@ohos.intl](reference/apis-localization-kit/js-apis-intl.md) 5691 5692 * 日期和时间模块 5693 * 使用i18n接口中is24HourClock方法判断系统时间是否为24小时制，getTimeZone方法获取日历对象的时区，set24HourClock方法修改系统时间的24小时制设置，setTime方法设置系统时间，setDate方法设置系统日期，getTimezone方法获取系统时区。 5694 * 接口参考：[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n-sys.md)，[@ohos.systemTime](reference/apis-basic-services-kit/js-apis-system-timer-sys.md) 5695 5696 * 区域格式示例模块 5697 * 使用i18n接口中is24HourClock方法判断系统时间是否为24小时制，NumberFormat方法创建一个NumberFormat对象，getResourceManager方法获取当前应用的资源管理对。 5698 * 接口参考：[@ohos.i18n](reference/apis-localization-kit/js-apis-i18n-sys.md)，[@ohos.intl](reference/apis-localization-kit/js-apis-intl.md)，[@ohos.resourceManager](reference/apis-localization-kit/js-apis-resource-manager.md) 5699 5700##### 约束与限制 5701 5702开发语言：ArkTS 5703 5704配套版本：API10版本SDK，版本号：4.0.7.5 5705 5706[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Internationalnation/International) 5707 5708### 媒体 5709 5710#### 相机和媒体库 5711 5712##### 介绍 5713 5714本示例使用[@ohos.multimedia.camera](reference/apis-basic-services-kit/js-apis-settings-sys.md)接口实现相机示例的主要功能：拍照、录像、参数配置等。使用[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md) 接口实现对媒体文件的存储。同时支持拍照角度旋转以及录制分辨率选择。 5715 5716##### 使用 5717 57181.启动应用，在权限弹窗中授权后返回应用，进入相机界面。 5719 57202.相机界面默认是拍照模式，点击底部拍照按钮可以拍照，拍照完成会在底部左侧显示照片预览图。 5721 57223.点击**录像**或者左滑切换到录像模式，点击底部按钮开始录像，点击结束按钮结束录像，结束录像后底部左侧显示视频图标。 5723 57244.点击系统**Back**键或界面顶部**返回**按钮退出应用。 5725 57265.点击顶部右侧按钮进入设置界面，点击拍照旋转角度，选择0，90，180，270四个角度其中一个，返回至界面再次拍照，照片角度根据选择角度旋转。 5727 57286.点击顶部右侧按钮进入设置界面，点击录像分辨率，选择1920x1080，1280x720，800x600三个分辨率其中一个，返回至界面再次录像，视频分辨率根据选择分辨率设置。 5729 57307.返回相机界面点击底部左侧预览图可进入相册应用，可以在其中查看照片和录制的视频 5731 5732##### 基本原理 5733 57341.使用@ohos.multimedia.camera接口实现相机示例的主要功能：拍照、录像、参数配置等。 57352.使用@ohos.multimedia.mediaLibrary接口实现对媒体文件的存储。 57363.通过跳转至相册来访问设备上的照片和录制视频。 5737 5738##### 约束与限制 5739 5740开发语言：ArkTS 5741 5742配套版本：API10版本SDK，版本号：4.0.9.1 5743 5744[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/Camera) 5745 5746#### 录屏示例 5747 5748##### 介绍 5749 5750本示例使用[@ohos.screen](reference/apis-arkui/js-apis-screen-sys.md)管理屏幕的一些基础能力，包括获取屏幕对象，监听屏幕变化，创建和销毁虚拟屏幕等。[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)和[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md)完成视频编码并保存到文件中。[@ohos.display](reference/apis-arkui/js-apis-display.md)捕捉屏幕显示图像帧，展示设备屏幕（含音频）录制功能。屏幕录制的主要工作是通过创建一个虚拟屏，捕获屏幕显示图形帧，完成视频编码并保存到文件中，帮助OEM设备厂家系统应用实现屏幕录制功能，也可以通过此应用抓取屏幕帧用于问题复现录制。 5751 5752##### 使用 5753 57541.启动应用，首次启动需要用户授予“**访问媒体和文件**”和“**麦克风**”的权限 5755 57562.点击**启动**按钮，启动屏幕录制。 5757 57583.启动录制后会弹出一个透明录制悬浮控件，并显示录制时间计时，此时可以操作屏幕，操作过程屏幕显示会被录制下来。 5759 57604.需要停止录屏时，点击悬浮半透明的红色按钮，屏幕录制停止。 5761 57625.打开图库应用，在图库中可以看到最新录屏的媒体文件，点击后可支持录屏回放。 5763 5764##### 基本原理 5765 5766* 该示例通过Screen方法获取屏幕实例，createVirtualScreen方法创建一个虚拟屏，getAllScreens方法获取获取所有的屏幕，makeMirror方法将屏幕设置为镜像模式，setVirtualScreenSurface方法设置虚拟屏幕的surface，display接口捕获屏幕显示图形帧，media，mediaLibrary接口完成视频编码并保存到文件中，帮助OEM设备厂家系统应用实现屏幕录制功能。 5767* 接口参考：[@ohos.screen](reference/apis-arkui/js-apis-screen-sys.md)，[@ohos.multimedia.media](reference/apis-media-kit/js-apis-media.md)，[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper-sys.md)，[@ohos.display](reference/apis-arkui/js-apis-display.md) 5768 5769##### 约束与限制 5770 5771开发语言：ArkTS 5772 5773配套版本：API9版本SDK，版本号：3.2.11.9 5774 5775[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/ScreenRecorder) 5776 5777#### 截屏 5778 5779##### 介绍 5780 5781本示例使用[screenshot](reference/apis-arkui/js-apis-screenshot-sys.md)模块实现屏幕截图 ，使用[window](reference/apis-arkui/js-apis-window.md#setwindowprivacymode9)模块实现隐私窗口切换，使用[display](reference/apis-arkui/js-apis-display-sys.md#displayhasprivatewindow9)模块查询当前隐私窗口。展示全屏截图和屏幕局部截图。 5782 5783##### 使用 5784 57851. 点击右上角图标打开弹窗，选择截屏，展示全屏截图；选择局部截屏，选择截屏区域，点击右下角完成，展示局部截屏； 57862. 点击滑块切换窗口隐私模式，隐私模式下截屏会弹出提示，拒绝截屏。 5787 5788##### 基本原理 5789 5790* 本示例通过screenshot接口实现屏幕截图 ，通过window接口实现隐私窗口切换，通过display接口查询当前隐私窗口。 5791* 接口参考：[@ohos.screenshot](reference/apis-arkui/js-apis-screenshot-sys.md)，[@ohos.window](reference/apis-arkui/js-apis-window.md#setwindowprivacymode9)，[@ohos.display](reference/apis-arkui/js-apis-display-sys.md#displayhasprivatewindow9) 5792 5793##### 约束与限制 5794 5795开发语言：ArkTS 5796 5797配套版本：API9版本SDK，版本号：3.2.11.9 5798 5799[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/Screenshot) 5800 5801#### 音频管理（仅对系统应用开放） 5802 5803##### 介绍 5804 5805本示例主要演示了设备外放音频、普通耳机播放音频、支持空间音频和头动追踪的耳机播放音频三种音频播放方式。使用[@ohos.multimedia.audio.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.multimedia.audio.d.ts)等接口完成相关功能。 5806 5807##### 使用 5808 58091. 启动应用，在主页卡片中选择空间音频卡片，进入空间音频演示。 5810 58112. 在上部的两个音乐播放器分别可以播放2.0和5.1的音源，体现了音频框架对多声道播放的支持。 5812 58133. 下方的空间音频UX，具体的界面会随音频播放的设备而变化：外放及普通耳机只会启用关闭模式；支持空间音频和头动追踪的耳机会使三个按钮全部可选。 5814 58154. 点击三个按钮，分别会启用“关闭空间音频”，“启用空间音频固定模式”，“启用空间音频头动追踪模式”。 5816 58175. 当前版本对是否支持空间音频的判断仍简单，即当前发声设备具备不为空的mac地址就会显示三态按钮UX。 5818 5819##### 基本原理 5820 5821* 播放立体声多声道音频文件、调用空间音频API查询设置开关状态功能实现： 5822 * 在createAudioRenderer(options: AudioRendererOptions)入参AudioRendererOptions中增加AudioChannelLayout字段指明音频文件声道布局，以辅助多声道音频文件播放。 5823 * 使用isSpatializationSupported(), isHeadTrackingSupported(), isSpatializationSupportedForDevice(AudioDeviceDescriptor), isHeadTrackingSupportedForDevice(AudioDeviceDescriptor)四个接口查询系统和设备是否支持空间音频和头动跟踪，根据查询结果设置用户UX界面状态:只有系统和设备全都支持某功能，其按钮状态才不会被置灰。 5824 * 使用isSpatializationEnabled(), isHeadTrackingEnabled()在每次UX界面出现时查询当前空间音频和头动跟踪是否开启，同步在其他app对开关状态的改动。 5825 * 使用setSpatializationEnabled(enable: boolean), setHeadTrackingEnabled(enable: boolean)，在点击UX按钮时设置空间音频和头动跟踪状态。 5826 5827##### 约束与限制 5828 5829开发语言：ArkTS 5830 5831配套版本：API11版本SDK，版本号：4.1.6.5 5832 5833[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/Audio) 5834 5835### 安全 5836 5837#### 访问权限控制 5838 5839##### 介绍 5840 5841本示例使用[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)接口中abilityAccessCtrl方法获取访问控制模块对象，GrantStatus.PERMISSION_GRANTED方法表示已授权状态，[@ohos.bundle.bundleManager](reference/apis-ability-kit/js-apis-bundleManager.md)接口中getApplicationInfo方法根据包名获取ApplicationInfo等展示应用申请权限场景 5842 5843##### 使用 5844 58451.打开应用，页面出现弹窗，点击 **取消** 按钮。 5846 58472.页面跳转显示 **检测权限** 按钮，点击检测权限，出现提示信息“权限未授予”。 5848 58493.关闭应用再次打开，页面出现弹窗，点击 **确认** 按钮。 5850 58514.页面跳转显示 **检测权限** 按钮，点击**检测权限** 按钮，出现提示信息“权限已授予”。 5852 58535.关闭应用再次打开，页面不出现弹窗，点击 **检测权限** 按钮，点击检测权限，出现提示信息“权限已授予”。 5854 5855##### 基本原理 5856 5857* 该示例使用abilityAccessCtrl接口中abilityAccessCtrl方法获取访问控制模块对象，GrantStatus.PERMISSION_GRANTED方法表示已授权状态，bundleManager接口中getApplicationInfo方法根据包名获取ApplicationInfo等展示应用申请权限场景 5858* 接口参考：[@ohos.abilityAccessCtrl](reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)，[@ohos.bundle.bundleManager](reference/apis-ability-kit/js-apis-bundleManager.md) 5859 5860##### 约束与限制 5861 5862开发语言：ArkTS 5863 5864配套版本：API9版本SDK，版本号：3.2.11.9 5865 5866[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Security/AbilityAccessCtrl) 5867 5868#### 安全控件类型的UI控件（仅对系统应用开放） 5869 5870##### 介绍 5871 5872本示例提供了安全控件类型的UI控件，支撑应用开发者集成安全控件做临时授权场景，当用户实际点击了某种类型的安全控件时，会对应用进行相应的临时授权，减少权限弹窗对用户的干扰，同时提供更小的授权范围。 5873 5874##### 使用 5875 58761. 在主界面，点击“LocationButton安全控件”按钮，进入“LocationButton安全控件”界面，点击“当前位置”按钮，成功获取当前定位信息，并显示在方框中。 5877 58782. 在主界面，点击“PasteButton安全控件”按钮，进入“PasteButton安全控件”界面，点击”复制“按钮，复制下方“天天开心”文本，点击“粘贴”按钮，获取剪贴板内容并显示在其下方框中。 5879 58803. 在主界面，点击“SaveButton安全控件”按钮，进入“SaveButton安全控件”界面，点击“下载”按钮，将当前页面中的图片保存到本地图库中。 5881 5882##### 基本原理 5883 5884* 本示例分为Location安全控件模块，剪贴板安全控件模块，媒体库安全控件模块 5885 5886 * Location安全控件模块 5887 5888 * 使用SecLocationButton组件开发获取定位信息功能，在其点击回调onclick事件中调用geoLocationManager.getCurrentLocation()得到当前定位信息经纬度。 5889 * 接口参考：[@ohos.geoLocationManager](reference/apis-location-kit/js-apis-geoLocationManager.md#geolocationmanagergetcurrentlocation) 5890 5891 * 剪贴板安全控件模块 5892 5893 * 使用SecPasteButton组件开发获取剪贴板信息功能，在其点击回调onclick事件中调用ystemPasteboard.setData()将文本复制到剪贴板中，systemPasteboard.getData()得到剪贴板内容。 5894 * 接口参考：[@ohos.pasteboard](reference/apis-basic-services-kit/js-apis-pasteboard.md#getdata9) 5895 5896 * 媒体库安全控件模块 5897 5898 * 使用SecSaveButton组件开发保存图片到媒体库功能，在其点击回调onclick事件中调用photoAccessHelper.getPhotoAccessHelper()得到媒体库图片管理器helper；helper.createAsset()得到保存到媒体库图片的uri，resourceManager.getMediaContent()得到存放在Resources/base/media文件下的banner.png图片内容；fs.open()和fs.write()将图片内容通过得到的uri写到媒体库中，最后fs.close()关闭文件。 5899 * 接口参考：[@ohos.file.photoAccessHelper](reference/apis-media-library-kit/js-apis-photoAccessHelper.md)，[@ohos.file.fs](reference/apis-core-file-kit/js-apis-file-fs.md) 5900 5901##### 约束与限制 5902 5903开发语言：ArkTS 5904 5905配套版本：API10版本SDK，版本号：4.0.10.15 5906 5907[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Security/AuthorizedButton) 5908 5909#### DLP 5910 5911##### 介绍 5912 5913本示例是一个安全类App，使用[@ohos.dlpPermission](reference/apis-data-protection-kit/js-apis-dlppermission.md) 接口展示了普通文件加密受限的过程。 5914 5915##### 使用 5916 59171. 启动应用后点击“**+**”按钮可以添加一个普通文件。 5918 59192. 长按点击加密按钮，出现加密权限弹窗，选择需要设置的权限并点击确定。 5920 59213. 点击加密文件，跳转到文本编辑应用，如果设置的权限是只读权限，页面置灰，不可编辑。 5922 59234. 长按点击删除按钮，删除文件。 5924 5925##### 基本原理 5926 5927* 文件的添加和文件列表的获取分别在Index和MediaFileUri中，具体实现为: 5928 5929 * 文件的添加：首先通过[@ohos.file.picker](reference/apis-core-file-kit/js-apis-file-picker.md)接口的DocumentSaveOptions()自定一个参数，然后通过new picker.DocumentViewPicker()拉起文件管理应用去新建一个普通文件。 5930 5931 * 文件列表的获取：首先使用[@ohos.file.fileAccess](reference/apis-core-file-kit/js-apis-fileAccess-sys.md) 接口的createFileAccessHelper()方法来创建连接指定wants的helper对象，然后通过getRoots()来获取helper对象连接的文件管理服务类的设备根节点信息，并获取到目录url，最后通过getFileInfoFromUri()得到文件的信息。 5932 5933* 文件的加密操作在DlpManager中，，具体实现为: 5934 5935 * 使用dlpPermission接口的generateDLPFile获得一个相关的操作型关系数据库RdbStore，将明文文件加密生成权限受控文件。 5936 5937##### 约束与限制 5938 5939开发语言：ArkTS 5940 5941配套版本：API10版本SDK，版本号：4.0.10.10 5942 5943[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Security/DLP) 5944 5945### 窗口管理 5946 5947#### 窗口扩展应用 5948 5949##### 介绍 5950 5951本示例通过 [窗口扩展能力](reference/apis-arkui/js-apis-application-windowExtensionAbility-sys.md) 设置不同Ability，使用 [AbilityComponent](reference/apis-arkui/arkui-ts/ts-container-ability-component-sys.md) 组件加载各个Ability。仿设置应用，实现点击设置菜单栏，跳转或加载详情页面。 5952 5953##### 使用 5954 59551.竖屏模式下点击左侧设置菜单栏，跳转详情页面。 5956 59572.横屏模式下点击左侧设置菜单栏，右侧显示详情页面。 5958 5959##### 基本原理 5960 5961* 本示例通过窗口扩展能力设置不同Ability，使用AbilityComponent组件加载各个Ability，matchMediaSync方法设置媒体查询的查询条件，RemoteObject方法实现远程对象。 5962* 接口参考：[@ohos.application.WindowExtensionAbility](reference/apis-arkui/js-apis-application-windowExtensionAbility-sys.md)，[AbilityComponent](reference/apis-arkui/arkui-ts/ts-container-ability-component-sys.md)，[@ohos.rpc](reference/apis-ipc-kit/js-apis-rpc.md)，[@ohos.mediaquery](reference/apis-arkui/js-apis-mediaquery.md) 5963 5964##### 约束与限制 5965 5966开发语言：ArkTS 5967 5968配套版本：API9版本SDK，版本号：3.2.11.9 5969 5970[示例链接](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/WindowManagement/WindowExtAbility) 5971
