1/* 2 * Copyright (C) 2022 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16import { AsyncCallback, Callback } from './basic'; 17import Context from './application/Context'; 18import image from './@ohos.multimedia.image'; 19 20/** 21 * @name mediaLibrary 22 * @since 6 23 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 24 * @deprecated since 9 25 * @useinstead ohos.file.picker 26 */ 27declare namespace mediaLibrary { 28 /** 29 * Obtains a MediaLibrary instance. 30 * @since 6 31 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 32 * @FAModelOnly 33 * @returns Returns a MediaLibrary instance if the operation is successful; returns null otherwise. 34 * @deprecated since 9 35 * @useinstead ohos.file.picker 36 */ 37 function getMediaLibrary(): MediaLibrary; 38 /** 39 * Returns an instance of MediaLibrary 40 * @since 8 41 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 42 * @StageModelOnly 43 * @param context hap context information 44 * @returns Instance of MediaLibrary 45 * @deprecated since 9 46 * @useinstead ohos.file.picker 47 */ 48 function getMediaLibrary(context: Context): MediaLibrary; 49 50 /** 51 * Enumeration types for different kind of Media Files 52 * @since 8 53 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 54 * @deprecated since 9 55 * @useinstead ohos.file.picker 56 */ 57 enum MediaType { 58 /** 59 * File media type 60 * @since 8 61 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 62 * @deprecated since 9 63 * @useinstead ohos.file.picker 64 */ 65 FILE = 0, 66 /** 67 * Image media type 68 * @since 8 69 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 70 * @deprecated since 9 71 * @useinstead ohos.file.picker 72 */ 73 IMAGE, 74 /** 75 * Video media type 76 * @since 8 77 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 78 * @deprecated since 9 79 * @useinstead ohos.file.picker 80 */ 81 VIDEO, 82 /** 83 * Audio media type 84 * @since 8 85 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 86 * @deprecated since 9 87 * @useinstead ohos.file.picker 88 */ 89 AUDIO 90 } 91 92 /** 93 * Describes media resource options. 94 * @since 6 95 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 96 * @deprecated since 9 97 */ 98 interface MediaAssetOption { 99 /** 100 * URI of the media source. 101 * @since 6 102 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 103 * @deprecated since 9 104 */ 105 src: string; 106 /** 107 * Multipurpose Internet Mail Extensions (MIME) type of the media. 108 * @since 6 109 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 110 * @deprecated since 9 111 */ 112 mimeType: string; 113 /** 114 * Relative path for storing media resources. 115 * @since 6 116 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 117 * @deprecated since 9 118 */ 119 relativePath?: string; 120 } 121 122 /** 123 * Describes media selection options. 124 * @since 6 125 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 126 * @deprecated since 9 127 */ 128 interface MediaSelectOption { 129 /** 130 * Media type, which can be image, video, or media (indicating both image and video). 131 * @since 6 132 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 133 * @deprecated since 9 134 */ 135 type: 'image' | 'video' | 'media'; 136 /** 137 * Maximum number of media items that can be selected 138 * @since 6 139 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 140 * @deprecated since 9 141 */ 142 count: number; 143 } 144 145 /** 146 * Provides methods to encapsulate file attributes. 147 * @since 7 148 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 149 * @deprecated since 9 150 * @useinstead ohos.file.picker 151 */ 152 interface FileAsset { 153 /** 154 * File ID. 155 * @since 7 156 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 157 * @deprecated since 9 158 * @useinstead ohos.file.picker 159 */ 160 readonly id: number; 161 /** 162 * URI of the file. 163 * @since 7 164 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 165 * @deprecated since 9 166 * @useinstead ohos.file.picker 167 */ 168 readonly uri: string; 169 /** 170 * MIME type, for example, video/mp4, audio/mp4, or audio/amr-wb. 171 * @since 7 172 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 173 * @deprecated since 9 174 * @useinstead ohos.file.picker 175 */ 176 readonly mimeType: string; 177 /** 178 * Media type, for example, IMAGE, VIDEO, FILE, AUDIO 179 * @since 8 180 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 181 * @deprecated since 9 182 * @useinstead ohos.file.picker 183 */ 184 readonly mediaType: MediaType; 185 /** 186 * Display name (with a file name extension) of the file. 187 * @since 7 188 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 189 * @deprecated since 9 190 * @useinstead ohos.file.picker 191 */ 192 displayName: string; 193 /** 194 * File name title (without the file name extension). 195 * @since 7 196 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 197 * @deprecated since 9 198 * @useinstead ohos.file.picker 199 */ 200 title: string; 201 /** 202 * Relative Path of the file. 203 * @since 8 204 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 205 * @deprecated since 9 206 * @useinstead ohos.file.picker 207 */ 208 relativePath: string; 209 /** 210 * Parent folder's file_id of the file. 211 * @since 8 212 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 213 * @deprecated since 9 214 * @useinstead ohos.file.picker 215 */ 216 readonly parent: number; 217 /** 218 * Data size of the file. 219 * @since 7 220 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 221 * @deprecated since 9 222 * @useinstead ohos.file.picker 223 */ 224 readonly size: number; 225 /** 226 * Date (timestamp) when the file was added. 227 * @since 7 228 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 229 * @deprecated since 9 230 * @useinstead ohos.file.picker 231 */ 232 readonly dateAdded: number; 233 /** 234 * Date (timestamp) when the file was modified. 235 * @since 7 236 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 237 * @deprecated since 9 238 * @useinstead ohos.file.picker 239 */ 240 readonly dateModified: number; 241 /** 242 * Date (timestamp) when the file was taken. 243 * @since 7 244 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 245 * @deprecated since 9 246 * @useinstead ohos.file.picker 247 */ 248 readonly dateTaken: number; 249 /** 250 * Artist of the audio file. 251 * @since 8 252 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 253 * @deprecated since 9 254 * @useinstead ohos.file.picker 255 */ 256 readonly artist: string; 257 /** 258 * audioAlbum of the audio file. 259 * @since 8 260 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 261 * @deprecated since 9 262 * @useinstead ohos.file.picker 263 */ 264 readonly audioAlbum: string; 265 /** 266 * Display width of the file. This is valid only for videos and images. 267 * @since 7 268 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 269 * @deprecated since 9 270 * @useinstead ohos.file.picker 271 */ 272 readonly width: number; 273 /** 274 * Display height of the file. This is valid only for videos and images. 275 * @since 7 276 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 277 * @deprecated since 9 278 * @useinstead ohos.file.picker 279 */ 280 readonly height: number; 281 /** 282 * Rotation angle of the file, in degrees. 283 * The rotation angle can be 0, 90, 180, or 270 degrees. This is valid only for videos. 284 * @since 7 285 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 286 * @deprecated since 9 287 * @useinstead ohos.file.picker 288 */ 289 orientation: number; 290 /** 291 * duration of the audio and video file. 292 * @since 8 293 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 294 * @deprecated since 9 295 * @useinstead ohos.file.picker 296 */ 297 readonly duration: number; 298 /** 299 * ID of the album where the file is located. 300 * @since 7 301 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 302 * @deprecated since 9 303 * @useinstead ohos.file.picker 304 */ 305 readonly albumId: number; 306 /** 307 * URI of the album where the file is located. 308 * @since 8 309 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 310 * @deprecated since 9 311 * @useinstead ohos.file.picker 312 */ 313 readonly albumUri: string; 314 /** 315 * Name of the album where the file is located. 316 * @since 7 317 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 318 * @deprecated since 9 319 * @useinstead ohos.file.picker 320 */ 321 readonly albumName: string; 322 323 /** 324 * If it is a directory where the file is located. 325 * @since 8 326 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 327 * @permission ohos.permission.READ_MEDIA 328 * @param callback Callback return the result of isDirectory. 329 * @deprecated since 9 330 * @useinstead ohos.file.picker 331 */ 332 isDirectory(callback: AsyncCallback<boolean>): void; 333 /** 334 * If it is a directory where the file is located. 335 * @since 8 336 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 337 * @permission ohos.permission.READ_MEDIA 338 * @deprecated since 9 339 * @useinstead ohos.file.picker 340 */ 341 isDirectory():Promise<boolean>; 342 /** 343 * Modify meta data where the file is located. 344 * @since 8 345 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 346 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 347 * @param callback no value will be returned. 348 * @deprecated since 9 349 * @useinstead ohos.file.picker 350 */ 351 commitModify(callback: AsyncCallback<void>): void; 352 /** 353 * Modify meta data where the file is located. 354 * @since 8 355 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 356 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 357 * @deprecated since 9 358 * @useinstead ohos.file.picker 359 */ 360 commitModify(): Promise<void>; 361 /** 362 * Open the file is located. 363 * @since 8 364 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 365 * @permission ohos.permission.READ_MEDIA or ohos.permission.WRITE_MEDIA 366 * @param mode mode for open, for example: rw, r, w. 367 * @param callback Callback return the fd of the file. 368 * @deprecated since 9 369 * @useinstead ohos.file.picker 370 */ 371 open(mode: string, callback: AsyncCallback<number>): void; 372 /** 373 * Open the file is located. 374 * @since 8 375 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 376 * @permission ohos.permission.READ_MEDIA or ohos.permission.WRITE_MEDIA 377 * @param mode mode for open, for example: rw, r, w. 378 * @deprecated since 9 379 * @useinstead ohos.file.picker 380 */ 381 open(mode: string): Promise<number>; 382 /** 383 * Close the file is located. 384 * @since 8 385 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 386 * @permission ohos.permission.READ_MEDIA or ohos.permission.WRITE_MEDIA 387 * @param fd fd of the file which had been opened 388 * @param callback no value will be returned. 389 * @deprecated since 9 390 * @useinstead ohos.file.picker 391 */ 392 close(fd: number, callback: AsyncCallback<void>): void; 393 /** 394 * Close the file is located. 395 * @since 8 396 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 397 * @permission ohos.permission.READ_MEDIA or ohos.permission.WRITE_MEDIA 398 * @param fd fd of the file which had been opened 399 * @deprecated since 9 400 * @useinstead ohos.file.picker 401 */ 402 close(fd: number): Promise<void>; 403 /** 404 * Get thumbnail of the file when the file is located. 405 * @since 8 406 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 407 * @permission ohos.permission.READ_MEDIA 408 * @param callback Callback used to return the thumbnail's pixelmap. 409 * @deprecated since 9 410 * @useinstead ohos.file.picker 411 */ 412 getThumbnail(callback: AsyncCallback<image.PixelMap>): void; 413 /** 414 * Get thumbnail of the file when the file is located. 415 * @since 8 416 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 417 * @permission ohos.permission.READ_MEDIA 418 * @param size thumbnail's size 419 * @param callback Callback used to return the thumbnail's pixelmap. 420 * @deprecated since 9 421 * @useinstead ohos.file.picker 422 */ 423 getThumbnail(size: Size, callback: AsyncCallback<image.PixelMap>): void; 424 /** 425 * Get thumbnail of the file when the file is located. 426 * @since 8 427 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 428 * @permission ohos.permission.READ_MEDIA 429 * @param size thumbnail's size 430 * @deprecated since 9 431 * @useinstead ohos.file.picker 432 */ 433 getThumbnail(size?: Size): Promise<image.PixelMap>; 434 /** 435 * Set favorite for the file when the file is located. 436 * @since 8 437 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 438 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 439 * @param isFavorite true is favorite file, false is not favorite file 440 * @param callback Callback used to return, No value is returned. 441 * @deprecated since 9 442 * @useinstead ohos.file.picker 443 */ 444 favorite(isFavorite: boolean, callback: AsyncCallback<void>): void; 445 /** 446 * Set favorite for the file when the file is located. 447 * @since 8 448 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 449 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 450 * @param isFavorite true is favorite file, false is not favorite file 451 * @deprecated since 9 452 * @useinstead ohos.file.picker 453 */ 454 favorite(isFavorite: boolean): Promise<void>; 455 /** 456 * If the file is favorite when the file is located. 457 * @since 8 458 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 459 * @permission ohos.permission.READ_MEDIA 460 * @param callback Callback used to return true or false. 461 * @deprecated since 9 462 * @useinstead ohos.file.picker 463 */ 464 isFavorite(callback: AsyncCallback<boolean>): void; 465 /** 466 * If the file is favorite when the file is located. 467 * @since 8 468 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 469 * @permission ohos.permission.READ_MEDIA 470 * @deprecated since 9 471 * @useinstead ohos.file.picker 472 */ 473 isFavorite():Promise<boolean>; 474 /** 475 * Set trash for the file when the file is located. 476 * @since 8 477 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 478 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 479 * @param isTrash true is trashed file, false is not trashed file 480 * @param callback Callback used to return, No value is returned. 481 * @deprecated since 9 482 * @useinstead ohos.file.picker 483 */ 484 trash(isTrash: boolean, callback: AsyncCallback<void>): void; 485 /** 486 * Set trash for the file when the file is located. 487 * @since 8 488 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 489 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 490 * @param isTrash true is trashed file, false is not trashed file 491 * @deprecated since 9 492 * @useinstead ohos.file.picker 493 */ 494 trash(isTrash: boolean): Promise<void>; 495 /** 496 * If the file is in trash when the file is located. 497 * @since 8 498 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 499 * @permission ohos.permission.READ_MEDIA 500 * @param callback Callback used to return true or false. 501 * @deprecated since 9 502 * @useinstead ohos.file.picker 503 */ 504 isTrash(callback: AsyncCallback<boolean>): void; 505 /** 506 * If the file is in trash when the file is located. 507 * @since 8 508 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 509 * @permission ohos.permission.READ_MEDIA 510 * @deprecated since 9 511 * @useinstead ohos.file.picker 512 */ 513 isTrash():Promise<boolean>; 514 } 515 516 /** 517 * Describes MediaFetchOptions's selection 518 * @since 8 519 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 520 * @deprecated since 9 521 * @useinstead ohos.file.picker 522 */ 523 enum FileKey { 524 /** 525 * File ID 526 * @since 8 527 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 528 * @deprecated since 9 529 * @useinstead ohos.file.picker 530 */ 531 ID = "file_id", 532 /** 533 * Relative Path 534 * @since 8 535 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 536 * @deprecated since 9 537 * @useinstead ohos.file.picker 538 */ 539 RELATIVE_PATH = "relative_path", 540 /** 541 * File name 542 * @since 8 543 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 544 * @deprecated since 9 545 * @useinstead ohos.file.picker 546 */ 547 DISPLAY_NAME = "display_name", 548 /** 549 * Parent folder file id 550 * @since 8 551 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 552 * @deprecated since 9 553 * @useinstead ohos.file.picker 554 */ 555 PARENT = "parent", 556 /** 557 * Mime type of the file 558 * @since 8 559 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 560 * @deprecated since 9 561 * @useinstead ohos.file.picker 562 */ 563 MIME_TYPE = "mime_type", 564 /** 565 * Media type of the file 566 * @since 8 567 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 568 * @deprecated since 9 569 * @useinstead ohos.file.picker 570 */ 571 MEDIA_TYPE = "media_type", 572 /** 573 * Size of the file 574 * @since 8 575 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 576 * @deprecated since 9 577 * @useinstead ohos.file.picker 578 */ 579 SIZE = "size", 580 /** 581 * Date of the file creation 582 * @since 8 583 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 584 * @deprecated since 9 585 * @useinstead ohos.file.picker 586 */ 587 DATE_ADDED = "date_added", 588 /** 589 * Modify date of the file 590 * @since 8 591 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 592 * @deprecated since 9 593 * @useinstead ohos.file.picker 594 */ 595 DATE_MODIFIED = "date_modified", 596 /** 597 * Date taken of the file 598 * @since 8 599 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 600 * @deprecated since 9 601 * @useinstead ohos.file.picker 602 */ 603 DATE_TAKEN = "date_taken", 604 /** 605 * Title of the file 606 * @since 8 607 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 608 * @deprecated since 9 609 * @useinstead ohos.file.picker 610 */ 611 TITLE = "title", 612 /** 613 * Artist of the audio file 614 * @since 8 615 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 616 * @deprecated since 9 617 * @useinstead ohos.file.picker 618 */ 619 ARTIST = "artist", 620 /** 621 * Audio album of the audio file 622 * @since 8 623 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 624 * @deprecated since 9 625 * @useinstead ohos.file.picker 626 */ 627 AUDIOALBUM = "audio_album", 628 /** 629 * Duration of the audio and video file 630 * @since 8 631 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 632 * @deprecated since 9 633 * @useinstead ohos.file.picker 634 */ 635 DURATION = "duration", 636 /** 637 * Width of the image file 638 * @since 8 639 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 640 * @deprecated since 9 641 * @useinstead ohos.file.picker 642 */ 643 WIDTH = "width", 644 /** 645 * Height of the image file 646 * @since 8 647 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 648 * @deprecated since 9 649 * @useinstead ohos.file.picker 650 */ 651 HEIGHT = "height", 652 /** 653 * Orientation of the image file 654 * @since 8 655 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 656 * @deprecated since 9 657 * @useinstead ohos.file.picker 658 */ 659 ORIENTATION = "orientation", 660 /** 661 * Album id of the file 662 * @since 8 663 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 664 * @deprecated since 9 665 * @useinstead ohos.file.picker 666 */ 667 ALBUM_ID = "bucket_id", 668 /** 669 * Album name of the file 670 * @since 8 671 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 672 * @deprecated since 9 673 * @useinstead ohos.file.picker 674 */ 675 ALBUM_NAME = "bucket_display_name", 676 } 677 678 /** 679 * Fetch parameters applicable on images, videos, audios, albums and other media 680 * @since 7 681 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 682 * @deprecated since 9 683 * @useinstead ohos.file.picker 684 */ 685 interface MediaFetchOptions { 686 /** 687 * Fields to retrieve, for example, selections: "media_type =? OR media_type =?". 688 * @since 7 689 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 690 * @deprecated since 9 691 * @useinstead ohos.file.picker 692 */ 693 selections: string; 694 /** 695 * Conditions for retrieval, for example, selectionArgs: [IMAGE, VIDEO]. 696 * @since 7 697 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 698 * @deprecated since 9 699 * @useinstead ohos.file.picker 700 */ 701 selectionArgs: Array<string>; 702 /** 703 * Sorting criterion of the retrieval results, for example, order: "dateTaken DESC,display_name DESC, file_id DESC". 704 * @since 7 705 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 706 * @deprecated since 9 707 * @useinstead ohos.file.picker 708 */ 709 order?: string; 710 /** 711 * uri for retrieval 712 * @since 8 713 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 714 * @deprecated since 9 715 * @useinstead ohos.file.picker 716 */ 717 uri?: string; 718 /** 719 * networkId for retrieval 720 * @since 8 721 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 722 * @deprecated since 9 723 * @useinstead ohos.file.picker 724 */ 725 networkId?: string; 726 /** 727 * extendArgs for retrieval 728 * @since 8 729 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 730 * @deprecated since 9 731 * @useinstead ohos.file.picker 732 */ 733 extendArgs?: string; 734 } 735 736 /** 737 * Implements file retrieval. 738 * @since 7 739 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 740 * @deprecated since 9 741 * @useinstead ohos.file.picker 742 */ 743 interface FetchFileResult { 744 /** 745 * Obtains the total number of files in the file retrieval result. 746 * @since 7 747 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 748 * @returns Total number of files. 749 * @deprecated since 9 750 * @useinstead ohos.file.picker 751 */ 752 getCount(): number; 753 /** 754 * Checks whether the result set points to the last row. 755 * @since 7 756 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 757 * @returns Whether the file is the last one. 758 * @deprecated since 9 759 * @useinstead ohos.file.picker 760 * You need to check whether the file is the last one before calling getNextObject, 761 * which returns the next file only when False is returned for this method. 762 */ 763 isAfterLast(): boolean; 764 /** 765 * Releases the FetchFileResult instance and invalidates it. Other methods cannot be called. 766 * @since 7 767 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 768 * @deprecated since 9 769 * @useinstead ohos.file.picker 770 */ 771 close(): void; 772 /** 773 * Obtains the first FileAsset in the file retrieval result. This method uses a callback to return the file. 774 * @since 7 775 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 776 * @param callback Callback used to return the file in the format of a FileAsset instance. 777 * @deprecated since 9 778 * @useinstead ohos.file.picker 779 */ 780 getFirstObject(callback: AsyncCallback<FileAsset>): void; 781 /** 782 * Obtains the first FileAsset in the file retrieval result. This method uses a promise to return the file. 783 * @since 7 784 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 785 * @returns A Promise instance used to return the file in the format of a FileAsset instance. 786 * @deprecated since 9 787 * @useinstead ohos.file.picker 788 */ 789 getFirstObject(): Promise<FileAsset>; 790 /** 791 * Obtains the next FileAsset in the file retrieval result. 792 * This method uses a callback to return the file. 793 * Before calling this method, you must use isAfterLast() to check whether the result set points to the last row. 794 * This method returns the next file only when False is returned for isAfterLast(). 795 * @since 7 796 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 797 * @param callback Callback used to return the file in the format of a FileAsset instance. 798 * @deprecated since 9 799 * @useinstead ohos.file.picker 800 */ 801 getNextObject(callback: AsyncCallback<FileAsset>): void; 802 /** 803 * Obtains the next FileAsset in the file retrieval result. 804 * This method uses a promise to return the file. 805 * Before calling this method, you must use isAfterLast() to check whether the result set points to the last row. 806 * This method returns the next file only when False is returned for isAfterLast(). 807 * @since 7 808 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 809 * @returns A Promise instance used to return the file in the format of a FileAsset instance. 810 * @deprecated since 9 811 * @useinstead ohos.file.picker 812 */ 813 getNextObject(): Promise<FileAsset>; 814 /** 815 * Obtains the last FileAsset in the file retrieval result. This method uses a callback to return the file. 816 * @since 7 817 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 818 * @param callback Callback used to return the file in the format of a FileAsset instance. 819 * @deprecated since 9 820 * @useinstead ohos.file.picker 821 */ 822 getLastObject(callback: AsyncCallback<FileAsset>): void; 823 /** 824 * Obtains the last FileAsset in the file retrieval result. This method uses a promise to return the file. 825 * @since 7 826 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 827 * @returns A Promise instance used to return the file in the format of a FileAsset instance. 828 * @deprecated since 9 829 * @useinstead ohos.file.picker 830 */ 831 getLastObject(): Promise<FileAsset>; 832 /** 833 * Obtains the FileAsset with the specified index in the file retrieval result. 834 * This method uses a callback to return the file. 835 * @since 7 836 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 837 * @param index Index of the file to obtain. 838 * @param callback Callback used to return the file in the format of a FileAsset instance. 839 * @deprecated since 9 840 * @useinstead ohos.file.picker 841 */ 842 getPositionObject(index: number, callback: AsyncCallback<FileAsset>): void; 843 /** 844 * Obtains the FileAsset with the specified index in the file retrieval result. 845 * This method uses a promise to return the file. 846 * @since 7 847 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 848 * @param index Index of the file to obtain. 849 * @returns A Promise instance used to return the file in the format of a FileAsset instance. 850 * @deprecated since 9 851 * @useinstead ohos.file.picker 852 */ 853 getPositionObject(index: number): Promise<FileAsset>; 854 /** 855 * Obtains all FileAssets in the file retrieval result. 856 * This method uses a callback to return the result. After this method is called, 857 * close() is automatically called to release the FetchFileResult instance and invalidate it. 858 * In this case, other methods cannot be called. 859 * @since 7 860 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 861 * @param callback Callback used to return a FileAsset array. 862 * @deprecated since 9 863 * @useinstead ohos.file.picker 864 */ 865 getAllObject(callback: AsyncCallback<Array<FileAsset>>): void; 866 /** 867 * Obtains all FileAssets in the file retrieval result. 868 * This method uses a promise to return the result. that store the selected media resources. 869 * close() is automatically called to release the FetchFileResult instance and invalidate it. 870 * In this case, other methods cannot be called. 871 * @since 7 872 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 873 * @returns A Promise instance used to return a FileAsset array. 874 * @deprecated since 9 875 * @useinstead ohos.file.picker 876 */ 877 getAllObject(): Promise<Array<FileAsset>>; 878 } 879 880 /** 881 * Defines the album. 882 * 883 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 884 * @since 7 885 * @deprecated since 9 886 * @useinstead ohos.file.picker 887 */ 888 interface Album { 889 /** 890 * Album ID. 891 * @since 7 892 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 893 * @deprecated since 9 894 * @useinstead ohos.file.picker 895 */ 896 readonly albumId: number; 897 /** 898 * Album name. 899 * @since 7 900 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 901 * @deprecated since 9 902 * @useinstead ohos.file.picker 903 */ 904 albumName: string; 905 /** 906 * Album uri. 907 * @since 8 908 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 909 * @deprecated since 9 910 * @useinstead ohos.file.picker 911 */ 912 readonly albumUri: string; 913 /** 914 * Date (timestamp) when the album was last modified. 915 * @since 7 916 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 917 * @deprecated since 9 918 * @useinstead ohos.file.picker 919 */ 920 readonly dateModified: number; 921 /** 922 * File count for the album 923 * @since 8 924 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 925 * @deprecated since 9 926 * @useinstead ohos.file.picker 927 */ 928 readonly count: number; 929 /** 930 * Relative path for the album 931 * @since 8 932 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 933 * @deprecated since 9 934 * @useinstead ohos.file.picker 935 */ 936 readonly relativePath: string; 937 /** 938 * coverUri for the album 939 * @since 8 940 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 941 * @deprecated since 9 942 * @useinstead ohos.file.picker 943 */ 944 readonly coverUri: string; 945 946 /** 947 * Modify the meta data for the album 948 * @since 8 949 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 950 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 951 * @param callback, no value will be returned. 952 * @deprecated since 9 953 * @useinstead ohos.file.picker 954 */ 955 commitModify(callback: AsyncCallback<void>): void; 956 /** 957 * Modify the meta data for the album 958 * @since 8 959 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 960 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 961 * @deprecated since 9 962 * @useinstead ohos.file.picker 963 */ 964 commitModify(): Promise<void>; 965 /** 966 * SObtains files in an album. This method uses an asynchronous callback to return the files. 967 * @since 7 968 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 969 * @permission ohos.permission.READ_MEDIA 970 * @param callback Callback used to return the files in the format of a FetchFileResult instance. 971 * @deprecated since 9 972 * @useinstead ohos.file.picker 973 */ 974 getFileAssets(callback: AsyncCallback<FetchFileResult>): void; 975 /** 976 * SObtains files in an album. This method uses an asynchronous callback to return the files. 977 * @since 7 978 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 979 * @permission ohos.permission.READ_MEDIA 980 * @param option Media retrieval options. 981 * @param callback Callback used to return the files in the format of a FetchFileResult instance. 982 * @deprecated since 9 983 * @useinstead ohos.file.picker 984 */ 985 getFileAssets(options: MediaFetchOptions, callback: AsyncCallback<FetchFileResult>): void; 986 /** 987 * Obtains files in an album. This method uses a promise to return the files. 988 * @since 7 989 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 990 * @permission ohos.permission.READ_MEDIA 991 * @param option Media retrieval options. 992 * @returns A Promise instance used to return the files in the format of a FetchFileResult instance. 993 * @deprecated since 9 994 * @useinstead ohos.file.picker 995 */ 996 getFileAssets(options?: MediaFetchOptions): Promise<FetchFileResult>; 997 } 998 999 /** 1000 * Enumeration public directory that predefined 1001 * @since 8 1002 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1003 * @deprecated since 9 1004 * @useinstead ohos.file.picker 1005 */ 1006 enum DirectoryType { 1007 /** 1008 * predefined public directory for files token by Camera. 1009 * @since 8 1010 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1011 * @deprecated since 9 1012 * @useinstead ohos.file.picker 1013 */ 1014 DIR_CAMERA = 0, 1015 /** 1016 * predefined public directory for VIDEO files. 1017 * @since 8 1018 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1019 * @deprecated since 9 1020 * @useinstead ohos.file.picker 1021 */ 1022 DIR_VIDEO, 1023 /** 1024 * predefined public directory for IMAGE files. 1025 * @since 8 1026 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1027 * @deprecated since 9 1028 * @useinstead ohos.file.picker 1029 */ 1030 DIR_IMAGE, 1031 /** 1032 * predefined public directory for AUDIO files. 1033 * @since 8 1034 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1035 * @deprecated since 9 1036 * @useinstead ohos.file.picker 1037 */ 1038 DIR_AUDIO, 1039 /** 1040 * predefined public directory for DOCUMENTS files. 1041 * @since 8 1042 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1043 * @deprecated since 9 1044 * @useinstead ohos.file.picker 1045 */ 1046 DIR_DOCUMENTS, 1047 /** 1048 * predefined public directory for DOWNLOAD files. 1049 * @since 8 1050 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1051 * @deprecated since 9 1052 * @useinstead ohos.file.picker 1053 */ 1054 DIR_DOWNLOAD 1055 } 1056 1057 /** 1058 * Defines the MediaLibrary class and provides functions to access the data in media storage. 1059 * 1060 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1061 * @since 6 1062 * @deprecated since 9 1063 * @useinstead ohos.file.picker 1064 */ 1065 interface MediaLibrary { 1066 /** 1067 * get system predefined root dir, use to create file asset by relative path 1068 * @since 8 1069 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1070 * @param type, public directory predefined in DirectoryType. 1071 * @param callback Callback return the FetchFileResult. 1072 * @deprecated since 9 1073 * @useinstead ohos.file.picker 1074 */ 1075 getPublicDirectory(type: DirectoryType, callback: AsyncCallback<string>): void; 1076 /** 1077 * get system predefined root dir, use to create file asset by relative path 1078 * @since 8 1079 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1080 * @param type public directory predefined in DirectoryType. 1081 * @returns A promise instance used to return the public directory in the format of string 1082 * @deprecated since 9 1083 * @useinstead ohos.file.picker 1084 */ 1085 getPublicDirectory(type: DirectoryType): Promise<string>; 1086 /** 1087 * query all assets just for count & first cover 1088 * if need all data, getAllObject from FetchFileResult 1089 * @since 7 1090 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1091 * @permission ohos.permission.READ_MEDIA 1092 * @param options, Media retrieval options. 1093 * @param callback, Callback return the FetchFileResult. 1094 * @deprecated since 9 1095 * @useinstead ohos.file.picker 1096 */ 1097 getFileAssets(options: MediaFetchOptions, callback: AsyncCallback<FetchFileResult>): void; 1098 /** 1099 * query all assets just for count & first cover 1100 * if need all data, getAllObject from FetchFileResult 1101 * @since 7 1102 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1103 * @permission ohos.permission.READ_MEDIA 1104 * @param options Media retrieval options. 1105 * @returns A promise instance used to return the files in the format of a FetchFileResult instance 1106 * @deprecated since 9 1107 * @useinstead ohos.file.picker 1108 */ 1109 getFileAssets(options: MediaFetchOptions): Promise<FetchFileResult>; 1110 /** 1111 * Turn on monitor the data changes by media type 1112 * @since 8 1113 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1114 * @param type one of 'deviceChange','albumChange','imageChange','audioChange','videoChange','fileChange','remoteFileChange' 1115 * @param callback no value returned 1116 * @deprecated since 9 1117 * @useinstead ohos.file.picker 1118 */ 1119 on(type: 'deviceChange'|'albumChange'|'imageChange'|'audioChange'|'videoChange'|'fileChange'|'remoteFileChange', callback: Callback<void>): void; 1120 /** 1121 * Turn off monitor the data changes by media type 1122 * @since 8 1123 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1124 * @param type one of 'deviceChange','albumChange','imageChange','audioChange','videoChange','fileChange','remoteFileChange' 1125 * @param callback no value returned 1126 * @deprecated since 9 1127 * @useinstead ohos.file.picker 1128 */ 1129 off(type: 'deviceChange'|'albumChange'|'imageChange'|'audioChange'|'videoChange'|'fileChange'|'remoteFileChange', callback?: Callback<void>): void; 1130 /** 1131 * Create File Asset 1132 * @since 8 1133 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1134 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 1135 * @param mediaType mediaType for example:IMAGE, VIDEO, AUDIO, FILE 1136 * @param displayName file name 1137 * @param relativePath relative path 1138 * @param callback Callback used to return the FileAsset 1139 * @deprecated since 9 1140 * @useinstead ohos.file.picker 1141 */ 1142 createAsset(mediaType: MediaType, displayName: string, relativePath: string, callback: AsyncCallback<FileAsset>): void; 1143 /** 1144 * Create File Asset 1145 * @since 8 1146 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1147 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 1148 * @param mediaType mediaType for example:IMAGE, VIDEO, AUDIO, FILE 1149 * @param displayName file name 1150 * @param relativePath relative path 1151 * @returns A Promise instance used to return the FileAsset 1152 * @deprecated since 9 1153 * @useinstead ohos.file.picker 1154 */ 1155 createAsset(mediaType: MediaType, displayName: string, relativePath: string): Promise<FileAsset>; 1156 /** 1157 * Delete File Asset 1158 * @since 8 1159 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1160 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 1161 * @param uri FileAsset's URI 1162 * @param callback no value returned 1163 * @systemapi 1164 * @deprecated since 9 1165 * @useinstead ohos.file.picker 1166 */ 1167 deleteAsset(uri: string, callback: AsyncCallback<void>): void; 1168 /** 1169 * Delete File Asset 1170 * @since 8 1171 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1172 * @permission ohos.permission.READ_MEDIA and ohos.permission.WRITE_MEDIA 1173 * @param uri, FileAsset's URI 1174 * @returns A Promise instance, no value returned 1175 * @systemapi 1176 * @deprecated since 9 1177 * @useinstead ohos.file.picker 1178 */ 1179 deleteAsset(uri: string): Promise<void>; 1180 /** 1181 * Obtains albums based on the media retrieval options. This method uses an asynchronous callback to return. 1182 * @since 7 1183 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1184 * @permission ohos.permission.READ_MEDIA 1185 * @param option Media retrieval options. 1186 * @param callback Callback used to return an album array. 1187 * @deprecated since 9 1188 * @useinstead ohos.file.picker 1189 */ 1190 getAlbums(options: MediaFetchOptions, callback: AsyncCallback<Array<Album>>): void; 1191 /** 1192 * Obtains albums based on the media retrieval options. This method uses a promise to return the albums. 1193 * @since 7 1194 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1195 * @permission ohos.permission.READ_MEDIA 1196 * @param option Media retrieval options. 1197 * @returns A Promise instance used to return an album array. 1198 * @deprecated since 9 1199 * @useinstead ohos.file.picker 1200 */ 1201 getAlbums(options: MediaFetchOptions): Promise<Array<Album>>; 1202 /** 1203 * Stores media resources. This method uses an asynchronous callback to return the URI that stores 1204 * the media resources. 1205 * @since 6 1206 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1207 * @param option Media resource option. 1208 * @param callback Callback used to return the URI that stores the media resources. 1209 * @deprecated since 9 1210 */ 1211 storeMediaAsset(option: MediaAssetOption, callback: AsyncCallback<string>): void; 1212 /** 1213 * Stores media resources. This method uses a promise to return the URI that stores the media resources. 1214 * @since 6 1215 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1216 * @param option Media resource option. 1217 * @returns Promise used to return the URI that stores the media resources. 1218 * @deprecated since 9 1219 */ 1220 storeMediaAsset(option: MediaAssetOption): Promise<string>; 1221 /** 1222 * Starts image preview, with the first image to preview specified. This method uses an asynchronous callback 1223 * to receive the execution result. 1224 * @since 6 1225 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1226 * @param images List of images to preview. 1227 * @param index Sequence number of the first image to preview. 1228 * @param callback Callback used for image preview. No value is returned. 1229 * @deprecated since 9 1230 */ 1231 startImagePreview(images: Array<string>, index: number, callback: AsyncCallback<void>): void; 1232 /** 1233 * Starts image preview. This method uses an asynchronous callback to receive the execution result. 1234 * @since 6 1235 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1236 * @param images List of images to preview. 1237 * @param callback Callback used for image preview. No value is returned. 1238 * @deprecated since 9 1239 */ 1240 startImagePreview(images: Array<string>, callback: AsyncCallback<void>): void; 1241 /** 1242 * Starts image preview, with the first image to preview specified. 1243 * This method uses a promise to return the execution result. 1244 * @since 6 1245 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1246 * @param images List of images to preview. 1247 * @param index Sequence number of the first image to preview. 1248 * @returns Promise used to return whether the operation is successful. 1249 * @deprecated since 9 1250 */ 1251 startImagePreview(images: Array<string>, index?: number): Promise<void>; 1252 /** 1253 * Starts media selection. This method uses an asynchronous callback to 1254 * return the list of URIs that store the selected media resources. 1255 * @since 6 1256 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1257 * @param option Media selection option. 1258 * @param callback Callback used to return the list of URIs that store the selected media resources. 1259 * @deprecated since 9 1260 */ 1261 startMediaSelect(option: MediaSelectOption, callback: AsyncCallback<Array<string>>): void; 1262 /** 1263 * Starts media selection. This method uses a promise to return the list of URIs 1264 * that store the selected media resources. 1265 * @since 6 1266 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1267 * @param option Media selection option. 1268 * @returns Promise used to return the list of URIs that store the selected media resources. 1269 * @deprecated since 9 1270 */ 1271 startMediaSelect(option: MediaSelectOption): Promise<Array<string>>; 1272 /** 1273 * Get Active Peer device information 1274 * @since 8 1275 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1276 * @permission ohos.permission.READ_MEDIA 1277 * @systemapi 1278 * @param callback, Callback return the list of the active peer devices' information 1279 * @deprecated since 9 1280 * @useinstead ohos.file.picker 1281 */ 1282 getActivePeers(callback: AsyncCallback<Array<PeerInfo>>): void; 1283 /** 1284 * Get Active Peer device information 1285 * @since 8 1286 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1287 * @permission ohos.permission.READ_MEDIA 1288 * @systemapi 1289 * @returns Promise used to return the list of the active peer devices' information 1290 * @deprecated since 9 1291 * @useinstead ohos.file.picker 1292 */ 1293 getActivePeers(): Promise<Array<PeerInfo>>; 1294 /** 1295 * Get all the peer devices' information 1296 * @since 8 1297 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1298 * @permission ohos.permission.READ_MEDIA 1299 * @systemapi 1300 * @param callback Callback return the list of the all the peer devices' information 1301 * @deprecated since 9 1302 * @useinstead ohos.file.picker 1303 */ 1304 getAllPeers(callback: AsyncCallback<Array<PeerInfo>>): void; 1305 /** 1306 * Get all the peer devices' information 1307 * @since 8 1308 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1309 * @permission ohos.permission.READ_MEDIA 1310 * @systemapi 1311 * @returns Promise used to return the list of the all the peer devices' information 1312 * @deprecated since 9 1313 * @useinstead ohos.file.picker 1314 */ 1315 getAllPeers(): Promise<Array<PeerInfo>>; 1316 /** 1317 * Release MediaLibrary instance 1318 * @since 8 1319 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1320 * @param callback no value returned 1321 * @deprecated since 9 1322 * @useinstead ohos.file.picker 1323 */ 1324 release(callback: AsyncCallback<void>): void; 1325 /** 1326 * Release MediaLibrary instance 1327 * @since 8 1328 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1329 * @deprecated since 9 1330 * @useinstead ohos.file.picker 1331 */ 1332 release(): Promise<void>; 1333 } 1334 1335 /** 1336 * thumbnail's size which have width and height 1337 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1338 * @since 8 1339 * @deprecated since 9 1340 * @useinstead ohos.file.picker 1341 */ 1342 interface Size { 1343 /** 1344 * Width of image file 1345 * @since 8 1346 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1347 * @deprecated since 9 1348 * @useinstead ohos.file.picker 1349 */ 1350 width: number; 1351 /** 1352 * Height of image file 1353 * @since 8 1354 * @syscap SystemCapability.Multimedia.MediaLibrary.Core 1355 * @deprecated since 9 1356 * @useinstead ohos.file.picker 1357 */ 1358 height: number; 1359 } 1360 1361 /** 1362 * peer devices' information 1363 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1364 * @systemapi 1365 * @since 8 1366 * @deprecated since 9 1367 * @useinstead ohos.file.picker 1368 */ 1369 interface PeerInfo { 1370 /** 1371 * Peer device name 1372 * @since 8 1373 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1374 * @systemapi 1375 * @deprecated since 9 1376 * @useinstead ohos.file.picker 1377 */ 1378 readonly deviceName: string; 1379 /** 1380 * Peer device network id 1381 * @since 8 1382 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1383 * @systemapi 1384 * @deprecated since 9 1385 * @useinstead ohos.file.picker 1386 */ 1387 readonly networkId: string; 1388 /** 1389 * Peer device type 1390 * @since 8 1391 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1392 * @systemapi 1393 * @deprecated since 9 1394 * @useinstead ohos.file.picker 1395 */ 1396 readonly deviceType: DeviceType; 1397 /** 1398 * Peer device online status 1399 * @since 8 1400 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1401 * @systemapi 1402 * @deprecated since 9 1403 * @useinstead ohos.file.picker 1404 */ 1405 readonly isOnline: boolean; 1406 } 1407 1408 /** 1409 * peer device type 1410 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1411 * @systemapi 1412 * @since 8 1413 * @deprecated since 9 1414 * @useinstead ohos.file.picker 1415 */ 1416 enum DeviceType { 1417 /** 1418 * Unknown device type 1419 * @since 8 1420 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1421 * @systemapi 1422 * @deprecated since 9 1423 * @useinstead ohos.file.picker 1424 */ 1425 TYPE_UNKNOWN = 0, 1426 /** 1427 * Laptop device 1428 * @since 8 1429 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1430 * @systemapi 1431 * @deprecated since 9 1432 * @useinstead ohos.file.picker 1433 */ 1434 TYPE_LAPTOP, 1435 /** 1436 * Phone device 1437 * @since 8 1438 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1439 * @systemapi 1440 * @deprecated since 9 1441 * @useinstead ohos.file.picker 1442 */ 1443 TYPE_PHONE, 1444 /** 1445 * Tablet device 1446 * @since 8 1447 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1448 * @systemapi 1449 * @deprecated since 9 1450 * @useinstead ohos.file.picker 1451 */ 1452 TYPE_TABLET, 1453 /** 1454 * Watch device 1455 * @since 8 1456 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1457 * @systemapi 1458 * @deprecated since 9 1459 * @useinstead ohos.file.picker 1460 */ 1461 TYPE_WATCH, 1462 /** 1463 * Car device 1464 * @since 8 1465 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1466 * @systemapi 1467 * @deprecated since 9 1468 * @useinstead ohos.file.picker 1469 */ 1470 TYPE_CAR, 1471 /** 1472 * TV device 1473 * @since 8 1474 * @syscap SystemCapability.Multimedia.MediaLibrary.DistributedCore 1475 * @systemapi 1476 * @deprecated since 9 1477 * @useinstead ohos.file.picker 1478 */ 1479 TYPE_TV 1480 } 1481} 1482 1483export default mediaLibrary;