下面列出了 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 函数自动在特定页面上打开图书查看器。
与 Books API 和 Dynamic Links 结合使用
构建高级应用时,建议您将 嵌入式查看器 API 与 Books API 或 Dynamic Links 功能结合使用。例如,您可以提前知道是否特定预览可用于嵌入(例如,确定是否为用户提供在您的网站上打开预览窗口的选项)。或者,您可能不知道某本图书的标识符,而是想先使用 Books API “查找”该图书。以下示例展示了如何执行这些操作。
- book-dynamiclinks-zippy
在这里,我们首先检查图书是否可以嵌入。当且仅当该图书可供预览时,我们才会呈现“预览 zippy”,当用户点击它时,系统会显示内嵌的图书预览。 - booksapi-titlesearch
在此示例中,您只需输入图书的搜索查询,即可打开嵌入式查看器。它会自动显示您输入的查询的第一个可嵌入结果。此 API 使用 Data API 的 JSON 输出格式访问搜索结果。