سرویس ویدیو یک فایل چندرسانهای را از استوریج میخواند، به کیفیتها و قالبهای مختلف تبدیل میکند و خروجی را دوباره در استوریج مینویسد. پلیلیست 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 | استریم ورودی در حال دانلود است. |
| درحال Transcode | Transcoding | تبدیل در حال انجام است؛ پیشرفت قابل مشاهده است. |
| در حال آپلود | 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 | پیشفرض: ۵ روز پس از شکست نهایی |
پاکسازی فهرست
این زمانها پیشفرض پاکسازی رکوردهای نهایی هستند و اجرای دورهای پاکسازی ممکن است حذف را به تاخیر بیندازد. فایلهای خروجی در استوریج پاک نمیشوند.
