範例與示範

下方列出 Embedded Viewer API 說明文件集中的所有範例,可供您快速參考。除此之外,我們還有一些額外示範來說明進階概念。

開發人員指南中的範例

這些基本範例列載於開發人員指南中,並說明 Embedded Viewer API 的最常見用途。

  • book-simple
    對於嵌入式檢視器 API 中的「Hello, World」範例,這個範例說明如何載入 API 並繪製特定書籍的檢視器。
  • 書籍語言
    這個範例說明如何將檢視者的介面語言變更為巴西葡萄牙文。
  • book-notfound
    展示如何新增在檢視者無法載入指定書籍時呼叫的回呼函式。您可以參考本範例的建構方式,妥善處理這類情況。
  • 書籍成功
    展示如何新增回呼函式。當檢視者成功初始化書籍,且現在可以透過程式化操作時,系統會呼叫此回呼函式。
  • 書籍動畫
    為示範使用者如何透過 JavaScript 操控檢視器,系統會顯示預覽畫面,每隔 3 秒自動翻頁一次。

透過程式輔助方式控管觀眾

透過觀眾與觀眾互動,您幾乎可以執行任何程式碼。以下範例呈現了這項功能的實用程度。

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

建構進階應用程式時,建議您將 Embedded Viewer API 與 Books APIDynamic Links 功能結合使用。舉例來說,事先得知特定預覽功能是否支援嵌入 (例如,決定是否提供使用者在網站上開啟預覽視窗的選項),可能會很有幫助。或者,您可能不知道特定書籍的 ID,但想先使用 Books API 「查詢」。以下範例說明如何執行這些作業。

  • book-dynamiclinks-zippy
    我們會在此檢查書籍是否開放嵌入。假如系統有提供「預覽 zippy」功能,只要點選該選項,即可以內嵌方式預覽書籍預覽畫面。
  • booksapi-titlesearch
    這個範例可讓您透過輸入書籍搜尋查詢的方式開啟內嵌檢視器。系統會根據您輸入的查詢自動顯示第一項可嵌入的結果。這會使用 Data API 的 JSON 輸出格式存取搜尋結果。