From a6c4bff9edd32f757a98616c9205f080ae05f175 Mon Sep 17 00:00:00 2001 From: gaohui Date: Sat, 18 Sep 2021 09:51:30 +0800 Subject: [PATCH] The README rectification Signed-off-by: gaohui --- UI/Animation/README_zh.md | 10 +++++ UI/AtomicLayout/README_zh.md | 2 +- UI/Badge/README_zh.md | 2 +- UI/CommonLayout/README_zh.md | 23 ++++++++--- UI/Components/README_zh.md | 14 ++++++- UI/Dialog/README_zh.md | 12 +++++- UI/Image/README_zh.md | 12 +++++- UI/JsAnimation/README_zh.md | 14 +++++-- UI/JsAnimationStyle/README_zh.md | 2 +- UI/JsApp/README_zh.md | 15 +++++-- UI/JsCallJava/README_zh.md | 14 ++++++- UI/List/README_zh.md | 16 +++++++- UI/Localization/README_zh.md | 12 +++++- UI/PositionLayout/README_zh.md | 18 +++++++-- UI/ProgressBar/README_zh.md | 14 ++++++- UI/UserRegistration/README_zh.md | 20 +++++++++- media/Audio/README_zh.md | 20 +++++++--- media/AudioPlayer/README_zh.md | 12 +++++- media/Camera/README_zh.md | 16 +++++++- media/PixelMap/README_zh.md | 30 +++++++++++--- media/VideoPlayer/README_zh.md | 22 +++++++++- network/Bluetooth/README_zh.md | 18 ++++++++- network/DistributedAbility/README_zh.md | 17 +++++++- network/DistributedDevices/README_zh.md | 13 +++++- network/NFC/README_zh.md | 53 ++++++++++++++++++++++--- network/NetworkManagement/README_zh.md | 26 ++++++++++-- security/DataSecurity/README_zh.md | 15 ++++++- security/FaceRecognition/README_zh.md | 16 +++++++- security/Permission/README_zh.md | 20 +++++++++- thread/EventHandler/README_zh.md | 18 ++++++++- thread/TaskDispatcher/README_zh.md | 28 ++++++++++++- 31 files changed, 456 insertions(+), 68 deletions(-) diff --git a/UI/Animation/README_zh.md b/UI/Animation/README_zh.md index a4e0bc2ec3..05ed3eefd3 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/AtomicLayout/README_zh.md b/UI/AtomicLayout/README_zh.md index fb0a13b04d..a93ea3a76c 100644 --- a/UI/AtomicLayout/README_zh.md +++ b/UI/AtomicLayout/README_zh.md @@ -19,5 +19,5 @@ ### 约束与限制 - 隐藏能力与占比能力需在非折行的flex布局中使用。 -- 本示例支持在轻量系统使用。 +- 本示例仅支持在标准系统上运行。 diff --git a/UI/Badge/README_zh.md b/UI/Badge/README_zh.md index ba456c6cc5..7d0c881aa6 100644 --- a/UI/Badge/README_zh.md +++ b/UI/Badge/README_zh.md @@ -12,5 +12,5 @@ ### 约束和限制 -本示例仅支持在轻量系统上运行。 +本示例仅支持在标准系统上运行。 diff --git a/UI/CommonLayout/README_zh.md b/UI/CommonLayout/README_zh.md index aa1d465746..d088f18c63 100644 --- a/UI/CommonLayout/README_zh.md +++ b/UI/CommonLayout/README_zh.md @@ -1,13 +1,24 @@ # 常用布局 -- DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。 +### 简介 - 该布局和其他布局的组合，可以实现更加丰富的布局方式。 +DirectionalLayout 是 Java UI 中的一种重要组件布局，用于将一组组件（Component）按照水平或者垂直方向排布，能够方便地对齐布局内的组件。 - DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 +该布局和其他布局的组合，可以实现更加丰富的布局方式。 - DependentLayout 是 Java UI 系统里的一种常见布局。 +DirectionalLayout 的排列方向（orientation）分为水平（horizontal）或者垂直（vertical）方向。使用 orientation 设置布局内组件的排列方式，默认为垂直排列。 - 与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 +DependentLayout 是 Java UI 系统里的一种常见布局。 + +与 DirectionalLayout 相比，拥有更多的排布方式，每个组件可以指定相对于其他同级元素的位置，或者指定相对于父组件的位置。 + +DependentLayout 的排列方式是相对于其他同级组件或者父组件的位置进行布局。 + +### 使用说明 + +本示例展示了DirectionalLayout 的排列方式与DependentLayout 的排列方式，分别点击对应的名字以显示对应的效果。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 - DependentLayout 的排列方式是相对于其他同级组件或者父组件的位置进行布局。 diff --git a/UI/Components/README_zh.md b/UI/Components/README_zh.md index ab61f3322a..2f78efeca9 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/Dialog/README_zh.md b/UI/Dialog/README_zh.md index d4b673f5e2..005135ed03 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 d877751c2d..6d9733486c 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 68327cc17c..45efd8be32 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/JsAnimationStyle/README_zh.md b/UI/JsAnimationStyle/README_zh.md index a4bb0ba08f..3ea548b6cd 100644 --- a/UI/JsAnimationStyle/README_zh.md +++ b/UI/JsAnimationStyle/README_zh.md @@ -20,5 +20,5 @@ ### 约束与限制 -本示例仅支持在轻量系统上运行。 +本示例仅支持在标准系统上运行。 diff --git a/UI/JsApp/README_zh.md b/UI/JsApp/README_zh.md index 3617040536..c9ad221b51 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 354746a24d..752d8159aa 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/List/README_zh.md b/UI/List/README_zh.md index c40c853f6a..7d5aaae66a 100644 --- a/UI/List/README_zh.md +++ b/UI/List/README_zh.md @@ -1,5 +1,17 @@ # ListContainer -- ListContainer 是用来呈现连续、多行数据的组件，包含一系列相同类型的列表项。 +### 简介 - 本示例通过长列表联系人的案例来演示 ListContainer 组件的基本使用方法。 +ListContainer 是用来呈现连续、多行数据的组件，包含一系列相同类型的列表项。 + +本示例通过长列表联系人的案例来演示 ListContainer 组件的基本使用方法。 + +### 使用说明 + +1.点击“+”，添加列表 + +2.点击“Edit”,设置列表 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/Localization/README_zh.md b/UI/Localization/README_zh.md index 267deef6e7..33a70b7db4 100644 --- a/UI/Localization/README_zh.md +++ b/UI/Localization/README_zh.md @@ -1,3 +1,13 @@ # 时区与语言 -- 本示例通过获取本机的国家、日期时间、时区、语言信息案例，来演示国际化相关功能。 +### 简介 + +本示例通过获取本机的国家、日期时间、时区、语言信息案例，来演示国际化相关功能。 + +### 使用说明 + +无需任何操作。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/PositionLayout/README_zh.md b/UI/PositionLayout/README_zh.md index 18f99e8cb1..e24e63bf81 100644 --- a/UI/PositionLayout/README_zh.md +++ b/UI/PositionLayout/README_zh.md @@ -1,7 +1,19 @@ # PositionLayout -- PositionLayout 即位置部局，视图以指定准确的x/y坐标值在屏幕上显示，\(0, 0\)为左上角，当向下或向右移动时，坐标值变大。 +### 简介 - 允许视图之间互相重叠，通常不推荐使用PositionLayout，它使界面代码太过刚性，不利于设备适配。 +PositionLayout 即位置部局，视图以指定准确的x/y坐标值在屏幕上显示，\(0, 0\)为左上角，当向下或向右移动时，坐标值变大。 - 本示例主要用于演示位置布局（PositionLayout）的一些特性，包括子组件位置的影响以及超越屏幕大小后子组件的显示规则。 +允许视图之间互相重叠，通常不推荐使用PositionLayout，它使界面代码太过刚性，不利于设备适配。 + +本示例主要用于演示位置布局（PositionLayout）的一些特性，包括子组件位置的影响以及超越屏幕大小后子组件的显示规则。 + +### 使用说明 + +1.点击“Start Code Ability”，跳转页面，展示PositionLayout方式布局 + +2.点击“Start Xml Ability”，跳转页面，展示XML方式布局 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/UI/ProgressBar/README_zh.md b/UI/ProgressBar/README_zh.md index c699041e5e..66d6de1574 100644 --- a/UI/ProgressBar/README_zh.md +++ b/UI/ProgressBar/README_zh.md @@ -1,5 +1,15 @@ # ProgressBar -- UI 提供了 ProgressBar 组件，它用于显示内容或操作的进度。 +### 简介 - 本示例演示了进度条 ProgressBar 的基本使用方法。 +UI 提供了 ProgressBar 组件，它用于显示内容或操作的进度。 + +本示例演示了进度条 ProgressBar 的基本使用方法。 + +### 使用说明 + +1.点击“Start Progress”，进度条按照设置的值开始变化 + +### 约束与限制 + +本示例仅支持在大型设备上运行。 diff --git a/UI/UserRegistration/README_zh.md b/UI/UserRegistration/README_zh.md index 7763d87052..c4744c1570 100644 --- a/UI/UserRegistration/README_zh.md +++ b/UI/UserRegistration/README_zh.md @@ -1,3 +1,21 @@ # 用户注册（JS） -- 本示例通过用户注册案例来展示 JS FA 应用基本控件的使用，包括文本输入框，日期选择控件，单选按钮，下拉菜单和普通按钮等。 +### 简介 + +本示例通过用户注册案例来展示 JS FA 应用基本控件的使用，包括文本输入框，日期选择控件，单选按钮，下拉菜单和普通按钮等。 + +### 使用说明 + +1.任意输入一个6位的名字 + +2.选择日期 + +3.选择性别 + +4.选择学历 + +5.点击“register”，注册用户 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/media/Audio/README_zh.md b/media/Audio/README_zh.md index 2f56244d94..dd21afa337 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 951a24313a..f8f4492cd7 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/Camera/README_zh.md b/media/Camera/README_zh.md index 6aecad2425..6e11c975e0 100644 --- a/media/Camera/README_zh.md +++ b/media/Camera/README_zh.md @@ -1,5 +1,17 @@ # 相机 -- 相机模块支持相机业务的开发，开发者可以通过已开放的接口实现相机硬件的访问、操作和新功能开发，最常见的操作如：预览、拍照、连拍和录像等。 +### 简介 - 开发者也可以通过合适的接口或者接口组合实现闪光灯控制、曝光时间控制、手动对焦和自动对焦控制、变焦控制、人脸识别以及更多的功能。 +相机模块支持相机业务的开发，开发者可以通过已开放的接口实现相机硬件的访问、操作和新功能开发，最常见的操作如：预览、拍照、连拍和录像等。 + +开发者也可以通过合适的接口或者接口组合实现闪光灯控制、曝光时间控制、手动对焦和自动对焦控制、变焦控制、人脸识别以及更多的功能。 + +### 使用说明 + +1.点击“Take Photo”，开启拍照功能； + +2.点击“Video Record”,开启录像功能。 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 diff --git a/media/PixelMap/README_zh.md b/media/PixelMap/README_zh.md index 48784d7b1b..01828502a6 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 454a430bfb..868078ee9f 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 ba415a105e..bd33bd5bdf 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 1de5535472..21749be180 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 ce60699e3a..453baeed10 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 432d21be7e..cc89a37c22 100644 --- a/network/NFC/README_zh.md +++ b/network/NFC/README_zh.md @@ -1,10 +1,53 @@ -# NFC +# WLAN -- NFC（Near Field Communication，近距离无线通信技术） 是一种非接触式识别和互联技术，让移动设备、消费类电子产品、PC和智能设备之间可以进行近距离无线通信。 +### 简介 - 应用或者其他模块可以通过接口完成以下功能： +WLAN 服务系统为用户提供 WLAN 基础功能、P2P（peer-to-peer）功能和 WLAN 消息通知的相应服务，让应用可以通过 WLAN 和其他设备互联互通。 - \* 查询本机是否支持NFC能力。 +1、WLAN 基础功能可以获取WLAN状态，查询WLAN是否打开。发起扫描并获取扫描结果。获取连接态详细信息，包括连接信息、IP 信息等。 - \* 开启或者关闭本机NFC。 +2、不信任热点配置是指应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。 +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/network/NetworkManagement/README_zh.md b/network/NetworkManagement/README_zh.md index 6eb86d77e3..5804ee57dc 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/security/DataSecurity/README_zh.md b/security/DataSecurity/README_zh.md index feea55eda3..de39086ec3 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 268953f55e..01689c18b9 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 be359ad2f9..433927db91 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 7432287a50..78fa84c363 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 1ab3f73e60..60a383ae3f 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”，执行多次任务 + +### 约束与限制 + +本示例仅支持在大型系统上运行。 -- Gitee