!11671 modify js-apis-medialibrary.md warning

Merge pull request !11671 from 胡伟奇/modify_medialibrary_md

zh-cn/application-dev/reference/apis/js-apis-medialibrary.md

@@ -203,8 +203,8 @@ on(type: 'deviceChange'|'albumChange'|'imageChange'|'audioChange'|'videoChange'|
 
 | 参数名      | 类型                   | 必填   | 说明                                       |
 | -------- | -------------------- | ---- | ---------------------------------------- |
-| type     | string               | 是    | 媒体类型 <br/>'deviceChange'：&nbsp;注册设备变更 <br/>'albumChange'：&nbsp;相册变更<br/>'imageChange'：&nbsp;图片文件变更<br/>'audioChange'： &nbsp;音频文件变更<br/>'videoChange'：  &nbsp;视频文件变更<br/>'fileChange'：     &nbsp;文件变更<br/>'remoteFileChange'：&nbsp;注册设备上文件变更 |
-| callback | callback&lt;void&gt; | 是    | 回调返回空                                    |
+| type     | 'deviceChange'&#124;'albumChange'&#124;'imageChange'&#124;'audioChange'&#124;'videoChange'&#124;'fileChange'&#124;'remoteFileChange'               | 是    | 媒体类型 <br/>'deviceChange'：&nbsp;注册设备变更 <br/>'albumChange'：&nbsp;相册变更<br/>'imageChange'：&nbsp;图片文件变更<br/>'audioChange'： &nbsp;音频文件变更<br/>'videoChange'：  &nbsp;视频文件变更<br/>'fileChange'：     &nbsp;文件变更<br/>'remoteFileChange'：&nbsp;注册设备上文件变更 |
+| callback | Callback&lt;void&gt; | 是    | 回调返回空                                    |
 
 **示例：**
 
@@ -225,8 +225,8 @@ off(type: 'deviceChange'|'albumChange'|'imageChange'|'audioChange'|'videoChange'
 
 | 参数名      | 类型                   | 必填   | 说明                                       |
 | -------- | -------------------- | ---- | ---------------------------------------- |
-| type     | string               | 是    | 媒体类型 <br/>'deviceChange'：&nbsp;注册设备变更 <br/>'albumChange'：&nbsp;相册变更<br/>'imageChange'：&nbsp;图片文件变更<br/>'audioChange'： &nbsp;音频文件变更<br/>'videoChange'：  &nbsp;视频文件变更<br/>'fileChange'：     &nbsp;文件变更<br/>'remoteFileChange'：&nbsp;注册设备上文件变更 |
-| callback | callback&lt;void&gt; | 否    | 回调返回空                                    |
+| type     | 'deviceChange'&#124;'albumChange'&#124;'imageChange'&#124;'audioChange'&#124;'videoChange'&#124;'fileChange'&#124;'remoteFileChange'               | 是    | 媒体类型 <br/>'deviceChange'：&nbsp;注册设备变更 <br/>'albumChange'：&nbsp;相册变更<br/>'imageChange'：&nbsp;图片文件变更<br/>'audioChange'： &nbsp;音频文件变更<br/>'videoChange'：  &nbsp;视频文件变更<br/>'fileChange'：     &nbsp;文件变更<br/>'remoteFileChange'：&nbsp;注册设备上文件变更 |
+| callback | Callback&lt;void&gt; | 否    | 回调返回空                                    |
 
 **示例：**
 
@@ -346,8 +346,6 @@ async function example() {
         selections: fileKeyObj.MEDIA_TYPE + '= ?',
         selectionArgs: [fileType.toString()],
     };
-    const context = getContext(this);
-    var media = mediaLibrary.getMediaLibrary(context);
     const fetchFileResult = await media.getFileAssets(option);
     let asset = await fetchFileResult.getFirstObject();
     if (asset == undefined) {
@@ -390,8 +388,6 @@ async function example() {
         selections: fileKeyObj.MEDIA_TYPE + '= ?',
         selectionArgs: [fileType.toString()],
     };
-    const context = getContext(this);
-    var media = mediaLibrary.getMediaLibrary(context);
     const fetchFileResult = await media.getFileAssets(option);
     let asset = await fetchFileResult.getFirstObject();
     if (asset == undefined) {
@@ -559,7 +555,6 @@ release(callback: AsyncCallback&lt;void&gt;): void
 **示例：**
 
 ```js
-var media = mediaLibrary.getMediaLibrary(context);
 media.release((err) => {
     // do something
 });
@@ -882,8 +877,6 @@ getActivePeers(): Promise\<Array\<PeerInfo>>;
 
 ```js
 async function example() {
-    const context = getContext(this);
-    var media = mediaLibrary.getMediaLibrary(context);
     media.getActivePeers().then((devicesInfo) => {
         if (devicesInfo != undefined) {
             for (let i = 0; i < devicesInfo.length; i++) {
@@ -920,8 +913,6 @@ getActivePeers(callback: AsyncCallback\<Array\<PeerInfo>>): void;
 
 ```js
 async function example() {
-    const context = getContext(this);
-    var media = mediaLibrary.getMediaLibrary(context);
     media.getActivePeers((err, devicesInfo) => {
         if (devicesInfo != undefined) {
             for (let i = 0; i < devicesInfo.length; i++) {
@@ -957,8 +948,6 @@ getAllPeers(): Promise\<Array\<PeerInfo>>;
 
 ```js
 async function example() {
-    const context = getContext(this);
-    var media = mediaLibrary.getMediaLibrary(context);
     media.getAllPeers().then((devicesInfo) => {
         if (devicesInfo != undefined) {
             for (let i = 0; i < devicesInfo.length; i++) {
@@ -995,8 +984,6 @@ getAllPeers(callback: AsyncCallback\<Array\<PeerInfo>>): void;
 
 ```js
 async function example() {
-    const context = getContext(this);
-    var media = mediaLibrary.getMediaLibrary(context);
     media.getAllPeers((err, devicesInfo) => {
         if (devicesInfo != undefined) {
             for (let i = 0; i < devicesInfo.length; i++) {
@@ -2470,12 +2457,12 @@ async function example() {
 
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
 
-| 名称  |  说明 |
-| ----- |  ---- |
-| FILE  |  文件 |
-| IMAGE |  图片 |
-| VIDEO |  视频 |
-| AUDIO |  音频 |
+| 名称  |  值 |  说明 |
+| ----- |  ---- | ---- |
+| FILE  |  0 | 文件 |
+| IMAGE |  1 | 图片 |
+| VIDEO |  2 | 视频 |
+| AUDIO |  3 | 音频 |
 
 ## FileKey<sup>8+</sup>
 
@@ -2483,7 +2470,7 @@ async function example() {
 
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
 
-| 名称          | 默认值              | 说明                                                       |
+| 名称          | 值              | 说明                                                       |
 | ------------- | ------------------- | ---------------------------------------------------------- |
 | ID            | file_id             | 文件编号                                                   |
 | RELATIVE_PATH | relative_path       | 相对公共目录路径                                           |
@@ -2511,14 +2498,14 @@ async function example() {
 
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
 
-| 名称          |  说明               |
-| ------------- |  ------------------ |
-| DIR_CAMERA    |  表示Camera文件路径 |
-| DIR_VIDEO     |  表示视频路径       |
-| DIR_IMAGE     |  表示图片路径       |
-| DIR_AUDIO     |  表示音频路径       |
-| DIR_DOCUMENTS |  表示文档路径       |
-| DIR_DOWNLOAD  |  表示下载路径       |
+| 名称          | 值 |  说明               |
+| ------------- | --- | ------------------ |
+| DIR_CAMERA    |  0 | 表示Camera文件路径 |
+| DIR_VIDEO     |  1 |  表示视频路径       |
+| DIR_IMAGE     |  2 | 表示图片路径       |
+| DIR_AUDIO     |  3 | 表示音频路径       |
+| DIR_DOCUMENTS |  4 | 表示文档路径       |
+| DIR_DOWNLOAD  |  5 |  表示下载路径       |
 
 ## DeviceType<sup>8+</sup>
 
@@ -2528,15 +2515,15 @@ async function example() {
 
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.DistributedCore
 
-| 名称         |  说明       |
-| ------------ |  ---------- |
-| TYPE_UNKNOWN |  未识别设备 |
-| TYPE_LAPTOP  |  笔记本电脑 |
-| TYPE_PHONE   |  手机       |
-| TYPE_TABLET  |  平板电脑   |
-| TYPE_WATCH   |  智能手表   |
-| TYPE_CAR     |  车载设备   |
-| TYPE_TV      |  电视设备   |
+| 名称         |  值 | 说明       |
+| ------------ | --- | ---------- |
+| TYPE_UNKNOWN |  0 | 未识别设备 |
+| TYPE_LAPTOP  |  1 | 笔记本电脑 |
+| TYPE_PHONE   |  2 | 手机       |
+| TYPE_TABLET  |  3 | 平板电脑   |
+| TYPE_WATCH   |  4 | 智能手表   |
+| TYPE_CAR     |  5 | 车载设备   |
+| TYPE_TV      |  6 | 电视设备   |
 
 ## MediaFetchOptions<sup>7+</sup>
 
@@ -2544,14 +2531,14 @@ async function example() {
 
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
 
-| 名称                    | 类型                | 可读 | 可写 | 必填 | 说明                                                         |
-| ----------------------- | ------------------- | ---- | ---- | ---- | ------------------------------------------------------------ |
-| selections              | string              | 是   | 是   | 是   | 检索条件，使用[FileKey](#filekey8)中的枚举值作为检索条件的列名。示例：<br />selections: mediaLibrary.FileKey.MEDIA_TYPE + '= ? OR ' +mediaLibrary.FileKey.MEDIA_TYPE + '= ?', |
-| selectionArgs           | Array&lt;string&gt; | 是   | 是   | 是   | 检索条件的值，对应selections中检索条件列的值。<br />示例：<br />selectionArgs: [mediaLibrary.MediaType.IMAGE.toString(), mediaLibrary.MediaType.VIDEO.toString()], |
-| order                   | string              | 是   | 是   | 否   | 检索结果排序方式，使用[FileKey](#filekey8)中的枚举值作为检索结果排序的列，可以用升序或降序排列。示例：<br />升序排列：order: mediaLibrary.FileKey.DATE_ADDED + " ASC"<br />降序排列：order: mediaLibrary.FileKey.DATE_ADDED + " DESC" |
-| uri<sup>8+</sup>        | string              | 是   | 是   | 否   | 文件URI                                                      |
-| networkId<sup>8+</sup>  | string              | 是   | 是   | 否   | 注册设备网络ID                                               |
-| extendArgs<sup>8+</sup> | string              | 是   | 是   | 否   | 扩展的检索参数，目前没有扩展检索参数                         |
+| 名称                    | 类型                | 可读 | 可写 | 说明                                                         |
+| ----------------------- | ------------------- | ---- | ---- | ------------------------------------------------------------ |
+| selections              | string              | 是   | 是   | 检索条件，使用[FileKey](#filekey8)中的枚举值作为检索条件的列名。示例：<br />selections: mediaLibrary.FileKey.MEDIA_TYPE + '= ? OR ' +mediaLibrary.FileKey.MEDIA_TYPE + '= ?', |
+| selectionArgs           | Array&lt;string&gt; | 是   | 是   | 检索条件的值，对应selections中检索条件列的值。<br />示例：<br />selectionArgs: [mediaLibrary.MediaType.IMAGE.toString(), mediaLibrary.MediaType.VIDEO.toString()], |
+| order                   | string              | 是   | 是   | 检索结果排序方式，使用[FileKey](#filekey8)中的枚举值作为检索结果排序的列，可以用升序或降序排列。示例：<br />升序排列：order: mediaLibrary.FileKey.DATE_ADDED + " ASC"<br />降序排列：order: mediaLibrary.FileKey.DATE_ADDED + " DESC" |
+| uri<sup>8+</sup>        | string              | 是   | 是   | 文件URI                                                      |
+| networkId<sup>8+</sup>  | string              | 是   | 是   | 注册设备网络ID                                               |
+| extendArgs<sup>8+</sup> | string              | 是   | 是   | 扩展的检索参数，目前没有扩展检索参数                         |
 
 ## Size<sup>8+</sup>
 
@@ -2573,11 +2560,11 @@ async function example() {
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
 
 
-| 名称         | 类型   | 必填 | 描述                                                         |
-| ------------ | ------ | ---- | ------------------------------------------------------------ |
-| src          | string | 是   | 本地文件应用沙箱路径。                                       |
-| mimeType     | string | 是   | 媒体MIME（Multipurpose&nbsp;Internet&nbsp;Mail&nbsp;Extensions）类型。<br/>包括：'image/\*'、'video/\*'、'audio/\*'、 'file\*'。 |
-| relativePath | string | 否   | 自定义媒体资源保存位置，例：Pictures/ 不填则保存到默认路径。 <br/> image类型默认路径Pictures/ <br/> video类型默认路径Videos/ <br/> audio类型默认路径Audios/ <br/> file类型默认路径Documents/ 。 |
+| 名称         | 类型   | 可读 | 可写 | 说明                                                         |
+| ------------ | ------ | ---- | ---- | ------------------------------------------------------------ |
+| src          | string | 是   | 是   | 本地文件应用沙箱路径。                                       |
+| mimeType     | string | 是   | 是   | 媒体MIME（Multipurpose&nbsp;Internet&nbsp;Mail&nbsp;Extensions）类型。<br/>包括：'image/\*'、'video/\*'、'audio/\*'、 'file\*'。 |
+| relativePath | string | 是   | 是   | 自定义媒体资源保存位置，例：Pictures/ 不填则保存到默认路径。 <br/> image类型默认路径Pictures/ <br/> video类型默认路径Videos/ <br/> audio类型默认路径Audios/ <br/> file类型默认路径Documents/ 。 |
 
 ## MediaSelectOption<sup>(deprecated)</sup>
 
@@ -2587,9 +2574,9 @@ async function example() {
 
 **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
 
-| 名称    | 类型     | 必填   | 描述                   |
-| ----- | ------ | ---- | -------------------- |
-| type  | string | 是    | 媒体类型，包括：image, video, media，当前仅支持media类型 |
-| count | number | 是    | 媒体选择，count = 1表示单选，count大于1表示多选。            |
+| 名称    | 类型     | 可读 | 可写 | 说明                   |
+| ----- | ------ | ---- | ---- | -------------------- |
+| type  | string | 是    | 是  | 媒体类型，包括：image, video, media，当前仅支持media类型 |
+| count | number | 是    | 是  | 媒体选择，count = 1表示单选，count大于1表示多选。            |