---
title: "NPC_UnloadAllRecords | open.mp"
description: "从内存中卸载所有 NPC 录制文件。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_UnloadAllRecords
language: zh-CN
---

# NPC\_UnloadAllRecords

注意

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

## 描述

从内存中卸载所有 NPC 录制文件以释放资源。

## 返回值

如果所有录制都成功卸载则返回`true`，否则返回`false`。

## 示例

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/npcunloadallrecords", true))
    {
        new bool:success = NPC_UnloadAllRecords();

        if (success)
            SendClientMessage(playerid, 0x00FF00FF, "所有录制卸载成功");
        else
            SendClientMessage(playerid, 0xFF0000FF, "卸载所有录制失败");
        return 1;
    }
    return 0;
}
```

## 注意事项

-   这会释放已加载录制占用的内存
-   此函数后所有录制 ID 变为无效
-   任何使用这些录制的 NPC 将停止播放

## 相关函数

-   [NPC\_LoadRecord](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_LoadRecord): 加载录制文件
-   [NPC\_UnloadRecord](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_UnloadRecord): 卸载特定录制
-   [NPC\_GetRecordCount](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_GetRecordCount): 获取已加载录制数量
-   [NPC\_IsValidRecord](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_IsValidRecord): 检查录制是否有效

## 相关回调

-   [OnNPCPlaybackEnd](https://omp.itsneufox.com/zh-CN/docs/scripting/callbacks/OnNPCPlaybackEnd): 播放结束时调用