---
title: "NPC_LoadRecord | open.mp"
description: "加载 NPC 录制文件用于回放。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_LoadRecord
language: zh-CN
---

# NPC\_LoadRecord

注意

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

## 描述

加载 NPC 录制文件用于回放使用。

| 参数 | 说明 |
| --- | --- |
| const filePath | 录制文件的路径 |

## 返回值

返回已加载录制的 ID，失败时返回`INVALID_RECORD_ID`。

## 示例

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp(cmdtext, "/npcloadrecord ", true, 15))
    {
        new filepath[128];
        new len = strlen(cmdtext);
        if (len <= 15)
            return SendClientMessage(playerid, 0xFF0000FF, "用法：/npcloadrecord [文件路径]");

        strmid(filepath, cmdtext, 15, len);

        new recordid = NPC_LoadRecord(filepath);

        if (recordid == -1)
            SendClientMessage(playerid, 0xFF0000FF, "从 %s 加载录制失败", filepath);
        else
            SendClientMessage(playerid, 0x00FF00FF, "录制已从 %s 加载，对应ID: %d", filepath, recordid);
        return 1;
    }
    return 0;
}
```

## 注意事项

-   在使用 NPC\_StartPlayback 之前加载录制

注意

与 [NPC\_StartPlayback](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_StartPlayback) 不同，`filePath` 需要提供从服务器根目录开始的完整路径，并包含 `.rec` 扩展名。  
例如：`npcmodes/recordings/myrecording.rec`

## 相关函数

-   [NPC\_UnloadRecord](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_UnloadRecord): 卸载录制
-   [NPC\_UnloadAllRecords](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_UnloadAllRecords): 卸载所有录制
-   [NPC\_StartPlayback](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_StartPlayback): 开始回放录制
-   [NPC\_GetRecordCount](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/NPC_GetRecordCount): 获取已加载录制数量

## 相关回调

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