diff --git a/UI/Animation/README_zh.md b/UI/Animation/README_zh.md index a4e0bc2ec3fb2b96b1865a35839e154d1e66c71b..05ed3eefd35759f12ca572cca1b33f42165bef06 100644 --- a/UI/Animation/README_zh.md +++ b/UI/Animation/README_zh.md @@ -1,5 +1,7 @@ # 动画 +### 简介 + - 动画是组件的基础特性之一，精心设计的动画使 UI 变化更直观，有助于改进应用程序的外观并改善用户体验。 1、帧动画是利用视觉暂留现象，将一系列静止的图片按序播放，给用户产生动画的效果。 @@ -7,3 +9,11 @@ 2、AnimatorValue 数值从0到1变化，本身与 Component 无关。开发者可以设置0到1变化过程的属性，例如：时长、变化曲线、重复次数等，并通过值的变化改变组件的属性，实现组件的动画效果。 3、AnimatorProperty 可以为 Component 设置某个属性或多个属性而实现动画效果。 + +### 使用说明 + +本示例展示了4种动画效果，包括图片动效，物体运动，物体变换以及多个物体移动。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/CommonLayout/README_zh.md b/UI/CommonLayout/README_zh.md index aa1d4657461fb187c489ee8a2600db8c1a477988..5fc6d20375fbb5480e1fa921b8f6ca6e54246ce8 100644 --- a/UI/CommonLayout/README_zh.md +++ b/UI/CommonLayout/README_zh.md @@ -1,13 +1,18 @@ # 常用布局 -- DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。 +### 简介 - 该布局和其他布局的组合，可以实现更加丰富的布局方式。 +DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。该布局和其他布局的组合，可以实现更加丰富的布局方式。DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 - DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 +DependentLayout 是 Java UI 系统里的一种常见布局。与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 - DependentLayout 是 Java UI 系统里的一种常见布局。 +DependentLayout 的排列方式是相对于其他同级组件或者父组件的位置进行布局。 - 与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 +### 使用说明 + +本示例展示了DirectionalLayout 的排列方式与DependentLayout 的排列方式，分别点击对应的名字以显示对应的效果。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 - DependentLayout 的排列方式是相对于其他同级组件或者父组件的位置进行布局。 diff --git a/UI/Components/README_zh.md b/UI/Components/README_zh.md index ab61f3322a90704064a7aa55ef37225088053f0f..2f78efeca9cb8457111e5c21698d63a56c89d811 100644 --- a/UI/Components/README_zh.md +++ b/UI/Components/README_zh.md @@ -1,5 +1,15 @@ # Components -- 本示例中文本 Text 是用来显示字符串的组件，在界面上显示为一块文本区域。 +### 简介 - 按钮 Button 是一种常见的组件，点击可以触发对应的操作，通常由文本或图标组成，也可以由图标和文本共同组成。 +文本 Text 是用来显示字符串的组件，在界面上显示为一块文本区域。 + +按钮 Button 是一种常见的组件，点击可以触发对应的操作，通常由文本或图标组成，也可以由图标和文本共同组成。 + +### 使用说明 + +点击Start Text 与 Start Button按钮显示对应的文本样式或者按钮样式，再点击文本展示对应的测试组件布局。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/CustomComponent/README_en.md b/UI/CustomComponent/README.md similarity index 81% rename from UI/CustomComponent/README_en.md rename to UI/CustomComponent/README.md index 86f46ecfc2d6bbb678611fc5e4c79f643c4cc128..2d02cf5b0ebbda2d44409ec6a91a9a8955626f0f 100644 --- a/UI/CustomComponent/README_en.md +++ b/UI/CustomComponent/README.md @@ -1,16 +1,16 @@ # CustomComponent -##### Introduction +### Introduction You can use the Java UI framework to customize components, add custom draw tasks, and define component attributes and event responses. This sample shows how to customize components. -##### Usage +### Usage On the application home screen, click the custom component **ColorChangingRing**. A yellow ring is displayed. You can click the ring to change its color. On the application home screen, click the custom component **RingProgressBar**. A round progress controller is displayed. You can click the controller to change the progress. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/CustomComponent/README_zh.md b/UI/CustomComponent/README_zh.md index 857d5f24f943e73807d5ef217e1b7ba9ab671286..40b2301e6db7c765932095e183ca6e38d8ca8214 100644 --- a/UI/CustomComponent/README_zh.md +++ b/UI/CustomComponent/README_zh.md @@ -1,16 +1,16 @@ # 自定义组件 -##### 简介 +### 简介 本示例展示了自定义组件的使用方法，在Java UI框架中提供了更加强大的能力，可以自定义组件，添加自定义绘制任务，并定义组件的属性和事件响应。 -##### 使用说明 +### 使用说明 进入应用主界面后，点击自定义组件：可变色圆环，跳转页面，出现黄色圆环，点击圆环改变其颜色； 点击自定义组件：环形进度条，跳转页面，出现环形进度控制器，点击环形可改变其进度。 -##### 约束和限制 +### 约束和限制 本示例支持在标准系统上运行。 diff --git a/UI/Dialog/README_zh.md b/UI/Dialog/README_zh.md index d4b673f5e21f02d10b0465269e10f7f9fb8fdff9..005135ed03bf4e86352e5d659bf0e305f6d03c7f 100644 --- a/UI/Dialog/README_zh.md +++ b/UI/Dialog/README_zh.md @@ -1,3 +1,13 @@ # 对话框 -- UI 提供了多种类型的 Dialog 组件，本示例主要演示了 CommonDialog ,ListDialog 以及自定义对话框的基本使用。 +### 简介 + +UI 提供了多种类型的 Dialog 组件，本示例主要演示了 CommonDialog ,ListDialog 以及自定义对话框的基本使用。 + +### 使用说明 + +点击不同的按钮展示不同的对话框，包括确认框，单选框，多选框以及输入框。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/Image/README_zh.md b/UI/Image/README_zh.md index d877751c2dbeace489f4337d510f0c6a3c4ce115..6d9733486c91ac8f2bf40443d3cf2a93f6c43ef2 100644 --- a/UI/Image/README_zh.md +++ b/UI/Image/README_zh.md @@ -1,3 +1,13 @@ # 基本动画（JS） -- 本示例演示了 JS FA 应用中，图片组件常见的几种动画，如：缩放，旋转，平移，渐变等。 +### 简介 + +本示例演示了 JS FA 应用中，图片组件常见的几种动画，如：缩放，旋转，平移，渐变等。 + +### 使用说明 + +从上往下依次点击按钮，图片会实现缩放、旋转、翻转的动画效果。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/JsAnimation/README_zh.md b/UI/JsAnimation/README_zh.md index 68327cc17c95609b591ffd92838452779fda5d04..45efd8be32ddc95ff01a599afbf2b67b90b6b7fc 100644 --- a/UI/JsAnimation/README_zh.md +++ b/UI/JsAnimation/README_zh.md @@ -1,5 +1,13 @@ # 动效示例应用 -- 该应用是一个体现组件动效基础能力的JS应用，包含组件的旋转、平移、显隐切换，以及组件阴影等功能，其中动效负载可调节。开发者可借鉴使用相关动效能力。适用于大型系统（参考内存≥1GiB）。 - 1. 使用了典型的div、stack、video、image、text、input、button组件。 - 2. 使用了旋转、显隐、平移等动画能力，以及阴影效果能力。 +### 简介 + +该应用是一个体现组件动效基础能力的JS应用，包含组件的旋转、平移、显隐切换，以及组件阴影等功能，其中动效负载可调节。开发者可借鉴使用相关动效能力。 + +### 使用说明 + +本示例展示了一组动效包括阴影，旋转，平移等。 + +### 约束与限制 + +本示例仅支持在大型系统上运行，且参考内存 ≥ 1GiB。 diff --git a/UI/JsApp/README_zh.md b/UI/JsApp/README_zh.md index 36170405362f5bcaba0b1a843c2312ac35238cf2..c9ad221b51eb001b363b0b8fd66f13d81d786020 100644 --- a/UI/JsApp/README_zh.md +++ b/UI/JsApp/README_zh.md @@ -1,7 +1,16 @@ # JsApp -- 本示例适用于介绍如何开发一个 JS FA 应用。 +### 简介 - 此应用相对于 Hello World 应用模板具备更复杂的页面布局、页面样式和页面逻辑。 +本示例适用于介绍如何开发一个 JS FA 应用。 + +此应用相对于 Hello World 应用模板具备更复杂的页面布局、页面样式和页面逻辑。 + +### 使用说明 + +在应用页面可以通过将焦点移动到不同颜色的圆形来选择不同的食物图片，也可以进行添加到购物车操作。 + +### 约束与限制 + +本示例仅支持在标准系统上运行。 - 该页面可以通过将焦点移动到不同颜色的圆形来选择不同的食物图片，也可以进行添加到购物车操作。 diff --git a/UI/JsCallJava/README_zh.md b/UI/JsCallJava/README_zh.md index 354746a24d0a901af6ff5ee5f5d7db288b509908..752d8159aa4075255058c64424b0e4f901b7d46a 100644 --- a/UI/JsCallJava/README_zh.md +++ b/UI/JsCallJava/README_zh.md @@ -1,5 +1,15 @@ # JsCallJava -- JS UI 框架提供了 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制，该机制提供了一种通道来传递方法调用、数据返回以及订阅事件上报。 +### 简介 - 本示例是以 JS 端调用 Java 端实时获取/监听电池电量为例来说明 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制。 +JS UI 框架提供了 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制，该机制提供了一种通道来传递方法调用、数据返回以及订阅事件上报。 + +本示例是以 JS 端调用 Java 端实时获取/监听电池电量为例来说明 JS FA（Feature Ability）调用 Java PA（Particle Ability）的机制。 + +### 使用说明 + +应用主界面有3个按钮，点击对应按钮显示对应文本通知。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/MultiModeInput/README_en.md b/UI/MultiModeInput/README.md similarity index 91% rename from UI/MultiModeInput/README_en.md rename to UI/MultiModeInput/README.md index 1217eb07fc3969a23643758adf9dd72a7da084f6..809a0110708d182994132e5b88a0cd195d350da8 100644 --- a/UI/MultiModeInput/README_en.md +++ b/UI/MultiModeInput/README.md @@ -1,10 +1,10 @@ # Multimodal Input -##### Introduction +### Introduction This sample app of multimodal input illustrates how to use APIs such as **KeyEventListener**, **TouchEventListener**, and **SpeechEventListener** to handle corresponding key, touch, and speech events. -##### Usage +### Usage The home page of the sample app contains the **touchEvent**, **keyEvent**, **mouseEvent**, and **speechEvent** buttons. The specific implementation is as follows: @@ -13,7 +13,7 @@ The home page of the sample app contains the **touchEvent**, **keyEvent**, ** 3. When you tap the **mouseEvent** button, you will be redirected to another page. If you tap the **mouse** button on that page by pressing the left key of the mouse, a popup dialog indicating a mouse click event will be displayed. 4. When you tap the **speechEvent** button, you will be redirected to another page. If you press the voice assistant button on the remote control of HUAWEI Vision, a popup dialog indicating a speech event will be displayed. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/MultiModeInput/README_zh.md b/UI/MultiModeInput/README_zh.md index 84c77269ad4f88953a1293ea4d91d64724386cbc..80c033f63330286f4dd78fe6c0618ba22d89b5f2 100644 --- a/UI/MultiModeInput/README_zh.md +++ b/UI/MultiModeInput/README_zh.md @@ -1,10 +1,10 @@ # 多模输入 -##### 简介 +### 简介 本示例通过实现相关接口KeyEventListener、TouchEventListener、SpeechEventListener等，对相应的事件进行处理，例如按键事件、触摸事件、语音事件等。 -##### 使用说明 +### 使用说明 本事例主页面包含触摸事件按钮、按键事件按钮、鼠标事件按钮、语音事件按钮； @@ -13,7 +13,7 @@ 3. 当点击鼠标事件按钮时，跳转到另一个页面，用鼠标左键点击当前页面上的按钮，页面上会弹出提示框显示鼠标事件； 4. 当点击语音事件按钮时，跳转到另一个页面，按智慧屏遥控器上的语音按钮，页面上会弹出提示框显示语音事件。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行； diff --git a/UI/MultimodalEvent/README_en.md b/UI/MultimodalEvent/README.md similarity index 100% rename from UI/MultimodalEvent/README_en.md rename to UI/MultimodalEvent/README.md diff --git a/UI/MultimodalEvent/README_zh.md b/UI/MultimodalEvent/README_zh.md index c32713f7f903c37ba4dc6f0499c5a2dde8cf3f41..573000bbdb3fb4df6ee36975017d5e62fe2bb0af 100644 --- a/UI/MultimodalEvent/README_zh.md +++ b/UI/MultimodalEvent/README_zh.md @@ -1,10 +1,10 @@ # 多模输入事件标准化 -##### 简介 +### 简介 本示例通过提供处理标准化事件的类MultimodalEventHandle对标准化基类StandardizedEventHandle衍生出来的其它标准化事件进行注册，然后对相应的事件进行处理，将不同输入设备的输入事件映射到标准化事件上。 -##### 使用说明 +### 使用说明 本示例主页面包含触摸类标准化事件按钮、按键类标准化事件按钮 、通用类标准化事件按钮、媒体类标准化事件按钮、系统类标准化事件按钮、通话类标准化事件按钮： @@ -15,7 +15,7 @@ 5. 当点击系统类标准化事件按钮时，跳转到另一个页面，执行返回操作，页面上会弹出提示框显示系统类标准化事件； 6. 当点击通话类标准化事件按钮时，跳转到另一个页面，插入耳机按拨打电话或挂断电话键，页面上会弹出提示框显示通话类标准化事件。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行； diff --git a/UI/Popup/README.md b/UI/Popup/README.md index 48345c44950130a5ffd90b6f1f6bb031dd8d6e9e..3a52ec995765a7bb3449f9458bf282ca39d60542 100644 --- a/UI/Popup/README.md +++ b/UI/Popup/README.md @@ -1,14 +1,14 @@ # JavaScript Bubble -##### Introduction +### Introduction This sample shows JavaScript bubbles. After you click a bound component, a bubble with a message is displayed to provide you with guidance. You can define component attributes such as its position, style, and events to respond. -##### Usage +### Usage On the home screen of the sample app, touch the prompt button or the text box. A JavaScript bubble is displayed. The bubble disappears after you touch it. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/Popup/README_zh.md b/UI/Popup/README_zh.md index be4d687f47e7bf131598d9550376de32e4389d89..6c78c01108b6d4c332c16597e7d350bf7c15a783 100644 --- a/UI/Popup/README_zh.md +++ b/UI/Popup/README_zh.md @@ -1,14 +1,14 @@ # JS气泡 -##### 简介 +### 简介 本示例展示了JS气泡提示，在点击绑定的控件后会弹出相应的气泡来引导用户进行操作。开发者可自行定义该控件的位置、样式、响应事件等属性信息。 -##### 使用说明 +### 使用说明 进入应用主界面后，点击提示按钮或者文本框，JS气泡提示会出现，点击JS气泡提示后，气泡提示会消失。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行。 diff --git a/UI/RefreshContainer/README.md b/UI/RefreshContainer/README.md index 89938b1c4617d6db0a4987f467f4caacf01a6368..0e6da24f7ae1544815a794b7f890894615d91707 100644 --- a/UI/RefreshContainer/README.md +++ b/UI/RefreshContainer/README.md @@ -1,14 +1,14 @@ # RefreshContainer -##### Introduction +### Introduction This sample shows the **** component in the JavaScript UI framework. You can use this component to refresh the content in child components and customize the conditions to trigger a refresh. -##### Usage +### Usage On the home screen of the sample app, a refresh icon is displayed when you swipe down the list. After the refresh is complete, two more items are displayed. -##### Constraints +### Constraints This sample can only be run on standard-system devices. diff --git a/UI/RefreshContainer/README_zh.md b/UI/RefreshContainer/README_zh.md index bd2fdff36851e84873427ca7f26b5f758a3601c3..8d1288e9a7fa418eb239f1fc48752a42219f4d86 100644 --- a/UI/RefreshContainer/README_zh.md +++ b/UI/RefreshContainer/README_zh.md @@ -1,14 +1,14 @@ # 下拉刷新容器 -##### 简介 +### 简介 本示例展示了JS UI框架中refresh组件的使用方法，refresh组件可以刷新子组件中的内容，并且可以自定义触发条件。 -##### 使用说明 +### 使用说明 进入应用后，下拉列表出现刷新图标，刷新结束后，新增两个ltem。 -##### 约束与限制 +### 约束与限制 本示例仅支持在标准系统上运行。 diff --git a/UI/Tabs/Tabs_README.md b/UI/Tabs/README.md similarity index 100% rename from UI/Tabs/Tabs_README.md rename to UI/Tabs/README.md diff --git a/UI/Tabs/Tabs_README_zh.md b/UI/Tabs/README_zh.md similarity index 100% rename from UI/Tabs/Tabs_README_zh.md rename to UI/Tabs/README_zh.md diff --git a/device/BatteryInfo/README_zh.md b/device/BatteryInfo/README_zh.md index 1c91766d4d63f536eb87fccff98f206d9f52113f..d70cbdfd7c825b6ad2a475ec2d379c27997035be 100644 --- a/device/BatteryInfo/README_zh.md +++ b/device/BatteryInfo/README_zh.md @@ -1,4 +1,18 @@ # 电池信息 -- 本示例演示了获取设备的电池信息，提供获取电池电量、健康状态、充电器类型、充电状态等能力。 -- Licensing +### 简介 + +电池信息提供了电池的各类参数信息，这些参数由系统提供，均为只读信息，不可修改。 + +本示例演示了获取设备的电池信息，提供获取电池电量、健康状态、充电器类型、充电状态等能力。 + +### 使用说明 + +1.点击“ Get Battery Level ”，可获取当前设备的电池状态信息，包括电池电量、是否充电、充电类型和电池状态。 + +2.点击“ Subscribe Battery Level ”，可订阅当前设备电池信息。 + +### 约束与限制 + +此设备仅支持在大型系统上运行。 + diff --git a/device/Compass/README_zh.md b/device/Compass/README_zh.md index 0916f7f64e7a53fe59b4d785fe56a640219ef6c7..dd6f9003a48dd0981bf3a878f9f3f62df889214d 100644 --- a/device/Compass/README_zh.md +++ b/device/Compass/README_zh.md @@ -1,7 +1,20 @@ # 指南针 -- 传感器是应用访问底层硬件传感器的一种设备抽象概念。开发者根据传感器提供的 Sensor API，可以查询设备上的传感器，订阅传感器的数据，并根据传感器数据定制相应的算法，开发各类应用。 +### 简介 + +传感器是应用访问底层硬件传感器的一种设备抽象概念。开发者根据传感器提供的 Sensor API，可以查询设备上的传感器，订阅传感器的数据，并根据传感器数据定制相应的算法，开发各类应用。 + +本示例通过实现一个简单的指南针，来演示传感器的常规使用方法（获取传感器并进行监听、取消监听等）。 + +### 使用说明 + +将设备水平放置，观察面板上的指针指向即可判断方向。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + + - 本示例通过实现一个简单的指南针，来演示传感器的常规使用方法（获取传感器并进行监听、取消监听等）。 diff --git a/device/Location/README_zh.md b/device/Location/README_zh.md index e52a4a0d3c85ef31fe7eee0f1011ce0c7b6f3e69..b550c50d93533aad95b229195f36f64430a26fe0 100644 --- a/device/Location/README_zh.md +++ b/device/Location/README_zh.md @@ -1,13 +1,24 @@ # 位置 -- 开发者可以调用位置相关接口，获取设备实时位置，或者最近的历史位置。 +### 简介 - 对于位置敏感的应用业务，建议获取设备实时位置信息。 +地理位置模块支持调用位置相关接口，获取设备实时位置，或者最近的历史位置。 - 如果不需要设备实时位置信息，并且希望尽可能的节省耗电，开发者可以考虑获取最近的历史位置。 +对于位置敏感的应用业务，建议获取设备实时位置信息。 - 使用坐标描述一个位置，非常准确，但是并不直观，面向用户表达并不友好。 +如果不需要设备实时位置信息，并且希望尽可能的节省耗电，开发者可以考虑获取最近的历史位置。 - 系统向开发者提供了地理编码转化能力（将坐标转化为地理编码信息），以及逆地理编码转化能力（将地理描述转化为具体坐标）。 +系统向开发者提供了地理编码转化能力（将坐标转化为地理编码信息），以及逆地理编码转化能力（将地理描述转化为具体坐标）。 - 其中地理编码包含多个属性来描述位置，包括国家、行政区划、街道、门牌号、地址描述等等，这样的信息更便于用户理解。 +其中地理编码包含多个属性来描述位置，包括国家、行政区划、街道、门牌号、地址描述等等，这样的信息更便于用户理解。 + +### 使用说明 + +1. 点击“ Start Location ”获取起始位置信息，可显示当前位置经纬度、当地时间，地区、城市等信息。 +2. 点击“ Stop Location ”获取终止位置信息，更新以上信息。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + +本示例需获取相关位置权限。 diff --git a/device/Setting/README_zh.md b/device/Setting/README_zh.md index 25b07a07685377c700589ce3098906bb8b256686..d5e25c6d3bc23522b371140016ad4f3cac7ef88e 100644 --- a/device/Setting/README_zh.md +++ b/device/Setting/README_zh.md @@ -1,5 +1,15 @@ # 设置 -- TTS、Wireless、Network、Input、Sound、Display、Date、Call、General 九类定义了表征终端设备状态的相关字段，如屏幕亮度、日期格式、字体显示大小等，应用程序可以根据自身所拥有的权限对其进行增、删、改、查等操作，并进行相应的场景适配。 +### 简介 - 例如：TIME\_FORMAT——表示日期格式，应用程序可进行读写。 +系统设置数据项分为TTS（Text To Speech）、Wireless、Network、Input、Sound、Display、Date、Call、General九类。 + +应用程序可通过SystemSettings提供系统设置的相关接口来对系统各类设置项进行查询。 + +### 使用说明 + +应用显示设备WiFi状态、蓝牙状态与飞行模式状态，修改以上三种设置，应用显示内容改变。 + +### 约束与限制 + +本示例仅支持在标准系统上运行。 diff --git a/media/Audio/README_zh.md b/media/Audio/README_zh.md index 2f56244d9411196901a3488bb0f3d28cb66f3e43..dd21afa33785a80be6279790e59352d2c96b4865 100644 --- a/media/Audio/README_zh.md +++ b/media/Audio/README_zh.md @@ -1,13 +1,23 @@ # 音频 -- 音频模块支持音频业务的开发，提供音频相关的功能，主要包括音频播放、音频采集、音量管理和短音播放等。 +### 简介 - 1、音频播放的主要工作是将音频数据转码为可听见的音频模拟信号并通过输出设备进行播放，同时对播放任务进行管理。 +音频模块支持音频业务的开发，提供音频相关的功能，主要包括音频播放、音频采集、音量管理和短音播放等。 - 2、音频采集的主要工作是通过输入设备将声音采集并转码为音频数据，同时对采集任务进行管理。 +1、音频播放的主要工作是将音频数据转码为可听见的音频模拟信号并通过输出设备进行播放，同时对播放任务进行管理。 - 3、音量管理的主要工作是音量调节，输入/输出设备管理，注册音频中断、音频采集中断的回调等。 +2、音频采集的主要工作是通过输入设备将声音采集并转码为音频数据，同时对采集任务进行管理。 - 4、短音播放主要负责管理音频资源的加载与播放、tone音的生成与播放以及系统音播放。 +3、音量管理的主要工作是音量调节，输入/输出设备管理，注册音频中断、音频采集中断的回调等。 +4、短音播放主要负责管理音频资源的加载与播放、tone音的生成与播放以及系统音播放。 +### 使用说明 + +1.点击“player”按钮，开始播放音频。 + +2.点击“Recorder”按钮，跳转界面，点击“Record”按钮准备录音 + +### 约束与限制 + +本示例仅支持在大型设备上运行。 diff --git a/media/AudioPlayer/README_zh.md b/media/AudioPlayer/README_zh.md index 951a24313a22a769117b5afb03f3e55cf376acd6..f8f4492cd7df278e3fab3d61ac1b72116206e6e0 100644 --- a/media/AudioPlayer/README_zh.md +++ b/media/AudioPlayer/README_zh.md @@ -1,9 +1,17 @@ # 媒体会话 -- 音视频播放控制框架，主要包括浏览器（AVBrowser）、控制器（AVController）、浏览器服务（AVBrowserService）、会话（AVSession）四部分组成。这四部分构成了音视频播放控制框架的核心。 +### 简介 - 本示例展示了如何使用音视频播放控制框架实现音乐播放功能。主要功能包括了曲目播放、暂停、上一首、下一首、播放进度、跳转曲目列表等功能。曲目列表展示曲目名称，并选中播放曲目。 +音视频播放控制框架，主要包括浏览器（AVBrowser）、控制器（AVController）、浏览器服务（AVBrowserService）、会话（AVSession）四部分组成。这四部分构成了音视频播放控制框架的核心。 +本示例展示了如何使用音视频播放控制框架实现音乐播放功能。主要功能包括了曲目播放、暂停、上一首、下一首、播放进度、跳转曲目列表等功能。曲目列表展示曲目名称，并选中播放曲目。 +### 使用方法 +1.点击播放按钮，开始播放本地音乐；点击“>”切换下一首音乐；点击“<”切换上一首音乐。 +2.在线音乐播放，连网条件下，点击“TO PLAY ONLINE AUDIO”，跳转界面，点击“PLAY”开始播放音。 + +### 约束与限制 + +本示例仅支持在大型设备上运行。 diff --git a/media/PixelMap/README_zh.md b/media/PixelMap/README_zh.md index 48784d7b1b39fa0ada923460f10125e34a762e57..01828502a6d5e9555d9d86360633b4422d45772e 100644 --- a/media/PixelMap/README_zh.md +++ b/media/PixelMap/README_zh.md @@ -1,13 +1,31 @@ # 图像 -- 图像模块支持图像业务的开发，常见功能如图像解码、图像编码、基本的位图操作、图像编辑等。 +### 简介 - 当然，也支持通过接口组合来实现更复杂的图像处理逻辑，详细如下： +图像模块支持图像业务的开发，常见功能如图像解码、图像编码、基本的位图操作、图像编辑等。 - \* 图像解码：图像解码就是将所支持格式的存档图片解码成统一的 PixelMap 图像，用于后续图像显示或其他处理，比如旋转、缩放、裁剪等。 +当然，也支持通过接口组合来实现更复杂的图像处理逻辑，详细如下： - 当前支持格式包括 JPEG、PNG、GIF、HEIF、WebP、BMP。 +\* 图像解码：图像解码就是将所支持格式的存档图片解码成统一的 PixelMap 图像，用于后续图像显示或其他处理，比如旋转、缩放、裁剪等。 - \* 图像编码：图像编码就是将 PixelMap 图像编码成不同存档格式图片，用于后续其他处理，比如保存、传输等。当前仅支持 JPEG 格式。 +当前支持格式包括 JPEG、PNG、GIF、HEIF、WebP、BMP。 - \* 位图操作：位图操作就是指对 PixelMap 图像进行相关的操作，比如创建、查询信息、读写像素数据等。 +\* 图像编码：图像编码就是将 PixelMap 图像编码成不同存档格式图片，用于后续其他处理，比如保存、传输等。当前仅支持 JPEG 格式。 + +\* 位图操作：位图操作就是指对 PixelMap 图像进行相关的操作，比如创建、查询信息、读写像素数据等。 + +### 使用说明 + +1.点击“Common Decode”，对图片进行常规解码 + +2.点击“ Region Decode”，对图片进行地区解码 + +3.点击“Encode”，对图片进行编码存储并显示存储路径 + +4.点击“PixelMap Edit"，对图片进行编辑，并展示编辑后的图片 + +5.点击”PixelMap Attribute“，对图片进行缩放 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/media/VideoPlayer/README_zh.md b/media/VideoPlayer/README_zh.md index 454a430bfb3e06248c9cefc03b6d47160b80584b..868078ee9f9a39229917e0e44222418d39c3f7c9 100644 --- a/media/VideoPlayer/README_zh.md +++ b/media/VideoPlayer/README_zh.md @@ -1,5 +1,23 @@ # 视频播放 -- 视频模块支持视频业务的开发和生态开放，开发者可以通过已开放的接口很容易地实现视频媒体的播放、操作和新功能开发。视频媒体的常见操作有视频编解码、视频合成、视频提取、视频播放以及视频录制等。 +### 简介 - 本示例主要演示了如何操作网络视频和本地 MP4，MOV，AVI 等格式的视频（设置视频资源、播放、暂停、释放资源等）。 +视频模块支持视频业务的开发和生态开放，开发者可以通过已开放的接口很容易地实现视频媒体的播放、操作和新功能开发。视频媒体的常见操作有视频编解码、视频合成、视频提取、视频播放以及视频录制等。 + +本示例主要演示了如何操作网络视频和本地 MP4，MOV，AVI 等格式的视频（设置视频资源、播放、暂停、释放资源等）。 + +### 使用说明 + +1.点击“Refresh List”，获取视频列表 + +2.点击视频名字，开始播放视频 + +3.点击“pause”，暂停视频播放 + +4.点击“play”，继续播放视频 + +5.点击“seek”，重新开始播放视频 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/Bluetooth/README_zh.md b/network/Bluetooth/README_zh.md index ba415a105e76fed39dd7f77d8352f67783610614..bd33bd5bdfd01570b5cd3387d4394cd46a517986 100644 --- a/network/Bluetooth/README_zh.md +++ b/network/Bluetooth/README_zh.md @@ -1,5 +1,19 @@ # Bluetooth -- 传统蓝牙本机管理主要是针对蓝牙本机的基本操作，包括打开和关闭蓝牙、设置和获取本机蓝牙名称、 +### 简介 - 扫描和取消扫描周边蓝牙设备、获取本机蓝牙profile对其他设备的连接状态、获取本机蓝牙已配对的蓝牙设备列表。 +传统蓝牙本机管理主要是针对蓝牙本机的基本操作，包括打开和关闭蓝牙、设置和获取本机蓝牙名称、 + +扫描和取消扫描周边蓝牙设备、获取本机蓝牙profile对其他设备的连接状态、获取本机蓝牙已配对的蓝牙设备列表。 + +### 使用说明 + +1.打开蓝牙开关 + +2.点击“Start Discovery”，开始搜索蓝牙设备，并显示设备名称。 + +3.可选择蓝牙设备进行配对，输入配对码即可配对。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/DistributedAbility/README_zh.md b/network/DistributedAbility/README_zh.md index 1de5535472ffd18fecf24f860f756349977b221a..21749be1802ec66f7d864df062d72c20128041ea 100644 --- a/network/DistributedAbility/README_zh.md +++ b/network/DistributedAbility/README_zh.md @@ -1,4 +1,19 @@ # 设备和服务的发现 & 连接 -- 本示例主要通过分布式能力，从而实现近场设备和服务的发现、连接。 +### 简介 +本示例主要通过分布式能力，从而实现近场设备和服务的发现、连接。 + +### 使用说明 + +1.点击“ScanRemoteAbility”,扫描远程能力，显示已发现的设备信息。 + +2.点击“RegisterChangeListener”,监听设备状态 + +3.点击“UnRegisterChangeListener”，取消设备监听 + +4.点击“DisconnectRemoteAbility”，断开远程能力 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/DistributedDevices/README_zh.md b/network/DistributedDevices/README_zh.md index ce60699e3a188b24f63e68980cd6381e0339b300..453baeed10ccc6ba66b146dc096eee21073de3bc 100644 --- a/network/DistributedDevices/README_zh.md +++ b/network/DistributedDevices/README_zh.md @@ -1,3 +1,14 @@ # 分布式设备 -- 本示例主要通过监听当前分布式网络中远程设备的在线/离线状态案例来演示分布式设备的发现能力。 +### 简介 + +本示例主要通过监听当前分布式网络中远程设备的在线/离线状态案例来演示分布式设备的发现能力。 + +### 使用说明 + +在组网条件下 ，应用自动检测与之成功连接的设备，并显示设备名称和类型。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + diff --git a/network/NFC/README_zh.md b/network/NFC/README_zh.md index 432d21be7ec98fa419ecfff43e327124f86d78ce..c2707f2221809fe40dbd6b5466bb76dc2a08d2c5 100644 --- a/network/NFC/README_zh.md +++ b/network/NFC/README_zh.md @@ -1,10 +1,21 @@ # NFC -- NFC（Near Field Communication，近距离无线通信技术） 是一种非接触式识别和互联技术，让移动设备、消费类电子产品、PC和智能设备之间可以进行近距离无线通信。 +### 简介 - 应用或者其他模块可以通过接口完成以下功能： +NFC（Near Field Communication，近距离无线通信技术） 是一种非接触式识别和互联技术，让移动设备、消费类电子产品、PC和智能设备之间可以进行近距离无线通信。 - \* 查询本机是否支持NFC能力。 +应用或者其他模块可以通过接口完成以下功能： - \* 开启或者关闭本机NFC。 +\* 查询本机是否支持NFC能力。 +\* 开启或者关闭本机NFC。 + +### 使用说明 + +1.开启NFC，状态显示“NFC_ENABLED” + +2.关闭NFC，状态显示“NFC_DISABLED” + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/NetworkManagement/README_zh.md b/network/NetworkManagement/README_zh.md index 6eb86d77e3fa12178052b8195ff72c746ba80b70..5804ee57dcf0531b190b08b62b7e58f61da289c1 100644 --- a/network/NetworkManagement/README_zh.md +++ b/network/NetworkManagement/README_zh.md @@ -1,9 +1,27 @@ # 网络管理 -- 网络管理模块主要提供以下功能： +### 简介 - 数据连接管理：网卡绑定，打开URL，数据链路参数查询。 +网络管理模块主要提供以下功能： - 数据网络管理：指定数据网络传输，获取数据网络状态变更，数据网络状态查询。 +数据连接管理：网卡绑定，打开URL，数据链路参数查询。 - 流量统计：获取蜂窝网络、所有网卡、指定应用或指定网卡的数据流量统计值。HTTP缓存：有效管理HTTP缓存，减少数据流量。 +数据网络管理：指定数据网络传输，获取数据网络状态变更，数据网络状态查询。 + +流量统计：获取蜂窝网络、所有网卡、指定应用或指定网卡的数据流量统计值。 + +HTTP缓存：有效管理HTTP缓存，减少数据流量。 + +### 使用说明 + +1.点击“Network Request”，跳转页面，点击“Start Request”，使用当前网络打开一个URL链接 + +2.点击“Socket Client”，跳转页面，输入服务器的IP地址，点击“Send Message"，使用当前网络进行Socket数据传输 + +3.点击“Socket Server”，跳转页面，点击“Start Server”，启动服务器 + +4.点击“HTTP Cache”，HTTP缓存的功能，点击“Start Request”，开始请求加载缓存内容 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/network/WLAN/README_zh.md b/network/WLAN/README_zh.md index 0d7b020e7b99a7b9218eb935e926e01c1f1fe18b..cc89a37c22f9cd6aed264423b96a0e03c68dc007 100644 --- a/network/WLAN/README_zh.md +++ b/network/WLAN/README_zh.md @@ -1,11 +1,53 @@ # WLAN -- WLAN 服务系统为用户提供 WLAN 基础功能、P2P（peer-to-peer）功能和 WLAN 消息通知的相应服务，让应用可以通过 WLAN 和其他设备互联互通。 +### 简介 - 1、WLAN 基础功能可以获取WLAN状态，查询WLAN是否打开。发起扫描并获取扫描结果。获取连接态详细信息，包括连接信息、IP 信息等。 +WLAN 服务系统为用户提供 WLAN 基础功能、P2P（peer-to-peer）功能和 WLAN 消息通知的相应服务，让应用可以通过 WLAN 和其他设备互联互通。 - 2、不信任热点配置是指应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。 +1、WLAN 基础功能可以获取WLAN状态，查询WLAN是否打开。发起扫描并获取扫描结果。获取连接态详细信息，包括连接信息、IP 信息等。 - 3、WLAN P2P 功能用于设备与设备之间的点对点数据传输。 +2、不信任热点配置是指应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。 - 4、WLAN 消息通知（Notification）是系统内部或者与应用之间跨进程通讯的机制，注册者在注册消息通知后，一旦符合条件的消息被发出，注册者即可接收到该消息并获取消息中附带的信息。 +3、WLAN P2P 功能用于设备与设备之间的点对点数据传输。 + +4、WLAN 消息通知（Notification）是系统内部或者与应用之间跨进程通讯的机制，注册者在注册消息通知后，一旦符合条件的消息被发出，注册者即可接收到该消息并获取消息中附带的信息。 + +### 使用说明 + + 1.点击“Basic Features”，跳转页面，WLAN基础功能 + +​ a.点击“Scan”，扫描无线网络 + +​ b.点击“Get Connected Info”，获取连接状态信息 + +​ c.点击“Get Country Code”，获取设备国家码 + +​ d.点击“Get Support Feature”，获取设备是否支持指定的能力 + + 2.点击“Untrusted Config”，跳转页面，不信任热点配置 + +​ a.点击“Add Untrusted Wifi”，设置不信任热点配置 + +​ b.点击“Remove Untrusted Wifi”，删除不信任热点配置 + + 3.点击“P2P”，跳转页面，P2P功能 + +​ a.点击“Discover”，搜索附近可用的P2P设备 + +​ b.点击“Stop Discover”，停止搜索附近的P2P设备 + +​ c.点击“Create Group”，建立P2P群组 + +​ d.点击“Remove Group”，移除P2P群组 + +​ e.点击“Disconnect”，取消向指定设备发起的连接 + + 4.点击“Wlan Notification”，WLAN消息通知 + +​ a.点击“Register”，注册WLAN变化消息事件 + +​ b.点击“Unregister”，注销WLAN变化消息事件 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/security/DataSecurity/README_zh.md b/security/DataSecurity/README_zh.md index feea55eda3c9398900960f3e25fef6e2594beb9b..de39086ec31f993e839cf247519b79512deecaca 100644 --- a/security/DataSecurity/README_zh.md +++ b/security/DataSecurity/README_zh.md @@ -1,3 +1,16 @@ # 数据安全 -- 支持开发者调用安全加解密接口来达到安全防护作用。 \ No newline at end of file +### 简介 + +支持开发者调用安全加解密接口来达到安全防护作用。 + +### 使用说明 + +1.点击“Encrypt”，加密文本内容“Hello World!”，显示加密后的文本 + +2.点击“Decrypt”,对加密后的文本解密，显示解密后的文本内容 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 + diff --git a/security/FaceRecognition/README_zh.md b/security/FaceRecognition/README_zh.md index 268953f55ed03fa37d03bd2a4e7cc66da2db2419..01689c18b93598f5b62e17af7a446eedadbc007b 100644 --- a/security/FaceRecognition/README_zh.md +++ b/security/FaceRecognition/README_zh.md @@ -1,3 +1,17 @@ # 人脸识别 -- 当前生物特征识别支持2D人脸识别、3D人脸识别，可应用于设备解锁、应用登录、支付等身份认证场景。 \ No newline at end of file +### 简介 + +当前生物特征识别支持2D人脸识别、3D人脸识别，可应用于设备解锁、应用登录、支付等身份认证场景。 + +### 使用说明 + +1.打开设置，进入生物识别和密码，选择人脸识别，开始录入人脸。 + +2.进入应用，点击“Start Face Unlock”，人脸对准摄像头进行生物识别。 + +3.点击“Cancel Authentication”，取消认证。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 \ No newline at end of file diff --git a/security/Permission/README_zh.md b/security/Permission/README_zh.md index be359ad2f9a4789a35d9e7bd825142ddcce1631e..433927db911b3045584b23c6b0a4da80f59c16bd 100644 --- a/security/Permission/README_zh.md +++ b/security/Permission/README_zh.md @@ -1,5 +1,21 @@ # 应用权限 -- 应用权限是程序访问操作某种对象的许可。权限在应用层面要求明确定义且经用户授权，以便系统化地规范各类应用程序的行为准则与权限许可。 +### 简介 - 本示例演示了照片/视频、位置、日历、麦克风的权限申请，并通过访问相关业务确认授权是否成功。 +应用权限是程序访问操作某种对象的许可。权限在应用层面要求明确定义且经用户授权，以便系统化地规范各类应用程序的行为准则与权限许可。 + +本示例演示了照片/视频、位置、日历、麦克风的权限申请，并通过访问相关业务确认授权是否成功。 + +### 使用说明 + +1.点击“Request Location permission”，位置请求许可弹框 + +2.点击“Request Microphone permission”，请求允许麦克风弹框 + +3.点击“Request Calendar permission”，日历请求许可弹框 + +4.点击“Request Storage permission”，请求存储权限弹框 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/thread/EventHandler/README_zh.md b/thread/EventHandler/README_zh.md index 7432287a50a5fde45cef2808879af684164ae74c..78fa84c363d8a135ff1e1d89412907a8cd4b2871 100644 --- a/thread/EventHandler/README_zh.md +++ b/thread/EventHandler/README_zh.md @@ -1,5 +1,19 @@ # 线程间通信 -- EventHandler 的主要功能是将 InnerEvent 事件或者 Runnable 任务投递到其他的线程进行处理; +### 简介 - EventRunner 的工作模式可以分为托管模式和手动模式。两种模式是在调用 EventRunner 的 create\(\) 方法时，通过选择不同的参数来实现的。 +EventHandler 的主要功能是将 InnerEvent 事件或者 Runnable 任务投递到其他的线程进行处理; + +EventRunner 的工作模式可以分为托管模式和手动模式。两种模式是在调用 EventRunner 的 create\(\) 方法时，通过选择不同的参数来实现的。 + +### 使用说明 + +1.点击“Send InnerEvent”，发送 InnerEvent事件 + +2.点击“Post Runnable Task”，发送Runnable 任务 + +3.点击“Send Event To OriginalThread”，发送事件到线程中 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/thread/TaskDispatcher/README_zh.md b/thread/TaskDispatcher/README_zh.md index 1ab3f73e604280effc42e51fb7126d91aa6ae4d9..60a383ae3f7e0dd55974f2ee130f2cbdcf7cd4be 100644 --- a/thread/TaskDispatcher/README_zh.md +++ b/thread/TaskDispatcher/README_zh.md @@ -1,5 +1,29 @@ # 线程管理 -- 如果应用的业务逻辑比较复杂，可能需要创建多个线程来执行多个任务。 +### 简介 - 这种情况下，代码复杂难以维护，任务与线程的交互也会更加繁杂，要解决此问题，开发者可以使 TaskDispatcher 来分发不同的任务。 +如果应用的业务逻辑比较复杂，可能需要创建多个线程来执行多个任务。 + +这种情况下，代码复杂难以维护，任务与线程的交互也会更加繁杂，要解决此问题，开发者可以使 TaskDispatcher 来分发不同的任务。 + +### 使用说明 + +1.点击“Sync Dispatch”，同步派发任务 + +2.点击“Async Dispatch”，异步分派任务 + +3.点击“Delay Dispatch”，异步延迟发送任务 + +4.点击“Dispatch Group”，任务组 + +5.点击“Revoke Task”，取消任务 + +6.点击“Sync Dispatch Barrier”，同步设置屏障任务 + +7.点击“Async Dispatch Barrier”，异步设置屏障任务 + +8.点击“Apply Dispatch”，执行多次任务 + +### 约束与限制 + +本示例仅支持在大型系统上运行。