“31e8d807d9dfa8682bdc8e5a0fc80fa34b577171”上不存在“paddle/phi/core/selected_rows_impl.h”
提交 323a01b1 编写于 作者: Z zengyawen

update docs

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>
上级 db69dbeb
# 接口
- [Ability框架](js-apis-ability.md)
- Ability框架
- [FeatureAbility模块](js-apis-featureAbility.md)
- [ParticleAbility模块](js-apis-particleAbility.md)
- [DataAbilityHelper模块](js-apis-dataAbilityHelper.md)
......@@ -9,31 +9,30 @@
- [CommonEvent模块](js-apis-commonEvent.md)
- [Notification模块](js-apis-notification.md)
- [Context模块](js-apis-Context.md)
- [资源管理](js-apis-resource.md)
- 资源管理
- [资源管理](js-apis-resource-manager.md)
- [国际化(I18n)](js-apis-i18n.md)
- [国际化(Intl)](js-apis-intl.md)
- [媒体](js-apis-multmedia.md)
- [国际化-Intl](js-apis-intl.md)
- [国际化-I18n](js-apis-i18n.md)
- 媒体
- [音频管理](js-apis-audio.md)
- [音频播放](js-apis-media.md)
- [音频录制](js-apis-recorder.md)
- [数据管理](js-apis-data.md)
- [音频播放和录制](js-apis-media.md)
- 数据管理
- [文件管理](js-apis-fileio.md)
- [轻量级存储](js-apis-data-storage.md)
- [分布式数据管理](js-apis-distributed-data.md)
- [关系型数据库](js-apis-data-rdb.md)
- [结果集](js-apis-data-resultset.md)
- [DataAbility 谓词](js-apis-data-ability.md)
- [账号管理](js-apis-account.md)
- 账号管理
- [分布式帐号管理](js-apis-distributed-account.md)
- [电话服务](js-apis-telephony.md)
- 电话服务
- [拨打电话](js-apis-call.md)
- [短信服务](js-apis-sms.md)
- [SIM卡管理](js-apis-sim.md)
- [网络搜索](js-apis-radio.md)
- [网络与连接](js-apis-connectivity.md)
- 网络与连接
- [WLAN](js-apis-wifi.md)
- [设备管理](js-apis-device-mgmt.md)
- 设备管理
- [传感器](js-apis-sensor.md)
- [振动](js-apis-vibrator.md)
- [屏幕亮度](js-apis-brightness.md)
......@@ -43,9 +42,10 @@
- [设备信息](js-apis-device-info.md)
- [系统属性](js-apis-system-parameter.md)
- [设备管理](js-apis-device-manager.md)
- [窗口](js-apis-window.md)
- [显示设备属性](js-apis-display.md)
- [升级](js-apis-libupdateclient.md)
- [基本功能](js-apis-basic-features.md)
- [升级](js-apis-update.md)
- 基本功能
- [应用上下文](js-apis-basic-features-app-context.md)
- [日志打印](js-apis-basic-features-logs.md)
- [页面路由](js-apis-basic-features-routes.md)
......@@ -56,9 +56,8 @@
- [动画](js-apis-basic-features-animator.md)
- [应用打点](js-apis-hiappevent.md)
- [性能打点](js-apis-bytrace.md)
- [语言基础类库](js-apis-base-library.md)
- 语言基础类库
- [获取进程相关的信息](js-apis-process.md)
- [URL字符串解析](js-apis-url.md)
- [字符串编解码](js-apis-util.md)
- [启动一个worker](js-apis-worker.md)
\ No newline at end of file
# 账号管理<a name="ZH-CN_TOPIC_0000001221945315"></a>
# 账号管理
- **[分布式帐号管理](js-apis-distributed-account.md)**
- **[分布式帐号管理](js-apis-distributed-account.md)**
\ No newline at end of file
# 语言基础类库<a name="ZH-CN_TOPIC_0000001219001649"></a>
# 语言基础类库
- **[获取进程相关的信息](js-apis-process.md)**
......@@ -7,5 +9,3 @@
- **[字符串编解码](js-apis-util.md)**
- **[启动一个worker](js-apis-worker.md)**
\ No newline at end of file
# 应用上下文<a name="ZH-CN_TOPIC_0000001173324607"></a>
# 应用上下文
## 导入模块<a name="s1959b1529f574b74861e62008289bb21"></a>
## 导入模块
```
import app from '@system.app';
```
## 权限列表<a name="section11257113618419"></a>
## 权限列表
## app.getInfo<a name="s0e8ff40704e442bc87a848afa47bdfbb"></a>
getInfo\(\): <[AppResponse](#t3e93239d9b134b80957bcdd4acb05291)\>
## app.getInfo
getInfo(): &lt;AppResponse&gt;
获取当前应用配置文件中声明的信息。
- 返回值
**表1** AppResponse
**表 1** AppResponse
<a name="t3e93239d9b134b80957bcdd4acb05291"></a>
<table><tbody><tr id="recc81d9f995d44aa87ba9d714b756569"><td class="cellrowborder" valign="top" width="19%"><p id="aa3137ce511d140fba6cc93513a7a91e3"><a name="aa3137ce511d140fba6cc93513a7a91e3"></a><a name="aa3137ce511d140fba6cc93513a7a91e3"></a>参数名</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="a6b166163db284e5ca8dc0190b36ae40a"><a name="a6b166163db284e5ca8dc0190b36ae40a"></a><a name="a6b166163db284e5ca8dc0190b36ae40a"></a>类型</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="a4ba8ead9ee7b48298d9a6ed10659f13b"><a name="a4ba8ead9ee7b48298d9a6ed10659f13b"></a><a name="a4ba8ead9ee7b48298d9a6ed10659f13b"></a>说明</p>
</td>
</tr>
<tr id="row2557173813243"><td class="cellrowborder" valign="top" width="19%"><p id="p898462584011"><a name="p898462584011"></a><a name="p898462584011"></a>appID<sup id="sup193948321350"><a name="sup193948321350"></a><a name="sup193948321350"></a>6+</sup></p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="p698492564013"><a name="p698492564013"></a><a name="p698492564013"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="p1998432514020"><a name="p1998432514020"></a><a name="p1998432514020"></a>表示应用的包名,用于标识应用的唯一性。</p>
</td>
</tr>
<tr id="r64430cb15b54497f88ea6330b9a7454c"><td class="cellrowborder" valign="top" width="19%"><p id="a7cccea39636b47cd83188d400eed51e3"><a name="a7cccea39636b47cd83188d400eed51e3"></a><a name="a7cccea39636b47cd83188d400eed51e3"></a>appName</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="a2f72300143c441ef9a3fb5dc2f8e4aac"><a name="a2f72300143c441ef9a3fb5dc2f8e4aac"></a><a name="a2f72300143c441ef9a3fb5dc2f8e4aac"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="a1c9b8d1829ef489e9e0fd1863190d228"><a name="a1c9b8d1829ef489e9e0fd1863190d228"></a><a name="a1c9b8d1829ef489e9e0fd1863190d228"></a>表示应用的名称。</p>
</td>
</tr>
<tr id="r4f8f612a65b24ae9b75ae53893aeb3b9"><td class="cellrowborder" valign="top" width="19%"><p id="ae036f88e139e4379abdaf4969f0720ea"><a name="ae036f88e139e4379abdaf4969f0720ea"></a><a name="ae036f88e139e4379abdaf4969f0720ea"></a>versionName</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="a1d379931a20144f0b6d98f5396202cd9"><a name="a1d379931a20144f0b6d98f5396202cd9"></a><a name="a1d379931a20144f0b6d98f5396202cd9"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="a70c91c442f7c41439a90ceb9041252e8"><a name="a70c91c442f7c41439a90ceb9041252e8"></a><a name="a70c91c442f7c41439a90ceb9041252e8"></a>表示应用的版本名称。</p>
</td>
</tr>
<tr id="r89cf0afd5f444bd1b66ace0c31a25cda"><td class="cellrowborder" valign="top" width="19%"><p id="a3a86c086e40e475b8fb26cf43fe9a8d6"><a name="a3a86c086e40e475b8fb26cf43fe9a8d6"></a><a name="a3a86c086e40e475b8fb26cf43fe9a8d6"></a>versionCode</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="abcfd352ff3d84552938de0e2daf0703e"><a name="abcfd352ff3d84552938de0e2daf0703e"></a><a name="abcfd352ff3d84552938de0e2daf0703e"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="af943e2ec7622407387d25d9331a01245"><a name="af943e2ec7622407387d25d9331a01245"></a><a name="af943e2ec7622407387d25d9331a01245"></a>表示应用的版本号。</p>
</td>
</tr>
</tbody>
</table>
| | | |
| -------- | -------- | -------- |
| 参数名 | 类型 | 说明 |
| appID<sup>6+</sup> | string | 表示应用的包名,用于标识应用的唯一性。 |
| appName | string | 表示应用的名称。 |
| versionName | string | 表示应用的版本名称。 |
| versionCode | number | 表示应用的版本号。 |
- 示例
```
export default {
getInfo(){
......@@ -71,14 +40,16 @@ getInfo\(\): <[AppResponse](#t3e93239d9b134b80957bcdd4acb05291)\>
```
## app.terminate<a name="section974325124119"></a>
## app.terminate
terminate\(\): void
terminate(): void
退出当前Ability
- 示例
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 从API Version 7 开始,推荐使用新接口['@ohos.ability.featureAbility'](js-apis-featureAbility.md)。
- 示例
```
export default {
terminate(){
......@@ -86,4 +57,23 @@ terminate\(\): void
}}
```
## app.requestFullWindow
requestFullWindow(duration: number): void
请求应用以全窗口运行,FA在某些场景下(如半模态FA)会以非全窗口运行,调用该接口会从非全窗口切换为全窗口运行,如果已经以全窗口运行则该接口调用无效。
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| duration | number | 否 | 请求全屏时,设定非全屏到全屏的过渡时间,单位为毫秒,默认时间与非全屏到全屏的距离成正比。 |
- 示例
```
export default {
requestFullWindow(){
app.requestFullWindow({
duration: 200});
}
}
```
# 应用配置<a name="ZH-CN_TOPIC_0000001173324675"></a>
# 应用配置
## 导入模块<a name="section15536249155915"></a>
- [导入模块](#导入模块)
- [权限列表](#权限列表)
- [configuration.getLocale](#configurationgetLocale)
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> - 从API Version 7 开始,该接口不再维护,推荐使用新接口['@ohos.i18n'](js-apis-i18n.md)和['@ohos.intl'](js-apis-intl.md)。
>
>
>
## 导入模块
```
import configuration from '@system.configuration';
```
## 权限列表<a name="section8152081004"></a>
## 权限列表
## configuration.getLocale<a name="section8389829903"></a>
getLocale\(\): <[LocaleResponse](#table1544853546)\>
## configuration.getLocale
getLocale(): &lt;LocaleResponse&gt;
获取应用当前的语言和地区。默认与系统的语言和地区同步。
- 返回值
**表1** LocaleResponse
**表 1** LocaleResponse
<a name="table1544853546"></a>
<table><thead align="left"><tr id="row1670755549"><th class="cellrowborder" valign="top" width="17.77177717771777%" id="mcps1.2.4.1.1"><p id="p57013505413"><a name="p57013505413"></a><a name="p57013505413"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="12.5012501250125%" id="mcps1.2.4.1.2"><p id="p9706511540"><a name="p9706511540"></a><a name="p9706511540"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="69.72697269726973%" id="mcps1.2.4.1.3"><p id="p16701957548"><a name="p16701957548"></a><a name="p16701957548"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row15709513545"><td class="cellrowborder" valign="top" width="17.77177717771777%" headers="mcps1.2.4.1.1 "><p id="p1370154548"><a name="p1370154548"></a><a name="p1370154548"></a>language</p>
</td>
<td class="cellrowborder" valign="top" width="12.5012501250125%" headers="mcps1.2.4.1.2 "><p id="p19701653545"><a name="p19701653545"></a><a name="p19701653545"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="69.72697269726973%" headers="mcps1.2.4.1.3 "><p id="p37010510548"><a name="p37010510548"></a><a name="p37010510548"></a>语言。例如:zh。</p>
</td>
</tr>
<tr id="row970165135413"><td class="cellrowborder" valign="top" width="17.77177717771777%" headers="mcps1.2.4.1.1 "><p id="p97055105414"><a name="p97055105414"></a><a name="p97055105414"></a>countryOrRegion</p>
</td>
<td class="cellrowborder" valign="top" width="12.5012501250125%" headers="mcps1.2.4.1.2 "><p id="p1770175115413"><a name="p1770175115413"></a><a name="p1770175115413"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="69.72697269726973%" headers="mcps1.2.4.1.3 "><p id="p77015518544"><a name="p77015518544"></a><a name="p77015518544"></a>国家或地区。例如:CN。</p>
</td>
</tr>
<tr id="row6332114185611"><td class="cellrowborder" valign="top" width="17.77177717771777%" headers="mcps1.2.4.1.1 "><p id="p53321542567"><a name="p53321542567"></a><a name="p53321542567"></a>dir</p>
</td>
<td class="cellrowborder" valign="top" width="12.5012501250125%" headers="mcps1.2.4.1.2 "><p id="p1433216410564"><a name="p1433216410564"></a><a name="p1433216410564"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="69.72697269726973%" headers="mcps1.2.4.1.3 "><p id="p33321417565"><a name="p33321417565"></a><a name="p33321417565"></a>文字布局方向。取值范围:</p>
<a name="ul1861816241119"></a><a name="ul1861816241119"></a><ul id="ul1861816241119"><li>ltr:从左到右;</li><li>rtl:从右到左。</li></ul>
</td>
</tr>
<tr id="row165137101137"><td class="cellrowborder" valign="top" width="17.77177717771777%" headers="mcps1.2.4.1.1 "><p id="p1351311101333"><a name="p1351311101333"></a><a name="p1351311101333"></a>unicodeSetting<sup id="sup1646171814502"><a name="sup1646171814502"></a><a name="sup1646171814502"></a>5+</sup></p>
</td>
<td class="cellrowborder" valign="top" width="12.5012501250125%" headers="mcps1.2.4.1.2 "><p id="p1513121019313"><a name="p1513121019313"></a><a name="p1513121019313"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="69.72697269726973%" headers="mcps1.2.4.1.3 "><p id="p849701364"><a name="p849701364"></a><a name="p849701364"></a>语言环境定义的Unicode语言环境键集,如果此语言环境没有特定键集,则返回空集。</p>
<p id="p16513111012314"><a name="p16513111012314"></a><a name="p16513111012314"></a>例如:{"nu":"arab"},表示当前环境下的数字采用阿拉伯语的数字。</p>
</td>
</tr>
</tbody>
</table>
| 参数名 | 类型 | 说明 |
| -------- | -------- | -------- |
| language | string | 语言。例如:zh。 |
| countryOrRegion | string | 国家或地区。例如:CN。 |
| dir | string | 文字布局方向。取值范围:<br/>-&nbsp;ltr:从左到右;<br/>-&nbsp;rtl:从右到左。 |
| $unicodeSetting^{5+}$ | string | 语言环境定义的Unicode语言环境键集,如果此语言环境没有特定键集,则返回空集。<br/>例如:{"nu":"arab"},表示当前环境下的数字采用阿拉伯语的数字。 |
- 示例
```
export default {
getLocale() {
......@@ -72,5 +48,3 @@ getLocale\(\): <[LocaleResponse](#table1544853546)\>
}
}
```
# 日志打印<a name="ZH-CN_TOPIC_0000001127284842"></a>
# 日志打印
## 导入模块<a name="s56d19203690d4782bfc74069abb6bd71"></a>
## 导入模块
无需导入。
## 权限列表<a name="section11257113618419"></a>
## 权限列表
## console.debug<a name="s298a3cf59a3b470dbb0742706102ced7"></a>
debug\(message: string\): void
## console.debug
debug(message: string): void
打印debug级别的日志信息。
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
<a name="t87748b0ba4e648079d53f9deccf4bfb2"></a>
<table><thead align="left"><tr id="rc5033ad045c14c2e806d59041aab002c"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="acf783ab6043e4ee1a7bb73b73a091e0b"><a name="acf783ab6043e4ee1a7bb73b73a091e0b"></a><a name="acf783ab6043e4ee1a7bb73b73a091e0b"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="a6736505551534b819d5a6376065a25f6"><a name="a6736505551534b819d5a6376065a25f6"></a><a name="a6736505551534b819d5a6376065a25f6"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="ac15c2a3de0e046af917cf09b48b3b46d"><a name="ac15c2a3de0e046af917cf09b48b3b46d"></a><a name="ac15c2a3de0e046af917cf09b48b3b46d"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="aeb94b88e78974288bab1b4940b50c840"><a name="aeb94b88e78974288bab1b4940b50c840"></a><a name="aeb94b88e78974288bab1b4940b50c840"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="r95c56d5cd62d4b518c3e7a3f158ed7fe"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="a7af41aec9a404f418202d90c61774825"><a name="a7af41aec9a404f418202d90c61774825"></a><a name="a7af41aec9a404f418202d90c61774825"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="aed6ae868d61349afa8f0e250108f8e47"><a name="aed6ae868d61349afa8f0e250108f8e47"></a><a name="aed6ae868d61349afa8f0e250108f8e47"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="ab72ac8cc02e34da4b717ca144fc521c1"><a name="ab72ac8cc02e34da4b717ca144fc521c1"></a><a name="ab72ac8cc02e34da4b717ca144fc521c1"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="ac53e6549d32f413e9c51cd8a53f4650a"><a name="ac53e6549d32f413e9c51cd8a53f4650a"></a><a name="ac53e6549d32f413e9c51cd8a53f4650a"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## console.log<a name="section146351482051"></a>
log\(message: string\): void
## console.log
log(message: string): void
打印debug级别的日志信息。
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
## console.info
<a name="table1852992312613"></a>
<table><thead align="left"><tr id="row953019231468"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="p353020231164"><a name="p353020231164"></a><a name="p353020231164"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="p15301423361"><a name="p15301423361"></a><a name="p15301423361"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="p853022316618"><a name="p853022316618"></a><a name="p853022316618"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="p1953072310614"><a name="p1953072310614"></a><a name="p1953072310614"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row6530823560"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="p135301231364"><a name="p135301231364"></a><a name="p135301231364"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="p15530523265"><a name="p15530523265"></a><a name="p15530523265"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="p165301323567"><a name="p165301323567"></a><a name="p165301323567"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="p853019231265"><a name="p853019231265"></a><a name="p853019231265"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## console.info<a name="section93434457711"></a>
info\(message: string\): void
info(message: string): void
打印info级别的日志信息。
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
<a name="table611782915816"></a>
<table><thead align="left"><tr id="row1211714291989"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="p41174291587"><a name="p41174291587"></a><a name="p41174291587"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="p711715295817"><a name="p711715295817"></a><a name="p711715295817"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="p101171729289"><a name="p101171729289"></a><a name="p101171729289"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="p17117162911815"><a name="p17117162911815"></a><a name="p17117162911815"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row411762913814"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="p111178291284"><a name="p111178291284"></a><a name="p111178291284"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="p91181929284"><a name="p91181929284"></a><a name="p91181929284"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="p12118152919810"><a name="p12118152919810"></a><a name="p12118152919810"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="p18118112910811"><a name="p18118112910811"></a><a name="p18118112910811"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## console.warn<a name="section1363520541678"></a>
warn\(message: string\): void
## console.warn
warn(message: string): void
打印warn级别的日志信息。
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
<a name="table2396103815819"></a>
<table><thead align="left"><tr id="row13396183810811"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="p3396153815820"><a name="p3396153815820"></a><a name="p3396153815820"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="p13964389819"><a name="p13964389819"></a><a name="p13964389819"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="p53961138987"><a name="p53961138987"></a><a name="p53961138987"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="p0396238787"><a name="p0396238787"></a><a name="p0396238787"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row9396163811811"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="p33966385817"><a name="p33966385817"></a><a name="p33966385817"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="p639610381280"><a name="p639610381280"></a><a name="p639610381280"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="p0396183816816"><a name="p0396183816816"></a><a name="p0396183816816"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="p039613818815"><a name="p039613818815"></a><a name="p039613818815"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## console.error<a name="section326012551578"></a>
error\(message: string\): void
## console.error
error(message: string): void
打印error级别的日志信息。
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
<a name="table79914568813"></a>
<table><thead align="left"><tr id="row899656288"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="p39911567816"><a name="p39911567816"></a><a name="p39911567816"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="p099156388"><a name="p099156388"></a><a name="p099156388"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="p3992564819"><a name="p3992564819"></a><a name="p3992564819"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="p89920561088"><a name="p89920561088"></a><a name="p89920561088"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row799956389"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="p699105614811"><a name="p699105614811"></a><a name="p699105614811"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="p99925618816"><a name="p99925618816"></a><a name="p99925618816"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="p189916561082"><a name="p189916561082"></a><a name="p189916561082"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="p799195610812"><a name="p799195610812"></a><a name="p799195610812"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## 示例<a name="section738673813104"></a>
## 示例
```
export default {
......@@ -176,13 +78,11 @@ export default {
var versionCode = 1;
console.info('Hello World. The current version code is ' + versionCode);
console.log(`versionCode: ${versionCode}`);
// 以下写法从API Version 6开始支持
console.log('versionCode:%d.', versionCode);
// 以下写法从API Version 6开始支持console.log('versionCode:%d.', versionCode);
}
}
```
在DevEco Studio的底部,切换到“HiLog”窗口。选择当前的设备及进程,日志级别选择Info,搜索内容设置为“Hello World”。此时窗口仅显示符合条件的日志,效果如图所示:
![](figures/打印日志.png)
![zh-cn_image_0000001200913929](figures/zh-cn_image_0000001200913929.png)
# 定时器<a name="ZH-CN_TOPIC_0000001173324687"></a>
# 定时器
## 导入模块<a name="section7480141454919"></a>
## 导入模块
无需导入。
## 权限列表<a name="section11257113618419"></a>
## 权限列表
## setTimeout<a name="section691616559215"></a>
setTimeout\(handler\[,delay\[,…args\]\]\): number
## setTimeout
setTimeout(handler[,delay[,…args]]): number
设置一个定时器,该定时器在定时器到期后执行一个函数。
- 参数
<a name="t80f094cffa594e7e842eccce3bf1eb19"></a>
<table><thead align="left"><tr id="rd6c76d49b85e4aea9496fd457b189a2a"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="aca3ed031fef246189779018bbcab4df3"><a name="aca3ed031fef246189779018bbcab4df3"></a><a name="aca3ed031fef246189779018bbcab4df3"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="16.61%" id="mcps1.1.5.1.2"><p id="a89f9e11cc75c4aa9b0b31af966020f61"><a name="a89f9e11cc75c4aa9b0b31af966020f61"></a><a name="a89f9e11cc75c4aa9b0b31af966020f61"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="6.3%" id="mcps1.1.5.1.3"><p id="a411664c3845840d4b2a6845105703f3b"><a name="a411664c3845840d4b2a6845105703f3b"></a><a name="a411664c3845840d4b2a6845105703f3b"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="62.91%" id="mcps1.1.5.1.4"><p id="ac962681702ac49e09c77a1270af9ecb2"><a name="ac962681702ac49e09c77a1270af9ecb2"></a><a name="ac962681702ac49e09c77a1270af9ecb2"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="r9d3ffb29e7e74ff4b18e0a3e3ad04925"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p1411112320620"><a name="p1411112320620"></a><a name="p1411112320620"></a>handler</p>
</td>
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="p11016237618"><a name="p11016237618"></a><a name="p11016237618"></a>Function</p>
</td>
<td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="p1892231068"><a name="p1892231068"></a><a name="p1892231068"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="p788516491307"><a name="p788516491307"></a><a name="p788516491307"></a>定时器到期后执行函数。</p>
</td>
</tr>
<tr id="r57344f1bd4304d548bf54ba81dbe8fa5"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p13718237614"><a name="p13718237614"></a><a name="p13718237614"></a>delay</p>
</td>
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="p261239618"><a name="p261239618"></a><a name="p261239618"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="p17516231062"><a name="p17516231062"></a><a name="p17516231062"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="p1943234615"><a name="p1943234615"></a><a name="p1943234615"></a>延迟的毫秒数,函数的调用会在该延迟之后发生。如果省略该参数,delay取默认值0,意味着“马上”执行,或尽快执行。</p>
</td>
</tr>
<tr id="r41a55619ed484b7092dfc843ebd4fba1"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p103182316615"><a name="p103182316615"></a><a name="p103182316615"></a>...args</p>
</td>
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="p1321231162"><a name="p1321231162"></a><a name="p1321231162"></a>Array&lt;any&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="p11111231363"><a name="p11111231363"></a><a name="p11111231363"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="p139991022863"><a name="p139991022863"></a><a name="p139991022863"></a>附加参数,一旦定时器到期,它们会作为参数传递给handler。</p>
</td>
</tr>
</tbody>
</table>
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| handler | Function | 是 | 定时器到期后执行函数。 |
| delay | number | 否 | 延迟的毫秒数,函数的调用会在该延迟之后发生。如果省略该参数,delay取默认值0,意味着“马上”执行,或尽快执行。 |
| ...args | Array&lt;any&gt; | 否 | 附加参数,一旦定时器到期,它们会作为参数传递给handler。 |
- 返回值
<a name="table1430416594311"></a>
<table><thead align="left"><tr id="row230485973113"><th class="cellrowborder" valign="top" width="15.97%" id="mcps1.1.3.1.1"><p id="p430405913312"><a name="p430405913312"></a><a name="p430405913312"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="84.03%" id="mcps1.1.3.1.2"><p id="p830413599312"><a name="p830413599312"></a><a name="p830413599312"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row130435914317"><td class="cellrowborder" valign="top" width="15.97%" headers="mcps1.1.3.1.1 "><p id="p4305759143119"><a name="p4305759143119"></a><a name="p4305759143119"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="84.03%" headers="mcps1.1.3.1.2 "><p id="p130555923110"><a name="p130555923110"></a><a name="p130555923110"></a>timeout定时器的ID。</p>
</td>
</tr>
</tbody>
</table>
| 类型 | 说明 |
| -------- | -------- |
| number | timeout定时器的ID。 |
- 示例
```
export default {
setTimeOut() {
......@@ -87,39 +41,18 @@ setTimeout\(handler\[,delay\[,…args\]\]\): number
```
## clearTimeout<a name="section591824471012"></a>
## clearTimeout
clearTimeout\(timeoutID: number\): void
clearTimeout(timeoutID: number): void
取消了先前通过调用setTimeout\(\)建立的定时器。
取消了先前通过调用setTimeout()建立的定时器。
- 参数
<a name="table242593951313"></a>
<table><thead align="left"><tr id="row1642533921320"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="p15425539131316"><a name="p15425539131316"></a><a name="p15425539131316"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9.700000000000001%" id="mcps1.1.5.1.2"><p id="p442518395136"><a name="p442518395136"></a><a name="p442518395136"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="6.18%" id="mcps1.1.5.1.3"><p id="p6425153915136"><a name="p6425153915136"></a><a name="p6425153915136"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="69.94%" id="mcps1.1.5.1.4"><p id="p9425193910134"><a name="p9425193910134"></a><a name="p9425193910134"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row1442613913132"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p16426133931310"><a name="p16426133931310"></a><a name="p16426133931310"></a>timeoutID</p>
</td>
<td class="cellrowborder" valign="top" width="9.700000000000001%" headers="mcps1.1.5.1.2 "><p id="p16426639151316"><a name="p16426639151316"></a><a name="p16426639151316"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="6.18%" headers="mcps1.1.5.1.3 "><p id="p1426739141312"><a name="p1426739141312"></a><a name="p1426739141312"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="69.94%" headers="mcps1.1.5.1.4 "><p id="p6426183941319"><a name="p6426183941319"></a><a name="p6426183941319"></a>要取消定时器的ID, 是由setTimeout()返回的。</p>
</td>
</tr>
</tbody>
</table>
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| timeoutID | number | 是 | 要取消定时器的ID,&nbsp;是由setTimeout()返回的。 |
- 示例
```
export default {
clearTimeOut() {
......@@ -132,74 +65,25 @@ clearTimeout\(timeoutID: number\): void
```
## setInterval<a name="section3644185910144"></a>
## setInterval
setInterval\(handler\[, delay\[, ...args\]\]\): number
setInterval(handler[, delay[, ...args]]): number
重复调用一个函数,在每次调用之间具有固定的时间延迟。
- 参数
<a name="table2064413592143"></a>
<table><thead align="left"><tr id="row16441591142"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="p0644195915145"><a name="p0644195915145"></a><a name="p0644195915145"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="16.61%" id="mcps1.1.5.1.2"><p id="p1264413594142"><a name="p1264413594142"></a><a name="p1264413594142"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="6.3%" id="mcps1.1.5.1.3"><p id="p86449591147"><a name="p86449591147"></a><a name="p86449591147"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="62.91%" id="mcps1.1.5.1.4"><p id="p16644185991417"><a name="p16644185991417"></a><a name="p16644185991417"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row264495931412"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p8644659161413"><a name="p8644659161413"></a><a name="p8644659161413"></a>handler</p>
</td>
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="p7645259181410"><a name="p7645259181410"></a><a name="p7645259181410"></a>Function</p>
</td>
<td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="p12645259111415"><a name="p12645259111415"></a><a name="p12645259111415"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="p4645155931418"><a name="p4645155931418"></a><a name="p4645155931418"></a>要重复调用的函数。</p>
</td>
</tr>
<tr id="row264575911146"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p17645159201410"><a name="p17645159201410"></a><a name="p17645159201410"></a>delay</p>
</td>
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="p3645175951416"><a name="p3645175951416"></a><a name="p3645175951416"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="p1645185981412"><a name="p1645185981412"></a><a name="p1645185981412"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="p13645559141415"><a name="p13645559141415"></a><a name="p13645559141415"></a>延迟的毫秒数(一秒等于1000毫秒),函数的调用会在该延迟之后发生。</p>
</td>
</tr>
<tr id="row96452594148"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p4645105911412"><a name="p4645105911412"></a><a name="p4645105911412"></a>...args</p>
</td>
<td class="cellrowborder" valign="top" width="16.61%" headers="mcps1.1.5.1.2 "><p id="p1564595951413"><a name="p1564595951413"></a><a name="p1564595951413"></a>Array&lt;any&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="6.3%" headers="mcps1.1.5.1.3 "><p id="p12645175971411"><a name="p12645175971411"></a><a name="p12645175971411"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="62.91%" headers="mcps1.1.5.1.4 "><p id="p12645105991413"><a name="p12645105991413"></a><a name="p12645105991413"></a>附加参数,一旦定时器到期,他们会作为参数传递给handler。</p>
</td>
</tr>
</tbody>
</table>
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| handler | Function | 是 | 要重复调用的函数。 |
| delay | number | 否 | 延迟的毫秒数(一秒等于1000毫秒),函数的调用会在该延迟之后发生。 |
| ...args | Array&lt;any&gt; | 否 | 附加参数,一旦定时器到期,他们会作为参数传递给handler。 |
- 返回值
<a name="table1947971515356"></a>
<table><thead align="left"><tr id="row247915156359"><th class="cellrowborder" valign="top" width="12.18%" id="mcps1.1.3.1.1"><p id="p54794159353"><a name="p54794159353"></a><a name="p54794159353"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="87.82%" id="mcps1.1.3.1.2"><p id="p14798156359"><a name="p14798156359"></a><a name="p14798156359"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row747919155356"><td class="cellrowborder" valign="top" width="12.18%" headers="mcps1.1.3.1.1 "><p id="p6479101518359"><a name="p6479101518359"></a><a name="p6479101518359"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="87.82%" headers="mcps1.1.3.1.2 "><p id="p10479151518353"><a name="p10479151518353"></a><a name="p10479151518353"></a>intervallID重复定时器的ID。</p>
</td>
</tr>
</tbody>
</table>
| 类型 | 说明 |
| -------- | -------- |
| number | intervallID重复定时器的ID。 |
- 示例
```
export default {
setInterval() {
......@@ -211,39 +95,18 @@ setInterval\(handler\[, delay\[, ...args\]\]\): number
```
## clearInterval<a name="section16451595149"></a>
## clearInterval
clearInterval\(intervalID: number\): void
clearInterval(intervalID: number): void
可取消先前通过 setInterval\(\) 设置的重复定时任务。
可取消先前通过 setInterval() 设置的重复定时任务。
- 参数
<a name="table86463597147"></a>
<table><thead align="left"><tr id="row146462597148"><th class="cellrowborder" valign="top" width="14.180000000000001%" id="mcps1.1.5.1.1"><p id="p176461759111416"><a name="p176461759111416"></a><a name="p176461759111416"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9.700000000000001%" id="mcps1.1.5.1.2"><p id="p8646195918141"><a name="p8646195918141"></a><a name="p8646195918141"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="6.18%" id="mcps1.1.5.1.3"><p id="p19646165981415"><a name="p19646165981415"></a><a name="p19646165981415"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="69.94%" id="mcps1.1.5.1.4"><p id="p8646185961419"><a name="p8646185961419"></a><a name="p8646185961419"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row12646125914143"><td class="cellrowborder" valign="top" width="14.180000000000001%" headers="mcps1.1.5.1.1 "><p id="p1964675951413"><a name="p1964675951413"></a><a name="p1964675951413"></a>intervalID</p>
</td>
<td class="cellrowborder" valign="top" width="9.700000000000001%" headers="mcps1.1.5.1.2 "><p id="p1864625921419"><a name="p1864625921419"></a><a name="p1864625921419"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="6.18%" headers="mcps1.1.5.1.3 "><p id="p3646145921419"><a name="p3646145921419"></a><a name="p3646145921419"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="69.94%" headers="mcps1.1.5.1.4 "><p id="p7646459141416"><a name="p7646459141416"></a><a name="p7646459141416"></a>要取消的重复定时器的ID,是由 setInterval() 返回的。</p>
</td>
</tr>
</tbody>
</table>
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| intervalID | number | 是 | 要取消的重复定时器的ID,是由&nbsp;setInterval()&nbsp;返回的。 |
- 示例
```
export default {
clearInterval() {
......@@ -254,5 +117,3 @@ clearInterval\(intervalID: number\): void
}
}
```
# 基本功能<a name="ZH-CN_TOPIC_0000001173342500"></a>
# 基本功能
- **[应用上下文](js-apis-basic-features-app-context.md)**
......@@ -19,5 +21,3 @@
- **[应用打点](js-apis-hiappevent.md)**
- **[性能打点](js-apis-bytrace.md)**
\ No newline at end of file
# 屏幕亮度<a name="ZH-CN_TOPIC_0000001152548786"></a>
# 屏幕亮度
>![](../../public_sys-resources/icon-note.gif) **说明:**
>从 API Version 7 开始支持
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本
## 导入模块<a name="s56d19203690d4782bfc74069abb6bd71"></a>
## 导入模块
```
import brightness from '@ohos.brightness';
```
## brightness.setValue<a name="section1853612361618"></a>
setValue\(value: number\)
## brightness.setValue
setValue(value: number)
设置系统的屏幕亮度。
- 参数:
<a name="table888613685714"></a>
<table><thead align="left"><tr id="row1988683685713"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="p1488693625712"><a name="p1488693625712"></a><a name="p1488693625712"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="11.64%" id="mcps1.1.5.1.2"><p id="p1886173613571"><a name="p1886173613571"></a><a name="p1886173613571"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="7.1499999999999995%" id="mcps1.1.5.1.3"><p id="p128861336155714"><a name="p128861336155714"></a><a name="p128861336155714"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70.17999999999999%" id="mcps1.1.5.1.4"><p id="p3886143617571"><a name="p3886143617571"></a><a name="p3886143617571"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row9886133613577"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="p14886163695720"><a name="p14886163695720"></a><a name="p14886163695720"></a>value</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.1.5.1.2 "><p id="p9886123605716"><a name="p9886123605716"></a><a name="p9886123605716"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="7.1499999999999995%" headers="mcps1.1.5.1.3 "><p id="p988723618577"><a name="p988723618577"></a><a name="p988723618577"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70.17999999999999%" headers="mcps1.1.5.1.4 "><p id="p2512184017289"><a name="p2512184017289"></a><a name="p2512184017289"></a><span>亮度的值</span>(0~255)</p>
</td>
</tr>
</tbody>
</table>
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | number | 是 | 亮度的值(0~255) |
- 示例:
```
import brightness from '@ohos.brightness.d.ts';
brightness.setValue(128);
```
# 性能打点<a name="ZH-CN_TOPIC_0000001165886716"></a>
# 性能打点
>![](../../public_sys-resources/icon-note.gif) **说明:**
>从 API Version 7 开始支持
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本
## 导入模块<a name="s56d19203690d4782bfc74069abb6bd71"></a>
## 导入模块
```
import bytrace from '@ohos.bytrace';
```
## 权限<a name="section11257113618419"></a>
## 权限
## bytrace.startTrace<a name="section785191510485"></a>
startTrace\(name: string, taskId: number, expectedTime?: number\): void
## bytrace.startTrace
startTrace(name: string, taskId: number, expectedTime?: number): void
标记一个预追踪耗时任务的开始,expectedTime是可选参数,标识该任务的期望耗时。
- 参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
| expectedTime | number | 否 | 期望的耗时时间,单位:ms |
<a name="table69661135912"></a>
<table><thead align="left"><tr id="row149668318915"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="p7966738914"><a name="p7966738914"></a><a name="p7966738914"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="13.22%" id="mcps1.1.5.1.2"><p id="p296713699"><a name="p296713699"></a><a name="p296713699"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.67%" id="mcps1.1.5.1.3"><p id="p196718315911"><a name="p196718315911"></a><a name="p196718315911"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="p9967231197"><a name="p9967231197"></a><a name="p9967231197"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row99671533914"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="p79671633910"><a name="p79671633910"></a><a name="p79671633910"></a>name</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="p11967433914"><a name="p11967433914"></a><a name="p11967433914"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="p19671336916"><a name="p19671336916"></a><a name="p19671336916"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="p2084833211463"><a name="p2084833211463"></a><a name="p2084833211463"></a>要追踪的任务名称</p>
</td>
</tr>
<tr id="row18967831393"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="p16813106387"><a name="p16813106387"></a><a name="p16813106387"></a>taskId</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="p976115416386"><a name="p976115416386"></a><a name="p976115416386"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="p149671932919"><a name="p149671932919"></a><a name="p149671932919"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="p19675312911"><a name="p19675312911"></a><a name="p19675312911"></a>任务id</p>
</td>
</tr>
<tr id="row1225911163813"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="p132250110380"><a name="p132250110380"></a><a name="p132250110380"></a>expectedTime</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="p1622551113381"><a name="p1622551113381"></a><a name="p1622551113381"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="p5226151110383"><a name="p5226151110383"></a><a name="p5226151110383"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="p22262111381"><a name="p22262111381"></a><a name="p22262111381"></a>期望的耗时时间,单位:ms</p>
</td>
</tr>
</tbody>
</table>
>![](../../public_sys-resources/icon-note.gif) **说明:**
>如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且这些会同时被执行,则每次调用startTrace的taskId必须不一致。如果具有相同name的任务是串行执行的,则taskId可以相同。在下面bytrace.finishTrace的示例中会举例说明。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 如果有多个相同name的任务需要追踪或者对同一个任务要追踪多次,并且这些会同时被执行,则每次调用startTrace的taskId必须不一致。如果具有相同name的任务是串行执行的,则taskId可以相同。在下面bytrace.finishTrace的示例中会举例说明。
- 示例:
```
bytrace.startTrace("myTestFunc", 1);
bytrace.startTrace("myTestFunc", 1, 5); //从startTrace到finishTrace流程的耗时期望为5ms
```
## bytrace.finishTrace<a name="section7895134841213"></a>
## bytrace.finishTrace
finishTrace\(name: string, taskId: number\): void
finishTrace(name: string, taskId: number): void
标记一个预追踪耗时任务的结束。
- 参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的任务名称 |
| taskId | number | 是 | 任务id |
<a name="table1589613488127"></a>
<table><thead align="left"><tr id="row208961448131215"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="p1089674831216"><a name="p1089674831216"></a><a name="p1089674831216"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="13.22%" id="mcps1.1.5.1.2"><p id="p1689613481128"><a name="p1689613481128"></a><a name="p1689613481128"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.67%" id="mcps1.1.5.1.3"><p id="p989613483125"><a name="p989613483125"></a><a name="p989613483125"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="p13896148111215"><a name="p13896148111215"></a><a name="p13896148111215"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row14896204817125"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="p10896174817128"><a name="p10896174817128"></a><a name="p10896174817128"></a>name</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="p189618483125"><a name="p189618483125"></a><a name="p189618483125"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="p118961548101215"><a name="p118961548101215"></a><a name="p118961548101215"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="p1989674810124"><a name="p1989674810124"></a><a name="p1989674810124"></a>要追踪的任务名称</p>
</td>
</tr>
<tr id="row5896548101211"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="p10896164811121"><a name="p10896164811121"></a><a name="p10896164811121"></a>taskId</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="p1789694821215"><a name="p1789694821215"></a><a name="p1789694821215"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="p08962488128"><a name="p08962488128"></a><a name="p08962488128"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="p8896194831214"><a name="p8896194831214"></a><a name="p8896194831214"></a>任务id</p>
</td>
</tr>
</tbody>
</table>
>![](../../public_sys-resources/icon-note.gif) **说明:**
>finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
- 示例:
```
bytrace.finishTrace("myTestFunc", 1);
```
......@@ -145,48 +84,20 @@ finishTrace\(name: string, taskId: number\): void
```
## bytrace.traceByValue<a name="section1388414179173"></a>
## bytrace.traceByValue
traceByValue\(name: string, value: number\): void
traceByValue(name: string, value: number): void
用来标记一个预追踪的数值变量,该变量的数值会不断变化。
- 参数:
<a name="table0884617171718"></a>
<table><thead align="left"><tr id="row1188481771714"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="p488419174178"><a name="p488419174178"></a><a name="p488419174178"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="13.22%" id="mcps1.1.5.1.2"><p id="p12884131721718"><a name="p12884131721718"></a><a name="p12884131721718"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.67%" id="mcps1.1.5.1.3"><p id="p188481714178"><a name="p188481714178"></a><a name="p188481714178"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="p188411174177"><a name="p188411174177"></a><a name="p188411174177"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row38849172174"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="p7884121719172"><a name="p7884121719172"></a><a name="p7884121719172"></a>name</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="p1488415174171"><a name="p1488415174171"></a><a name="p1488415174171"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="p7884171711717"><a name="p7884171711717"></a><a name="p7884171711717"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="p17884517161715"><a name="p17884517161715"></a><a name="p17884517161715"></a>要追踪的数值变量名称</p>
</td>
</tr>
<tr id="row188419179172"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="p206756457267"><a name="p206756457267"></a><a name="p206756457267"></a>value</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="p9884917111710"><a name="p9884917111710"></a><a name="p9884917111710"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="p18841217141719"><a name="p18841217141719"></a><a name="p18841217141719"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="p178842174174"><a name="p178842174174"></a><a name="p178842174174"></a>变量的值</p>
</td>
</tr>
</tbody>
</table>
- 参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| name | string | 是 | 要追踪的数值变量名称 |
| value | number | 是 | 变量的值 |
- 示例:
```
let traceCount = 3;
bytrace.traceByValue("myTestCount", traceCount);
......@@ -194,5 +105,3 @@ traceByValue\(name: string, value: number\): void
traceCount = 5;
bytrace.traceByValue("myTestCount", traceCount);
```
......@@ -2,9 +2,7 @@
>**说明:**
>
>- 从 API Version 6 开始支持。
>
>- 标记<sup>7+</sup>的接口从API Version 7开始支持。
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
......@@ -24,9 +22,9 @@ dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
- 参数
| 参数 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| phoneNumber | string | 是 |电话号码。|
| callback |AsyncCallback&lt;boolean&gt;|是|回调函数:<br/>- true:成功。<br/>- false:失败。|
| ----------- | ---------------------------- | ---- | ------------------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数:<br/>- true:成功。<br/>- false:失败。 |
- 示例
......@@ -411,14 +409,14 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise<str
拨打电话的可选参数。
| 参数 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| extras | boolean | 否 |根据extras的值判断是否为视频通话,默认为语音通话。<br/>- true:视频通话。<br/>- fasle:语音通话。|
| ------ | ------- | ---- | ------------------------------------------------------------ |
| extras | boolean | 否 | 根据extras的值判断是否为视频通话,默认为语音通话。<br/>- true:视频通话。<br/>- fasle:语音通话。 |
## CallState<a name=CallState></a>
通话状态码。
| 变量 | 值 | 说明 |
| -------- | -------- | -------- |
| ------------------ | ---- | ------------------------------------------------------------ |
| CALL_STATE_UNKNOWN | -1 | 无效状态,当获取呼叫状态失败时返回。 |
| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。 |
| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。 |
......@@ -428,12 +426,12 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise<str
判断是否是紧急电话号码的可选参数。
| 参数 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| slotId | number | 否 |卡槽ID:<br/>- 0:卡槽1。<br/>- 1:卡槽2。|
| ------ | ------ | ---- | ------------------------------------------ |
| slotId | number | 否 | 卡槽ID:<br/>- 0:卡槽1。<br/>- 1:卡槽2。 |
## NumberFormatOptions<sup>7+</sup><a name=NumberFormatOptions></a>
格式化号码的可选参数。
| 参数 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| countryCode | string | 否 |国家码,支持所有国家的国家码,如:中国(CN)。默认为:CN。|
| ----------- | ------ | ---- | ---------------------------------------------------------- |
| countryCode | string | 否 | 国家码,支持所有国家的国家码,如:中国(CN)。默认为:CN。 |
\ No newline at end of file
# 数据管理<a name="ZH-CN_TOPIC_0000001218703847"></a>
# 数据管理
- **[文件管理](js-apis-fileio.md)**
......@@ -11,5 +13,3 @@
- **[结果集](js-apis-data-resultset.md)**
- **[DataAbility 谓词](js-apis-data-ability.md)**
\ No newline at end of file
# 设备管理<a name="ZH-CN_TOPIC_0000001218703849"></a>
# 设备管理
- **[传感器](js-apis-sensor.md)**
- **[振动](js-apis-vibrator.md)**
- **[屏幕亮度](js-apis-brightness.md)**
- **[电量信息](js-apis-battery-info.md)**
- **[屏幕亮度(新)](js-apis-brightness.md)**
- **[电量信息(新)](js-apis-battery-info.md)**
- **[系统电源管理](js-apis-power.md)**
- **[Runninglock锁](js-apis-runninglock.md)**
- **[设备信息](js-apis-device-info.md)**
- **[系统属性](js-apis-system-parameter.md)**
- **[设备管理](js-apis-device-manager.md)**
- **[显示设备属性](js-apis-display.md)**
- **[升级](js-apis-libupdateclient.md)**
- **[窗口](js-apis-window.md)**
- **[显示设备属性](js-apis-display.md)**
\ No newline at end of file
# 媒体<a name="ZH-CN_TOPIC_0000001218662311"></a>
# 媒体
- **[音频管理](js-apis-audio.md)**
- **[音频播放](js-apis-media.md)**
- **[音频录制](js-apis-recorder.md)**
- **[音频管理](js-apis-audio.md)**
- **[音频播放和录制](js-apis-media.md)**
# 公共事件与通知<a name="ZH-CN_TOPIC_0000001222145373"></a>
......@@ -2,8 +2,7 @@
>**说明:**
>
>- 从 API Version 6 开始支持。
>- 标记<sup>7+</sup>的接口从API Version 7开始支持。
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
......
# 资源管理<a name="ZH-CN_TOPIC_0000001173443312"></a>
# 资源管理
- **[资源管理](js-apis-resource-manager.md)**
- **[国际化(I18n)](js-apis-i18n.md)**
- **[国际化(Intl)](js-apis-intl.md)**
- **[资源管理](js-apis-resource-manager.md)**
- **[国际化-Intl(新)](js-apis-intl.md)**
- **[国际化-I18n(新)](js-apis-i18n.md)**
\ No newline at end of file
此差异已折叠。
此差异已折叠。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册