# Univer Slides 简介

> Univer Slides 提供 Univer Office SDK 中的演示文稿编辑产品能力。

- Human documentation: [https://docs.univer.ai/zh-CN/guides/slides](https://docs.univer.ai/zh-CN/guides/slides)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/slides.md](https://docs.univer.ai/zh-CN/guides/slides.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [slides/index.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/slides/index.zh-CN.mdx)

---

## Univer Slides 是什么

Univer Slides 是 Univer Office SDK 中的演示文稿产品能力。它用于构建幻灯片编辑器、播放视图、导入导出流程，以及基于 Web SDK runtime 的服务端幻灯片处理能力。

Univer Office SDK 包含三个 SDK：[Web SDK](https://docs.univer.ai/zh-CN/guides/sheets.md) 提供嵌入式编辑器和无头内容处理能力，[Server SDK](https://docs.univer.ai/zh-CN/server.md) 提供协同与文件导入导出能力，[AI SDK](https://docs.univer.ai/zh-CN/ai.md) 提供 Agent 工作流能力。

Slides 是独立的 Web SDK unit type。运行时需要创建 `UniverInstanceType.UNIVER_SLIDE` unit，然后按需注册 侧的模型、UI 和可选功能插件。

> [!INFO]
> Univer Slides 现在位于 `@univerjs-pro` 包作用域下。集成前请先阅读 [Server SDK](https://docs.univer.ai/zh-CN/server.md) 中的授权和部署说明。

## 浏览器兼容性

Web SDK 的编译目标是 Chrome 88，但这并不意味着 Web SDK 能够完全支持所有主流环境。我们会尽力确保 Web SDK 在以下浏览器和 Node.js 环境中能够正常运行：

| Edge | Firefox | Chrome | Safari | Electron |
| ---- | ------- | ------ | ------ | -------- |
| >=88 | >=90    | >=88   | >=14.1 | >=12     |

> [!WARNING]
> Web SDK 依赖 `Intl.Segmenter`，如果你的浏览器或运行时环境暂不支持它，请先补充对应的 polyfill。我们推荐使用
> `@formatjs/intl-segmenter`。

如果遇到无法兼容的情况，请先借助对应的 polyfill 来解决，如果仍然无法解决，请[提交 issue](https://github.com/dream-num/univer/issues/new/choose)。

## Node.js 兼容性

> [!WARNING]
> 以下仅适用于在 Node.js 环境中运行 Web SDK 的情况，并不适用于那些基于 Node.js 使用构建工具在浏览器中运行 Web SDK 的情况。

Web SDK 可以在 Node.js 环境中运行，支持的版本为 v18.17.0 及之后的版本。

## 主要功能

* **演示文稿模型**：管理演示文稿标识、页面尺寸、幻灯片顺序、幻灯片、母版页、版式页、主题、切换效果和资源。
* **渲染与编辑**：提供幻灯片画布、缩略图、选择、剪贴板、文本与形状编辑、对齐参考线和放映能力。
* **命令管线**：通过命令和变更应用页面与元素更新，使模型、渲染以及撤销和重做保持同步。
* **Facade API**：通过面向应用的对象创建和查找演示文稿、保存快照，并操作幻灯片和元素。
* **插件架构**：表格、图表、打印和导入导出等可选功能与核心插件栈相互独立。

## 如何使用这些文档

在屏幕的左侧是文档导航栏。文档页面按从基础到高级的顺序组织，你可以按照这个顺序循序渐进地了解 Web SDK，或者跳到你感兴趣的章节。你还可以在侧边栏的顶部切换 Univer Slides 的文档。

屏幕的右侧是当前页面的大纲。如果你需要快速找到页面，可以使用顶部的搜索栏或搜索快捷键（Ctrl+K 或 Cmd+K）。

我们推荐从 [快速开始](https://docs.univer.ai/zh-CN/guides/slides/getting-started/installation.md) 出发了解 Web SDK。

## 前置知识

尽管我们已经尽力使得文档对新手也易于理解，但是我们必须假设你在开始阅读之前已经了解了一些基础知识，以便我们的文档可以专注于 Web SDK。

为了充分利用我们的文档，建议你对 JavaScript 及其生态系统有基本的了解。

如果你有兴趣在 Node.js 上运行 Web SDK，你还应该对 Node.js 有基本的了解。

如果你想尝试高级功能并部署 Univer Server，我们建议你对 Linux、Docker 和 Docker Compose（或 Kubernetes）有基本的了解。

## 扩展 Univer Slides

在设计之初，Web SDK 就被设计为高度可扩展的，因此你可以根据自己的需求来定制它。

- [快速开始](https://docs.univer.ai/zh-CN/guides/slides/getting-started/installation.md)

- [许可证配置](https://docs.univer.ai/zh-CN/guides/license.md)

- [功能一览](https://docs.univer.ai/zh-CN/guides/slides/features/core.md)

- [API 参考](https://docs.univer.ai/zh-CN/reference/classes/univer.md)
