تم إدراج جميع الأمثلة الواردة في مجموعة وثائق واجهة برمجة التطبيقات للعارض المضمن أدناه للرجوع إليها بسرعة. بالإضافة إلى ذلك، يتم تضمين عدد من العروض التوضيحية الإضافية لتوضيح المفاهيم المتقدمة.
أمثلة من دليل المطوّر
تظهر هذه الأمثلة الأساسية في دليل المطوّر وتتناول الاستخدامات الأكثر شيوعًا لواجهة برمجة التطبيقات Include Viewer API.
- book-simple
يعرض مثال "Hello, World" لواجهة برمجة تطبيقات Include Viewer API، ويشير هذا المثال إلى كيفية تحميل واجهة برمجة التطبيقات ورسم مُشاهد باستخدام كتاب معيّن. - لغة الكتاب
يوضّح هذا المثال كيفية تغيير لغة واجهة المُشاهد، وهي في هذه الحالة اللغة البرتغالية البرازيلية. - book-notfound
يوضّح هذا كيفية إضافة دالة استدعاء يتم استدعاؤها عندما يتعذّر على المشاهد تحميل الكتاب المحدّد. يمكنك الاعتماد على هذا المثال للتعامل مع هذه الشروط بسلاسة. - book-success
توضح هذه المقالة كيفية إضافة دالة استدعاء يتم استدعاؤها عندما يبدأ المشاهد في إعداد أحد الكتب بنجاح ويكون جاهزًا لمعالجة البيانات بطريقة برمجية. - رسم متحرك على كتاب
لتوضيح كيفية التحكّم في المشاهد آليًا باستخدام JavaScript، يتم عرض معاينة تنتقل تلقائيًا إلى الصفحة التالية كل 3 ثوانٍ.
التحكم الآلي في العارض
يتيح لك المشاهد تنفيذ أي شيء تقريبًا يمكن للمستخدم القيام به من خلال التفاعل مع المشاهد باستخدام التعليمات البرمجية. توضّح الأمثلة أدناه مدى فائدة هذا الإجراء.
- book-interactions-controls
يلخص هذا المثال العملي جميع طرق التفاعل التي يوفّرها المشاهد، بما في ذلك وظائف التكبير/التصغير والصفحة التالية والانتقال إلى الصفحة والتمييز. - book-interactions-openatpage
يعرض كيفية فتح عارض كتب تلقائيًا على صفحة معيّنة باستخدام عمليات الاستدعاء ودالة goToPage.
عند الدمج مع واجهة برمجة تطبيقات "كتب Google" و"الروابط الديناميكية"
عند إنشاء تطبيقات متقدّمة، قد تجد أنه من المفيد دمج واجهة برمجة تطبيقات العرض المضمّن مع واجهة برمجة تطبيقات الكتب أو ميزة الروابط الديناميكية. على سبيل المثال، قد يكون من المفيد معرفة ما إذا كانت معاينة معيّنة ستكون متاحة للتضمين (على سبيل المثال، لتحديد ما إذا كان سيتم منح المستخدم خيار فتح نافذة معاينة على موقعك الإلكتروني). أو قد لا تعرف معرف كتاب معين، وتريد "البحث عنه" أولاً باستخدام واجهة برمجة تطبيقات الكتب. توضح الأمثلة التالية كيفية إجراء هذه العمليات.
- book-dynamiclinks-zippy
نتحقق هنا مما إذا كان الكتاب متاحًا للتضمين أولاً. إذا كان هذا الملف متوفرًا فقط، نعرض "رابط معاينة الكتاب"، والذي يؤدي النقر عليه إلى عرض معاينة الكتاب بشكل مضمّن. - booksapi-titlesearch
يتيح لك هذا المثال فتح عارض مضمّن من خلال إدخال طلب بحث عن كتاب. سيعرض تلقائيًا أول نتيجة قابلة للتضمين لطلب البحث الذي تدخله. يستخدم هذا تنسيق إخراج JSON من Data API للوصول إلى نتائج البحث.