Медіагрупи (вбудовано)

Плагін медіагрупи допоможе вам надсилати групи мультимедійних даних, дозволяючи створювати обʼєкти InputMedia. До речі, обʼєкти InputMedia також використовуються під час редагування медіаповідомлень, тому цей плагін також допоможе вам редагувати медіа.

Памʼятайте, що обʼєкти InputMedia описано тут.

Побудова обʼєкту InputMedia

Ви можете використовувати цей плагін ось так:

TypeScript

import { InputMediaBuilder } from "grammy";

const photo = InputMediaBuilder.photo(new InputFile("/tmp/photo.mp4"));
const video = InputMediaBuilder.video(new InputFile("/tmp/video.mp4"));
// тощо

JavaScript

const { InputMediaBuilder } = require("grammy");

const photo = InputMediaBuilder.photo(new InputFile("/tmp/photo.mp4"));
const video = InputMediaBuilder.video(new InputFile("/tmp/video.mp4"));
// тощо

Deno

import { InputMediaBuilder } from "https://deno.land/x/grammy@v1.27.0/mod.ts";

const photo = InputMediaBuilder.photo(new InputFile("/tmp/photo.mp4"));
const video = InputMediaBuilder.video(new InputFile("/tmp/video.mp4"));
// тощо

Ознайомтеся зі всіма методами InputMediaBuilder у довідці API.

Ви також можете безпосередньо передавати публічні URL-адреси, які запросить (fetch) Telegram.

const photo = InputMediaBuilder.photo("https://grammy.dev/images/grammY.png");

Інші параметри можуть бути надані в обʼєкті параметрів в кінці.

const photo = InputMediaBuilder.photo("https://grammy.dev/images/grammY.png", {
  caption: "grammY чудовий",
  // тощо
});

Надсилання медіагруп

Ви можете надіслати медіагрупу наступним чином:

await ctx.replyWithMediaGroup([photo0, photo1, photo2, video]);

Так само ви можете передати масив обʼєктів InputMedia до ctx.api.sendMediaGroup або bot.api.sendMediaGroup.

Редагування медіаповідомлень

Оскільки обʼєкти InputMedia також використовуються для редагування медіаповідомлень, цей плагін допоможе вам і тут:

const newMedia = InputMediaBuilder.photo(
  "https://grammy.dev/images/grammY.png",
);
await ctx.editMessageMedia(newMedia);

Як і завжди, це також працює для ctx.api.editMessageMedia та bot.api.editMessageMedia.

Загальні відомості про плагін

Цей плагін вбудовано в ядро grammY. Вам не потрібно нічого встановлювати, щоб використовувати його. Просто імпортуйте все з самого grammY.

До того ж документація і довідка API цього плагіна уніфіковані з ядром пакета.