التضمين
ضع فيديوهاتك وأداة البحث على موقعك بإطار iframe جاهز أو برموز OTP من خادمك.
صفحة الواجهة البرمجية والتضمين هي حيث تختار كيف يحمّل موقعك فيديوهات المكتبة. افتحها من الشريط الجانبي للمكتبة: المكتبات ← مكتبتك ← الواجهة البرمجية والتضمين.
النطاقات المسموحة أولًا
يعرض شريط في أعلى الصفحة النطاقات التي تعمل عليها التضمينات. إذا نبّهك إلى أن أي موقع يمكنه تشغيل فيديوهاتك، فاختر اضبط النطاقات المسموح بها وأضف موقعك قبل أي تضمين. يفتح أدِرها في الأمان القائمة الكاملة. اقرأ النطاقات المسموحة.
اختر طريقة
تعرض الصفحة ثلاث طرق:
- التضمين السريع (إطار iframe، صفحة HTML ثابتة): سطر HTML واحد، بلا حاجة إلى خادم أو مفتاح.
- الخادم المخصّص (PHP، Node.js، Python، cURL): يطلب خادمك رمز OTP لكل مشاهد.
- أداة البحث (بحث بالذكاء الاصطناعي، إطار iframe): مربع بحث في الكلام المنطوق في فيديوهاتك.
للفيديوهات، اختر بين الطريقتين الأوليين:
| التضمين السريع | الخادم المخصّص | |
|---|---|---|
| الحاجة إلى خادم | لا: الصق إطار iframe في أي صفحة. | نعم: يستدعي خادمك واجهة أوكتا فيديو البرمجية. |
| رمز OTP | رمز واحد يشترك فيه كل الزوّار، صالح لشهر واحد. | رمز جديد لكل مشاهد ولكل مشاهدة للصفحة. |
| قواعد الأمان | مربوط بفيديو واحد وبنطاقاتك المسموحة. | تنطبق كل قواعد OTP: نافذة الصلاحية، وطول الجلسة، وربط عنوان IP، والاستخدام الواحد. |
| عدّ كل مشاهد والعلامة المائية | لا: الزوّار مجهولون. | نعم: أرسل user_id لكل مشاهد. |
| الأنسب لـ | المعاينات العامة والصفحات التعريفية والتجربة. | الدورات المدفوعة وأي محتوى يتطلب تسجيل الدخول. |
التضمين السريع
اختر فيديو. اكتب للبحث في فيديوهاتك الجاهزة واختر واحدًا. لا تظهر هنا الفيديوهات التي ما زالت قيد الترميز.
أين يمكن تشغيله. لا يعمل الإطار إلا على نطاقاتك المسموحة، فأضف نطاقًا واحدًا على الأقل. النطاقات التي تضيفها أو تزيلها هنا تُحفظ في قائمة المكتبة، وتُسأل قبل إزالة أي منها.
أنشئ إطار iframe. تعرض النافذة الكود. اختر انسخ إطار iframe والصقه حيث تريد أن يظهر الفيديو في صفحتك.
<iframe src="https://player.octavideo.tech/embed/LIBRARY_ID/VIDEO_ID?otp=OTP"
style="border:0;width:100%;aspect-ratio:16/9"
allow="encrypted-media; fullscreen" allowfullscreen></iframe>يأخذ المشغّل عرض الحاوية ويحافظ على نسبة 16:9، فتحدّد صفحتك الحجم.
يمكنك أيضًا الحصول على الكود من صفحة تفاصيل الفيديو: اختر احصل على كود التضمين، ثم احصل على iframe لهذا الفيديو.
أكواد التضمين
يظهر كل كود تنشئه تحت أكواد التضمين مع تاريخ انتهاء صلاحيته:
- اعرض الكود: يعرض الإطار مرة أخرى لنسخه.
- مدّد شهرًا: يُبقي الكود صالحًا شهرًا آخر. لا يتغيّر الكود نفسه، فلا حاجة إلى تعديل صفحتك.
- إلغاء…: يوقف تشغيل الكود بعد التأكيد.
يتوقف كود التضمين السريع عن التشغيل عند انتهاء صلاحيته. تنبّهك لوحة المستخدم إلى المكتبات التي تنتهي صلاحية أكواد تضمينها قريبًا أو انتهت؛ مدّدها قبل ذلك.
الخادم المخصّص
مع الخادم المخصّص، يطلب خادمك كلمة مرور لمرة واحدة (OTP) من واجهة أوكتا فيديو البرمجية في كل مرة يفتح فيها مشاهد مسجَّل الدخول صفحة فيديو، ثم يضعها في الإطار. هذه أكثر طرق التضمين أمانًا.
المفتاح الخاص
تعرض بطاقة المفتاح الخاص مفتاح المكتبة مخفيًا. يرسله خادمك مع كل طلب إلى الواجهة البرمجية.
- انسخ يضع المفتاح في الحافظة. إذا منع المتصفح النسخ، تخبرك لوحة التحكم بذلك ولا تعرض المفتاح نصًا أبدًا.
- أعد إنشاء المفتاح… ينشئ مفتاحًا جديدًا بعد تحذير. يتوقف المفتاح القديم عن العمل، فانسخ الجديد وحدّث خادمك فورًا.
أبقِ المفتاح على خادمك
يستطيع المفتاح الخاص طلب رموز OTP لكل فيديوهات المكتبة. احفظه في متغيّرات بيئة خادمك، ولا تضعه أبدًا في صفحة ويب أو تطبيق أو مستودع كود.
اطلب رمز OTP
يستدعي خادمك POST /playback/otp بمعرّف الفيديو وuser_id للمشاهد، ثم يكتب embed_url المُعاد (أو رمز OTP) في الصفحة:
<iframe src="EMBED_URL_FROM_YOUR_SERVER"
style="border:0;width:100%;aspect-ratio:16/9"
allow="encrypted-media; fullscreen" allowfullscreen></iframe>يشرح التشغيل الآمن الطلب خطوة بخطوة بـ cURL وNode.js وPHP وPython.
العلامة المائية للمستخدم
مفتاح العلامة المائية للمستخدم ونصّها في هذه الصفحة هما الإعداد نفسه الموجود في الأمان ← حماية المحتوى. اقرأ العلامة المائية للمستخدم.
أداة البحث
- اضبط الأداة أولًا من صفحة أداة البحث. اقرأ أداة البحث.
- من أداة البحث في هذه الصفحة، اختر الأداة من اختر أداة.
- اختر أنشئ إطار iframe للأداة، وانسخ الكود والصقه حيث تريد أن يظهر البحث في صفحتك.
تظهر أكواد الأداة تحت أكواد تضمين الأداة، مع إجراءات اعرض الكود ومدّد شهرًا وإلغاء… نفسها التي لأكواد الفيديو.
تستخدم خادمك الخاص؟ انسخ معرّف الأداة من صفحة أداة البحث. يطلب خادمك رمز OTP للأداة بالطريقة نفسها التي يطلبه بها لفيديو، ثم يضعه في إطار iframe الخاص بالأداة. اقرأ التشغيل الآمن.