كود ويدجت الفيديو: كيف تصل مهام الفيديو في الخلفية إلى زوارك
يستغرق توليد الفيديو دقائق لا ثوانٍ. يشرح هذا الدليل ما يحدث خلف كود ويدجت الفيديو، من الطلب الأول إلى المقطع النهائي، وما يراه زوارك خلال ذلك.
تاريخ النشر:
تُعرض إجابة الدردشة خلال ثوانٍ، أما الفيديو المولّد فقد يستغرق بضع دقائق. صُمم ويدجت الفيديو حول هذا الفرق، فيحصل زوارك على تجربة واضحة ويبقى حسابك محميًا أثناء تنفيذ المهمة.
سطر الكود الواحد نفسه
تستخدم كل أنواع الويدجت كود التضمين نفسه:
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
الفرق على الخادم. عندما يكون نوع الويدجت فيديو، يبدأ وصف الزائر مهمة بدلًا من إعادة نتيجة فورية.
خطوة بخطوة
- يرسل الزائر وصفًا. يذهب الطلب إلى api14 مع معرّف الويدجت. يتحقق الخادم من أن الصفحة على أحد مواقعك المسموح بها، ويطبّق حدودك، ويبدأ المهمة بالنموذج الذي اخترته.
- يعود معرّف المهمة. يُظهر الويدجت أنه يعمل. معرّف المهمة مرتبط بالويدجت الخاص بك: لا يستطيع ويدجت آخر، ولا أي شخص يخمّن المعرّفات، قراءته.
- يتحقق الويدجت من الحالة. كل بضع ثوانٍ يسأل ما إذا كان الفيديو جاهزًا. تخضع هذه الاستعلامات لحد معدل منفصل عن الأوصاف الجديدة، فلا تستهلك المهمة الطويلة حصة طلبات الزائر.
- يُشغَّل الفيديو. عند اكتمال المهمة، ينزّل الويدجت المقطع ويشغّله ويعرض رابط تنزيل.
إذا فشل التوليد، يرى الزائر رسالة الخطأ الخاصة بك (أو رسالة افتراضية محايدة)، ويظهر السبب في قائمة الأدوات لديك لتتمكن من إصلاحه.
ما الذي تتحكم فيه
- النموذج: يُختار في الأدوات المضمّنة. يطلب الويدجت المدة المدعومة الأقرب إلى 5 ثوانٍ والدقة الأقرب إلى 720p، فتبقى تكلفة المقطع قابلة للتوقع.
- مفتاح API: يعمل كل ويدجت تحت أحد مفاتيح API الخاصة بك، ويُختار في المحرر. تنتهي القائمة بخيار إنشاء مفتاح API جديد. تُسجَّل المهام تحت ذلك المفتاح وتنطبق عليها حدوده.
- المظهر: العنوان والنصوص ولون التمييز والسمة واستدارة الزوايا والموضع. الويدجت خالٍ من أي علامة تجارية.
لا يرى زوارك التفاصيل الداخلية أبدًا
لا يرى الزائر سوى نصوصك وحالة التقدم والفيديو النهائي. أما تعليماتك ورصيدك ومفتاح API والأخطاء الخام الصادرة عن المزوّد، فتبقى كلها على الخادم.
المراقبة
تعرض قائمة الأدوات آخر استخدام وإنفاق اليوم وآخر خطأ لكل ويدجت. وتجمّع صفحة الاستخدام الطلبات حسب الويدجت أو الموقع، وتخبرك رسائل البريد عند التعطل بالمشكلات التي يمكنك إصلاحها، مثل نفاد الرصيد أو إزالة نموذج.
اعرف المزيد عن نماذج الفيديو في وثائق الفيديو وصمّم الويدجت في صفحة الويدجت.