PowerPoint JavaScript API 要求集

项目
03/29/2024

要求集是指各组已命名的 API 成员。 Office 加载项使用清单中指定的要求集或执行运行时检查，以确定 Office 应用程序是否支持加载项所需的 API。有关详细信息，请参阅 Office 版本和要求集。

下表列出了 PowerPoint 要求集、支持的 Office 客户端应用程序，以及这些应用程序（如果适用） 的最低 版本。

要求集	Windows 版 Office - Microsoft 365 订阅 - 零售永久 Office 2016 及更高版本	Windows 版 Office (批量许可的永久)	Mac 版 Office	iPad 版 Office	Office 网页版
预览	请使用最新的 Office 版本尝试预览版 API， (可能需要加入 Microsoft 365 预览体验计划) 。
PowerPointApi 1.5	版本 2208 (内部版本 15601.20230)	不可用	16.64.804.0	不可用	支持
PowerPointApi 1.4	版本 2207 (内部版本 15330.20122)	不可用	16.62	不可用	支持
PowerPointApi 1.3	版本 2111（内部版本 14701.20060）	不可用	16.55	不可用	支持
PowerPointApi 1.2	版本 2011（内部版本 13426.20184）	Office 2021：版本 2011 (内部版本 13426.20184)	16.43	不可用	支持
PowerPointApi 1.1	版本 1810（内部版本 11001.20074）	Office 2021：版本 1810 (内部版本 11001.20074)	16.19	2.17	支持

Office 版本和内部版本号

有关 Office 版本和内部版本号的详细信息，请参阅：

PowerPoint JavaScript API 1.1

PowerPoint JavaScript API 1.1 包含用于创建新演示文稿的单一 API。有关 API 的详细信息，请参阅创建演示文稿。

PowerPoint JavaScript API 1.2

PowerPoint JavaScript API 1.2 增加了对将其他 PowerPoint 演示文稿中的幻灯片插入当前演示文稿以及删除幻灯片的支持. 有关 API 的详细信息，请参阅在 PowerPoint 演示文稿中插入和删除幻灯片。

PowerPoint JavaScript API 1.3

PowerPoint JavaScript API 1.3 增加了对添加和删除幻灯片的额外支持。它还允许外接程序应用自定义元数据标记。有关 API 的详细信息，请参阅在 PowerPoint 中添加和删除幻灯片和在 PowerPoint 中为演示文稿、幻灯片和形状使用自定义标记。

PowerPoint JavaScript API 1.4

PowerPoint JavaScript API 1.4 添加了对添加、移动、调整大小、设置格式和删除形状的其他支持。有关使用这些 API 的详细信息，请参阅使用形状。

PowerPoint JavaScript API 1.5

PowerPoint JavaScript API 1.5 包括用于在演示文稿中选择幻灯片、文本范围和形状的 API。有关详细信息，请参阅 PowerPoint JavaScript API 要求集 1.5。

如何在运行时和清单中使用 PowerPoint 要求集

注意

本节假定你熟悉 Office 版本和要求集和指定 Office 应用程序和 API 要求集处的要求集概述。

要求集是指各组已命名的 API 成员。 Office 加载项可以执行运行时检查或使用清单中指定的要求集确定 Office 应用程序是否支持加载项所需的 API。

在运行时检查要求集支持

以下代码示例显示如何确定运行加载项的 Office 应用程序是否支持指定的 API 要求集。

if (Office.context.requirements.isSetSupported('PowerPointApi', '1.1')) {
  // Perform actions.
} else {
  // Provide alternate flow/logic.
}

在清单中定义要求集支持

可以在加载项清单中使用要求元素指定加载项要求激活的最小要求集和/或 API 方法。如果 Office 应用程序或平台不支持清单的 Requirements 元素中指定的要求集或 API 方法，则加载项将不会在该应用程序或平台中运行，也不会出现在“我的加载项”中显示的加载项列表中。如果你的加载项需要特定要求集以实现完整功能，但是即使在不支持该要求集的平台上也可以为用户提供值，则建议在运行时按照上述方式检查要求支持，而不是在清单中定义要求集支持。

以下代码示例显示加载项清单中的 Requirements 元素，该元素指定应在支持 PowerPointApi 要求集版本 1.1 或更高版本的所有 Office 客户端应用程序中加载该加载项。

<Requirements>
   <Sets DefaultMinVersion="1.1">
      <Set Name="PowerPointApi" MinVersion="1.1"/>
   </Sets>
</Requirements>

Office 通用 API 要求集

大多数 PowerPoint 加载项功能都来自通用 API 集。若要了解通用 API 要求集，请参阅 Office 通用 API 要求集。