範例和示範

下方列出 Embedded Viewer API 說明文件集中的所有範例,方便您快速參考。此外,我們也會加入一些額外的示範來說明進階概念。

開發人員指南中的範例

這些基本範例請參閱開發人員指南,並說明 Embedded Viewer API 的常見用途。

  • book-simple
    Embedded Viewer API 的「Hello, World」範例。此範例將示範如何載入 API,以及如何使用特定書籍繪製檢視器。
  • book-language
    這個範例說明如何變更觀眾的介面語言,本例中以巴西葡萄牙文為例。
  • book-notFound
    示範如何在檢視者無法載入指定書籍時呼叫回呼函式。以此範例為基礎,即可妥善處理這類情況。
  • book-success
    說明如何新增回呼函式,該函式會在觀眾成功完成書籍初始化後開始呼叫,並且準備透過程式進行操控。
  • book-animate
    為說明如何使用 JavaScript 以程式輔助方式控制檢視器,系統會顯示預覽畫面,每 3 秒自動切換至下一頁。

以程式輔助的方式控管觀眾

檢視工具可讓您使用與觀眾互動時幾乎可用的程式碼。以下舉例說明這項功能的實用之處。

  • book-interactions-controls
    這個工作範例列舉了觀眾支援的所有互動方法,包括 zoom、nextPage、goToPage 和 highlight 函式。
  • book-interactions-openatpage
    示範如何使用回呼和 goToPage 函式,自動在特定頁面上開啟書籍檢視器。

建構進階應用程式時,將嵌入式檢視者 API 與 Books APIDynamic Links 功能搭配使用可能會有所幫助。舉例來說,建議您事先瞭解是否有特定的預覽功能可嵌入 (例如,讓使用者能否在您的網站上開啟預覽視窗)。或者,您可能不知道特定書籍的識別碼,因此想要先使用 Books API 進行「查詢」。下列範例說明如何執行這些作業。

  • book-dynamiclinks-zippy
    這裡會先檢查書籍是否可嵌入。只有在書籍上架時,我們才會顯示「試閱版」,使用者只要按一下該按鈕,系統就會以內嵌方式顯示書籍預覽畫面。
  • booksapi-titlesearch
    這個例子可讓您輸入書籍的搜尋查詢來開啟嵌入式檢視器。所選查詢會自動顯示第一個可嵌入的搜尋結果。這會使用 Data API 的 JSON 輸出格式存取搜尋結果。