caption: Optional[str]
- Заголовок к сообщению(подпись
/прикреплённый текст), дает возможность отправить документ с текстовым сообщением.
await bot.send_document(chat_id = chat_id, document = file1, caption = "TEXT_MESSAGE")
Используйте этот метод, чтобы отправить группу фотографий, видео,
документов или аудио в виде альбома.
# Создать медиа группу
media = types.MediaGroup()
# Прикрепить/добавить файл, документ, аудио и тд.
media.attach_photo(types.InputFile('data/cat.jpg'), 'Cat!')
# Ещё файл - он так же может быть документом, аудио и тд.
media.attach_photo(types.InputFile('data/cats.jpg'), 'More cats!')
# Можно использовать URL ссылки на фото, документы и тд.
# Из документации - получить случайного кота:
media.attach_photo('http://lorempixel.com/400/200/cats/', 'Random cat.')
# ID файла тоже подойдет для добавления в медиа группу.
# media.attach_photo('<file_id>', 'cat-cat-cat.')
# Готово! Можно отправлять!
await message.send_media_group(chat_id = chat_id, media=media)
#caption - использовать это свойство нужно при добавлении нового файла, т.е. - attach_photo(file, caption = "TEXT")
Вы должны использовать sendMediaGroup
, где вы можете указать
media
поле с массивом фото / видео объектов, но хитрость заключается в
том, чтобы установить caption
нужно сделать подпись только для первого элемента
массива . В этом случае телеграмм покажет эту подпись под
медиаконтентом.
Если вы укажете подписи для более чем одного элемента, телеграмма
покажет их только при нажатии на превью фото для каждого фото
отдельно.
Пример использования MediaGroup