Перейти к содержимому

Префикс бота discord что это

  • автор:

как сделать уникальный префикс для сервера discord.py?

Подскажите, пожалуйста, как сделать уникальный префикс для каждого сервера на котором находится бот. Допустим чтобы на одном сервере пользователь мог поставить для бота тот префикс, который хочет и это бы не влияло на префиксы на других серверах. Необходимо чтобы работало с декоратором @bot.command() . Возможно ли обойтись без on_message ?

Отслеживать
543 5 5 серебряных знаков 14 14 бронзовых знаков
задан 22 дек 2020 в 22:06
38 4 4 бронзовых знака

1 ответ 1

Сортировка: Сброс на вариант по умолчанию

В аргумент command_prefix конструктора бота можно передавать функцию, которая будет возвращать необходимый префикс в зависимости от сообщения: Bot.command_prefix

GUILD_PREFIXES = def guild_based_prefix(bot, message): return GUILD_PREFIXES.get(message.guild.id, "!") bot = commands.Bot(prefix=guild_based_prefix) 

Таким образом, на сервере с ID 840938031829325150 все команды будут выполняться с префиксом ? , а на остальных серверах — с префиксом !

Создание бота Discord Bot с помощью Node.js

Создание бота Discord Bot с помощью Node.js

Discord — это приложение чата, позволяющее миллионам пользователей со всего мира обмениваться сообщениями и общаться в голосовом чате в сообществах, называемых «гильдии» или «серверы». Discord также включает функциональный API, который разработчики смогут использовать для построения мощных ботов Discord. Боты могут выполнять разнообразные действия, в том числе отправлять сообщения на серверы, отправлять пользователям сообщения DM, модерировать серверы и воспроизводить звук в голосовых чатах. Это позволяет разработчикам создавать мощных ботов со сложными и продвинутыми функциями, включая инструменты модерирования и даже игры. Например, служебный бот Dyno обслуживает миллионы гильдий и содержит множество полезных функций, включая защиту от спама, музыкальный проигрыватель и другие служебные функции. Научившись создавать боты Discord, вы получите множество возможностей, с которыми тысячи людей смогут взаимодействовать каждый день.

В этом обучающем модуле мы создадим бот Discord с нуля, используя Node.js и библиотеку Discord.js, позволяющую пользователям взаимодействовать с Discord API напрямую. Мы настроим профиль бота Discord, получим токены аутентификации для бота и запрограммируем бот для обработки отправляемых пользователями команд с аргументами.

Предварительные требования

Для начала вам потребуется следующее:

  • Node.js, установленный на вашем компьютере для разработки. Чтобы установить его в macOS или Ubuntu 18.04, следуйте указаниям руководства Установка Node.js и создание локальной среды разработки в macOS или раздела Установка с помощью PPA руководства Установка Node.js в Ubuntu 18.04.
  • Любой текстовый редактор по вашему усмотрению, например, Visual Studio Code, Atom, Sublime или Nano.
  • Бесплатная учетная запись Discord с подтвержденной учетной записью электронной почты и бесплатный сервер Discord, который вы будете использовать для тестирования вашего бота Discord.

Шаг 1 — Настройка бота Discord

На этом шаге вы будете использовать графический интерфейс разработчиков Discord для настройки бота Discord и получения токена бота, который вы передадите в свою программу.

Чтобы зарегистрировать бота на платформе Discord, используйте панель приложений Discord. Здесь разработчики могут создавать приложения Discord, включая ботов Discord.

Изображение панели приложений Discord после первого посещения сайта https://discord.com/developers/applications

Для начала нажмите New Application (Новое приложение). Discord предложит вам ввести имя нового приложения. Затем нажмите Create (Создать) для создания приложения.

Изображение командной строки для создания приложения с введенным именем приложения

Примечание. Имя приложения не связано с именем бота, и эти имена могут не совпадать.

Теперь откройте свою панель приложения. Чтобы добавить бота в приложение, откройте вкладку Bot (Бот) на панели навигации слева.

Изображение вкладки Bot на панели приложений

Нажмите кнопку Add Bot (Добавить бота), чтобы добавить бота в приложение. Нажмите кнопку Yes, do it! (Да, сделать это!) в диалоге запроса подтверждения. Откроется панель с подробными сведениями об имени вашего бота, токене аутентификации и изображении в профиле.

Панель с подробными сведениями о боте

На этой панели вы можете изменить имя бота или изображение профиля. Также необходимо скопировать токен аутентификации бота, нажав Click to Reveal Token (Нажмите для показа токена) и скопировав отображаемый токен.

Предупреждение. Никогда не публикуйте и не выгружайте в сеть свой токен бота, поскольку это позволит любому пользователю выполнить вход в бот.

Теперь нужно создать приглашение, которое позволяет добавить гильдии ботов Discord, где вы можете протестировать бот. Вначале перейдите на вкладку OAuth2 на панели приложения. Чтобы создать приглашения, прокрутите страницу и выберите бота в разделе scopes. Также необходимо установить разрешения, чтобы определить, какие действия бот может выполнять в гильдиях. Для целей этого обучающего модуля выберите пункт Administrator (Администратор), которые дадут вашему боту разрешения для выполнения в гильдиях практически любых действий. Скопируйте ссылку с помощью кнопки Copy.

Вкладка OAuth2 с установленной сферой действия bot и уровнем разрешений administator

Затем добавьте бот на сервер. Перейдите по созданной ссылке с приглашением. Вы можете добавить бот на любой сервер, который вам принадлежит или на котором у вас есть права администратора, используя выпадающее меню.

Страница после перехода по ссылке с приглашением, что позволяет пользователям добавлять бот на серверы

Теперь нажмите кнопку Continue (Продолжить). Обязательно установите отметку рядом с полем Administrator, чтобы предоставить боту разрешения администратора. Затем нажмите Authorize (Авторизация). Discord предложит вам решить головоломку CAPTCHA, прежде чем бот сможет подключиться к серверу. Теперь наш бот Discord отображается в списке пользователей сервера, на который вы добавили бота, со статусом offline (не в сети).

Список пользователей сервера Discord с новым ботом в разделе offline списка пользователей

Вы успешно создали бота Discord и добавили его на сервер. Далее мы напишем программу для входа в бот.

Шаг 2 — Создание проекта

На этом шаге мы настроим базовую среду программирования, где выполним сборку бота и войдем в него программным путем.

Вначале необходимо настроить папку проекта и необходимые файлы проекта для бота.

Создайте папку проекта:

Перейдите в только что созданную папку проекта:

Далее используйте текстовый редактор для создания файла с именем config.json для сохранения токена аутентификации вашего бота:

Затем добавьте в файл конфигурации следующий код, заменяя выделенный текст токеном аутентификации вашего бота:

config.json

 "BOT_TOKEN": "YOUR BOT TOKEN" > 

Сохраните и закройте файл.

Затем мы создадим файл package.json , где будут храниться детали нашего проекта и информация о зависимостях, используемых в проекте. Для создания файла package.json запустите следующую команду npm :

Сейчас мы установим пакет discord.js , который будем использовать для взаимодействия с Discord API. Вы можете установить discord.js через npm с помощью следующей команды:

Мы настроили файл конфигурации, установили необходимую зависимость и теперь можем начать сборку бота. В реальном приложении мы бы разделили код большого бота на несколько файлов, но в этом обучающем модуле мы поместим весь код бота в один файл.

Вначале создайте файл с именем index.js в папке discord-bot для кода:

Начните программирование бота, запросив зависимость discord.js и файл конфигурации с токеном бота:

const Discord = require("discord.js"); const config = require("./config.json"); 

После этого добавьте следующие две строки кода:

. const client = new Discord.Client(); client.login(config.BOT_TOKEN); 

Сохраните и закройте файл.

Первая строка кода создает новый клиент Discord.Client и назначает его как значение константы client . Этот клиент частично обеспечивает взаимодействие с Discord API и получает уведомления Discord о событиях, например, о новых сообщениях. Фактически клиент представляет бот Discord.

Во второй строке кода метод login используется на клиенте для входа в созданный бот Discord с использованием токена в файле config.json в качестве пароля. Токен сообщает Discord API, для какого бота предназначена программа, а также подтверждает вашу аутентификацию для использования бота.

Теперь запустите файл index.js с помощью Node:

Теперь статус вашего бота на сервере Discord, куда вы его добавили, изменится на online (в сети).

Изображение бота со статусом online

Мы успешно настроили среду программирования и создали базовый код для входа в бот Discord. На следующем шаге мы займемся пользовательскими командами и заставим бота выполнить определенные действия, например, отправить сообщения.

Шаг 3 — Обработка первой команды пользователя

На этом шаге мы создадим бот, который может обрабатывать команды пользователя. Вы запустите свою первую команду ping , на которую будет отправлен ответ pong с указанием времени ответа на команду.

Сначала необходимо обеспечить обнаружение и получение любых отправляемых пользователями сообщений, чтобы бот мог обрабатывать любые команды. Используя метод on клиента Discord, Discord будет отправлять вам уведомления о новых событиях. Метод on принимает два аргумента: название ожидаемого события и функцию, которая будет запускаться каждый раз, когда будет возникать это событие. С этим методом вы можете ожидать события message , которое будет возникать каждый раз при отправке сообщения в гильдию, где у бота имеется разрешение на просмотр сообщений. Поэтому мы создадим функцию, которая будет запускаться для обработки команд каждый раз при отправке сообщения.

Вначале откройте свой файл:

Добавьте в файл следующий код:

. const client = new Discord.Client(); client.on("message", function(message)   >);  client.login(config.BOT_TOKEN); 

Эта функция, выполняемая для события message , принимает параметр message . Параметр message имеет значение экземпляра Discord.js message, содержащее информацию об отправленном сообщении и методах, которые помогут боту ответить на него.

Добавьте следующую строку кода в функцию обработки команд:

. client.on("message", function(message)  if (message.author.bot) return; >); . 

Эта строка проверяет, является ли автор сообщения ботом, и если это так, останавливает обработку команды. Это важно, поскольку обычно нам не нужно обрабатывать сообщения ботов или отвечать на них. Другим ботам обычно не требуется использовать наш бот, и поэтому игнорирование их сообщений позволит нам сэкономить вычислительную мощность и предотвратить случайные ответы.

Теперь мы напишем обработчик команд. Для этого важно понимать обычный формат команды Discord. Обычно структура команды Discord содержит три части в следующем порядке: префикс, имя команды и (иногда) аргументы команды.

Изображение типичной команды Discord

  • Префикс: префикс может быть любым, но обычно это знак пунктуации или абстрактная фраза, которая обычно не может располагаться в начале сообщения. Это означает, что при добавлении префикса в начало сообщения бот будет знать, что это команда, которую ему необходимо обработать.
  • Имя команды: имя команды, которое пользователь хочет использовать. Это означает, что бот может поддерживать несколько команд с разными функциями и разрешать пользователям выбирать между ними, используя разные имена команд.
  • Аргументы: иногда команда запрашивает или использует дополнительную информацию от пользователя, и пользователь может указывать аргументы после имени команды, разделяя их пробелами.

Примечание. Принудительно устанавливаемой структуры команд нет, и боты могут обрабатывать команды как угодно, однако здесь мы описываем эффективную структуру, которую использует большинство ботов.

Чтобы начать создание синтаксического анализатора команд, поддерживающего этот формат, добавьте следующие строки кода в функцию обработки сообщений:

. const prefix = "!"; client.on("message", function(message)  if (message.author.bot) return; if (!message.content.startsWith(prefix)) return; >); . 

Первая строка кода добавляется, чтобы присвоить значение «!» константе prefix , которую мы будем использовать в качестве префикса бота.

Вторая строка кода проверяет, начинается ли содержание обрабатываемого ботом сообщения с заданного префикса, и останавливает дальнейшую обработку сообщения, если префикса нет.

Теперь необходимо конвертировать остальную часть сообщения в название команды и любые аргументы, которые могут присутствовать в сообщении. Добавьте следующие выделенные строки:

. client.on("message", function(message)  if (message.author.bot) return; if (!message.content.startsWith(prefix)) return; const commandBody = message.content.slice(prefix.length); const args = commandBody.split(' '); const command = args.shift().toLowerCase(); >); . 

Первая строка используется для удаления префикса из содержания сообщения и назначения результата константе commandBody . Это необходимо, поскольку нам не нужно, чтобы префикс входил в обработанное имя команды.

Вторая строка принимает сообщение с удаленным префиксом и использует на нем метод split с пробелом в качестве разделителя. Он разделяет команду на массив субстрок, проводя разделение после каждого пробела. В результате получается массив, содержащий имя команды, за которым идут аргументы (если они содержатся в сообщении). Мы назначаем этот массив константе args .

Третья строка удаляет первый элемент из массива args (это будет имя команды), конвертирует его в нижний регистр и назначает константе command . Это позволяет изолировать имя команды и оставить в массиве только аргументы. Также мы используем метод toLowerCase , поскольку команды в ботах Discord обычно не учитывают регистр.

Мы завершили построение синтаксического анализатора команд с реализацией обязательного префикса и получением имени команды и всех аргументов из сообщений. Теперь мы реализуем и создадим код для определенных команд.

Добавьте следующий код, чтобы начать реализацию команды ping :

. const args = commandBody.split(' '); const command = args.shift().toLowerCase(); if (command === "ping")  >  >); . 

Это выражение if проверяет соответствие обработанного имени команды (назначенного константе command ) значению «ping» . Такое соответствие означает, что пользователь хочет использовать команду «ping» . Мы вложим код определенной команды в блок выражения if . Впоследствии вы сможете использовать этот шаблон для других команд.

Теперь вы можете реализовать код для команды «ping» :

. if (command === "ping")  const timeTaken = Date.now() - message.createdTimestamp; message.reply(`Pong! This message had a latency of $timeTaken>ms.`); > . 

Сохраните и закройте файл.

Мы добавляем блок команды «ping» , который рассчитывает разницу между текущим временем, определяемым с помощью метода now объекта Date , и временной меткой создания сообщения, выражаемую в миллисекундах. Таким образом рассчитывается время обработки сообщения и ответа бота на команду «ping» .

Вторая строка отвечает на команду пользователя, используя метод reply с константой message . Метод reply отправляет запрос ping (уведомляющий пользователя и выделяющий сообщение для указанного пользователя) пользователю, который отправил команду, добавляя после запроса содержание, указанное в качестве первого аргумента метода. Мы указали литераль шаблона, содержащую сообщение и рассчитанное значение ping, в качестве ответа, который будет использоваться методом reply .

На этом мы завершаем реализацию команды «ping» .

Запустите свой бот с помощью следующей команды (в той же папке, что и index.js ):

Теперь вы можете использовать команду «! ping» на любом канале, где бот может просматривать и принимать сообщения, а также отправлять ответы.

Изображение бота, отвечающего в Discord на запрос

Вы успешно создали бот, который может обрабатывать команды пользователей, и реализовали свою первую команду. На следующем шаге мы продолжим разработку бота, реализовав команду sum.

Шаг 4 — Реализация команды Sum

Теперь мы расширим нашу программу, реализовав команду «! sum» . Эта команда принимает любое количество аргументов, складывает их и возвращает пользователю сумму всех аргументов.

Если ваш бот Discord еще работает, вы можете остановить его процессы, нажав CTRL + C .

Откройте файл index.js снова:

Чтобы начать реализацию команды «! sum» , мы используем блок else-if . После проверки имени команды ping бот будет проверять, имеет ли имя команды значение «sum» . Мы используем блок else-if , потому что одновременно будет обрабатываться только одна команда, и если программа определит совпадение с именем команды «ping» , ей не нужно будет проводить проверку на совпадение с именем команды «sum» . Добавьте в файл следующие выделенные строки:

. if (command === "ping")  const timeTaken = Date.now() - message.createdTimestamp; message.reply(`Ping! This message had a latency of $timeTaken>ms.`); > else if (command === "sum")  >  >); . 

Теперь вы можете начать реализацию кода для команды «sum» . Код команды «sum» будет размещен в только что созданном нами блоке else-if . Теперь добавьте следующий код:

. else if (command === "sum")  const numArgs = args.map(x => parseFloat(x)); const sum = numArgs.reduce((counter, x) => counter += x); message.reply(`The sum of all the arguments you provided is $sum>!`); > . 

Мы используем метод map для списка аргументов, чтобы создать новый список, используя функцию parseFloat для каждого элемента в массиве args . При этом создается новый массив (назначенный константе numArgs ), где все элементы являются числами, а не строками. Это означает, что в дальнейшем вы можете определить сумму чисел, выполнив операцию сложения.

Вторая строка использует метод reduce на константе numArgs , предоставляя функцию, суммирующую все элементы в списке. Мы назначаем сумму всех элементов в numArgs как значение константы sum .

Затем мы используем метод reply на объекте сообщений, чтобы ответить на команду пользователя, отправив литераль шаблона, содержащую сумму всех аргументов, отправленных пользователем боту.

Это завершает реализацию команды «sum» . Теперь запустите бот, используя следующую команду (в той же папке, что и index.js ):

Теперь вы можете использовать команду «! sum» на любом канале, где бот может просматривать и отправлять сообщения.

Изображение бота, отвечающего

Далее приведена законченная версия скрипта бота index.js :

const Discord = require("discord.js"); const config = require("./config.json"); const client = new Discord.Client(); const prefix = "!"; client.on("message", function(message)  if (message.author.bot) return; if (!message.content.startsWith(prefix)) return; const commandBody = message.content.slice(prefix.length); const args = commandBody.split(' '); const command = args.shift().toLowerCase(); if (command === "ping")  const timeTaken = Date.now() - message.createdTimestamp; message.reply(`Pong! This message had a latency of $timeTaken>ms.`); > else if (command === "sum")  const numArgs = args.map(x => parseFloat(x)); const sum = numArgs.reduce((counter, x) => counter += x); message.reply(`The sum of all the arguments you provided is $sum>!`); > >); client.login(config.BOT_TOKEN); 

На этом шаге мы дополнили наш бот Discord, реализовав в нем команду sum .

Заключение

Мы успешно создали бот Discord, который может обрабатывать разные команды пользователей и аргументы команд. Если вы хотите расширить возможности вашего бота, вы можете реализовать дополнительные команды или использовать другие части Discord API для построения мощного бота Discord. Вы можете ознакомиться с документацией по Discord.js или Discord API, чтобы узнать больше о Discord API.

При создании ботов Discord всегда помните об условиях обслуживания Discord API, определяющих требования к использованию Discord API разработчиками. Также вам может быть полезен этот набор рекомендаций, показывающий наилучшие способы построения бота Discord и содержащий советы по проектированию ботов Discord. Если вы хотите узнать больше о Node.js, ознакомьтесь с нашей серией материалов «Программирование в Node.js».

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Базовое использование

Usage manual

Изучите основы использования бота Discord Переводчик, включая установку, права доступа, префикс по умолчанию, структуру команды и список разделов справки.

Установка

Следуйте инструкции, чтобы установить бота на Ваш сервер Discord:

  1. Нажмите на ссылку для установки
  2. Выберите нужный сервер Discord из списка (необходимо иметь возможность приглашать)
  3. Авторизируйте бота, чтобы он присоединился к серверу с необходимыми правами доступа
  4. Напишите команду -t help , чтобы получить инструкцию в Discord

Бот должен иметь правильные права доступа на всех соответствующих каналах для полной функциональности. Минимальные требования для этого бота:

Право доступа Описание
Видеть текстовые и голосовые каналы Бот не работает без возможности видеть каналы и читать сообщения. Эти права доступа необходимы для обработки команды и автоматизированных задач.
Отправлять сообщения Бот должен иметь возможность писать в каналах сервера, чтобы отвечать на команды и автоматизированные команды
Встраивать ссылки Бот отправляет сообщения в специальном формате, называемом RichEmbed, который похож на предпросмотр ссылок в Discord. Он также показывает ссылки на официальный вебсайт и вики для справки.
Читать историю сообщений Боту нужен доступ к истории сообщений для перевода старых сообщений при помощи реакций эмодзи флагами, а также для синхронизации изменений/удалений.
Управлять сообщениями Это право доступа необходимо для синхронизации изменений и удалений оригинального и переведенного сообщений. Также требуется для возможности автоудаления команд.
Прикреплять файлы Это не обязательное право доступа, которое позволяет боту пересылать пользовательские вложения в автопереводимых каналах.
Управление ролями Это необходим лишь если Вы хотите автоматически переводить или банить пользователей, не присваивая вручную им роли автоперевод или не переводить .
Управление вебхуками Это не обязательно и необходимо для включения стиля Вебхук — инновационную интеграцию вебхука, для вывода перевода в чистом формате (без аватара и имени бота).

Префикс по умолчанию

Префикс Описание Настройка
-t Короткий префикс по умолчанию Проверить настройки префикса
-translate Полный префикс по умолчанию —
@Translator Упоминание бота Изменить никнейм бота
@Translator#2653 Полное упоминание бота —

Структура команд

префикс + главная команда + параметры

-translate help custom

или

-t help custom

или

@Translator help custom

Получить помощь в Discord

-translate help

-translate help custom

-translate help react

-translate help auto

-translate help user

-translate help bots

-translate help settings

-translate help misc

-translate help detect

Предложить функционал или сообщить об ошибке

Пожалуйста, присоединитесь к официальному серверу Discord, чтобы сообщить об ошибках или обсудить новый функционал/улучшение с сообществом.

Слэш команды

Слэш команды — это один из типов взаимодействий, интегрированных с клиентом, которые может создать бот. В отличие от команд с префиксом, они не требуют намерения на контент сообщения.

В этом разделе подробно рассказано о создании, типах и обработке слэш командах с помощью disnake .

Бот должен быть добавлен с разрешением applications.commands , чтобы создавать слэш команды на сервере. Мы рекомендуем добавить это разрешение к приглашениям вашего бота.

Определение слэш команд​

Для создания слэш команд используйте декоратор @bot.slash_command .

@bot.slash_command(  name="ping",  description="Возращает задержку бота", ) async def ping(inter: disnake.ApplicationCommandInteraction): ... 

Dellyis used / ping

Disnake Bot Bot 05/16/2023

Если используется ког, используйте декоратор @commands.slash_command .

class Meta(commands.Cog): @commands.slash_command(  name="ping",  description="Возращает задержку бота", ) async def ping(self, inter: disnake.ApplicationCommandInteraction): ... 

Параметры​

В то время как некоторые команды могут существовать без аргументов, большинство команд должны принимать их, чтобы быть полезными. Чтобы определить параметр, это так же просто, как определить аргумент для обычной команды.

Вот пример команды с одним целочисленным параметром (без описания):

@bot.slash_command(description="Увеличивает число в 7 раз") async def multiply(inter, number: int): await inter.response.send_message(number * 7) 

Чтобы сделать параметр опциональным, укажите стандартное значение аргументу.

@bot.slash_command(description="Увеличивает число в указанное количество раз") async def multiply(inter, number: int, multiplier: int = 7): await inter.response.send_message(number * multiplier) 

Подкоманды​

Регистрация команд​

В отличие от команд с префиксом, слэш команды должны быть сначала зарегистрированы в Discord. В противном случае они не появятся, если вы нажмете «/». По умолчанию библиотека автоматически регистрирует и обновляет ваши слэш команды. Это происходит при запуске бота или при выгрузке или перезагрузке одного или нескольких когов.

Библиотека не делает ненужных запросов API во время этого процесса. Если зарегистрированные команды совпадают с командами в вашем коде, запросы API не выполняются. В противном случае выполняется только один запрос на массовую перезапись.

Если вы хотите отключить автоматическую регистрацию, установите параметр sync_commands в экземпляре commands.Bot на False . Если вы хотите увидеть, как именно изменяется список зарегистрированных команд, установите параметр sync_commands_debug на True .

bot = commands.Bot("!", sync_commands_debug=True) 

Он выведет, какие команды были добавлены, отредактированы, удалены или нетронуты. Это также зависит от вашего уровня ведения логирования.

Глобальные команды​

Глобальные слэш команды видны везде, включая личные сообщения с ботом. Если вы не укажете параметр test_guilds в commands.Bot , все ваши слэш команды по умолчанию являются глобальными.

Глобальные команды сразу видны и доступны для использования на большинстве устройств.

Серверные команды​

Если вы укажете параметр test_guilds в commands.Bot , все слэш команды в вашем коде больше не будут являться глобальными. Следующий код зарегистрирует все слэш команды только на двух серверах:

bot = commands.Bot("!", test_guilds=[123456789, 987654321]) # ID серверов 

Если вы хотите сохранить некоторые из ваших команд с косой чертой глобальными, а некоторые сделать локальными, укажите параметр guild_ids в декораторе @bot.slash_command() :

bot = commands.Bot("!")   @bot.slash_command() async def global_command(inter): """Эта команда видна везде""" ...   @bot.slash_command(guild_ids=[123456789]) async def local_command(inter): """Эта команда видна только на одном сервере""" ... 

Ответ на команды​

Отправка ответа​

Атрибут response ссылается на экземпляр InteractionResponse , который имеет 4 способа ответа на ApplicationCommandInteraction . Ответ может быть выполнен только один раз. Если вы хотите отправлять повторные сообщения, рассмотрите возможность использования followup вместо вебхука.

Ответ может быть использован только один раз. После получения ответа больше никаких ответов быть не может. Смотрите объект followup для отправки сообщений после ответа.

  1. send_message — Отправляет ответное сообщение
  2. edit_message — Редактирует оригинальное сообщение, вы не можете использовать это в командах приложения, потому что во время ответа нет сообщений.
  3. defer — Откладывает взаимодействие
  4. send_modal — отправляет Modal (модальное окно).

Кроме того, существует один метод, который не дает ответа:

  1. is_done — Указывает, был ли выполнен ответ на взаимодействие.

Если вы собираетесь запускать длительные процессы (более 3 секунд) во время ответа, вы должны сначала отложить взаимодействие. Затем, когда ваш ответ будет готов, вы можете отредактировать сообщение, используя edit_original_message .

@bot.slash_command() async def ping(inter: ApplicationCommandInteraction): await inter.response.send_message("Понг!")   @bot.slash_command() async def defer(inter: ApplicationCommandInteraction): await inter.response.defer() await asyncio.sleep(10) await inter.edit_original_message(content="Ожидание закончилось, мои товарищи!") 

Последующие действия​

Последующие действия — это способ отправить сообщение после ответа. Существует два важных ограничения в отношении того, когда можно использовать последующее наблюдение:

  • на взаимодействие должен быть дан ответ в течение первых 3 секунд (см. Отправка ответа).
  • срок действия взаимодействия не должен быть истек. Проверка того, истек ли срок действия взаимодействия, может быть выполнена с помощью ApplicationCommandInteraction.is_expired .

По своей сути, последующие действия — это просто экземпляр Webhook . В этом нет ничего особенного, за исключением того, что параметр wait обрабатывается так, как если бы он всегда имел значение True .

Одним из возможных способов последующего использования может быть отправка инструкций, которые будут видны, если модальное сообщение не отправлено.

@bot.slash_command() async def confirm(inter: ApplicationCommandInteraction): await inter.response.send_modal(  title="Подтверждение",  custom_id="confirm-or-deny",  components=[disnake.ui.TextInput(label="подтвердить?", custom_id="confirm")], ) await inter.followup.send(content="Пожалуйста, не закрывайте модальное окно!", ephemeral=True) 

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *