将 Word Online 检测为 Office 加载项中的主机答案

【问题标题】：Detecting Word Online as the host inside Office Add-ins将 Word Online 检测为 Office 加载项中的主机
【发布时间】：2015-10-26 17:05:21
【问题描述】：

我在任务窗格应用程序中使用JavaScript API 的Settings 对象在文档中保存一些键值对。

我的代码是这样的

 Office.context.document.settings.set(key, value);
 Office.context.document.settings.saveAsync(function () {
        Toast.showToast("Setting saved", "Info saved into the document using saveAsync");
 });

我还在其上调用saveAsync 函数来保持值。

我面临的问题是设置没有保留在 Word Online 中，因为当前设置对象是 not supported in Word Online

那么有没有办法发现应用程序正在 Word Online 中运行，从而可以显示一条消息，或者可以使用 localStorage 或其他东西来保存值。

编辑：创建了一个用户语音请求以在 Word Online 中添加此功能，您可以支持此功能here

编辑 2

为了更好地解释问题并分享一个例子，我创建了一个示例插件，清单位于here。

您可以在此处键入键 test 的值并按保存，这会在内部调用位于 StorageLibrary.js 中的函数 saveToPropertyBag(key, value)。这个函数有上面提到的代码来保存设置，然后saveAsync被调用，所以值被保存在文档中。

现在您可以刷新浏览器或重新加载插件，然后按获取，该值将在 Excel 和 Powerpoint 中可用，但在 Word Online 中不可用。

所以我正在寻找一种方法来检测主机（Word Online），以便我可以回退到另一种方式来存储本地存储之类的值并向用户显示警告。

【问题讨论】：

标签： ms-office office-addins office-js

【解决方案1】：

查看我对Neat ways to get environment (i.e. Office version)的回复

基本上，你应该可以调用

if (Office.context.requirements.isSetSupported("Settings", 1.1)) {
    // Use Office settings
} else {
    // Fall back to local storage or something else.
}

~ 迈克尔·兹拉特科夫斯基
Microsoft Office 可扩展性团队的开发人员

【讨论】：

Office.context.requirements.isSetSupported("Settings", 1.1) 在 WordOnline 客户端中返回 true，尽管其中不支持设置
@Shiva，听到这个消息我非常非常惊讶。您能否描述“其中不支持设置”的确切含义。你想调用什么方法？我问的原因是，正如您在msdn.microsoft.com/en-us/library/office/dn535871.aspx 中看到的那样，设置要求集仅包括设置下的一些成员——即get、remove、saveAsync 和set。还有许多其他的——addHandlerAsync、refreshAsync 和 removeHandlerAsync，它们不是需求集的一部分，您需要以不同的方式检查它们。但是你打电话给哪一个？
在重新阅读您的问题时，听起来您只是想调用 saveAsync？这绝对应该得到支持（事实上，即使上面链接的 MSDN 文章也显示它支持 Word Online）。让我看看是不是bug...
@Shiva，好的，感谢您的澄清。这听起来像一个错误。我正在将其上报给我团队中合适的工程师。
此错误已修复；如果您在这里遇到更多问题，请告诉我们。谢谢！