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