示例和演示

下面列出了 Embed Viewer API 文档集中包含的所有示例,以方便您快速参考。此外,我们还会提供一些额外的演示内容来说明高级概念。

《开发者指南》中的示例

下面的基本示例显示在开发者指南中,并介绍了 Embed Viewer API 的最常见用途。

  • book-simple
    这是嵌入式查看器 API 的“Hello, World”示例,该示例展示了如何加载 API 以及如何使用特定图书绘制查看器。
  • book-language
    此示例展示了如何更改观看者的界面语言(在本例中为巴西葡萄牙语)。
  • book-not found
    此示例展示了如何添加回调函数,该函数在查看者无法加载指定图书时调用。您可以基于此示例构建,以妥善处理此类条件。
  • book-success
    此示例展示了如何添加回调函数,该函数会在查看者成功通过图书初始化且可供程序化操作时调用。
  • book-animate
    为了说明如何使用 JavaScript 以程序化方式控制查看器,我们展示了一个预览,预览时每隔 3 秒就会自动跳到下一页。

以程序化方式控制查看器

借助查看器,您可以通过与查看者互动来完成几乎所有用户可以执行的操作。以下示例展示了此操作的实用性。

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

构建高级应用时,建议您将 嵌入式查看器 API 与 Books APIDynamic Links 功能结合使用。例如,您可以提前知道是否特定预览可用于嵌入(例如,确定是否为用户提供在您的网站上打开预览窗口的选项)。或者,您可能不知道某本图书的标识符,而是想先使用 Books API “查找”该图书。以下示例展示了如何执行这些操作。

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