@antha/多人-核心
该软件包提供会议室、信号、WebRTC和标识功能 安莎游戏引擎'对等多人功能. 直接用它来构建自定义的多人策略,或者使用其中一种策略包来进行现成的方法.
安装
npm i @antha/multiplayer-core
默认 STUN 服务器
默认情况下,多人连接会使用Cloudflare的公用STUN服务器(stun.cloudflare.com:3478),是一种第三方服务. 每个客户端都会向它发送请求,这暴露了客户端的公开IP地址给Cloudflare. 这帮助不同网络上的同龄人找到彼此的路径.
要改变这个, 设置 stunServerUrls 调用时 initMultiplayer数字 :
- 使用您的 STUN 服务器 :
stunServerUrls: ['stun.example.com:3478']
- 完全不用 STUN 服务器 :
stunServerUrls: []
选择 stunServerUrls (或设置为 undefined)使用 Cloudflare 默认值,导出为 defaultStunServerUrls。 。 。 .
使用量
import {createMultiplayerApiClient, createMultiplayerId} from '@antha/multiplayer-core';
const roomId = createMultiplayerId.room();
const multiplayerApiClient = await createMultiplayerApiClient({
backendOrigin: 'http://localhost:9348',
portScanOptions: false,
});
关于 @antha/multiplayer-core 的常见问题
@antha/multiplayer-core 是什么？
Antha 多人模式的核心功能.
如何安装 @antha/multiplayer-core？
在项目目录运行 npm install @antha/multiplayer-core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@antha/util（^0.28.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@antha/multiplayer-core 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@antha/multiplayer-core 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@antha/multiplayer-core 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@antha/multiplayer-core 可以商用吗？
@antha/multiplayer-core 使用 (MIT OR CC0-1.0) 许可。可在 MIT、CC0-1.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@antha/multiplayer-core 的下载量有多少？
根据 npm 官方下载统计，@antha/multiplayer-core 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,714 次，日均约 57 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@antha/multiplayer-core 还在维护吗？
最新版本 0.28.0 发布于 2026/10/25（16 天前）；至今共发布 51 个版本，其中过去 12 个月发布了 51 个；首次发布于 2026/06/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。