@akashic/playlog

中文文档
3.4.1发布于 2025/02/21MITTypeScriptCommonJS零依赖近 30 天下载 1.2万

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

中文使用文档
文档目录9 节
  1. 仕様
  2. 活动
  3. 选中
  4. 类型脚本QQ
  5. インストール
  6. 利用方法
  7. 開発
  8. ビルドテスト
  9. ライセンス

播放日志

Akashic 切入脚本。 本リポジトリは型の定義のみを提供しています。 Akashic 引擎编辑器 公式ページ を参照してください。

仕様

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 を参照してください。

离开事件( 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 を参照してください。

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。 詳しくは 自由主义 をご覧ください。

ただし、画像ファイルおよび音声ファイルは CC BY 2.1 JP (日语) の元で公開されています。

版本与发布记录

@akashic/playlog 共发布 10 个版本,首次发布于 2019/01/28;过去 12 个月发布了 0 个版本。

版本发布日期距今
3.4.1latest2025/02/211.7 年前
3.4.02025/01/231.8 年前
3.3.02023/10/033 年前
3.2.02023/06/133 年前
3.1.02020/07/286 年前
3.0.02020/06/156 年前

关于 @akashic/playlog 的常见问题

@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 和提交记录判断。