Audio

این شی نشان‌دهنده یک فایل صوتی است.

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

فیلد	نوع	توضیحات
file_id	String	شناسه این فایل که می‌توان آن‌ را جهت دانلود یا استفاده مجدد از فایل به کار برد.
file_unique_id	String	شناسه منحصربه‌فرد این فایل که فرض می‌شود، در طول زمان و برای بازوهای مختلف یکسان است. نمی‌توان این شناسه را برای دانلود یا استفاده مجدد از فایل به کار برد.
duration	Integer	مدت زمان فایل صوتی به ثانیه.
title	String	اختیاری. عنوان فایل صوتی
file_name	String	اختیاری. نام اصلی فایل
mime_type	String	اختیاری. نوع MIME فایل
file_size	Integer	اختیاری. حجم فایل با واحد بایت. می‌تواند بیشتر از ۲^۳۱ باشد و برخی زبان‌های برنامه‌نویسی ممکن است در تفسیر آن با مشکل روبه‌رو شوند. اما این فیلد حداکثر ۵۲ بیت با ارزش اهمیت دارد و فرمت ۶۴ بیتی علامت‌دار عدد صحیح یا عدد اعشاری ۶۴ بیتی برای ذخیره‌سازی آن مناسب است.

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

getFileId()

شناسه این فایل را بازیابی می‌کند که می‌توان از آن برای دانلود یا استفاده مجدد از فایل استفاده کرد.

$audioFileId = $audioObject->getFileId();

getFileUniqueId()

شناسه منحصر به فرد این فایل را بازیابی می‌کند که در طول زمان و برای ربات‌های مختلف ثابت می‌ماند.

$audioFileUniqueId = $audioObject->getFileUniqueId();

getDuration()

مدت زمان صوت به ثانیه را بازیابی می‌کند، همانطور که توسط فرستنده تعریف شده است.

$audioDuration = $audioObject->getDuration();

getTitle()

عنوان صوت را بازیابی می‌کند، اگر موجود باشد.

$audioTitle = $audioObject->getTitle();

getFileName()

نام اصلی فایل صوتی را بازیابی می‌کند، اگر موجود باشد.

$audioFileName = $audioObject->getFileName();

getMimeType()

نوع MIME فایل صوتی را بازیابی می‌کند، اگر موجود باشد.

$audioMimeType = $audioObject->getMimeType();

getFileSize()

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

$audioFileSize = $audioObject->getFileSize();

➕ بیشتر

نکته

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