Описание
Этот объект представляет аудиофайл, который клиенты Telegram обрабатывают как музыку.
| Поле | Тип | Описание |
|---|---|---|
| file_id | String | Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла |
| file_unique_id | String | Уникальный идентификатор этого файла, который должен оставаться неизменным с течением времени и для разных ботов. Не может использоваться для загрузки или повторного использования файла. |
| duration | Integer | Длительность аудио в секундах, указанная отправителем |
| performer | String | Опционально. Исполнитель аудио, указанный отправителем или аудиотегами |
| title | String | Опционально. Название аудио, указанное отправителем или аудиотегами |
| file_name | String | Опционально. Оригинальное имя файла, указанное отправителем |
| mime_type | String | Опционально. MIME-тип файла, указанный отправителем |
| file_size | Integer | Опционально. Размер файла в байтах. Может превышать 2^31, и некоторые языки программирования могут иметь сложности/скрытые ошибки при его интерпретации. Однако он имеет не более 52 значащих битов, поэтому для хранения этого значения безопасно использовать знаковый 64-битный целочисленный тип или тип с плавающей запятой двойной точности. |
| thumbnail | PhotoSize | Опционально. Миниатюра обложки альбома, к которому принадлежит музыкальный файл |
Примеры
json
{
"file_id": "AwACAgQAAxkBAAIBF2YtDummyFileId123456789",
"file_unique_id": "AgADBQADMqo5G",
"duration": 217,
"performer": "Radiohead",
"title": "Creep",
"file_name": "creep.mp3",
"mime_type": "audio/mpeg",
"file_size": 4234567,
"thumbnail": {
"file_id": "AQADAgADMqo5G",
"file_unique_id": "AQADBQADMqo5G",
"width": 320,
"height": 320,
"file_size": 12345
}
}История изменений
- API 4.5. Обновлен объект Audio: Добавлено поле file_unique_id
- API 5.0. Обновлен объект Audio: Добавлено поле file_name
- API 6.6. Обновлен объект Audio: Переименовано поле thumb в thumbnail
Дополнительно
- PhotoSize - Объект, представляющий один размер фотографии или миниатюры файла/стикера с метаданными файла.