## 导入模块

PhonePC/2in1TabletWearable



```
1. import { map } from '@kit.MapKit';
2. import { image } from '@kit.ImageKit';
```

## PlayImageAnimation

PhonePC/2in1TabletWearable

控制多张图片的帧动画，继承[Animation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-map-animation)。

帧动画是一种通过快速连续显示一系列静态图像来创建动画效果的技术。每一张图像被称为一帧，当这些帧以快速的顺序播放时，用户会感知到平滑的运动或变化。

**模型约束：** 此接口仅可在Stage模型下使用。

**元服务API：** 从版本5.0.0(12)开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Map.Core

**起始版本：** 5.0.0(12)

**示例：**



```
1. let images: Array<ResourceStr | image.PixelMap> = [
2. // 图片存放在resources/rawfile
3. 'test1.png',
4. 'test2.png',
5. 'test3.png',
6. 'test4.png'
7. ];
8. let playImageAnimation: map.PlayImageAnimation = new map.PlayImageAnimation();
9. await playImageAnimation.addImages(images);
```

### addImages

PhonePC/2in1TabletWearable

addImages(images: Array<ResourceStr | image.PixelMap>): Promise<void>

添加动画的图片资源。使用Promise异步回调。

**模型约束：** 此接口仅可在Stage模型下使用。

**元服务API：** 从版本5.0.0(12)开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.Map.Core

**起始版本：** 5.0.0(12)

**参数：**

展开

| **参数名** | **类型** | 必填 | **说明** |
| --- | --- | --- | --- |
| images | Array<[ResourceStr](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-types#resourcestr) | [image.PixelMap](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-image-pixelmap)> | 是 | 动画的图片资源。  **说明：**  - 建议图片大小相同。  - 图片数量不超过200张。  - 持续时间需要大于33ms。如果不是，它将被更改为33ms。  - string类型入参，图片存放在resources/rawfile。 |

**返回值：**

展开

| 类型 | 说明 |
| --- | --- |
| Promise<void> | Promise对象。无返回结果的Promise对象。 |

**错误码：**

以下错误码的详细介绍请参见[ArkTS API错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-map)。

展开

| 错误码ID | 错误信息 |
| --- | --- |
| 401 | Invalid input parameter. |

**示例：**



```
1. let images: Array<ResourceStr | image.PixelMap> = [
2. // 图片存放在resources/rawfile
3. 'test1.png',
4. 'test2.png',
5. 'test3.png',
6. 'test4.png'
7. ];
8. await playImageAnimation.addImages(images);
```