تضمين الويبتون

للمطوّرين

إذا كانت خدمتك تدعم oEmbed، فيكفي رابط المنشور لعرض المشغّل.

نقطة نهاية oEmbed

مرّر عنوان المنشور في المعامل url. الصيغتان المتاحتان هما json و xml، وعند تمرير maxwidth و maxheight يصغر المشغّل مع الحفاظ على نسبته. وتتضمّن صفحات المنشورات وسوم link لاكتشاف oEmbed.

https://www.gentoon.ai/api/oembed

GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=json
GET https://www.gentoon.ai/api/oembed?url=https%3A%2F%2Fwww.gentoon.ai%2Fcommunity%2Fposts%2F9fa0016a-1192-4a72-afa8-d0ffad90c315&format=xml

رموز الاستجابة: 200 نجاح · 404 المنشور غير موجود، أو العنوان ليس عنوان منشور على GenToon · 401 المنشور موجود، لكن لا يمكن تضمينه (مثل المنشورات الخاصة أو المتاحة في التطبيق فقط) · 501 صيغة غير json و xml.

<iframe src="https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315" width="400" height="644" title="تضمين الويبتون · GenToon" frameborder="0" scrolling="no" loading="lazy" allow="clipboard-write; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen style="border:0;max-width:100%"></iframe>

عنوان المشغّل والمعاملات

https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315?hl=en&theme=dark&start=2&layout=scroll

hl

يثبّت لغة العرض (مثل en أو ja). وبدونه يتبع المشغّل لغة متصفّح القارئ.

theme

استخدم dark لعرض المشغّل بألوان داكنة.

start

يبدأ من اللقطة رقم N (يبدأ العدّ من 1).

layout

استخدم scroll لقراءة اللقطات متتابعة عموديًا. وبدونه يتصفّح القارئ اللقطات واحدة في كل مرة. ورمز التضمين عبر oEmbed يعرض دائمًا لقطة واحدة في كل مرة.

لا يظهر زر ملء الشاشة إلا إذا احتوى iframe على allowfullscreen (رمز التضمين لدينا يتضمّنه). يحذف WordPress هذه السمة، ولا يدعم Safari على iPhone ملء الشاشة، لذلك لا يظهر الزر هناك. ولا يظهر زر الترجمة المكتوبة (CC) إلا إذا اختلفت لغة القارئ عن لغة الحوار، وعند الضغط عليه يحمّل الترجمة مرة واحدة.

رسائل الارتفاع (postMessage)

يُبلغ المشغّل النافذة الأم عندما يتغيّر ارتفاعه. استمع إلى الرسائل أدناه واضبط ارتفاع iframe وفقًا لها.

{"type":"gentoon:embed:resize","postId":"9fa0016a-1192-4a72-afa8-d0ffad90c315","height":644}

JSON.stringify({"src":"https://www.gentoon.ai/embed/post/9fa0016a-1192-4a72-afa8-d0ffad90c315","context":"iframe.resize","height":644,"domains":"all"})

{"message":"height","value":644,"secret":"<secret>"}

لا تعيّن استجابات المشغّل أي ملفات تعريف ارتباط، وتحمل علامة noindex حتى لا تفهرسها محركات البحث.