InputMediaVideo

نشان‌دهنده یک ویدیو برای ارسال است.

📝 اسکیمای داده

فیلد	نوع	توضیحات
type	string	باید video باشد.
media	string	فایلی که باید ارسال شود و ۳ حالت میتواند داشته باشد۱) یک file_id را قرار دهید وارد کنید تا یک فایل که در سرورهای بله وجود دارد، ارسال شود (پیشنهادی) ۲) یک HTTP URL وارد کنید تا آن یک فایل را از اینترنت دریافت شود. ۳) عبارت “<attach://file_attach_name>” را وارد کنید تا یک فایل جدید با استفاده از multipart/form-data با نام <file_attach_name> آپلود شود.
thumbnail	InputFile, string	اختیاری. thumbnail فایلی که ارسال می‌شود؛ اگر تولید thumbnail برای ویدیو در سمت سرور پشتیبانی شود، می‌توان آن را نادیده گرفت. thumbnail باید با فرمت JPEG و حجم آن کمتر از ۲۰۰ کیلوبایت باشد. پهنا و ارتفاع thumbnail نباید بیشتر از ۳۲۰ باشد. اگر ویدیو با استفاده از multipart/form-data آپلود نشده باشد، نادیده گرفته می‌شود. thumbnailها را نمی‌توان مجدداً استفاده کرد و آن‌ها را فقط می‌توان به صورت یک فایل جدید آپلود کرد، بنابراین اگر thumbnail با استفاده از multipart/form-data با نام <file_attach_name> آپلود شده باشد، می‌توانید عبارت “<attach://<file_attach_name>” را وارد کنید.
caption	string	اختیاری. زیرنویس ویدیویی که باید ارسال شود، بین ۰ تا ۱۰۲۴ کاراکتر
width	Integer	اختیاری. پهنای تصویر ویدیو
height	Integer	اختیاری. ارتفاع تصویر ویدیو
duration	Integer	اختیاری. مدت زمان ویدیو (در واحد ثانیه)

⚙️ متد‌های دریافت

getType()

نوع رسانه را بازیابی می‌کند، که همیشه باید "ویدئو" را بازگرداند.

$type = $inputMediaVideoObject->getType();

getMedia()

فایل رسانه‌ای (چه file_id، URL HTTP، یا ارجاع attach) که قرار است ارسال شود را بازیابی می‌کند.

$media = $inputMediaVideoObject->getMedia();

getThumbnail()

تصویر بندانگشتی عکس ویدئو را بازیابی می‌کند. این می‌تواند یک file_id، URL HTTP، یا ارجاع attach باشد اگر با استفاده از multipart/form-data آپلود شده باشد.

$thumbnail = $inputMediaVideoObject->getThumbnail();

getCaption()

کپشن ویدئو که قرار است ارسال شود را بازیابی می‌کند. یک مقدار رشته‌ای (۰-۱۰۲۴ کاراکتر) را باز می‌گرداند.

$caption = $inputMediaVideoObject->getCaption();

getWidth()

عرض فایل ویدئو را بازیابی می‌کند. اگر تنظیم شده باشد، یک مقدار عدد صحیح را باز می‌گرداند.

$width = $inputMediaVideoObject->getWidth();

getHeight()

ارتفاع فایل ویدئو را بازیابی می‌کند. اگر تنظیم شده باشد، یک مقدار عدد صحیح را باز می‌گرداند.

$height = $inputMediaVideoObject->getHeight();

getDuration()

مدت زمان فایل ویدئو را به ثانیه بازیابی می‌کند.

$duration = $inputMediaVideoObject->getDuration();

➕ بیشتر

نکته

برای اطلاعات بیشتر، به مستندات رسمی بله مراجعه کنید.