media

Описание: Прикрепляет медиа-ресурсы к реакциям sendMessage и sendMenu. Поддерживает отправку как одиночных файлов, так и альбомов (до 10 файлов), а также получение данных о файлах из контекста.

Параметры:

Макрос можно использовать в трёх режимах:

Режим 1: Через путь в контексте (path)

Получение данных о файлах из переменных контекста.

Параметры:

• path - путь к данным в контексте (обязательный)

Формат данных по пути:

Вариант А: Одиночный объект

{  
"file_id": "AgACAgIAAxk...",  // или fileid, fileId, fileID, id  
"type": "photo"                 // тип медиа  
}

Вариант Б: Список объектов (альбом)

[  
{"file_id": "AgACAgIAAxk1...", "type": "photo"},  
{"file_id": "AgACAgIAAxk2...", "type": "video"},  
{"url": "https://example.com/file.jpg", "type": "photo"}  
]

Правила:

• Объект должен содержать ID (file_id/fileid/fileId/fileID/id) или URL (url/URL)
• Приоритет: сначала ищется ID, затем URL
• Обязательно наличие поля type
• Элементы без валидных данных пропускаются

Пример использования:
!{media|path:update.message.photo.0} !{media|path:var.local.files}
!{media|path:form.result.attachments}

Режим 2: Одиночный файл (прямое указание)

Через ID файла:

• id - идентификатор файла (длинная строка от Telegram) (обязательный)
• type - тип медиа-ресурса (обязательный)

Через URL:

• url - HTTP ссылка на файл (обязательный)
• type - тип медиа-ресурса (обязательный)

Пример:
!{media|id:AgACAgIAAxkBAAI...;type:photo}
!{media|url:https://example.com/photo.jpg;type:photo}

Режим 3: Альбом (несколько файлов)

Для отправки альбома используйте параметры с номерами от 1 до 10:

• id1, id2, ..., id10 - идентификаторы файлов
• url1, url2, ..., url10 - URL файлов
• type1, type2, ..., type10 - типы файлов

Правила для альбома:

• Каждый файл должен иметь (idN или urlN) И typeN
• Файлы без указанного типа будут пропущены
• Файлы с невалидным типом будут пропущены
• Максимум 10 файлов в одном альбоме

Пример:
!{media|id1:AgACAgIAAxkBAAI...;type1:photo;id2:AgACAgIAAxkBAAJ...;type2:photo}
!{media|url1:https://example.com/1.jpg;type1:photo;url2:https://example.com/2.jpg;type2:photo}

Доступные типы медиа:

• photo - фото
• audio - аудио
• video - видео
• video_note (или videonote) - видео-заметка
• animation - гиф
• document - документ
• voice - голосовое сообщение
• sticker - стикер

Возвращает: При следующей отправке сообщения будет отправлен указанный файл или альбом файлов.

Примечания:

• Режим определяется автоматически по наличию параметров:
  • Если есть path → режим через контекст
  • Если есть параметры с номерами (id1, url1, type1 и т.д.) → режим альбома
  • Иначе → режим одиночного файла
• Нельзя смешивать режимы в одном вызове