# @fluid-internal/presence-runtime 中文文档

规范地址：https://npmcn.com/package/%40fluid-internal/presence-runtime/

版本：3\.12\.0
npm 元数据更新时间：2026-11-10T22:31:41.905Z
中文译文更新时间：2026-11-15T01:42:28.015Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fluid-internal/presence-runtime
原文对照：https://npmcn.com/package/%40fluid-internal/presence-runtime/?lang=original
项目主页：https://fluidframework.com/
源码仓库：https://github.com/microsoft/FluidFramework

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

- 包体积（解压后）：364 kB，99 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：9 个
- 首次发布：2026-04-16T00:01:06.489Z
- 最新版本发布：2026-11-10T22:31:41.702Z
- 近 30 天下载量：22497（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

Fluid框架核心运行时间执行

## 安装

```sh
npm install @fluid-internal/presence-runtime
```

也可以使用：`pnpm add @fluid-internal/presence-runtime`、`yarn add @fluid-internal/presence-runtime`、`bun add @fluid-internal/presence-runtime`

## README

# @fluid-内部/现场运行时间

这是一个内部一揽子计划,包含执行 `presence` APIs (英语). `presence` API应该通过 `@fluidframework/presence` 软件包.

## 来源组织

```
        @fluidframework/presence
                  |
        +---------^---------+-------+
        |                   |       |
    ./states           ./runtime    |
        |                   |       |
        ^---------v---------+       |
        |         |         |       |
        |   ./workspace     |       |
        |         |         |       |
        ^-------v-+---------^       |
        |       |           |       |
        |   ./utils         |       |
        |       |           |       |
        ^-------^---v-------^-------^
                    |
    @fluid-internal/presence-definitions
```

### 倾斜

**目的:** 通用功能与共享实施.

**文件 :**

-   `internalUtils.ts` → `objectEntries`, (中文(简体) ), `objectKeys`, (中文(简体) ), `getOrCreateRecord`JSON帮助者
-   `timerManager.ts` → `TimerManager` 类
-   `broadcastControls.ts` → `OptionalBroadcastControl`, (中文(简体) ), `RequiredBroadcastControl` 类
-   `valueManager.ts` → `brandIVM`, (中文(简体) ), `unbrandIVM`

### 工作空间

**目的:** 工作空间抽象与状态数据存储合同.

**文件 :**

-   `stateDatastore.ts` → `StateDatastore` 接口, `handleFromDatastore`, (中文(简体) ), `datastoreFromHandle`
-   `presenceStates.ts` → `PresenceStatesImpl`, (中文(简体) ), `createPresenceStates`,工作空间执行

### 运行时间

**目的:** 核心运行时间 - 存在管理器,数据存储管理器,系统工作空间.

**展览:** 扩展内容 `ContainerPresenceFactory` 财务报告和审定财务报表 `extensionId`

**文件 :**

-   `extension/containerPresence.ts` → `ContainerPresenceFactory`, (中文(简体) ), `extensionId`
-   `presenceDatastoreManager.ts` → `PresenceDatastoreManagerImpl`
-   `presenceManager.ts` → `PresenceManager` 班级, `createPresenceManager`
-   `protocol.ts` • 信息类型定义, `joinMessageType`, (中文(简体) ), `datastoreUpdateMessageType`, (中文(简体) ), `acknowledgementMessageType`
-   `runtimeTypes.ts` → `IEphemeralRuntime`, (中文(简体) ), `ExtensionHost`
-   `systemWorkspace.ts` → `SystemWorkspace`, (中文(简体) ), `createSystemWorkspace`

### 状态

**目的:** 国家管理人员的执行.

**展览:** `StateFactory` 财务报告和审定财务报表 `Notifications` (单位)

**文件 :**

-   `latestMapValueManager.ts` → `latestMap` 工厂
-   `latestValueManager.ts` → `latest` 工厂
-   `notificationsManager.ts` → `NotificationsManager`, (中文(简体) ), `Notifications` 工厂
-   `presence.ts` → `SpecificAttendee`
-   `stateFactory.ts` → `StateFactory` 对象
-   `validatedGetter.ts` → `createValidatedGetter`

## 常见问题

### @fluid-internal/presence-runtime 是什么？

Fluid框架核心运行时间执行

### 如何安装 @fluid-internal/presence-runtime？

在项目目录运行 npm install @fluid-internal/presence-runtime，或使用 pnpm add / yarn add / bun add。

### @fluid-internal/presence-runtime 支持 TypeScript 吗？

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

### @fluid-internal/presence-runtime 支持 ESM 还是 CommonJS？

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

### @fluid-internal/presence-runtime 可以商用吗？

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

### @fluid-internal/presence-runtime 的下载量有多少？

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

### @fluid-internal/presence-runtime 还在维护吗？

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