例とデモ

Embedded Viewer API ドキュメント セットに含まれるすべての例は、簡単に参照できるようにまとめられています。さらに、高度なコンセプトを説明するデモも多数含まれています。

デベロッパー ガイドの例

デベロッパー ガイドにはこれらの基本的な例が掲載されており、Embedded Viewer API の一般的な用途について説明しています。

  • book-simple
    Embedded Viewer API の「Hello, World」の例では、API を読み込んで特定の書籍のビューアを描画する方法を示しています。
  • book-language
    次の例は、閲覧者のインターフェース言語(この場合はブラジル ポルトガル語)を変更する方法を示しています。
  • book-notfound
    これは、閲覧者が指定された書籍を読み込めなかったときに呼び出されるコールバック関数の追加方法を示しています。この例を基にして、このような条件を適切に処理できます。
  • book-success
    これは、閲覧者が書籍で正常に初期化され、プログラムによる操作の準備が整ったときに呼び出されるコールバック関数の追加方法を示しています。
  • book-Animation
    JavaScript を使用してプログラムによってビューアがどのように制御されるかを説明するため、3 秒ごとに自動的に次のページに切り替わるプレビューが表示されます。

プログラムによる閲覧者の制御

ビューアでは、ビューアを操作してユーザーが実行できるほぼすべての操作を行うことができます。以下の例は、これがどのように役立つかを示しています。

  • book-interactions-controls
    この実用的な例では、ズーム、nextPage、goToPage、ハイライト表示機能など、ビューアでサポートされているすべてのインタラクション方法を列挙しています。
  • book-interactions-openatpage
    コールバックと goToPage 関数を使用して、特定のページで書籍ビューアを自動的に開く方法を示します。

高度なアプリケーションを構築する場合は、Embedded Viewer API を Books API または Dynamic Links 機能と組み合わせると便利です。たとえば、特定のプレビューが埋め込み可能かどうかを事前に把握しておくと便利です(サイトでプレビュー ウィンドウを開くオプションをユーザーに提供するかどうかを指定する場合など)。特定の書籍の ID がわからない場合には、まず Books API を使用して「検索」する必要があります。以下の例は、これらの操作の実行方法を示しています。

  • book-dynamiclinks-zippy
    最初に、書籍が埋め込みが可能なかどうかをチェックします。利用可能な場合にのみ、「preview zippy」を表示します。これをクリックすると、書籍のプレビューがインライン表示されます。
  • booksapi-titlesearch
    この例では、書籍の検索クエリを入力するだけで埋め込みビューアを開くことができます。入力したクエリの最初の埋め込み可能な結果が自動的に表示されます。Data API の JSON 出力形式を使用して検索結果にアクセスします。