Prosta obsługa poleceń Discord Slash dla discord.py

Wypróbuj Nasz Instrument Do Eliminowania Problemów

Polecenia ukośnikowe zapewniają wygodny sposób tworzenia potężnych botów Discord z łatwymi w użyciu interfejsami. W tym samouczku pokazano, jak utworzyć prosty, ale solidny plik procedura obsługi poleceń ukośnikowych do rejestracji, organizowania i wykonywania niestandardowego bota polecenia za pomocą discord.py .

Przegląd poleceń Discord Slash

Wprowadzono Discorda polecenia ukośnika jako uproszczona metoda wywoływania botów przez użytkowników. Zapewniają wbudowane argumenty bez konieczności zapamiętywania przedrostków i składni.

Wewnętrznie boty rejestrują definicje poleceń z ukośnikiem, które Discord renderuje w kliencie użytkownika. Gdy użytkownik wpisze nazwę polecenia, pojawią się parametry umożliwiające wprowadzenie wartości, którą bot otrzyma po wykonaniu.

Kluczowe funkcje poleceń ukośnikowych

  • Intuicyjne interfejsy w kliencie Discord
  • Ustrukturyzowane dane wejściowe za pomocą argumentów
  • Kontrola uprawnień dla bezpieczniejszych botów
  • Automatyczna dokumentacja pomocy

Opierając się na ukośnikach zamiast na przedrostkach, boty tworzą bogatsze doświadczenia użytkowników.

discord.py Podstawy poleceń ukośnikowych

The discord.py Framework zapewnia solidną platformę do tworzenia botów Python Discord. W przypadku poleceń ukośnikowych rejestracją i wykonaniem zajmują się specjalnie klasy kluczowe.

Grupa poleceń z ukośnikiem

Reprezentuje grupę powiązanych poleceń, takich jak muzyka, administrator itp. Pomocne w organizacji i uprawnieniach.

Polecenie ukośnika

Definiuje konkretne polecenie, które obsługuje logikę wykonania. Może zawierać argumenty wprowadzane przez użytkownika.

Menu kontekstowe

Dołącza polecenie ukośnika do komunikatu wejściowego w celu szybkiego dostępu.

Budując na tych klasach, bogate w funkcje procedury obsługi botów szybko nabierają kształtu.

Projektowanie procedury obsługi ukośników

Przed kodowaniem warto rozważyć na początku pewne decyzje dotyczące projektu procedury obsługi ukośników:

  • Organizacja - Płaska lista poleceń czy grupy strukturalne?
  • Argumenty - Które polecenia wymagają danych wejściowych?
  • Uprawnienia - Szczegółowa kontrola dostępu użytkowników/roli?
  • Pomoc - Generować automatyczną dokumentację?

Uwzględnienie tych opcji wpływa na podejście do wdrożenia.

Przykładowe funkcje bota

W celach demonstracyjnych przykładowe polecenia bota mogą zawierać:

  • /odtwarzanie muzyki - Kolejkuj utwory według nazwy/adresu URL
  • /mod warn – Ostrzegaj niewłaściwie zachowujących się użytkowników
  • /fun meme — losowy obraz mema

Mając na uwadze ukierunkowany zestaw funkcji, kod obsługi ukośników nabiera kształtu w następnej kolejności.

Konfiguracja projektu

Uruchomienie bota discord.py od zera obejmuje:

  1. Tworzenie konta bota Discord
  2. Instalowanie pakietu discord.py
  3. Konfigurowanie skryptu uruchamiającego bota

Zakładając, że te wymagania wstępne zostały spełnione, struktura katalogów projektu może wyglądać następująco:

|_+_|

|_+_| skrypt uruchamia bota podczas |_+_| deklaruje zależność discord.py.

Import

Import poleceń z ukośnikiem rdzenia obejmuje:

|_+_|

To pociąga za sobą klienta niezgody, organizację poleceń i elementy struktury bota.

Utwórz instancję bota

Zainicjuj bota za pomocą tokena z portalu deweloperów Discord:

|_+_|

Przedrostek nie będzie miał zastosowania do poleceń z ukośnikiem, raczej do zwykłych poleceń opartych na wiadomościach! tylko wyzwalacze.

Implementuj grupy ukośników i polecenia

Następnie utwórz instancje grupy poleceń z ukośnikiem i dodaj do nich polecenia. Zajmuje się rejestracją i organizacją.

Grupy dowodzenia

Grupuj podobne polecenia w następujący sposób:

|_+_|

Parametry string definiują nazwy grup i opis pomocy.

Polecenia ukośnikowe

Następnie utwórz indywidualne polecenia udostępniające procedury obsługi:

|_+_|

Dekoratory dołączają funkcje do grup poleceń jako nazwane umiejętności ukośnika. Argumenty uzyskują dostęp do danych wejściowych użytkownika.

Dodaj grupy do bota

Na koniec zarejestruj wszystkie grupy poleceń globalnie w instancji bota:

|_+_|

Umożliwia to wykrywanie i wywoływanie w Discord dla użytkowników z odpowiednimi uprawnieniami.

Udoskonal obsługę

Po wprowadzeniu niezbędnego szkieletu ulepszenia pomagają w udoskonaleniu architektury slash.

Uprawnienia

Ogranicz dostęp za pomocą |_+_| atrybut podczas deklarowania grup lub poleceń:

|_+_|

Zapobiega to globalnemu użyciu, które można później udoskonalić poprzez dodanie listy dozwolonych określonych ról/użytkowników.

Typy argumentów

Wymuś typy argumentów, takie jak element członkowski, ciąg znaków, liczba całkowita itp.:

|_+_|

Wymaga to wprowadzenia odpowiednio sformatowanych wartości podczas wywoływania.

Wybory

Przedstaw opcje do wyboru, a nie surowe dane wejściowe:

|_+_|

Lista rozwijana z predefiniowanymi prawidłowymi opcjami do wyboru.

Klasy opcji

W przypadku wielu argumentów utwórz moduł opcji wielokrotnego użytku z predefiniowanymi typami:

|_+_|

Następnie zastosuj czyste typy w programach obsługi.

Eksternalizuj do opakowania

Skaluj rozwój poleceń, eksportując moduł obsługi do importowalnego pakietu z punktem wejścia:

|_+_|

I ładuj dynamicznie:

|_+_|

Pozwala to zachować oddzielenie problemów w celu ułatwienia testowania i wkładu innych osób.

Wdrażaj globalnie

Początkowo polecenia z ukośnikiem rejestrują się na serwerze programistycznym w celu przetestowania. Gdy wszystko będzie gotowe, wdróż globalnie:

|_+_|

Odczekaj około 1 godziny na ogólnoświatową propagację, po czym każdy będzie mógł odkryć!

Wniosek

W tym samouczku przedstawiono prostą procedurę obsługi poleceń ukośnikowych, którą można zbudować z grup implementujących, poleceń, argumentów, uprawnień i pakietów przy użyciu pliku discord.py dla profesjonalnych botów.

Stąd mnóstwo możliwości przekładania pomysłów na intuicyjne doświadczenia Discord, które są dostępne dla członków serwerów i społeczności na całym świecie 24 godziny na dobę, 7 dni w tygodniu!

Zobacz Też: