---
title: "GetActorAnimation | open.mp"
description: "获取演员当前正在播放的动画信息。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/GetActorAnimation
language: zh-CN
---

# GetActorAnimation

注意

这个函数是在omp v1.1.0.2612中添加的，在以前的版本中不起作用！

## 描述

获取演员当前正在播放的动画信息。

| 参数 | 说明 |
| --- | --- |
| actorid | 要获取动画的演员 ID |
| animationLibrary\[\] | 用于存储动画库名称的数组（引用传递） |
| librarySize | 动画库名称数组的长度 |
| animationName\[\] | 用于存储动画名称的数组（引用传递） |
| nameSize | 动画名称数组的长度 |
| &Float:delta | 浮点变量，用于存储动画增量（引用传递） |
| &bool:loop | 布尔变量，用于存储循环状态（引用传递） |
| &bool:lockX | 布尔变量，用于存储 X 轴锁定状态（引用传递） |
| &bool:lockY | 布尔变量，用于存储 Y 轴锁定状态（引用传递） |
| &bool:freeze | 布尔变量，用于存储冻结状态（引用传递） |
| &time | 整型变量，用于存储动画时间（引用传递） |

## 返回值

若演员存在且有效返回 true，否则返回 false。

## 示例代码

```c
new gMyActor;

public OnGameModeInit()
{
    gMyActor = CreateActor(179, 1153.9640, -1772.3915, 16.5920, 0.0000);
    ApplyActorAnimation(gMyActor, "PED", "IDLE_CHAT", 4.1, true, true, true, true, 0);

    new animationLibrary[32],
        animationName[32],
        Float:delta,
        bool:loop,
        bool:lockX,
        bool:lockY,
        bool:freeze,
        time;

    GetActorAnimation(gMyActor, animationLibrary, sizeof animationLibrary, animationName, sizeof animationName, delta, loop, lockX, lockY, freeze, time);
    return 1;
}
```

## 相关函数

-   [CreateActor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreateActor): 创建演员（静态 NPC）
-   [ApplyActorAnimation](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/ApplyActorAnimation): 对演员应用动画
-   [ClearActorAnimations](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/ClearActorAnimations): 清除演员的所有动画