适用于: 开发人员版
当 SharePoint Embedded 应用需要实时共享状态(例如协作控件、实时计数器、光标、批注或多用户窗体状态)时,请使用 Fluid Framework。 Fluid 提供用于分发、同步和保存共享数据的客户端库。
准备 SharePoint Embedded
在运行 Fluid 示例之前,请创建或识别 SharePoint Embedded 应用程序。 需要 Microsoft 365 租户的管理员凭据、应用程序客户端 ID、容器类型 ID 以及至少为该容器类型创建的容器。
如果使用 SharePoint Embedded Visual Studio Code 扩展,请使用生成的示例配置ContainerTypeId查找 和 ClientId. 还可以在“应用注册”下的 Microsoft Entra ID 中找到客户端 ID。
若要免费试用 SharePoint Embedded,请创建试用容器类型。 请参阅 创建和配置容器类型。
运行项目计数器示例
该 item-counter-spe 示例位于流体示例存储库中。
git clone https://github.com/microsoft/FluidExamples.git
cd FluidExamples\item-counter-spe
在示例文件夹中创建一个空 .env 文件,并添加 SharePoint 嵌入式标识符。
SPE_CLIENT_ID=YOUR_CLIENTID
SPE_CONTAINER_TYPE_ID=YOUR_CONTAINERTYPE_ID
SPE_ENTRA_TENANT_ID=YOUR_ENTRA_TENANT_ID
安装包并启动开发服务器。
npm install
npm run dev
Webpack 完成后,打开 http://localhost:8080,使用租户凭据登录,并在出现提示时授予应用的管理员同意。 在另一个浏览器选项卡中打开相同的 URL,或将其发送给同一租户中的另一个用户。 对项目计数器的更改在连接的客户端之间同步。
如果无法登录示例或其显示空白页,请参阅重定向 URI 和 API 权限检查疑 难解答 。
确定哪些内容属于 Fluid
将 Fluid 用于受益于低延迟同步的协作应用程序状态。 将耐用文档和文件存储在 SharePoint Embedded 容器中。 当方案需要审核、保留、搜索或报告时,将最终业务输出保留到你自己的持久模型或 SharePoint 嵌入式文件。
将流畅的共享对象视为用户可见的协作状态。 不要将机密、访问令牌、SAS URL 或特权 Graph 响应放置在共享数据结构中。
处理标识和访问
应用仍需要 SharePoint Embedded 客户端 ID 和容器类型 ID 来获取正确的令牌和访问容器。 使用一个选项卡、同一用户的两个选项卡以及租户中的两个不同用户来测试示例。 验证可以查看容器但不应编辑协作状态的用户的行为。
从示例转移到应用设计
使用项目计数器示例证明租户设置、许可和客户端连接。 在你自己的应用中,为用户放弃的协作会话规划重新连接行为、令牌刷新、脱机转换、容器切换和清理。