حالة المعالجة

بعد الرفع أو الاستيراد تعالج أوكتا فيديو الفيديو في الخلفية، وتتابع أنت المعالجة بقراءة الفيديو حتى تصبح حالته ready أو failed.

اقرأ الحالةنسخ رابط القسم

GET https://api.octavideo.tech/api/v1/videos/{videoId}
AccessKey: ovk_your_private_key

تخبرك ثلاثة حقول في الفيديو بمرحلة المعالجة:

{
  "data": {
    "id": "6f1c2b9e-4a7d-4f3e-9b8a-2d5c7e1f0a34",
    "library_id": "0b8e5d3a-1c2f-4e6a-8b7d-9f0a1b2c3d4e",
    "title": "Lesson 1: Introduction",
    "description": "",
    "encoding_status": "processing",
    "progress": 42,
    "stage": "transcode",
    "duration_seconds": 754.2,
    "size_bytes": 412337152,
    "chapters": [],
    "created_at": "2026-10-25T09:30:00Z"
  }
}

دورة الحالةنسخ رابط القسم

يُرمَّز الفيديو بإعدادات الترميز التي كانت في المكتبة لحظة دخوله قائمة الانتظار. تغيير إعدادات الترميز لاحقًا لا يغيّر الفيديوهات التي اكتملت معالجتها.

مراحل المعالجةنسخ رابط القسم

أثناء حالة processing يمر الفيديو بهذه المراحل بالترتيب، ولكل مرحلة حصة ثابتة من progress:

تستغرق مرحلة transcode معظم الوقت، ويطول وقتها كلما طال الفيديو أو زاد عدد النسخ.

استعلم حتى الجاهزيةنسخ رابط القسم

لتعرف أن الفيديو أصبح جاهزًا استخدم إشعارات webhooks (الخيار الموصى به) أو استعلم عن الفيديو نفسه. تنتظر دالة Node.js هذه الفيديو وتزيد المهلة بين كل استعلام والذي يليه:

const API = 'https://api.octavideo.tech/api/v1';
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

export async function waitUntilReady(videoId) {
  let delay = 10_000; // start at 10 s
  for (;;) {
    const res = await fetch(`${API}/videos/${videoId}`, {
      headers: { AccessKey: process.env.OCTAVIDEO_KEY },
    });
    if (!res.ok) throw new Error(`OctaVideo ${res.status}`);
    const { data: video } = await res.json();

    if (video.encoding_status === 'ready') return video;
    if (video.encoding_status === 'failed') {
      throw new Error(`Processing failed: ${video.failure_reason}`);
    }

    console.log(`${video.encoding_status} ${video.progress}% ${video.stage ?? ''}`);
    await sleep(delay);
    delay = Math.min(delay * 1.5, 30_000); // back off to 30 s
  }
}

• استعلم كل 10 إلى 30 ثانية، وزِد المهلة ما دام الفيديو في الانتظار أو قيد الترميز.
• توقّف فور أن تصبح الحالة ready أو failed.
• لمتابعة فيديوهات كثيرة، اعرضها عبر عرض الفيديوهات بدلًا من قراءة كل فيديو وحده. اقرأ الصفحات والحدود.

عند فشل المعالجةنسخ رابط القسم

تعيد أوكتا فيديو محاولة المرحلة الفاشلة تلقائيًا حتى 5 مرات بمهلة متزايدة، قبل أن تعلّم الفيديو failed. عندها يحمل failure_reason أحد هذه الرموز:

تعامل مع أي قيمة أخرى كما تتعامل مع processing_error.

ما تنتجه المعالجةنسخ رابط القسم

الفيديو الجاهز (ready) يتضمن:

• تدفق بث HLS وآخر DASH بكل النسخ، مشفّرَين. يختار المشغّل المناسب منهما لكل جهاز.
• صورة غلاف ومجموعة من الصور المصغّرة. تعيد عرض الصور المصغّرة للفيديو روابطها بعد انتهاء مرحلة الصور المصغّرة.
• مدته في duration_seconds.

الخطوة التاليةنسخ رابط القسم