示例和演示

下面列出了 Embedded Viewer API 文档集中的所有示例以供快速参考。此外，还提供了许多其他演示来阐明高级概念。

开发者指南中的示例

开发者指南中提供了这些基本示例，并介绍了 Embedded Viewer API 的最常见用途。

  • book-simple
    Embedded Viewer API 的“Hello, World”示例，此示例指明了如何加载该 API 并绘制特定图书的查看者。
  • book-language
    此示例展示了如何将查看者的界面语言（在本例中为巴西葡萄牙语）更改为该语言。
  • book-notfound
    此代码展示了如何添加在查看者无法加载指定图书时调用的回调函数。您可以基于此示例进行构建，以妥善处理此类情况。
  • book-success
    这展示了如何添加回调函数，当查看者已成功使用某本图书进行初始化并准备好通过编程方式操作时，系统会调用该函数。
  • book-Animated
    为了说明如何使用 JavaScript 以编程方式控制查看器，我们展示了预览，每 3 秒会自动翻到下一页。

对查看者进行程序化控制

通过查看器，您可以使用代码执行用户可通过与其互动所能做的几乎任何操作。以下示例展示了它可能有何帮助。

  • book-engagements-controls
    以下有效示例枚举了查看器支持的所有互动方法，包括缩放、nextPage、goToPage 和突出显示函数。
  • book-engagements-openatpage
    展示了如何使用回调和 goToPage 函数在特定页面上自动打开图书查看器。

构建高级应用时，您可能会发现将 Embedded Viewer API 与 Books API 或 Dynamic Links 功能结合使用会很有用。例如，提前了解特定预览是否可供嵌入（例如，确定是否为用户提供在您的网站上打开预览窗口的选项）可能很有用。或者，您可能不知道特定图书的标识符，但希望先使用 Books API 进行“查询”。以下示例说明了如何执行这些操作。

  • book-dynamiclinks-zippy
    在这里，我们先检查图书是否可嵌入。当且仅当可供图书阅读时，我们才会显示“预览 zippy”，当用户点击此 zippy 时，便会以内嵌方式显示图书预览。
  • booksapi-titlesearch
    在此示例中，您只需输入针对某本图书的搜索查询，即可打开嵌入式查看器。它会自动显示您输入的查询的第一个可嵌入结果。这使用 Data API 的 JSON 输出格式来访问搜索结果。