InputMediaAnimation

نشان‌دهنده یک فایل انیمیشن است (ویدیو GIF یا H.264/MPEG-4 AVC بدون صدا) برای ارسال است.

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

فیلد	نوع	توضیحات
type	string	باید animation باشد.
media	string	فایلی که باید ارسال شود و ۳ حالت میتواند داشته باشد. ۱)یک file_id را وارد کنید تا یک فایل که در سرورهای بله وجود دارد، ارسال شود (پیشنهادی)، ۲) یک HTTP URL وارد کنید تا آن یک فایل را از اینترنت دریافت شود ۳) یا عبارت “<attach://file_attach_name>” را وارد کنید تا یک فایل جدید را با استفاده از multipart/form-data با نام <file_attach_name> آپلود شود کنید.
thumbnail	InputFile, string	اختیاری. thumbnail فایلی که ارسال شده است؛ اگر تولید تامبنیل برای فایل در سمت سرور پشتیبانی شود، می‌توان آن را نادیده گرفت. تامبنیل باید با فرمت JPEG و حجم آن کمتر از ۲۰۰ کیلوبایت باشد. پهنا و ارتفاع تامبنیل نباید بیشتر از ۳۲۰ باشد. اگر فایل با استفاده از 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 = $inputMediaAnimationObject->getType();

getMedia()

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

$media = $inputMediaAnimationObject->getMedia();

getThumbnail()

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

$thumbnail = $inputMediaAnimationObject->getThumbnail();

getCaption()

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

$caption = $inputMediaAnimationObject->getCaption();

getWidth()

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

$width = $inputMediaAnimationObject->getWidth();

getHeight()

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

$height = $inputMediaAnimationObject->getHeight();

getDuration()

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

$duration = $inputMediaAnimationObject->getDuration();

➕ بیشتر

نکته

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