media

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

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

Path

Через путь в контексте (path)

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

Параметры:

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

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

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

{  
"file_id": "AgACAgIAAxk...",  
"type": "photo"                
}

алиасы file_id — fileid, fileId, fileID, id type - тип отправляемого медиа*

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

[  
{"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}

Fileid

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

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

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

Через URL:

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

Пример:

!{media|
  id:AgACAgIAAxkBAAI...;
  type:photo}

!{media|
  url:https://example.com/photo.jpg;
  type:photo}

Альбом

Альбом (несколько файлов)

Для отправки альбома используйте параметры с номерами от 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}

Примечания:

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