أمثلة وعروض توضيحية

تم إدراج جميع الأمثلة الواردة في مجموعة وثائق واجهة برمجة التطبيقات للعارض المضمن أدناه للرجوع إليها بسرعة. بالإضافة إلى ذلك، يتم تضمين عدد من العروض التوضيحية الإضافية لتوضيح المفاهيم المتقدمة.

أمثلة من دليل المطوّر

تظهر هذه الأمثلة الأساسية في دليل المطوّر وتتناول الاستخدامات الأكثر شيوعًا لواجهة برمجة التطبيقات Include Viewer API.

  • book-simple
    يعرض مثال "Hello, World" لواجهة برمجة تطبيقات Include Viewer API، ويشير هذا المثال إلى كيفية تحميل واجهة برمجة التطبيقات ورسم مُشاهد باستخدام كتاب معيّن.
  • لغة الكتاب
    يوضّح هذا المثال كيفية تغيير لغة واجهة المُشاهد، وهي في هذه الحالة اللغة البرتغالية البرازيلية.
  • book-notfound
    يوضّح هذا كيفية إضافة دالة استدعاء يتم استدعاؤها عندما يتعذّر على المشاهد تحميل الكتاب المحدّد. يمكنك الاعتماد على هذا المثال للتعامل مع هذه الشروط بسلاسة.
  • book-success
    توضح هذه المقالة كيفية إضافة دالة استدعاء يتم استدعاؤها عندما يبدأ المشاهد في إعداد أحد الكتب بنجاح ويكون جاهزًا لمعالجة البيانات بطريقة برمجية.
  • رسم متحرك على كتاب
    لتوضيح كيفية التحكّم في المشاهد آليًا باستخدام JavaScript، يتم عرض معاينة تنتقل تلقائيًا إلى الصفحة التالية كل 3 ثوانٍ.

التحكم الآلي في العارض

يتيح لك المشاهد تنفيذ أي شيء تقريبًا يمكن للمستخدم القيام به من خلال التفاعل مع المشاهد باستخدام التعليمات البرمجية. توضّح الأمثلة أدناه مدى فائدة هذا الإجراء.

  • book-interactions-controls
    يلخص هذا المثال العملي جميع طرق التفاعل التي يوفّرها المشاهد، بما في ذلك وظائف التكبير/التصغير والصفحة التالية والانتقال إلى الصفحة والتمييز.
  • book-interactions-openatpage
    يعرض كيفية فتح عارض كتب تلقائيًا على صفحة معيّنة باستخدام عمليات الاستدعاء ودالة goToPage.

عند إنشاء تطبيقات متقدّمة، قد تجد أنه من المفيد دمج واجهة برمجة تطبيقات العرض المضمّن مع واجهة برمجة تطبيقات الكتب أو ميزة الروابط الديناميكية. على سبيل المثال، قد يكون من المفيد معرفة ما إذا كانت معاينة معيّنة ستكون متاحة للتضمين (على سبيل المثال، لتحديد ما إذا كان سيتم منح المستخدم خيار فتح نافذة معاينة على موقعك الإلكتروني). أو قد لا تعرف معرف كتاب معين، وتريد "البحث عنه" أولاً باستخدام واجهة برمجة تطبيقات الكتب. توضح الأمثلة التالية كيفية إجراء هذه العمليات.

  • book-dynamiclinks-zippy
    نتحقق هنا مما إذا كان الكتاب متاحًا للتضمين أولاً. إذا كان هذا الملف متوفرًا فقط، نعرض "رابط معاينة الكتاب"، والذي يؤدي النقر عليه إلى عرض معاينة الكتاب بشكل مضمّن.
  • booksapi-titlesearch
    يتيح لك هذا المثال فتح عارض مضمّن من خلال إدخال طلب بحث عن كتاب. سيعرض تلقائيًا أول نتيجة قابلة للتضمين لطلب البحث الذي تدخله. يستخدم هذا تنسيق إخراج JSON من Data API للوصول إلى نتائج البحث.