Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
804041e9
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
804041e9
编写于
3月 16, 2022
作者:
Z
zengyawen
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs
Signed-off-by:
N
zengyawen
<
zengyawen1@huawei.com
>
上级
1404d042
变更
9
展开全部
隐藏空白更改
内联
并排
Showing
9 changed file
with
3807 addition
and
53 deletion
+3807
-53
en/application-dev/application-dev-website-en.md
en/application-dev/application-dev-website-en.md
+581
-0
en/application-dev/media/Readme-EN.md
en/application-dev/media/Readme-EN.md
+0
-5
zh-cn/application-dev/application-dev-website.md
zh-cn/application-dev/application-dev-website.md
+0
-11
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+4
-0
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
+1047
-0
zh-cn/application-dev/reference/apis/js-apis-request.md
zh-cn/application-dev/reference/apis/js-apis-request.md
+1102
-0
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
+168
-0
zh-cn/application-dev/reference/apis/js-apis-system-time.md
zh-cn/application-dev/reference/apis/js-apis-system-time.md
+336
-37
zh-cn/application-dev/reference/apis/js-apis-wallpaper.md
zh-cn/application-dev/reference/apis/js-apis-wallpaper.md
+569
-0
未找到文件。
en/application-dev/application-dev-website-en.md
0 → 100644
浏览文件 @
804041e9
此差异已折叠。
点击以展开。
en/application-dev/media/Readme-EN.md
浏览文件 @
804041e9
...
...
@@ -13,13 +13,8 @@
- [Audio Recording Development](audio-recorder.md)
- [Audio Recorder Development Using AudioCapturer](audio-capturer)
-
Video
-
[
Video Playback Development
](
video-playback.md
)
-
[
Video Recording Development
](
video-recorder.md
)
-
Sound
-
[
SoundManager Development
](
sound-manager.md
)
zh-cn/application-dev/application-dev-website.md
浏览文件 @
804041e9
# 应用开发
-
[
应用开发导读
](
application-dev-guide.md
)
-
了解OpenHarmony
-
[
了解OpenHarmony开源项目
](
../OpenHarmony-Overview_zh.md
)
-
[
了解OpenHarmony系统
](
../readme
)
-
[
术语
](
../device-dev/glossary/glossary.md
)
-
[
版本说明
](
../release-notes/Readme.md
)
-
OpenHarmony 3.x Releases
...
...
@@ -30,7 +25,6 @@
-
[
OpenHarmony 1.1.1 LTS (2021-06-22)
](
../release-notes/OpenHarmony-1-1-1-LTS.md
)
-
[
OpenHarmony 1.1.0 LTS (2021-04-01)
](
../release-notes/OpenHarmony-1-1-0-LTS.md
)
-
[
OpenHarmony 1.0 (2020-09-10)
](
../release-notes/OpenHarmony-1-0.md
)
-
快速开始
-
[
应用开发快速入门
](
quick-start/Readme-CN.md
)
-
DevEco Studio(OpenHarmony)使用指南
...
...
@@ -43,7 +37,6 @@
-
[
配置OpenHarmony应用签名信息
](
quick-start/configuring-openharmony-app-signature.md
)
-
[
安装运行OpenHarmony应用
](
quick-start/installing-openharmony-app.md
)
-
[
应用开发包结构说明
](
quick-start/quick-start/package-structure.md
)
-
开发
-
[
Ability开发
](
ability/Readme-CN.md
)
-
[
Ability框架概述
](
ability/ability-brief.md
)
...
...
@@ -262,7 +255,6 @@
-
分布式跟踪
-
[
分布式跟踪概述
](
dfx/hitracechain-overview.md
)
-
[
分布式跟踪开发指导
](
dfx/hitracechain-guidelines.md
)
-
工具
-
[
DevEco Studio(OpenHarmony)使用指南
](
quick-start/deveco-studio-user-guide-for-openharmony.md
)
-
[
概述
](
quick-start/deveco-studio-overview.md
)
...
...
@@ -271,12 +263,10 @@
-
[
创建OpenHarmony工程
](
quick-start/create-openharmony-project.md
)
-
[
配置OpenHarmony应用签名信息
](
quick-start/configuring-openharmony-app-signature.md
)
-
[
安装运行OpenHarmony应用
](
quick-start/installing-openharmony-app.md
)
-
示例教程
-
[
示例代码
](
https://gitee.com/openharmony/app_samples/blob/master/README_zh.md
)
-
[
Codelabs
](
https://gitee.com/openharmony/codelabs/blob/master/README.md
)
-
API参考
-
[
组件参考(基于JS扩展的类Web开发范式)
](
reference/arkui-js/Readme-CN.md
)
-
组件
...
...
@@ -644,7 +634,6 @@
-
定制管理
-
[
配置策略
](
reference/apis/js-apis-config-policy.md
)
-
[
企业设备管理
](
reference/apis/js-apis-enterprise-device-manager.md
)
-
贡献
-
[
参与贡献
](
../contribute/贡献文档.md
)
\ No newline at end of file
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
804041e9
...
...
@@ -54,6 +54,7 @@
-
[
Socket连接
](
js-apis-socket.md
)
-
[
WebSocket连接
](
js-apis-webSocket.md
)
-
[
数据请求
](
js-apis-http.md
)
-
[
上传下载
](
js-apis-request.md
)
-
通信与连接
-
[
WLAN
](
js-apis-wifi.md
)
-
[
Bluetooth
](
js-apis-bluetooth.md
)
...
...
@@ -81,7 +82,10 @@
-
[
弹窗
](
js-apis-basic-features-pop-up.md
)
-
[
应用配置
](
js-apis-basic-features-configuration.md
)
-
[
定时器
](
js-apis-basic-features-timer.md
)
-
[
锁屏管理
](
js-apis-screen-lock.md
)
-
[
设置系统时间
](
js-apis-system-time.md
)
-
[
壁纸
](
js-apis-wallpaper.md
)
-
[
剪贴板
](
js-apis-pasteboard.md
)
-
[
动画
](
js-apis-basic-features-animator.md
)
-
[
WebGL
](
js-apis-webgl.md
)
-
[
WebGL2
](
js-apis-webgl2.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-pasteboard.md
0 → 100644
浏览文件 @
804041e9
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-request.md
0 → 100644
浏览文件 @
804041e9
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
0 → 100644
浏览文件 @
804041e9
# 锁屏管理
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import screenlock from '@ohos.screenLock';
```
## screenlock.isScreenLocked
isScreenLocked(callback: AsyncCallback
<
boolean
>
): void
判断屏幕是否锁屏,使用callback作为异步方法。
**系统能力**
: SystemCapability.MiscServices.ScreenLock
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回true表示屏幕已锁屏,返回false表示屏幕未锁屏。 |
-
示例:
```
screenlock.isScreenLocked((err, data)=>{
if (err) {
console.error('isScreenLocked callback error -> ${JSON.stringify(err)}');
return;
}
console.info('isScreenLocked callback success data -> ${JSON.stringify(data)}');
});
```
## screenlock.isScreenLocked
isScreenLocked(): Promise
<
boolean
>
判断屏幕是否锁屏,使用Promise作为异步方法。
**系统能力**
: SystemCapability.MiscServices.ScreenLock
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
boolean
>
| 以Promise形式返回结果。 |
-
示例:
```
screenlock.isScreenLocked().then((data) => {
console.log('isScreenLocked success: data -> ${JSON.stringify(data)}');
}).catch((err) => {
console.error('isScreenLocked fail, promise: err -> ${JSON.stringify(err)}');
});
```
## screenlock.isSecureMode
isSecureMode(callback: AsyncCallback
<
boolean
>
): void
判断设备是否处于安全模式下,使用callback作为异步方法。
**系统能力**
: SystemCapability.MiscServices.ScreenLock
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数。返回true表示屏幕处于安全模式下,返回false表示屏幕当前不在安全模式下。 |
-
示例:
```
screenlock.isSecureMode((err, data)=>{
if (err) {
console.error('isSecureMode callback error -> ${JSON.stringify(err)}');
return;
}
console.info('isSecureMode callback success data -> ${JSON.stringify(err)}');
});
```
## screenlock.isSecureMode
isSecureMode(): Promise
<
boolean
>
判断设备是否处于安全模式下,使用Promise作为异步方法。
**系统能力**
: SystemCapability.MiscServices.ScreenLock
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
boolean
>
| 以Promise形式返回结果。 |
-
示例:
```
screenlock.isSecureMode().then((data) => {
console.log('isSecureMode success: data->${JSON.stringify(data)}');
}).catch((err) => {
console.error('isSecureMode fail, promise: err->${JSON.stringify(err)}');
});
```
## screenlock.unlockScreen
unlockScreen(callback: AsyncCallback
<
void
>
): void
解锁屏幕,使用callback作为异步方法。
**系统能力**
: SystemCapability.MiscServices.ScreenLock
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,失败时返回错误信息。 |
-
示例:
```
screenlock.unlockScreen((err)=>{
if (err) {
console.error('unlockScreen callback error -> ${JSON.stringify(err)}');
return;
}
console.info('unlockScreen callback success');
});
```
## screenlock.unlockScreen
unlockScreen(): Promise
<
void
>
解锁屏幕,使用Promise作为异步方法。
**系统能力**
: SystemCapability.MiscServices.ScreenLock
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 以Promise形式返回结果。 |
-
示例:
```
screenlock.unlockScreen().then(() => {
console.log('unlockScreen success');
}).catch((err) => {
console.error('unlockScreen fail, promise: err->${JSON.stringify(err)}');
});
```
zh-cn/application-dev/reference/apis/js-apis-system-time.md
浏览文件 @
804041e9
...
...
@@ -6,6 +6,7 @@
## 导入模块
```
import systemTime from '@ohos.systemTime';
```
...
...
@@ -15,15 +16,20 @@ import systemTime from '@ohos.systemTime';
setTime(time : number, callback : AsyncCallback
<
void
>
) : void
设置系统时间,需要ohos.permission.SET_TIME权限。
设置系统时间。
**需要权限:**
ohos.permission.SET_TIME
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| time | number | 是 | 目标时间戳(毫秒)。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
| time | number | 是 | 目标时间戳(毫秒)。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
-
示例:
```
// time对应的时间为2021-01-20 02:36:25
var time = 1611081385000;
...
...
@@ -32,7 +38,7 @@ setTime(time : number, callback : AsyncCallback<void>) : void
console.error(`failed to systemTime.setTime because ` + JSON.stringify(error));
return;
}
console.log(`s
uccess to systemTime.setTime
: ` + JSON.stringify(data));
console.log(`s
ystemTime.setTime success data
: ` + JSON.stringify(data));
});
```
...
...
@@ -41,51 +47,229 @@ setTime(time : number, callback : AsyncCallback<void>) : void
setTime(time : number) : Promise
<
void
>
设置系统时间,需要ohos.permission.SET_TIME权限。
设置系统时间。
**需要权限:**
ohos.permission.SET_TIME
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| time | number | 是 | 目标时间戳(毫秒)。 |
| time | number | 是 | 目标时间戳(毫秒)。 |
-
返回值:
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数。 |
| Promise
<
void
>
| 返回的异步回调函数。 |
-
示例:
```
// time对应的时间为2021-01-20 02:36:25
var time = 1611081385000;
systemTime.setTime(time).then((data) => {
console.log(`s
uccess to systemTime.setTime
: ` + JSON.stringify(data));
console.log(`s
ystemTime.setTime success data
: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to systemTime.setTime because ` + JSON.stringify(error));
});
```
## systemTime.getCurrentTime<sup>8+</sup>
getCurrentTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
获取自 Unix 纪元以来经过的时间,使用callback形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自
Unix
纪元以来经过的时间。 |
-
示例:
```
systemTime.getCurrentTime(true, (error, data) => {
if (error) {
console.error(`failed to systemTime.getCurrentTime because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getCurrentTime success data : ` + JSON.stringify(data));
});
```
## systemTime.getCurrentTime<sup>8+</sup>
getCurrentTime(isNano?: boolean): Promise
<
number
>
获取自 Unix 纪元以来经过的时间,使用Promise形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回自
Unix
纪元以来经过的时间。 |
-
示例:
```
systemTime.getCurrentTime().then((data) => {
console.log(`systemTime.getCurrentTime success data : ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to systemTime.getCurrentTime because ` + JSON.stringify(error));
});
```
## systemTime.getRealActiveTime<sup>8+</sup>
getRealActiveTime(isNano?: boolean, callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用callback形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来但不包括度睡眠时间经过的时间。 |
-
示例:
```
systemTime.getRealActiveTime(true, (error, data) => {
if (error) {
console.error(`failed to systemTime.getRealActiveTimebecause ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getRealActiveTime success data : ` + JSON.stringify(data));
});
```
## systemTime.getRealActiveTime<sup>8+</sup>
getRealActiveTime(isNano?: boolean): Promise
<
number
>
获取自系统启动以来经过的时间,不包括深度睡眠时间,使用Promise形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回自系统启动以来但不包括度睡眠时间经过的时间。 |
-
示例:
```
systemTime.getCurrentTime().then((data) => {
console.log(`systemTime.getRealActiveTime success data : ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to systemTime.getRealActiveTime because ` + JSON.stringify(error));
});
```
## systemTime.getRealTime<sup>8+</sup>
getRealTime(callback: AsyncCallback
<
number
>
): void
获取自系统启动以来经过的时间,包括深度睡眠时间,使用callback形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回自系统启动以来包括深度睡眠时间经过的毫秒数。 |
-
示例:
```
systemTime.getRealTime(true, (error, data) => {
if (error) {
console.error(`failed to systemTime.getRealTime because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getRealTime success data: ` + JSON.stringify(data));
});
```
## systemTime.getRealTime<sup>8+</sup>
getRealTime(): Promise
<
number
>
获取自系统启动以来经过的时间,包括深度睡眠时间,使用Promise形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| isNano | boolean | 否 | 如果是true,返回纳秒数;否则返回毫秒数。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 以Promise形式返回结果,返回自系统启动以来包括深度睡眠时间经过的时间。 |
-
示例:
```
systemTime.getRealTime().then((data) => {
console.log(`systemTime.getRealTime success data: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to systemTime.getRealTime because ` + JSON.stringify(error));
});
```
## systemTime.setDate
setDate(date: Date, callback: AsyncCallback
<
void
>
): void
设置系统日期,需要ohos.permission.SET_TIME权限。
设置系统日期,使用callback形式返回结果。
**需要权限:**
ohos.permission.SET_TIME
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| date | Date | 是 | 目标日期。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
| date | Date | 是 | 目标日期。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
-
示例:
```
var data = new Date("October 13, 2020 11:13:00");
systemTime.setDate(data,(error, data) => {
if (error) {
console.error('
SystemTimePlugin setDate failed
because ' + JSON.stringify(error));
console.error('
failed to systemTime.setDate
because ' + JSON.stringify(error));
return;
}
console.info('
SystemTimePlugin
setDate success data : ' + JSON.stringify(data));
console.info('
systemTime.
setDate success data : ' + JSON.stringify(data));
});
```
...
...
@@ -94,25 +278,80 @@ setDate(date: Date, callback: AsyncCallback<void>): void
setDate(date: Date): Promise
<
void
>
设置系统日期,需要ohos.permission.SET_TIME权限。
设置系统日期,使用Promise形式返回结果。
**需要权限:**
ohos.permission.SET_TIME
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| date | Date | 是 | 目标日期。 |
| date | Date | 是 | 目标日期。 |
-
返回值:
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数。 |
| Promise
<
void
>
| 返回的异步回调函数。 |
-
示例:
```
var data = new Date("October 13, 2020 11:13:00");
systemTime.setDate(data).then((value) => {
console.log(`
SystemTimePlugin success to systemTime.setDate
: ` + JSON.stringify(value));
console.log(`
systemTime.setDate success data
: ` + JSON.stringify(value));
}).catch((error) => {
console.error(`SystemTimePlugin failed to systemTime.setDate because: ` + JSON.stringify(error));
console.error(`failed to systemTime.setDate because: ` + JSON.stringify(error));
});
```
## systemTime.getDate<sup>8+</sup>
getDate(callback: AsyncCallback
<
Date
>
): void
获取当前系统日期,使用callback形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
Date
>
| 是 | 回调函数,返回当前系统日期。 |
-
示例:
```
systemTime.getDate((error, data) => {
if (error) {
console.error(`failed to systemTime.getDate because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getDate success data : ` + JSON.stringify(data));
});
```
## systemTime.getDate<sup>8+</sup>
getDate(): Promise
<
Date
>
获取当前系统日期,使用Promise形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Date
>
| 以Promise形式返回结果,返回当前系统日期。 |
-
示例:
```
systemTime.getDate().then((data) => {
console.log(`systemTime.getDate success data : ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to systemTime.getDate because ` + JSON.stringify(error));
});
```
...
...
@@ -121,22 +360,27 @@ setDate(date: Date): Promise<void>
setTimezone(timezone: string, callback: AsyncCallback
<
void
>
): void
设置系统时区,需要ohos.permission.SET_TIME_ZONE权限。
设置系统时区。
**需要权限:**
ohos.permission.SET_TIME_ZONE
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| timezone | string | 是 | 系统时区。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
| timezone | string | 是 | 系统时区。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,可以在回调函数中处理接口返回值。 |
-
示例:
```
systemTime.setTimezone('Asia/Shanghai', (error, data) => {
if (error) {
console.error('
SystemTimePlugin setTimezone failed because ' + JSON.stringify(error));
console.error('
failed to systemTime.setTimezone because ' + JSON.stringify(error));
return;
}
console.info('SystemTimePlugin setTimezone success data : ' + JSON.stringify(data));
console.info('SystemTimePlugin s
ystemTime.s
etTimezone success data : ' + JSON.stringify(data));
});
```
...
...
@@ -145,23 +389,78 @@ setTimezone(timezone: string, callback: AsyncCallback<void>): void
setTimezone(timezone: string): Promise
<
void
>
设置系统时区,需要ohos.permission.SET_TIME_ZONE权限。
设置系统时区。
**需要权限:**
ohos.permission.SET_TIME_ZONE
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| timezone | string | 是 | 系统时区。 |
| timezone | string | 是 | 系统时区。 |
-
返回值:
| 类型 | 说明 |
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 返回的异步回调函数。 |
| Promise
<
void
>
| 返回的异步回调函数。 |
-
示例:
```
systemTime.setTimezone('Asia/Shanghai').then((data) => {
console.log(`
SystemTimePlugin success to systemTime.setTimezone
: ` + JSON.stringify(data));
console.log(`
systemTime.setTimezone success data
: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`SystemTimePlugin failed to systemTime.setTimezone because: ` + JSON.stringify(error));
console.error(`failed to systemTime.setTimezone because: ` + JSON.stringify(error));
});
```
## systemTime.getTimeZone<sup>8+</sup>
getTimeZone(callback: AsyncCallback
<
string
>
): void
获取系统时区,使用callback形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
string
>
| 是 | 回调函数,返回系统时区。 |
-
示例:
```
systemTime.getTimeZone((error, data) => {
if (error) {
console.error(`failed to systemTime.getTimeZone because ` + JSON.stringify(error));
return;
}
console.log(`systemTime.getTimeZone success data : ` + JSON.stringify(data));
});
```
## systemTime.getTimeZone<sup>8+</sup>
getTimeZone(): Promise
<
string
>
获取系统时区,使用Promise形式返回结果。
**系统能力**
: SystemCapability.Miscservices.Time
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
string
>
| 以Promise形式返回结果,返回系统时区。 |
-
示例:
```
systemTime.getDate().then((data) => {
console.log(`systemTime.getTimeZone success data : ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to systemTime.getTimeZone because ` + JSON.stringify(error));
});
```
zh-cn/application-dev/reference/apis/js-apis-wallpaper.md
0 → 100644
浏览文件 @
804041e9
# 壁纸
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import wallpaper from '@ohos.wallpaper';
```
## WallpaperType
定义壁纸类型。
**系统能力**
: 以下各项对应的系统能力均为SystemCapability.Miscservices.Wallpaper。
| 名称 | 说明 |
| -------- | -------- |
| WALLPAPER_LOCKSCREEN | 锁屏壁纸标识。 |
| WALLPAPER_SYSTEM | 主屏幕壁纸标识。 |
## wallpaper.getColors
getColors(wallpaperType: WallpaperType, callback: AsyncCallback
<
Array
<
RgbaColor
>>
): void
获取指定类型壁纸的主要颜色信息。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
| callback | AsyncCallback
<
Array
<
[RgbaColor](#rgbacolor)
>>
| 是 | 回调函数,返回壁纸的主要颜色信息。 |
-
示例:
```
wallpaper.getColors(wallpaper.WallpaperType.WALLPAPER_SYSTEM, (error, data) => {
if (error) {
console.error(`failed to getColors because: ` + JSON.stringify(error));
return;
}
console.log(`success to getColors.`);
});
```
## wallpaper.getColors
getColors(wallpaperType: WallpaperType): Promise
<
Array
<
RgbaColor
>>
获取指定类型壁纸的主要颜色信息。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Array
<
[RgbaColor](#rgbacolor)
>>
| 返回壁纸的主要颜色信息。 |
-
示例:
```
wallpaper.getColors(wallpaper.WallpaperType.WALLPAPER_SYSTEM).then((data) => {
console.log(`success to getColors.`);
}).catch((error) => {
console.error(`failed to getColors because: ` + JSON.stringify(error));
});
```
## wallpaper.getId
getId(wallpaperType: WallpaperType, callback: AsyncCallback
<
number
>
): void
获取指定类型壁纸的ID。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回壁纸的ID。如果配置了指定类型的壁纸就返回一个大于等于0的数,否则返回-1。取值范围是-1~2^31-1。 |
-
示例:
```
wallpaper.getId(wallpaper.WallpaperType.WALLPAPER_SYSTEM, (error, data) => {
if (error) {
console.error(`failed to getId because: ` + JSON.stringify(error));
return;
}
console.log(`success to getId: ` + JSON.stringify(data));
});
```
## wallpaper.getId
getId(wallpaperType: WallpaperType): Promise
<
number
>
获取指定类型壁纸的ID。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 壁纸的ID。如果配置了这种壁纸类型的壁纸就返回一个大于等于0的数,否则返回-1。取值范围是-1~2^31-1。 |
-
示例:
```
wallpaper.getId(wallpaper.WallpaperType.WALLPAPER_SYSTEM).then((data) => {
console.log(`success to getId: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to getId because: ` + JSON.stringify(error));
});
```
## wallpaper.getMinHeight
getMinHeight(callback: AsyncCallback
<
number
>
): void
获取壁纸的最小高度值。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,返回壁纸的最小高度值,单位是像素。如果返回值等于0,说明没有设置壁纸,调用者应该使用默认显示的高度值代替。 |
-
示例:
```
wallpaper.getMinHeight((error, data) => {
if (error) {
console.error(`failed to getMinHeight because: ` + JSON.stringify(error));
return;
}
console.log(`success to getMinHeight: ` + JSON.stringify(data));
});
```
## wallpaper.getMinHeight
getMinHeight(): Promise
<
number
>
获取壁纸的最小高度值。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 返回壁纸的最小高度值,单位是像素。如果返回值等于0,说明没有设置壁纸,调用者应该使用默认显示的高度值代替。 |
-
示例:
```
wallpaper.getMinHeight().then((data) => {
console.log(`success to getMinHeight: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to getMinHeight because: ` + JSON.stringify(error));
});
```
## wallpaper.getMinWidth
getMinWidth(callback: AsyncCallback
<
number
>
): void
获取壁纸的最小宽度值。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
number
>
| 是 | 回调函数,壁纸的最小宽度值,单位是像素。如果返回值等于0,说明没有设置壁纸,调用者应该使用默认显示的宽度值代替。 |
-
示例:
```
wallpaper.getMinWidth((error, data) => {
if (error) {
console.error(`failed to getMinWidth because: ` + JSON.stringify(error));
return;
}
console.log(`success to getMinWidth: ` + JSON.stringify(data));
});
```
## wallpaper.getMinWidth
getMinWidth(): Promise
<
number
>
获取壁纸的最小宽度值。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 壁纸的最小宽度值,单位是像素。如果返回值等于0,说明没有设置壁纸,调用者应该使用默认显示的宽度值代替。 |
-
示例:
```
wallpaper.getMinWidth().then((data) => {
console.log(`success to getMinWidth: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to getMinWidth because: ` + JSON.stringify(error));
});
```
## wallpaper.isChangePermitted
isChangePermitted(callback: AsyncCallback
<
boolean
>
): void
是否允许应用改变当前用户的壁纸。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回是否允许应用改变当前用户的壁纸。如果允许返回true,否则返回false。 |
-
示例:
```
wallpaper.isChangePermitted((error, data) => {
if (error) {
console.error(`failed to isChangePermitted because: ` + JSON.stringify(error));
return;
}
console.log(`success to isChangePermitted: ` + JSON.stringify(data));
});
```
## wallpaper.isChangePermitted
isChangePermitted(): Promise
<
boolean
>
是否允许应用改变当前用户的壁纸。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
boolean
>
| 返回是否允许应用改变当前用户的壁纸。如果允许返回true,否则返回false。 |
-
示例:
```
wallpaper.isChangePermitted().then((data) => {
console.log(`success to isChangePermitted: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to isChangePermitted because: ` + JSON.stringify(error));
});
```
## wallpaper.isOperationAllowed
isOperationAllowed(callback: AsyncCallback
<
boolean
>
): void
是否允许用户设置壁纸。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数,返回是否允许用户设置壁纸。如果允许返回true,否则返回false。 |
-
示例:
```
wallpaper.isOperationAllowed((error, data) => {
if (error) {
console.error(`failed to isOperationAllowed because: ` + JSON.stringify(error));
return;
}
console.log(`success to isOperationAllowed: ` + JSON.stringify(data));
});
```
## wallpaper.isOperationAllowed
isOperationAllowed(): Promise
<
boolean
>
是否允许用户设置壁纸。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
boolean
>
| 异步回调函数,返回是否允许用户设置壁纸。如果允许返回true,否则返回false。 |
-
示例:
```
wallpaper.isOperationAllowed().then((data) => {
console.log(`success to isOperationAllowed: ` + JSON.stringify(data));
}).catch((error) => {
console.error(`failed to isOperationAllowed because: ` + JSON.stringify(error));
});
```
## wallpaper.reset
reset(wallpaperType: WallpaperType, callback: AsyncCallback
<
void
>
): void
移除指定类型的壁纸,恢复为默认显示的壁纸。
**需要权限**
:ohos.permission.SET_WALLPAPER
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,调用成功则返回是否移除成功的结果,调用失败则返回error信息。 |
-
示例:
```
wallpaper.reset((error, data) => {
if (error) {
console.error(`failed to reset because: ` + JSON.stringify(error));
return;
}
console.log(`success to reset.`);
});
```
## wallpaper.reset
reset(wallpaperType: WallpaperType): Promise
<
void
>
移除指定类型的壁纸,恢复为默认显示的壁纸。
**需要权限:**
ohos.permission.SET_WALLPAPER
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 调用成功则返回是否移除成功的结果,调用失败则返回error信息。 |
-
示例:
```
wallpaper.reset(wallpaper.WALLPAPER_SYSTEM).then((data) => {
console.log(`success to reset.`);
}).catch((error) => {
console.error(`failed to reset because: ` + JSON.stringify(error));
});
```
## wallpaper.setWallpaper
setWallpaper(uriOrPixelMap: string | image.PixelMap, wallpaperType: WallpaperType, callback: AsyncCallback
<
void
>
): void
将指定资源设置为指定类型的壁纸。
**需要权限:**
ohos.permission.SET_WALLPAPER
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| uriOrPixelMap | string
\|
[ERROR:Invalid
link:zh-cn_topic_0000001154665636.xml#xref134981523104113,link:zh-cn_topic_0000001122977382.xml#section160331714124](zh-cn_topic_0000001122977382.xml#section160331714124) | 是 | JPEG或PNG文件的Uri路径,或者PNG格式文件的位图。 |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数,调用成功则返回是返回设置的结果,调用失败则返回error信息。 |
-
示例:
```
// uriOrPixelMap类型为string
let wallpaperPath = "/data/data/ohos.acts.aafwk.plrdtest.form/files/Cup_ic.jpg";
wallpaper.setWallpaper(wallpaperPath, wallpaper.WALLPAPER_SYSTEM, (error, data) => {
if (error) {
console.error(`failed to setWallpaper because: ` + JSON.stringify(error));
return;
}
console.log(`success to setWallpaper.`);
});
// uriOrPixelMap类型为image.PixelMap
import image from '@ohos.multimedia.image';
let imageSource = image.createImageSource("file://" + wallpaperPath);
let opts = {
"desiredSize": {
"height": 3648,
"width": 2736
}
};
imageSource.createPixelMap(opts).then((pixelMap) => {
wallpaper.setWallpaper(pixelMap, wallpaper.WALLPAPER_SYSTEM, (error, data) => {
if (error) {
console.error(`failed to setWallpaper because: ` + JSON.stringify(error));
return;
}
console.log(`success to setWallpaper.`);
});
}).catch((error) => {
console.error(`failed to createPixelMap because: ` + JSON.stringify(error));
});
```
## wallpaper.setWallpaper
setWallpaper(uriOrPixelMap: string | image.PixelMap, wallpaperType: WallpaperType): Promise
<
void
>
将指定资源设置为指定类型的壁纸。
**需要权限**
:ohos.permission.SET_WALLPAPER
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| uriOrPixelMap | string
\|
[ERROR:Invalid
link:zh-cn_topic_0000001154665636.xml#xref2071734616,link:zh-cn_topic_0000001122977382.xml#section160331714124](zh-cn_topic_0000001122977382.xml#section160331714124) | 是 | JPEG或PNG文件的Uri路径,或者PNG格式文件的位图。 |
| wallpaperType |
[
WallpaperType
](
#wallpapertype
)
| 是 | 壁纸类型。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| 调用成功则返回是返回设置的结果,调用失败则返回error信息。 |
-
示例:
```
// uriOrPixelMap类型为string
let wallpaperPath = "/data/data/ohos.acts.aafwk.plrdtest.form/files/Cup_ic.jpg";
wallpaper.setWallpaper(wallpaperPath, wallpaper.WALLPAPER_SYSTEM).then((data) => {
console.log(`success to setWallpaper.`);
}).catch((error) => {
console.error(`failed to setWallpaper because: ` + JSON.stringify(error));
});
// uriOrPixelMap类型为image.PixelMap
import image from '@ohos.multimedia.image';
let imageSource = image.createImageSource("file://" + wallpaperPath);
let opts = {
"desiredSize": {
"height": 3648,
"width": 2736
}
};
imageSource.createPixelMap(opts).then((pixelMap) => {
wallpaper.setWallpaper(pixelMap, wallpaper.WALLPAPER_SYSTEM).then((data) => {
console.log(`success to setWallpaper.`);
}).catch((error) => {
console.error(`failed to setWallpaper because: ` + JSON.stringify(error));
});
}).catch((error) => {
console.error(`failed to createPixelMap because: ` + JSON.stringify(error));
});
```
## wallpaper.on('colorChange')
on(type: 'colorChange', callback: (colors: Array
<
RgbaColor
>
, wallpaperType: WallpaperType) =
>
void): void
订阅壁纸颜色变化结果上报事件。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 取值为'colorChange',表示壁纸颜色变化结果上报事件。 |
| callback | function | 是 | 壁纸颜色变化触发该回调方法,返回壁纸类型和壁纸的主要颜色信息。
<br/>
-
colors
<br/>
壁纸的主要颜色信息,其类型见[RgbaColor](#rgbacolor)。
<br/>
-
wallpaperType
<br/>
壁纸类型。 |
-
示例:
```
let listener = (colors, wallpaperType) => {
console.log(`wallpaper color changed.`);
};
wallpaper.on('colorChange', listener);
```
## wallpaper.off('colorChange')
off(type: 'colorChange', callback?: (colors: Array
<
RgbaColor
>
, wallpaperType: WallpaperType) =
>
void): void
取消订阅壁纸颜色变化结果上报事件。
**系统能力**
: SystemCapability.Miscservices.Wallpaper
-
参数:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 取值为'colorChange',表示取消订阅壁纸颜色变化结果上报事件。 |
| callback | function | 否 |
表示取消壁纸颜色变化结果上报,不填写该参数则取消订阅该type对应的所有回调。
<br/>
-
colors
<br/>
壁纸的主要颜色信息,其类型见[RgbaColor](#rgbacolor)。
<br/>
-
wallpaperType
<br/>
壁纸类型。 |
-
示例:
```
let listener = (colors, wallpaperType) => {
console.log(`wallpaper color changed.`);
};
wallpaper.on('colorChange', listener);
// 取消订阅listener
wallpaper.off('colorChange', listener);
// 取消所有'colorChange'类型的订阅
wallpaper.off('colorChange');
```
## RgbaColor
**系统能力**
: 以下各项对应的系统能力均为SystemCapability.Miscservices.Wallpaper。
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| red | number | 是 | 是 | 表示红色值,范围为
0
到
255。 |
| green | number | 是 | 是 | 表示绿色值,范围为
0
到
255。 |
| blue | number | 是 | 是 | 表示蓝色值,范围为
0
到
255。 |
| alpha | number | 是 | 是 | 表示
alpha
值,范围为
0
到
255。 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录