# @akashic/playlog 中文文档

规范地址：https://npmcn.com/package/%40akashic/playlog/

版本：3\.4\.1
npm 元数据更新时间：2025-10-08T10:36:05.996Z
中文译文更新时间：2026-11-05T22:35:50.984Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40akashic/playlog
原文对照：https://npmcn.com/package/%40akashic/playlog/?lang=original
项目主页：https://github.com/akashic-games/playlog#readme
源码仓库：https://github.com/akashic-games/playlog

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：46.7 kB，21 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2019-01-28T02:44:52.236Z
- 最新版本发布：2025-02-21T03:36:40.345Z
- 近 30 天下载量：11750（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 0 个）

## 中文简介

Playlog 的界面定义, Akashic 游戏执行的序列化格式

## 安装

```sh
npm install @akashic/playlog
```

也可以使用：`pnpm add @akashic/playlog`、`yarn add @akashic/playlog`、`bun add @akashic/playlog`

## README

![](https://github.com/akashic-games/playlog/blob/master/img/akashic.png)

# 播放日志

Akashic 切入脚本。 本リポジトリは型の定義のみを提供しています。 Akashic 引擎编辑器 [公式ページ](https://akashic-games.github.io/) を参照してください。

## 仕様

`Event`, (中文) `Tick` の仕様を定義します。

これらは、通信路を流れる際のオーバヘッドを少なくするため、配列型のデータとなっています。

**オプショナル** 页:1 **对** となっているものは、 `null` 又は配列末尾のデータであれば省略することができます。

编号 :。

### 活动

`Event` はゲームに発生した出来事を表すデータです。

| 事件代码 | イベント |
| :-- | :-- |
| 0x0 (英语) | プレイヤー参加 |
| 0x1 (英语) | プレイヤー離脱 |
| 0x2 数据 | 時間の記録 |
| 0x3 (英语) | プレイヤー情報 |
| 0x20 (英语) | 汎用的なデータ |
| 0x21 (英语) | ポイントダウン |
| 0x22 (英语) | ポイントムーブ |
| 0x23 (英语) | ポイントアップ |
| 0x40 (英语) | 操作プラグイン |

`Event` 共通のデータ・フォーマットは以下のようになります。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 0 个 | 编号 | 无 | 事件代码 |
| 1个 | 编号 | 无 | イベントフラグ |
| 2个 | 字符串 | 无 | 缩写 |

インデックス2番以降は各イベントのデータがセットされます。

#### イベントフラグ

`EventFlags` は以下のビットフラグをからなる数値を表します。

| 下位ビット | 説明 |
| :-- | :-- |
| 0 个 | プライオリティ |
| 1个 | プライオリティ |
| 2个 | 予約フィールド |
| 3个 | 非永続化フラグ |
| 页:1 | 省略可能フラグ |

下位0ビット目と1ビット目はプライオリティを表します。

3ビット目は非永続化フラグを表します。このビットが1の場合、対象のイベントは永続化されないことを許容します。

\# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #。

#### 加入Event (0x0) (中文(简体) )

プレイヤーの参加イベントを表します。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 字符串 | 无 | プレイヤー名 |
| 页:1 | 存储数据 \[\] | 对 | ストレージデータ |

`StorageData[]` は。 `StorageData` のデータ・フォーマットは [类型脚本QQ](https://github.com/akashic-games/playlog/blob/master/src/StorageData.ts) を参照してください。

#### 离开事件( 0x1)

プレイヤーの離脱イベントを表します。

#### 时间戳事件( 0x2)

時間の記録を表すイベントです。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 编号 | 无 | 時間を示す値 |

時間を示す値同士を比較したときに、大きい値が未来の時間を表します。

#### 玩家信息事件 (0x3)

プレイヤーの情報を表すイベントです。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 字符串 | 无 | プレイヤー名 |
| 页:1 | 任意 | 对 | ユーザ定義データ |

#### 信件事件 (0x20)

汎用的なデータを表すイベントを表します。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 任意 | 无 | 汎用的なデータ |

#### 点下事件( 0x21)

ポイントダウンイベントを表します。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 编号 | 无 | 缩写 |
| 页:1 | 编号 | 无 | X座標 |
| 页:1 | 编号 | 无 | 哟 |
| 6个 | 编号 | 对 | 缩写 |
| 第7条 | 按钮 | 对 | ボタンの種類 |

#### 点移动事件( 0x22)

ポイントムーブイベントを表します。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 编号 | 无 | 缩写 |
| 页:1 | 编号 | 无 | X座標 |
| 页:1 | 编号 | 无 | 哟 |
| 6个 | 编号 | 无 | ポイントダウンイベントからのX座標の差 |
| 第7条 | 编号 | 无 | {\\FN黑体\\FS22\\BORD1\\SHAD0\\3AHBE\\4AH00\\FSCX67\\FSCY66\\2CHFFFFFF\\3CH808080}你来干什么 |
| 第8条 | 编号 | 无 | 直前のポイントムーブイベントからのX座標の差 |
| 第9条 | 编号 | 无 | {\\FN黑体\\FS22\\BORD1\\SHAD0\\3AHBE\\4AH00\\FSCX67\\FSCY66\\2CHFFFFFF\\3CH808080}你来干什么 |
| 10个 | 编号 | 对 | 缩写 |
| 第11个 | 按钮 | 对 | ボタンの種類 |

#### 点出事件( 0x23)

ポイントアップイベントを表します。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 编号 | 无 | 缩写 |
| 页:1 | 编号 | 无 | X座標 |
| 页:1 | 编号 | 无 | 哟 |
| 6个 | 编号 | 无 | ポイントダウンイベントからのX座標の差 |
| 第7条 | 编号 | 无 | {\\FN黑体\\FS22\\BORD1\\SHAD0\\3AHBE\\4AH00\\FSCX67\\FSCY66\\2CHFFFFFF\\3CH808080}你来干什么 |
| 第8条 | 编号 | 无 | 直前のポイントムーブイベントからのX座標の差 |
| 第9条 | 编号 | 无 | {\\FN黑体\\FS22\\BORD1\\SHAD0\\3AHBE\\4AH00\\FSCX67\\FSCY66\\2CHFFFFFF\\3CH808080}你来干什么 |
| 10个 | 编号 | 对 | 缩写 |
| 第11个 | 按钮 | 对 | ボタンの種類 |

#### 行动Event (0x40)

操作プラグインイベントを表します。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 3个 | 编号 | 无 | 操作プラグインコード |
| 页:1 | (数目) \[ | 无 | 操作プラグインデータ |

### 选中

`Tick` はゲームの1フレームを実行するために必要なデータです。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 0 个 | 编号 | 无 | フレーム番号 |
| 1个 | 活动\[ \] | 对 | イベント |
| 2个 | 存储数据 \[\] | 对 | ストレージデータ |

`StorageData` のデータ・フォーマットは [类型脚本QQ](https://github.com/akashic-games/playlog/blob/master/src/StorageData.ts) を参照してください。

`Tick` は通信路を流れる際に、以下のような最適化を実施することが望まれます。

#### 编号

`Tick` (数目) 。

#### 备忘列表

`TickList` はフレーム番号の続く複数の `Tick` を表します。

| 指数 | 页:1 | オプショナル | 説明 |
| :-- | :-- | :-- | :-- |
| 0 个 | 编号 | 无 | 開始フレーム番号 |
| 1个 | 编号 | 无 | 終了フレーム番号 |
| 2个 | 计时 | 对 | 勾选 \[1\] + 勾选 \[2\] + 勾选 |

## 类型脚本QQ

### インストール

```
npm install @akashic/playlog
```

### 利用方法

```
import * as playlog from "@akashic/playlog";
```

## 開発

### ビルドテスト

```
cd test
tsc
```

## ライセンス

麻省理工学院 许可证 QQ。 詳しくは [自由主义](https://github.com/akashic-games/playlog/blob/master/LICENSE) をご覧ください。

ただし、画像ファイルおよび音声ファイルは [CC BY 2.1 JP (日语)](https://creativecommons.org/licenses/by/2.1/jp/) の元で公開されています。

## 常见问题

### @akashic/playlog 是什么？

Playlog 的界面定义, Akashic 游戏执行的序列化格式

### 如何安装 @akashic/playlog？

在项目目录运行 npm install @akashic/playlog，或使用 pnpm add / yarn add / bun add。

### @akashic/playlog 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @akashic/playlog 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @akashic/playlog 可以商用吗？

@akashic/playlog 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @akashic/playlog 的下载量有多少？

根据 npm 官方下载统计，@akashic/playlog 在 2026/10/06 – 2026/11/04 这 30 天内被下载 11,750 次，日均约 392 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @akashic/playlog 还在维护吗？

最新版本 3\.4\.1 发布于 2025/02/21（1\.7 年前）；至今共发布 10 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/01/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。