# @ai-game-assets/phaser 中文文档

规范地址：https://npmcn.com/package/%40ai-game-assets/phaser/

版本：0\.11\.39
npm 元数据更新时间：2026-11-07T16:11:29.458Z
中文译文更新时间：2026-11-06T14:19:37.254Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.4 MB，126 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：phaser \>=4
- 首次发布：2026-06-17T03:29:19.532Z
- 最新版本发布：2026-11-07T16:11:29.081Z
- 近 30 天下载量：3007（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：61（近 12 个月 61 个）

## 中文简介

相机集成和游戏内设计者,用于即时意识AI游戏资产.

## 安装

```sh
npm install @ai-game-assets/phaser
```

也可以使用：`pnpm add @ai-game-assets/phaser`、`yarn add @ai-game-assets/phaser`、`bun add @ai-game-assets/phaser`

## README

# `@ai-game-assets/phaser`

相接器加载,运行时间帮助,以及AI Game States的游戏中资产设计师.

[播放空间入侵者演示](https://tzachshabtay.github.io/ai-assets/) • 妇女 [在 npm 上查看此软件包](https://www.npmjs.com/package/@ai-game-assets/phaser) • 妇女 [阅读全部文档](https://github.com/tzachshabtay/ai-assets#readme)

```sh
npm install @ai-game-assets/core @ai-game-assets/phaser phaser
```

使用此软件包将显示的资产加载到Priver中,对设计者预览作出反应,并在开发过程中安装调试后的资产设计器.

设计师的图像模型选择器提供 GPT 图像 2.5 Sunburst (默认) 和 GPT 图像 2.5 用于光栅生成,编辑,图案,和平板动画的火焰. 有明确遗产或习俗的资产 `settings.model` 保持这个选择。 推动生成的选项来保存其模式偏好; SVG 和音频保留自己的提供者.

本届会议期间,未经推动的即时和实地编辑在转换资产、目标和动画中幸存。 刷新它们重放到保存的定义 。 使用 **添加引用** 选择一个资产或动画工作表,上传一个图像,或用内置编辑器绘制草图。 这一参考优先于现有的视觉参考,在会议期间仍可选择,直至删除.

## 缩放变体

资产设计师的 **缩放的变体...** 按钮管理当前源版本的替代分辨率。 设置宽度和高度(动画/工作表的每个框架,瓷砖的每个瓦片),然后 **生成**如果分辨率已经存在,则窗体切换到 **重新生成** 并仅在您保存候选人后替换该变量;您不需要先选择编辑. **编辑** 更改内容和提议 **重新生成**· ; **抚摸..** 打开现有的像素编辑器; **删除** 从使用中删除一个变体. **宣传** 在保留对话框时保存所选候选人。 在挑选候选人之后, **关闭** 变成 **保存并关闭** ,在关闭前等待保存和运行时间更新;失败的保存会让对话框和选择打开供重试。 在同一设计者会话中重开此对话框时, 不选择的关闭会保留候选人 . **丢弃候选人** 清除待批货物。 源图像,逻辑资产维度,帧顺序,动画时间不变. 新推广的源起自自变种.

Scaled 变体对话框在保存前生成三个候选人 。 每个动画候选作品都有Animate/停止控制,使用原始帧顺序和时间. 选择候选人并升职保存,或者丢弃候选人. 再生保留了现有的变体,直到被推广取而代之. 所保存的动画也可以用动画预览.

生成按比例选择最接近可用的分辨率,偏好平分上较大的源. 再生排除被替换的变体. 严格的像素使用精确近邻的RGBA复制. 平滑的重塑大小使用定型再取样. OpenAI 图像上尺度使用现有的 OpenAI 密钥并使用保存提示;它可能精细细节. 在这种模式下缩小规模使用确定性的平稳再缩小。 人工智能结果的透明度得到保留,工作单一次处理一个单元格.

`loadAiAsset`编号 :`loadAiAssets` 加载活动版本的变体. `AiAssetRuntime` 自动选择可用变体 `bindTexture` 财务报告和审定财务报表 `playAnimation` 每个场景更新后的目标,基于显示大小,主相机缩放,画布显示缩放,以及设备像素比. 框架、来源、翻转和世界空间显示大小保留下来。 缺失的变体纹理会回落到一个可用的源;活的变体会同步地加载;删除会立即回落. 活动生成预览比被保存的变体优先.

对于自定义相机, 渲染出纹理, 或明确同步, 调用 `runtime.applyScaledVariant(sprite, assetId, { width, height, frame })`,其中宽度/高度是理想的屏幕-像素尺寸。 使用主相机和帆布测量的外观尺寸. 设定 `scaledVariants: false` 在运行时选项中禁用选择。 平面 不由运行时间管理的相位图示可以使用导出 `applyAiScaledVariant` 帮手 动画平板花序纹理仍与基板的变体相分离.

## 常见问题

### @ai-game-assets/phaser 是什么？

相机集成和游戏内设计者,用于即时意识AI游戏资产\.

### 如何安装 @ai-game-assets/phaser？

在项目目录运行 npm install @ai-game-assets/phaser，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：phaser（\>=4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ai-game-assets/phaser 支持 TypeScript 吗？

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

### @ai-game-assets/phaser 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @ai-game-assets/phaser 可以商用吗？

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

### @ai-game-assets/phaser 的下载量有多少？

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

### @ai-game-assets/phaser 还在维护吗？

最新版本 0\.11\.39 发布于 2026/11/08（今天）；至今共发布 61 个版本，其中过去 12 个月发布了 61 个；首次发布于 2026/06/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。