Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
af96081c
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看板
体验新版 GitCode,发现更多精彩内容 >>
提交
af96081c
编写于
4月 27, 2023
作者:
C
caochuan
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add notify interface description
Signed-off-by:
N
caochuan
<
caochuan@huawei.com
>
上级
241c9a60
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
129 addition
and
0 deletion
+129
-0
zh-cn/application-dev/reference/apis/js-apis-userFileManager.md
...application-dev/reference/apis/js-apis-userFileManager.md
+129
-0
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-userFileManager.md
浏览文件 @
af96081c
...
...
@@ -902,6 +902,98 @@ async function example() {
}
```
### on<sup>10+</sup>
on(uri: string, forSubUri: boolean, callback: Callback
<
ChangeData
>
) : void
打开对指定uri的监听,使用callback方式返回异步结果。
**系统能力**
:SystemCapability.FileManagement.UserFileManager.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------------------------------- | ---- | ------------------------------------------------------------ |
| uri | string | 是 | FileAsset的uri, Album的uri或
[
DefaultChangeUri
](
#defaultchangeuri10
)
的值 |
| forSubUri | boolean | 是 | 是否模糊监听,如果是true注册uri为datashare:///media/album,能监听到所有相册的变化,如果是false只能监听当前uri对应的相册变化 |
| callback | Callback
<
[ChangeData](#changedata10)
>
| 是 | 返回要监听的
[
ChangeData
](
#changedata10
)
|
**示例:**
```
ts
async
function
example
()
{
console
.
info
(
'
onDemo
'
);
let
fileAsset
;
try
{
let
testFileName
=
'
testFile
'
+
Date
.
now
()
+
'
.jpg
'
;
let
fileAsset
=
await
mgr
.
createPhotoAsset
(
testFileName
);
console
.
info
(
'
createPhotoAsset file displayName
'
+
fileAsset
.
displayName
);
console
.
info
(
'
createPhotoAsset successfully
'
);
}
catch
(
err
)
{
console
.
error
(
'
createPhotoAsset failed, message =
'
+
err
);
}
let
count
=
0
;
mgr
.
on
(
fileAsset
.
uri
,
false
,
(
changeData
)
=>
{
count
++
;
console
.
info
(
JSON
.
stringify
(
changeData
));
//file had changed, do something
});
fileAsset
.
favorite
(
true
);
//sleep 1s
if
(
count
>
0
)
{
console
.
info
(
'
onDemo success
'
);
}
else
{
console
.
error
(
'
onDemo fail
'
);
}
}
```
### off<sup>10+</sup>
off(uri: string, callback?: Callback
<
ChangeData
>
): void
关闭对指定uri的监听,使用callback方式返回异步结果。
**系统能力**
:SystemCapability.FileManagement.UserFileManager.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------- | ---- | ------------------------------------------------------------ |
| uri | string | 是 | FileAsset的uri, Album的uri或
[
DefaultChangeUri
](
#defaultchangeuri10
)
的值 |
| callback | Callback
<
[ChangeData](#changedata10)
>
| 否 | 解除指定callback方法的监听 |
**示例:**
```
ts
async
function
example
()
{
console
.
info
(
'
offDemo
'
);
let
count
=
0
;
mgr
.
on
(
'
imageChange
'
,
()
=>
{
count
++
;
// file had changed, do something
});
mgr
.
off
(
'
imageChange
'
,
()
=>
{
// stop listening success
});
try
{
let
testFileName
=
'
testFile
'
+
Date
.
now
()
+
'
.jpg
'
;
let
fileAsset
=
await
mgr
.
createPhotoAsset
(
testFileName
);
console
.
info
(
'
createPhotoAsset file displayName
'
+
fileAsset
.
displayName
);
console
.
info
(
'
createPhotoAsset successfully
'
);
}
catch
(
err
)
{
console
.
error
(
'
createPhotoAsset failed, message =
'
+
err
);
}
//sleep 1s
if
(
count
==
0
)
{
console
.
info
(
'
offDemo success
'
);
}
else
{
console
.
error
(
'
offDemo fail
'
);
}
}
```
## FileAsset
提供封装文件属性的方法。
...
...
@@ -2466,3 +2558,40 @@ async function example() {
| ---------------------- | ------------------- | ---- |---- | ------------------------------------------------ |
| predicates |
[
dataSharePredicates.DataSharePredicates
](
js-apis-data-dataSharePredicates.md
)
| 是 | 是 | 谓词查询,显示过滤条件 |
## ChangeData<sup>10+</sup>
监听器回调函数的值。
**系统能力**
:SystemCapability.FileManagement.UserFileManager.Core
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------- | --------------------------- | ---- | ---- | ------------------------------------------------------------ |
| type |
[
NotifyType
](
#notifytype10
)
| 是 | 否 | ChangeData的通知类型 |
| uris | Array
<
string
>
| 是 | 否 | 相同
[
NotifyType
](
#notifytype10
)
的所有uri,可以是FileAsset或Album |
| subUris | Array
<
string
>
| 是 | 否 | 当uri是Album的uri类型时,更改Album的FileAssets的详细信息 |
## NotifyType<sup>10+</sup>
枚举,notify类型。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.FileManagement.UserFileManager.Core
| 名称 | 值 | 说明 |
| ------------------------- | ---- | ------------------------------ |
| NOTIFY_ADD | 0 | 添加文件集或相册通知的类型 |
| NOTIFY_UPDATE | 1 | 文件集或相册的更新通知类型 |
| NOTIFY_REMOVE | 2 | 删除文件集或相册的通知类型 |
| NOTIFY_ALBUM_ADD_ASSET | 3 | 在相册中添加的文件集的通知类型 |
| NOTIFY_ALBUM_REMOVE_ASSET | 4 | 在相册中删除的文件集的通知类型 |
## DefaultChangeUri<sup>10+</sup>
枚举,DefaultChangeUri子类型。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.FileManagement.UserFileManager.Core
| 名称 | 值 | 说明 |
| ----------------- | ----------------------------- | ------------------------------------------------------------ |
| DEFAULT_PHOTO_URI | datashare:///media/Photo | 默认PhotoAsset的Uri,与forSubUri{true}一起使用,将接收所有PhotoAsset的更改通知 |
| DEFAULT_ALBUM_URI | datashare:///media/PhotoAlbum | 默认相册的Uri,与forSubUri{true}一起使用,将接收所有相册的更改通知 |
| DEFAULT_AUDIO_URI | datashare:///media/Audio | 默认AudioAsset的Uri,与forSubUri{true}一起使用,将接收所有AudioAsset的更改通知 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录