InputMediaAudio
نشان‌دهنده یک فایل صوتی برای ارسال است. این فایل به صورت یک موسیقی در نظر گرفته می‌شود.
📝 اسکیمای داده
| فیلد | نوع | توضیحات |
|---|---|---|
type | string | نشان‌دهنده یک فایل صوتی برای ارس ال است. این فایل به صورت یک موسیقی در نظر گرفته می‌شود. |
media | string | فایلی که باید ارسال شود و ۳ حالت میتواند داشته باشد. ۱)یک file_id را وارد کنید تا یک فایل که در سرورهای بله وجود دارد، ارسال شود (پیشنهادی)، ۲) یک HTTP URL وارد کنید تا آن یک فایل را از اینترنت دریافت شود ۳) یا عبارت “<attach://file_attach_name>” را وارد کنید تا یک فایل جدید را با استفاده از multipart/form-data با نام <file_attach_name> آپلود شود کنید. |
thumbnail | string | اختیاری. thumbnail فایلی که ارسال شده است؛ اگر تولید thumbnail برای فایل در سمت سرور پشتیبانی شود، می‌توان آن را نادیده گرفت. تامبنیل باید با فرمت JPEG و حجم آن کمتر از ۲۰۰ کیلوبایت باشد. پهنا و ارتفاع تامبنیل نباید بیشتر از ۳۲۰ باشد. اگر فایل با استفاده از multipart/form-data آپلود نشده باشد، نادیده گرفته می‌شود. تامبنیل‌ها را نمی‌توان مجدداً استفاده کرد و آن‌ها را فقط می‌توان به صورت یک فایل جدید آپلود کرد، بنابراین اگر thumbnail با استفاده از multipart/form-data با نام <file_attach_name> آپلود شده باشد، می‌توانید عبارت “<attach://<file_attach_name>” را وارد کنید. |
caption | InputFile, string | اختیاری. زیرنویس فایل صوتی که باید ارسال شود، بین ۰ تا ۱۰۲۴ کاراکتر |
duration | Integer | اختیاری. مدت زمان فایل صوتی (در واحد ثانیه) |
title | string | اختیاری. عنوان فایل صوتی |
⚙️ متد‌های دریافت
getType()
نوع رسانه را بازیابی می‌کند، که همیشه باید "صدا" را بازگرداند.
$type = $inputMediaAudioObject->getType();
getMedia()
فایل رسانه‌ای (چه file_id، URL HTTP، یا ارجاع attach) که قرار است ارسال شود را بازیابی می‌کند.
$media = $inputMediaAudioObject->getMedia();
getThumbnail()
تصویر بندانگشتی فایل صوتی را بازیابی می‌کند. این میتواند file_id، URL HTTP، یا ارجاع attach باشد اگر با استفاده از multipart/form-data بارگذاری شده باشد.
$thumbnail = $inputMediaAudioObject->getThumbnail();
getCaption()
کپشن صوتی که قرار است ارسال شود را بازیابی می‌کند. یک مقدار رشته‌ای (۰-۱۰۲۴ کاراکتر) را باز می‌گرداند.
$caption = $inputMediaAudioObject->getCaption();
getDuration()
مدت زمان فایل صوتی را به ثانیه بازیابی می‌کند.
$duration = $inputMediaAudioObject->getDuration();
getTitle()
عنوان فایل صوتی را بازیابی می‌کند.
$title = $inputMediaAudioObject->getTitle();
➕ بیشتر
نکته
برای اطلاعات بیشتر، به مستندات رسمی بله مراجعه کنید.