سرویس ویدیو یک فایل چندرسانه‌ای را از استوریج می‌خواند، به کیفیت‌ها و قالب‌های مختلف تبدیل می‌کند و خروجی را دوباره در استوریج می‌نویسد. پلی‌لیست HLS برای پخش تطبیقی از CDN قابل دریافت است.

برای اولین ترنسکد، اولین ویدیو را با سرویس ویدیو ترنسکد کنید را دنبال می‌کنیم.

محدودیت ورودی

عرض و ارتفاع استریم ویدیوی ورودی:

محدودیتمقدار
ضلع بزرگ‌ترحداکثر ۳۸۴۰ پیکسل
ضلع کوچک‌ترحداکثر ۲۱۶۰ پیکسل

با این محدودیت، ورودی و خروجی تا ابعاد 3840×2160 (portrait و landscape) پشتیبانی می‌شود.

گزینه‌های فرم ترنسکد

گزینهتوضیح
نامشناسه رکورد ترنسکد و نام پلی‌لیست؛ نام فقط حروف کوچک انگلیسی، عدد و خط فاصله (-) است و باید با حرف کوچک انگلیسی شروع شود؛ مثلا first-video.
ویدیو ورودیمسیر فایل ورودی در باکت سرویس استوریج (مثلا videos/sample.mp4).
نادیده گرفتن خطاهای رمزگشایی ورودیادامه‌ی تبدیل فایل معیوب تا حد امکان؛ پیش‌فرض خاموش است. جزئیات رفتار و هشدارها در بخش بعد آمده است.
محل ذخیره ویدیو خروجیمسیر پیشوند فایل‌های خروجی در سرویس استوریج. اگر مسیر تکراری بگذاریم، خروجی ترنسکد جدید روی قبلی نوشته می‌شود.
فرمت خروجیفقط HLS (پیشنهاد برای استریم) یا HLS به همراه MP4 (برای دانلود روی دستگاه‌های قدیمی).
کیفیت‌های خروجییکی یا چند مورد از 360p، 480p، 720p، 1080p و 4k (مقدار API: 2160).
کدک خروجیH264 (AVC) یا H265 (HEVC).
ایجاد Thumbnailاگر روشن باشد، Thumbnailها در بازه‌های زمانی از ویدیو ساخته می‌شود.
اضافه کردن زیرنویسفایل زیرنویس از باکت استوریج، از جمله .srt، .vtt و .ass.
اضافه کردن دوبلهفایل صوتی از باکت استوریج، از جمله .mp3، .wav و .aac.

نادیده گرفتن خطاهای رمزگشایی ورودی

گزینه‌ی «نادیده گرفتن خطاهای رمزگشایی ورودی» به‌صورت پیش‌فرض خاموش است. با فعال شدن آن، تبدیل فایل دارای خطای رمزگشایی تا حد امکان ادامه می‌یابد. این گزینه فایل اصلی را تعمیر نمی‌کند؛ ممکن است بخشی از صدا یا تصویر حذف یا مخفی شود و مدت خروجی تغییر کند.

در API، این گزینه با فیلد اختیاری spec.input.ignoreDecodeErrors تنظیم می‌شود:

spec:
  input:
    ignoreDecodeErrors: true

نبودن فیلد یا مقدار false، رفتار پیش‌فرض تشخیص خطا را حفظ می‌کند. گزینه‌های رمزگشایی فقط برای ورودی اصلی تغییر می‌کنند؛ در این حالت، پیام‌های خطای فرایند به‌تنهایی باعث شکست جاب نمی‌شوند. شکست اجرای فرایند تبدیل، خطای خواندن پیام‌های آن و خطاهای پردازش یا ذخیره‌ی خروجی همچنان می‌توانند جاب را ناموفق کنند.

بررسی خروجی

فعال بودن این گزینه تضمین نمی‌کند که همه‌ی صداها، تصاویر یا مدت فایل اصلی در خروجی حفظ شوند. پس از اتمام، پخش خروجی، صدا و مدت آن را بررسی می‌کنیم.

وضعیت ترنسکد

عنوان در پنلمقدار APIمعنی
—Scheduledجاب زمان‌بندی شده و به‌زودی شروع می‌شود.
در حال آماده‌سازیPreparingمقدمات قبل از دانلود در حال اجراست.
درحال دانلودDownloadingاستریم ورودی در حال دانلود است.
درحال TranscodeTranscodingتبدیل در حال انجام است؛ پیشرفت قابل مشاهده است.
در حال آپلودUploadingخروجی در حال آپلود در استوریج است.
تکمیل شدهCompletedتبدیل و آپلود خروجی تمام شده؛ لینک CDN در دسترس است.
ناموفقFailedتبدیل ناموفق؛ علت در پیام وضعیت می‌آید.

در حالت Completed، لینک خروجی‌ها روی ردیف همان ویدیو در فهرست قابل دریافت است.

پیام‌ها، خطاها و هشدارها

دکمه‌ی «جزئیات وضعیت» در ردیف ویدیو، پیام فعلی و خطای ثبت‌شده از تلاش قبلی را در بخش‌های جداگانه نشان می‌دهد. وجود خطای تلاش قبلی به‌تنهایی به معنی شکست تلاش فعلی نیست.

فیلد APIمعنی
status.messageپیام وضعیت فعلی؛ در شکست شامل شرح خطا و در تکمیل همراه هشدار شامل هشدارهای خروجی است.
status.lastErrorخطای ثبت‌شده از تلاش قبلی که هنگام زمان‌بندی مجدد حفظ می‌شود.

پیام خطای تبدیل، آخرین زمان گزارش‌شده از ویدیو را نیز دارد؛ برای نمونه last reported video time: 00:08:36.65. این مقدار زمان سپری‌شده‌ی اجرای جاب نیست و فریم یا بسته‌ی معیوب را دقیقا مشخص نمی‌کند. پیش از اولین گزارش پیشرفت، مقدار آن unavailable است.

در حالت نادیده گرفتن خطاها، هشدارها در status.message باقی می‌مانند و وضعیت API همچنان Completed است. پنل این حالت را «تکمیل شده با هشدار» نشان می‌دهد. پیام می‌تواند شامل تعداد خطاهای نادیده‌گرفته‌شده و حداکثر سه نمونه از آن‌ها باشد؛ متن هر نمونه به یک کیبی‌بایت محدود است.

اگر اختلاف آخرین زمان معتبر گزارش‌شده از ویدیو با مدت ورودی بیش از پنج ثانیه باشد، هشدار مدت به پیام اضافه می‌شود. این بررسی برای خروجی‌های دارای پلی‌لیست و بدون پلی‌لیست انجام می‌شود و تقریبی است؛ مدت تک‌تک فایل‌ها یا ترک‌های صدا و تصویر را تایید نمی‌کند. اگر زمان معتبر یا مدت ورودی معتبر در دسترس نباشد، این مقایسه انجام نمی‌شود. بررسی مدت پلی‌لیست نیز در این حالت اختلاف بیش از پنج ثانیه را به‌صورت هشدار گزارش می‌کند؛ با خاموش بودن گزینه، همان اختلاف پلی‌لیست باعث شکست جاب می‌شود.

هشدار تکمیل، status.lastError را تغییر نمی‌دهد و باعث تلاش مجدد خودکار نمی‌شود. «تکمیل شده» بدون هشدار نیز جای بررسی پخش خروجی را نمی‌گیرد.

پاک‌سازی خودکار رکورد

پاک‌سازی فقط رکورد ترنسکد را از فهرست برمی‌دارد؛ فایل‌های خروجی در استوریج می‌مانند. ترنسکدهای در حال پردازش حذف نمی‌شوند.

وضعیتمدت نگهداری در فهرست
Completedپیش‌فرض: ۱ ساعت پس از اتمام
Failedپیش‌فرض: ۵ روز پس از شکست نهایی

پاک‌سازی فهرست

این زمان‌ها پیش‌فرض پاک‌سازی رکوردهای نهایی هستند و اجرای دوره‌ای پاک‌سازی ممکن است حذف را به تاخیر بیندازد. فایل‌های خروجی در استوریج پاک نمی‌شوند.

ادامه مسیر