همه نمونههای موجود در مجموعه مستندات Embedded Viewer API برای ارجاع سریع در زیر فهرست شدهاند. علاوه بر این، تعدادی دمو اضافی برای نشان دادن مفاهیم پیشرفته گنجانده شده است.
نمونه هایی از راهنمای برنامه نویس
این مثالهای اولیه در راهنمای توسعهدهنده ظاهر میشوند و رایجترین کاربردهای Embedded Viewer API را پوشش میدهند.
- کتاب ساده
مثال "Hello, World" از Embedded Viewer API، این مثال نحوه بارگیری API و ترسیم بیننده با یک کتاب خاص را نشان می دهد. - زبان کتاب
این مثال نحوه تغییر زبان رابط بیننده، در این مورد به پرتغالی برزیل را نشان می دهد. - کتاب یافت نشد
این نشان می دهد که چگونه می توان یک تابع تماس را اضافه کرد که زمانی فراخوانی می شود که بیننده نتواند کتاب مشخص شده را بارگیری کند. شما می توانید از این مثال استفاده کنید تا به خوبی چنین شرایطی را مدیریت کنید. - کتاب-موفقیت
این نشان میدهد که چگونه میتوان یک تابع تماس را اضافه کرد که زمانی فراخوانی میشود که بیننده با موفقیت یک کتاب را مقداردهی اولیه کند و آماده دستکاری برنامهای باشد. - کتاب - جاندار
برای نشان دادن اینکه چگونه میتوان بیننده را با استفاده از جاوا اسکریپت به صورت برنامهنویسی کنترل کرد، یک پیشنمایش نشان داده میشود که هر 3 ثانیه بهطور خودکار به صفحه بعدی باز میگردد.
کنترل برنامه ای بیننده
بیننده به شما امکان می دهد تقریباً هر کاری را که کاربر می تواند با تعامل با بیننده انجام دهد، با کد انجام دهید. مثالهای زیر نشان میدهند که چگونه این ممکن است مفید باشد.
- کتاب-تعامل-کنترل
این مثال کاری تمام روشهای تعاملی را که توسط بیننده پشتیبانی میشود، از جمله زوم، nextPage، goToPage و توابع برجسته کردن را برمیشمارد. - کتاب-تعامل-صفحه باز
نحوه باز کردن خودکار نمایشگر کتاب در یک صفحه خاص را با استفاده از تماسهای برگشتی و عملکرد goToPage نشان میدهد.
ترکیب با Books API و Dynamic Links
هنگام ساخت برنامه های پیشرفته، ممکن است ترکیب API نمایشگر جاسازی شده با ویژگی Books API یا Dynamic Links مفید باشد. به عنوان مثال، ممکن است از قبل دانستن اینکه آیا یک پیشنمایش خاص برای جاسازی در دسترس است یا خیر مفید باشد (مثلاً برای تعیین اینکه آیا به کاربر این امکان را میدهد که یک پنجره پیشنمایش در سایت شما باز کند یا خیر). یا ممکن است شناسه یک کتاب خاص را ندانید و بخواهید ابتدا با استفاده از Books API آن را جستجو کنید. مثال های زیر نحوه انجام این عملیات را نشان می دهد.
- book-dynamiclinks-zippy
در اینجا ابتدا بررسی می کنیم که آیا کتابی برای جاسازی در دسترس است یا خیر. اگر و فقط در صورت موجود باشد، یک "پیش نمایش فشرده" ارائه می کنیم، که با کلیک کردن، پیش نمایش کتاب را به صورت خطی نشان می دهد. - booksapi-titlesearch
این مثال به شما امکان میدهد تا با وارد کردن یک عبارت جستجو برای یک کتاب، یک نمایشگر تعبیهشده را باز کنید. به طور خودکار اولین نتیجه قابل جاسازی را برای درخواستی که وارد می کنید نشان می دهد. این از فرمت خروجی JSON Data API برای دسترسی به نتایج جستجو استفاده می کند.