提交 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,56 +9,55 @@
- [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)
- [音频管理](js-apis-audio.md)
- [音频播放](js-apis-media.md)
- [音频录制](js-apis-recorder.md)
- [数据管理](js-apis-data.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-resource-manager.md)
- [国际化-Intl](js-apis-intl.md)
- [国际化-I18n](js-apis-i18n.md)
- 媒体
- [音频管理](js-apis-audio.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-distributed-account.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)
- [电量信息](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-basic-features.md)
- [应用上下文](js-apis-basic-features-app-context.md)
- [日志打印](js-apis-basic-features-logs.md)
- [页面路由](js-apis-basic-features-routes.md)
- [弹窗](js-apis-basic-features-pop-up.md)
- [应用配置](js-apis-basic-features-configuration.md)
- [定时器](js-apis-basic-features-timer.md)
- [设置系统时间](js-apis-system-time.md)
- [动画](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)
- 设备管理
- [传感器](js-apis-sensor.md)
- [振动](js-apis-vibrator.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-window.md)
- [显示设备属性](js-apis-display.md)
- [升级](js-apis-update.md)
- 基本功能
- [应用上下文](js-apis-basic-features-app-context.md)
- [日志打印](js-apis-basic-features-logs.md)
- [页面路由](js-apis-basic-features-routes.md)
- [弹窗](js-apis-basic-features-pop-up.md)
- [应用配置](js-apis-basic-features-configuration.md)
- [定时器](js-apis-basic-features-timer.md)
- [设置系统时间](js-apis-system-time.md)
- [动画](js-apis-basic-features-animator.md)
- [应用打点](js-apis-hiappevent.md)
- [性能打点](js-apis-bytrace.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)**
- **[URL字符串解析](js-apis-url.md)**
- **[字符串编解码](js-apis-util.md)**
- **[获取进程相关的信息](js-apis-process.md)**
- **[启动一个worker](js-apis-worker.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_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
<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>
- 示例
```
export default {
getInfo(){
var info = app.getInfo();
console.log(JSON.stringify(info));
}
}
```
- 返回值
**表1** AppResponse
| | | |
| -------- | -------- | -------- |
| 参数名 | 类型 | 说明 |
| appID<sup>6+</sup> | string | 表示应用的包名,用于标识应用的唯一性。 |
| appName | string | 表示应用的名称。 |
| versionName | string | 表示应用的版本名称。 |
| versionCode | number | 表示应用的版本号。 |
- 示例
```
export default {
getInfo(){
var info = app.getInfo();
console.log(JSON.stringify(info));
}
}
```
## 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(){
app.terminate();
}}
```
- 示例
```
export default {
terminate(){
app.terminate();
}}
```
## 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
<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>
- 示例
获取应用当前的语言和地区。默认与系统的语言和地区同步。
```
export default {
getLocale() {
const localeInfo = configuration.getLocale();
console.info(localeInfo.language);
}
- 返回值
**表1** LocaleResponse
| 参数名 | 类型 | 说明 |
| -------- | -------- | -------- |
| language | string | 语言。例如:zh。 |
| countryOrRegion | string | 国家或地区。例如:CN。 |
| dir | string | 文字布局方向。取值范围:<br/>-&nbsp;ltr:从左到右;<br/>-&nbsp;rtl:从右到左。 |
| $unicodeSetting^{5+}$ | string | 语言环境定义的Unicode语言环境键集,如果此语言环境没有特定键集,则返回空集。<br/>例如:{"nu":"arab"},表示当前环境下的数字采用阿拉伯语的数字。 |
- 示例
```
export default {
getLocale() {
const localeInfo = configuration.getLocale();
console.info(localeInfo.language);
}
```
}
```
# 日志打印<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级别的日志信息。
- 参数
<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
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
## console.log
log(message: string): void
打印debug级别的日志信息。
- 参数
<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
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
## console.info
info(message: string): void
打印info级别的日志信息。
- 参数
<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
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
## console.warn
warn(message: string): void
打印warn级别的日志信息。
- 参数
<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
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
## console.error
error(message: string): void
打印error级别的日志信息。
- 参数
<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>
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| message | string | 是 | 表示要打印的文本信息。 |
## 示例
```
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_0000001173342500"></a>
# 基本功能
- **[应用上下文](js-apis-basic-features-app-context.md)**
- **[日志打印](js-apis-basic-features-logs.md)**
- **[页面路由](js-apis-basic-features-routes.md)**
- **[应用上下文](js-apis-basic-features-app-context.md)**
- **[弹窗](js-apis-basic-features-pop-up.md)**
- **[日志打印](js-apis-basic-features-logs.md)**
- **[应用配置](js-apis-basic-features-configuration.md)**
- **[页面路由](js-apis-basic-features-routes.md)**
- **[定时器](js-apis-basic-features-timer.md)**
- **[弹窗](js-apis-basic-features-pop-up.md)**
- **[设置系统时间](js-apis-system-time.md)**
- **[应用配置](js-apis-basic-features-configuration.md)**
- **[动画](js-apis-basic-features-animator.md)**
- **[定时器](js-apis-basic-features-timer.md)**
- **[应用打点](js-apis-hiappevent.md)**
- **[设置系统时间](js-apis-system-time.md)**
- **[性能打点](js-apis-bytrace.md)**
- **[动画](js-apis-basic-features-animator.md)**
- **[应用打点](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>
- 示例:
```
import brightness from '@ohos.brightness.d.ts';
brightness.setValue(128);
```
设置系统的屏幕亮度。
- 参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| value | number | 是 | 亮度的值(0~255) |
- 示例:
```
import brightness from '@ohos.brightness.d.ts';
brightness.setValue(128);
```
......@@ -2,9 +2,7 @@
>**说明:**
>
>- 从 API Version 6 开始支持。
>
>- 标记<sup>7+</sup>的接口从API Version 7开始支持。
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
......@@ -23,10 +21,10 @@ 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:失败。 |
- 示例
......@@ -410,30 +408,30 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise<str
## DialOptions<a name=DialOptions></a>
拨打电话的可选参数。
| 参数 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| 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 | 表示来电正在振铃或等待。 |
| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态,并且没有新的来电振铃或等待。 |
| 变量 | 值 | 说明 |
| ------------------ | ---- | ------------------------------------------------------------ |
| CALL_STATE_UNKNOWN | -1 | 无效状态,当获取呼叫状态失败时返回。 |
| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。 |
| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。 |
| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态,并且没有新的来电振铃或等待。 |
## EmergencyNumberOptions<sup>7+</sup><a name=EmergencyNumberOptions></a>
判断是否是紧急电话号码的可选参数。
| 参数 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| 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)**
- **[轻量级存储](js-apis-data-storage.md)**
- **[分布式数据管理](js-apis-distributed-data.md)**
- **[文件管理](js-apis-fileio.md)**
- **[关系型数据库](js-apis-data-rdb.md)**
- **[轻量级存储](js-apis-data-storage.md)**
- **[结果集](js-apis-data-resultset.md)**
- **[分布式数据管理](js-apis-distributed-data.md)**
- **[DataAbility 谓词](js-apis-data-ability.md)**
- **[关系型数据库](js-apis-data-rdb.md)**
- **[结果集](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-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-sensor.md)**
- **[振动](js-apis-vibrator.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-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
......@@ -2,8 +2,7 @@
>**说明:**
>
>- 从 API Version 6 开始支持。
>- 标记<sup>7+</sup>的接口从API Version 7开始支持。
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
......@@ -275,10 +274,10 @@ getSimState\(slotId: number, callback: AsyncCallback<SimState\>\): void
- 参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ----------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0:卡槽1<br/>- 1:卡槽2 |
| callback | AsyncCallback\<[SimState](#SimState)\> | 是 | 回调函数。参考[SimState](#SimState)。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0:卡槽1<br/>- 1:卡槽2 |
| callback | AsyncCallback\<[SimState](#SimState)\> | 是 | 回调函数。参考[SimState](#SimState) |
- 示例
......
# 电话服务<a name="ZH-CN_TOPIC_0000001176904124"></a>
# 电话服务
- [拨打电话](js-apis-call.md)
- [短信服务](js-apis-sms.md)
- [SIM卡管理](js-apis-sim.md)
- [网络搜索](js-apis-radio.md)
\ No newline at end of file
此差异已折叠。
此差异已折叠。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册