下方列出 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 函式,在特定頁面中自動開啟書籍檢視器。
與 Books API 和 Dynamic Links 搭配使用
建構進階應用程式時,建議您將 Embedded Viewer API 與 Books API 或 Dynamic Links 功能結合使用。舉例來說,事先得知特定預覽功能是否支援嵌入 (例如,決定是否提供使用者在網站上開啟預覽視窗的選項),可能會很有幫助。或者,您可能不知道特定書籍的 ID,但想先使用 Books API 「查詢」。以下範例說明如何執行這些作業。
- book-dynamiclinks-zippy
我們會在此檢查書籍是否開放嵌入。假如系統有提供「預覽 zippy」功能,只要點選該選項,即可以內嵌方式預覽書籍預覽畫面。 - booksapi-titlesearch
這個範例可讓您透過輸入書籍搜尋查詢的方式開啟內嵌檢視器。系統會根據您輸入的查詢自動顯示第一項可嵌入的結果。這會使用 Data API 的 JSON 輸出格式存取搜尋結果。