• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Interface (QuickImageDataHandler)
2
3> **说明:**
4>
5> - 本模块首批接口从API version 10开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
6> - 本Interface首批接口从API version 13开始支持。
7
8媒体资源处理器,应用在onDataPrepared方法中可自定义媒体资源处理逻辑。
9
10**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core
11
12## 导入模块
13
14```ts
15import { photoAccessHelper } from '@kit.MediaLibraryKit';
16```
17
18## onDataPrepared<sup>13+</sup>
19
20onDataPrepared(data: T, imageSource: image.ImageSource, map: Map<string, string>): void
21
22当请求的图片资源准备就绪时,系统会回调媒体资源就绪通知方法。如果资源准备出错,回调的data将为undefined。
23
24map支持返回的信息:
25
26| map键名  | 值说明 |
27|----------|-------|
28| 'quality'  | 图片质量。高质量为'high',低质量为'low'。 |
29
30**系统能力**:SystemCapability.FileManagement.PhotoAccessHelper.Core
31
32**参数:**
33
34| 参数名  | 类型 | 必填 | 说明                                                                            |
35|------|---| ---- |-------------------------------------------------------------------------------|
36| data | T | 是   | 已就绪的图片资源数据。泛型,支持[Picture](../apis-image-kit/arkts-apis-image-Picture.md)数据类型。 |
37| imageSource | image.ImageSource | 是   | 已就绪的图片资源数据。 |
38| map<sup>13+</sup> | Map<string, string> | 是   | 用于获取图片资源的额外信息,如图片质量。仅支持'quality'。 |
39
40**示例:**
41
42```ts
43import { image } from '@kit.ImageKit';
44
45class MediaHandler implements photoAccessHelper.QuickImageDataHandler<image.Picture> {
46  onDataPrepared(data: image.Picture, imageSource: image.ImageSource, map: Map<string, string>) {
47    console.info('on image data prepared');
48  }
49}
50```
51