Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
54af8d7c
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看板
未验证
提交
54af8d7c
编写于
12月 12, 2022
作者:
O
openharmony_ci
提交者:
Gitee
12月 12, 2022
浏览文件
操作
浏览文件
下载
差异文件
!12268 【锁屏】API参考优化
Merge pull request !12268 from qimeng/master
上级
fa2e1fa8
5003251b
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
139 addition
and
84 deletion
+139
-84
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
+139
-84
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-screen-lock.md
浏览文件 @
54af8d7c
...
@@ -20,17 +20,17 @@ import screenlock from '@ohos.screenLock';
...
@@ -20,17 +20,17 @@ import screenlock from '@ohos.screenLock';
| 事件类型 | 说明 |
| 事件类型 | 说明 |
| ------------------ | ------------------------ |
| ------------------ | ------------------------ |
| beginWakeUp | 表示
事件开始时
开始唤醒。 |
| beginWakeUp | 表示
设备
开始唤醒。 |
| endWakeUp | 表示
事件结束时
结束唤醒。 |
| endWakeUp | 表示
设备
结束唤醒。 |
| beginScreenOn | 表示
事件开始时
开始亮屏。 |
| beginScreenOn | 表示
设备
开始亮屏。 |
| endScreenOn | 表示
事件结束时
结束亮屏。 |
| endScreenOn | 表示
设备
结束亮屏。 |
| beginScreenOff | 表示
事件开始时
开始灭屏。 |
| beginScreenOff | 表示
设备
开始灭屏。 |
| endScreenOff | 表示
事件结束时
结束灭屏。 |
| endScreenOff | 表示
设备
结束灭屏。 |
| unlockScreen | 表示请求
解锁屏幕
。 |
| unlockScreen | 表示请求
屏幕解锁
。 |
| lockScreen | 表示请求
锁定屏幕
。 |
| lockScreen | 表示请求
屏幕锁定
。 |
| beginExitAnimation | 表示
动画开始退场
。 |
| beginExitAnimation | 表示
开始退场动画
。 |
| beginSleep | 表示开始休眠。 |
| beginSleep | 表示
设备
开始休眠。 |
| endSleep | 表示结束休眠。 |
| endSleep | 表示
设备
结束休眠。 |
| changeUser | 表示切换用户。 |
| changeUser | 表示切换用户。 |
| screenlockEnabled | 表示锁屏是否启用。 |
| screenlockEnabled | 表示锁屏是否启用。 |
| serviceRestart | 表示锁屏服务进行重启。 |
| serviceRestart | 表示锁屏服务进行重启。 |
...
@@ -44,7 +44,7 @@ import screenlock from '@ohos.screenLock';
...
@@ -44,7 +44,7 @@ import screenlock from '@ohos.screenLock';
| 名称 | 类型 | 必填 | 说明 |
| 名称 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | ------------- |
| --------- | ------ | ---- | ------------- |
| eventType |
[
EventType
](
#eventtype
)
| 是 | 系统事件类型。 |
| eventType |
[
EventType
](
#eventtype
)
| 是 | 系统事件类型。 |
| params | string | 是 | 系统事件
的事件
参数。 |
| params | string | 是 | 系统事件参数。 |
## screenlock.isLocked<sup>9+</sup>
## screenlock.isLocked<sup>9+</sup>
...
@@ -58,7 +58,7 @@ isLocked(): boolean
...
@@ -58,7 +58,7 @@ isLocked(): boolean
| 类型 | 说明 |
| 类型 | 说明 |
| ------- | ------------------------------------------------- |
| ------- | ------------------------------------------------- |
| boolean | 返回true表示屏幕已锁屏
,
返回false表示屏幕未锁屏。 |
| boolean | 返回true表示屏幕已锁屏
;
返回false表示屏幕未锁屏。 |
**示例:**
**示例:**
...
@@ -70,7 +70,7 @@ let isLocked = screenlock.isLocked();
...
@@ -70,7 +70,7 @@ let isLocked = screenlock.isLocked();
isSecure(): boolean
isSecure(): boolean
判断
设备是否处于安全模式下
。
判断
当前设备的屏幕锁定是否安全(安全屏幕锁定意味着解锁屏幕需要密码、图案或其他用户身份识别)
。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -78,7 +78,7 @@ isSecure(): boolean
...
@@ -78,7 +78,7 @@ isSecure(): boolean
| 类型 | 说明 |
| 类型 | 说明 |
| ------- | ------------------------------------------------------------ |
| ------- | ------------------------------------------------------------ |
| boolean | 返回true表示
屏幕处于安全模式下,返回false表示屏幕当前不在安全模式下
。 |
| boolean | 返回true表示
当前设备的屏幕锁定安全;返回false表示当前设备的屏幕锁定不安全
。 |
**示例:**
**示例:**
...
@@ -90,7 +90,7 @@ let isSecure = screenlock.isSecure();
...
@@ -90,7 +90,7 @@ let isSecure = screenlock.isSecure();
unlock(callback: AsyncCallback
<
boolean
>
): void
unlock(callback: AsyncCallback
<
boolean
>
): void
解锁屏幕
,
使用callback异步回调。
解锁屏幕
。
使用callback异步回调。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -98,17 +98,25 @@ unlock(callback: AsyncCallback<boolean>): void
...
@@ -98,17 +98,25 @@ unlock(callback: AsyncCallback<boolean>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ------------------------- |
| -------- | --------------------- | ---- | ------------------------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数。返回true表示屏幕解锁成功,返回false表示屏幕解锁失败。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数。返回true表示屏幕解锁成功;返回false表示屏幕解锁失败。 |
**错误码**
:
以下错误码的详细介绍请参见
[
锁屏服务错误码
](
../errorcodes/errorcode-screenlock.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 13200002 | The screenlock management service is abnormal. |
**示例:**
**示例:**
```
js
```
js
screenlock
.
unlock
((
err
,
data
)
=>
{
screenlock
.
unlock
((
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
error
(
'
unlock error -> ${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to unlock the screen, because:
${
err
.
message
}
`
);
return
;
return
;
}
}
console
.
info
(
'
unlock success data -> ${JSON.stringify(data)}
'
);
console
.
info
(
`unlock the screen successfully. result:
${
data
}
`
);
});
});
```
```
...
@@ -116,7 +124,7 @@ screenlock.unlock((err,data) => {
...
@@ -116,7 +124,7 @@ screenlock.unlock((err,data) => {
unlock(): Promise
<
boolean
>
unlock(): Promise
<
boolean
>
解锁屏幕
,
使用Promise异步回调。
解锁屏幕
。
使用Promise异步回调。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -124,15 +132,23 @@ unlock(): Promise<boolean>
...
@@ -124,15 +132,23 @@ unlock(): Promise<boolean>
| 类型 | 说明 |
| 类型 | 说明 |
| ------------------- | ------------------------------------------------------------ |
| ------------------- | ------------------------------------------------------------ |
| Promise
<
boolean
>
| Promise对象。返回true表示屏幕解锁成功,返回false表示屏幕解锁失败。 |
| Promise
<
boolean
>
| Promise对象。返回true表示屏幕解锁成功;返回false表示屏幕解锁失败。 |
**错误码**
:
以下错误码的详细介绍请参见
[
锁屏服务错误码
](
../errorcodes/errorcode-screenlock.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 13200002 | The screenlock management service is abnormal. |
**示例:**
**示例:**
```
js
```
js
screenlock
.
unlock
().
then
((
data
)
=>
{
screenlock
.
unlock
().
then
((
data
)
=>
{
console
.
log
(
'
unlock success
'
);
console
.
info
(
`unlock the screen successfully. result:
${
data
}
`
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
error
(
'
unlock fail, : err->${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to unlock the screen, because:
${
err
.
message
}
`
);
});
});
```
```
...
@@ -140,7 +156,7 @@ screenlock.unlock().then((data) => {
...
@@ -140,7 +156,7 @@ screenlock.unlock().then((data) => {
lock(callback: AsyncCallback
<
boolean
>
): void
lock(callback: AsyncCallback
<
boolean
>
): void
锁定屏幕
,
使用callback异步回调。
锁定屏幕
。
使用callback异步回调。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -150,17 +166,25 @@ lock(callback: AsyncCallback<boolean>): void
...
@@ -150,17 +166,25 @@ lock(callback: AsyncCallback<boolean>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---------------- |
| -------- | ---------------------- | ---- | ---------------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数。返回true表示屏幕锁定成功,返回false表示屏幕锁定失败。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数。返回true表示屏幕锁定成功;返回false表示屏幕锁定失败。 |
**错误码**
:
以下错误码的详细介绍请参见
[
锁屏服务错误码
](
../errorcodes/errorcode-screenlock.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 13200002 | The screenlock management service is abnormal. |
**示例:**
**示例:**
```
js
```
js
screenlock
.
lock
((
err
,
data
)
=>
{
screenlock
.
lock
((
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
error
(
'
lock callback error -> ${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to lock the screen, because:
${
err
.
message
}
`
);
return
;
return
;
}
}
console
.
info
(
'
lock callback success
'
);
console
.
info
(
`lock the screen successfully. result:
${
data
}
`
);
});
});
```
```
...
@@ -168,7 +192,7 @@ screenlock.lock((err,data) => {
...
@@ -168,7 +192,7 @@ screenlock.lock((err,data) => {
lock(): Promise
<
boolean
>
lock(): Promise
<
boolean
>
锁定屏幕
,
使用Promise异步回调。
锁定屏幕
。
使用Promise异步回调。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -178,21 +202,29 @@ lock(): Promise<boolean>
...
@@ -178,21 +202,29 @@ lock(): Promise<boolean>
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------- | ------------------------------------------------------------ |
| ---------------------- | ------------------------------------------------------------ |
| Promise
<
boolean
>
| Promise对象。返回true表示屏幕锁定成功,返回false表示屏幕锁定失败。 |
| Promise
<
boolean
>
| Promise对象。返回true表示屏幕锁定成功;返回false表示屏幕锁定失败。 |
**错误码**
:
以下错误码的详细介绍请参见
[
锁屏服务错误码
](
../errorcodes/errorcode-screenlock.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 13200002 | The screenlock management service is abnormal. |
**示例:**
**示例:**
```
js
```
js
screenlock
.
lock
().
then
((
data
)
=>
{
screenlock
.
lock
().
then
((
data
)
=>
{
console
.
log
(
'
lock success
'
);
console
.
info
(
`lock the screen successfully. result:
${
data
}
`
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
error
(
'
lock fail, promise: err->${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to lock the screen, because:
${
err
.
message
}
`
);
});
});
```
```
## screenlock.onSystemEvent<sup>9+</sup>
## screenlock.onSystemEvent<sup>9+</sup>
onSystemEvent(callback: Callback
\<
SystemEvent
\>
): boolean
onSystemEvent(callback: Callback
<
SystemEvent
>
): boolean
注册锁屏相关的系统事件。
注册锁屏相关的系统事件。
...
@@ -210,24 +242,33 @@ onSystemEvent(callback: Callback\<SystemEvent\>): boolean
...
@@ -210,24 +242,33 @@ onSystemEvent(callback: Callback\<SystemEvent\>): boolean
| 类型 | 说明 |
| 类型 | 说明 |
| ------- | ------------------------------------------------- |
| ------- | ------------------------------------------------- |
| boolean | 返回true表示锁屏系统事件注册成功,否则返回false。 |
| boolean | 返回true表示锁屏相关系统事件注册成功;返回false表示锁屏相关系统事件注册失败。 |
**错误码**
:
以下错误码的详细介绍请参见
[
锁屏服务错误码
](
../errorcodes/errorcode-screenlock.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 13200002 | The screenlock management service is abnormal. |
**示例:**
**示例:**
```
js
```
js
let
isSuccess
=
screenlock
.
onSystemEvent
((
event
)
=>
{
try
{
console
.
log
(
`onSystemEvent:callback:
${
event
.
eventType
}
`
)
let
isSuccess
=
screenLock
.
onSystemEvent
((
event
)
=>
{
});
console
.
log
(
`Register the system event which related to screenlock successfully. eventType:
${
event
.
eventType
}
`
)
if
(
!
isSuccess
)
{
});
console
.
log
(
`onSystemEvent result is false`
)
}
catch
(
err
)
{
console
.
error
(
`Failed to register the system event which related to screenlock, because:
${
err
.
message
}
`
)
}
}
```
```
## screenlock.sendScreenLockEvent<sup>9+</sup>
## screenlock.sendScreenLockEvent<sup>9+</sup>
sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback
\<
boolean>
): void
sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback
<
boolean
>
): void
应用发送事件到锁屏服务
,
使用callback异步回调。
应用发送事件到锁屏服务
。
使用callback异步回调。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -237,23 +278,35 @@ sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback\<b
...
@@ -237,23 +278,35 @@ sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback\<b
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------------ | ---- | -------------------- |
| --------- | ------------------------ | ---- | -------------------- |
| event | String | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "screenDrawDone",表示屏幕绘制完成。 |
| event | String | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "lockScreenResult",表示锁屏结果。
<br/>
- "screenDrawDone",表示屏幕绘制完成。 |
| parameter | number | 是 | 解锁状态。
<br/>
- parameter为0,表示解锁成功。
<br/>
- parameter为1,表示解锁失败。
<br/>
- parameter为2,表示解锁取消。 |
| parameter | number | 是 | 事件结果。
<br/>
- parameter为0,表示成功。例如解锁成功或锁屏成功。
<br/>
- parameter为1,表示失败。例如解锁失败或锁屏失败。
<br/>
- parameter为2,表示取消。例如锁屏取消或解锁取消。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数,返回执行的结果。true表示执行成功,false表示执行失败。 |
| callback | AsyncCallback
\<
boolean> | 是 | 回调函数。返回true表示发送事件成功;返回false表示发送事件失败。 |
**错误码**
:
以下错误码的详细介绍请参见
[
锁屏服务错误码
](
../errorcodes/errorcode-screenlock.md
)
。
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
| 13200002 | The screenlock management service is abnormal. |
**示例:**
**示例:**
```
js
```
js
screenlock
.
sendScreenLockEvent
(
'
unlockScreenResult
'
,
0
,
(
err
,
result
)
=>
{
screenlock
.
sendScreenLockEvent
(
'
unlockScreenResult
'
,
0
,
(
err
,
result
)
=>
{
console
.
log
(
'
sending result:
'
+
result
);
if
(
err
)
{
console
.
error
(
`Failed to send screenlock event, because:
${
err
.
message
}
`
);
return
;
}
console
.
info
(
`Send screenlock event successfully. result:
${
result
}
`
);
});
});
```
```
## screenlock.sendScreenLockEvent<sup>9+</sup>
## screenlock.sendScreenLockEvent<sup>9+</sup>
sendScreenLockEvent(event: String, parameter: number): Promise
\<
boolean>
sendScreenLockEvent(event: String, parameter: number): Promise
<
boolean
>
应用发送事件到锁屏服务
,
使用Promise异步回调。
应用发送事件到锁屏服务
。
使用Promise异步回调。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -263,20 +316,22 @@ sendScreenLockEvent(event: String, parameter: number): Promise\<boolean>
...
@@ -263,20 +316,22 @@ sendScreenLockEvent(event: String, parameter: number): Promise\<boolean>
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | --------------------------------------- |
| --------- | ------ | ---- | --------------------------------------- |
| event | String | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "screenDrawDone",表示屏幕绘制完成。 |
| event | String | 是 | 事件类型,支持如下取值:
<br/>
- "unlockScreenResult",表示解锁结果。
<br/>
- "
lockScreenResult",表示锁屏结果。
<br/>
- "
screenDrawDone",表示屏幕绘制完成。 |
| parameter | number | 是 |
解锁状态。
<br/>
- parameter为0,表示解锁成功。
<br/>
- parameter为1,表示解锁失败。
<br/>
- parameter为2,表示
解锁取消。 |
| parameter | number | 是 |
事件结果。
<br/>
- parameter为0,表示成功。例如解锁成功或锁屏成功。
<br/>
- parameter为1,表示失败。例如解锁失败或锁屏失败。
<br/>
- parameter为2,表示取消。例如锁屏取消或
解锁取消。 |
**返回值:**
**返回值:**
| 类型 | 说明 |
| 类型 | 说明 |
| ----------------- | ---------------------------------------------- |
| ----------------- | ---------------------------------------------- |
| Promise
\<
boolean> | Promise对象
,返回执行的结果。true表示执行成功,false表示执行
失败。 |
| Promise
\<
boolean> | Promise对象
。返回true表示发送事件成功;返回false表示发送事件
失败。 |
**示例:**
**示例:**
```
js
```
js
screenlock
.
sendScreenLockEvent
(
'
unlockScreenResult
'
,
0
).
then
((
result
)
=>
{
screenlock
.
sendScreenLockEvent
(
'
unlockScreenResult
'
,
0
).
then
((
result
)
=>
{
console
.
log
(
'
sending result:
'
+
result
);
console
.
info
(
`Send screenlock event successfully. result:
${
result
}
`
);
}).
catch
((
err
)
=>
{
console
.
error
(
`Failed to send screenlock event, because:
${
err
.
message
}
`
);
});
});
```
```
...
@@ -284,11 +339,11 @@ screenlock.sendScreenLockEvent('unlockScreenResult', 0).then((result) => {
...
@@ -284,11 +339,11 @@ screenlock.sendScreenLockEvent('unlockScreenResult', 0).then((result) => {
isScreenLocked(callback: AsyncCallback
<
boolean
>
): void
isScreenLocked(callback: AsyncCallback
<
boolean
>
): void
判断屏幕是否锁屏
,
使用callback异步回调。
判断屏幕是否锁屏
。
使用callback异步回调。
> **说明:**
> **说明:**
>
>
>
从 API version 7开始支持,从API version 9开始废弃
。建议使用[screenlock.isLocked<sup>9+</sup>](#screenlockislocked9)代替。
>
从API version 7开始支持,从API version 9开始不再维护
。建议使用[screenlock.isLocked<sup>9+</sup>](#screenlockislocked9)代替。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -296,17 +351,17 @@ isScreenLocked(callback: AsyncCallback<boolean>): void
...
@@ -296,17 +351,17 @@ isScreenLocked(callback: AsyncCallback<boolean>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------- | ---- | ----------------------------------------------------------- |
| -------- | ---------------------------- | ---- | ----------------------------------------------------------- |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数
,返回true表示屏幕已锁屏,
返回false表示屏幕未锁屏。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数
。返回true表示屏幕已锁屏;
返回false表示屏幕未锁屏。 |
**示例:**
**示例:**
```
js
```
js
screenlock
.
isScreenLocked
((
err
,
data
)
=>
{
screenlock
.
isScreenLocked
((
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
error
(
'
isScreenLocked callback error -> ${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to obtain whether the screen is locked, because:
${
err
.
message
}
`
);
return
;
return
;
}
}
console
.
info
(
'
isScreenLocked callback success data -> ${JSON.stringify(data)}
'
);
console
.
info
(
`Obtain whether the screen is locked successfully. result:
${
data
}
`
);
});
});
```
```
...
@@ -314,11 +369,11 @@ screenlock.isScreenLocked((err, data)=>{
...
@@ -314,11 +369,11 @@ screenlock.isScreenLocked((err, data)=>{
isScreenLocked(): Promise
<
boolean
>
isScreenLocked(): Promise
<
boolean
>
判断屏幕是否锁屏
,
使用Promise异步回调。
判断屏幕是否锁屏
。
使用Promise异步回调。
> **说明:**
> **说明:**
>
>
> 从API version 7开始支持,从API version 9开始
废弃
。建议使用[screenlock.isLocked<sup>9+</sup>](#screenlockislocked9)代替。
> 从API version 7开始支持,从API version 9开始
不再维护
。建议使用[screenlock.isLocked<sup>9+</sup>](#screenlockislocked9)代替。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -326,15 +381,15 @@ isScreenLocked(): Promise<boolean>
...
@@ -326,15 +381,15 @@ isScreenLocked(): Promise<boolean>
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------- | ------------------------------------------- |
| ---------------------- | ------------------------------------------- |
| Promise
<
boolean
>
| Promise对象
,返回判断结果。返回true表示屏幕已锁屏,
返回false表示屏幕未锁屏。 |
| Promise
<
boolean
>
| Promise对象
。返回true表示屏幕已锁屏;
返回false表示屏幕未锁屏。 |
**示例:**
**示例:**
```
js
```
js
screenlock
.
isScreenLocked
().
then
((
data
)
=>
{
screenlock
.
isScreenLocked
().
then
((
data
)
=>
{
console
.
log
(
'
isScreenLocked success: data -> ${JSON.stringify(data)}
'
);
console
.
info
(
`Obtain whether the screen is locked successfully. result:
${
data
}
`
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
error
(
'
isScreenLocked fail, promise: err -> ${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to obtain whether the screen is locked, because:
${
err
.
message
}
`
);
});
});
```
```
...
@@ -342,11 +397,11 @@ screenlock.isScreenLocked().then((data) => {
...
@@ -342,11 +397,11 @@ screenlock.isScreenLocked().then((data) => {
isSecureMode(callback: AsyncCallback
<
boolean
>
): void
isSecureMode(callback: AsyncCallback
<
boolean
>
): void
判断
设备是否处于安全模式下,
使用callback异步回调。
判断
当前设备的屏幕锁定是否安全(安全屏幕锁定意味着解锁屏幕需要密码、图案或其他用户身份识别)。
使用callback异步回调。
> **说明:**
> **说明:**
>
>
> 从
API version 7开始支持,从API version 9开始废弃
。建议使用[screenlock.isSecure<sup>9+</sup>](#screenlockissecure9)代替。
> 从
API version 7开始支持,从API version 9开始不再维护
。建议使用[screenlock.isSecure<sup>9+</sup>](#screenlockissecure9)代替。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -354,17 +409,17 @@ isSecureMode(callback: AsyncCallback<boolean>): void
...
@@ -354,17 +409,17 @@ isSecureMode(callback: AsyncCallback<boolean>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ------------------------ |
| -------- | --------------------- | ---- | ------------------------ |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数。返回true表示
屏幕处于安全模式下,返回false表示屏幕当前不在安全模式下
。 |
| callback | AsyncCallback
<
boolean
>
| 是 | 回调函数。返回true表示
当前设备的屏幕锁定安全;返回false表示当前设备的屏幕锁定不安全
。 |
**示例:**
**示例:**
```
js
```
js
screenlock
.
isSecureMode
((
err
,
data
)
=>
{
screenlock
.
isSecureMode
((
err
,
data
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
error
(
'
isSecureMode callback error -> ${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to obtain whether the device is in secure mode, because:
${
err
.
message
}
`
);
return
;
return
;
}
}
console
.
info
(
'
isSecureMode callback success data -> ${JSON.stringify(err)}
'
);
console
.
info
(
`Obtain whether the device is in secure mode successfully. result:
${
data
}
`
);
});
});
```
```
...
@@ -372,11 +427,11 @@ screenlock.isSecureMode((err, data)=>{
...
@@ -372,11 +427,11 @@ screenlock.isSecureMode((err, data)=>{
isSecureMode(): Promise
<
boolean
>
isSecureMode(): Promise
<
boolean
>
判断
设备是否处于安全模式下,
使用Promise异步回调。
判断
当前设备的屏幕锁定是否安全(安全屏幕锁定意味着解锁屏幕需要密码、图案或其他用户身份识别)。
使用Promise异步回调。
> **说明:**
> **说明:**
>
>
> 从
API version 7开始支持,从API version 9开始废弃
。建议使用[screenlock.isSecure<sup>9+</sup>](#screenlockissecure9)代替。
> 从
API version 7开始支持,从API version 9开始不再维护
。建议使用[screenlock.isSecure<sup>9+</sup>](#screenlockissecure9)代替。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -384,26 +439,26 @@ isSecureMode(): Promise<boolean>
...
@@ -384,26 +439,26 @@ isSecureMode(): Promise<boolean>
| 类型 | 说明 |
| 类型 | 说明 |
| ---------------------- | ------------------------------------------------------------ |
| ---------------------- | ------------------------------------------------------------ |
| Promise
<
boolean
>
| Promise对象。返回true表示
屏幕处于安全模式下,返回false表示屏幕当前不在安全模式下
。 |
| Promise
<
boolean
>
| Promise对象。返回true表示
当前设备的屏幕锁定安全;返回false表示当前设备的屏幕锁定不安全
。 |
**示例:**
**示例:**
```
js
```
js
screenlock
.
isSecureMode
().
then
((
data
)
=>
{
screenlock
.
isSecureMode
().
then
((
data
)
=>
{
console
.
log
(
'
isSecureMode success: data->${JSON.stringify(data)}
'
);
console
.
info
(
`Obtain whether the device is in secure mode successfully. result:
${
data
}
`
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
error
(
'
isSecureMode fail, promise: err->${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to obtain whether the device is in secure mode, because:
${
err
.
message
}
`
);
});
});
```
```
## screenlock.unlockScreen<sup>(deprecated)</sup>
## screenlock.unlockScreen<sup>(deprecated)</sup>
unlockScreen(callback: AsyncCallback
<
void
>
): void
unlockScreen(callback: AsyncCallback
<
void
>
): void
解锁屏幕
,
使用callback异步回调。
解锁屏幕
。
使用callback异步回调。
> **说明:**
> **说明:**
>
>
> 从
API version 7开始支持,从API version 9开始废弃
。建议使用[screenlock.unlock<sup>9+</sup>](#screenlockunlock9)代替。
> 从
API version 7开始支持,从API version 9开始不再维护
。建议使用[screenlock.unlock<sup>9+</sup>](#screenlockunlock9)代替。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -411,17 +466,17 @@ unlockScreen(callback: AsyncCallback<void>): void
...
@@ -411,17 +466,17 @@ unlockScreen(callback: AsyncCallback<void>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------- | ---- | --------------- |
| -------- | ------------- | ---- | --------------- |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数
,失败时返回错误信息
。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数
。解锁屏幕成功,err为undefined,否则为错误对象
。 |
**示例:**
**示例:**
```
js
```
js
screenlock
.
unlockScreen
((
err
)
=>
{
screenlock
.
unlockScreen
((
err
)
=>
{
if
(
err
)
{
if
(
err
)
{
console
.
error
(
'
unlockScreen callback error -> ${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to unlock the screen, because:
${
err
.
message
}
`
);
return
;
return
;
}
}
console
.
info
(
'
unlock
Screen callback success
'
);
console
.
info
(
'
unlock
the screen successfully.
'
);
});
});
```
```
...
@@ -429,11 +484,11 @@ screenlock.unlockScreen((err) => {
...
@@ -429,11 +484,11 @@ screenlock.unlockScreen((err) => {
unlockScreen(): Promise
<
void
>
unlockScreen(): Promise
<
void
>
解锁屏幕
,
使用Promise异步回调。
解锁屏幕
。
使用Promise异步回调。
> **说明:**
> **说明:**
>
>
> 从
API version 7开始支持,从API version 9开始废弃
。建议使用[screenlock.unlock<sup>9+</sup>](#screenlockunlock9)代替。
> 从
API version 7开始支持,从API version 9开始不再维护
。建议使用[screenlock.unlock<sup>9+</sup>](#screenlockunlock9)代替。
**系统能力:**
SystemCapability.MiscServices.ScreenLock
**系统能力:**
SystemCapability.MiscServices.ScreenLock
...
@@ -441,14 +496,14 @@ unlockScreen(): Promise<void>
...
@@ -441,14 +496,14 @@ unlockScreen(): Promise<void>
| 类型 | 说明 |
| 类型 | 说明 |
| ------------------- | ------------------------- |
| ------------------- | ------------------------- |
| Promise
<
void
>
| 无返回结果的Promise对象。 |
| Promise
<
void
>
|
Promise对象。
无返回结果的Promise对象。 |
**示例:**
**示例:**
```
js
```
js
screenlock
.
unlockScreen
().
then
(()
=>
{
screenlock
.
unlockScreen
().
then
(()
=>
{
console
.
log
(
'
unlockScreen success
'
);
console
.
info
(
'
unlock the screen successfully.
'
);
}).
catch
((
err
)
=>
{
}).
catch
((
err
)
=>
{
console
.
error
(
'
unlockScreen fail, promise: err->${JSON.stringify(err)}
'
);
console
.
error
(
`Failed to unlock the screen, because:
${
err
.
message
}
`
);
});
});
```
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录