AutocompleteHandlers

[Autocompleters] provide a similar pattern to TypeConverters. [Autocompleters] are cached, singleton services and they are used by the Interaction Service to handle Autocomplete Interations targeted to a specific Slash Command parameter.

To start using AutocompleteHandlers, use the [AutocompleteAttribute(Type type)] overload of the [AutocompleteAttribute]. This will dynamically link the parameter to the AutocompleteHandler type.

AutocompleteHandlers raise the AutocompleteHandlerExecuted event on execution. This event can be also used to create a post-execution logic, just like the *CommandExecuted events.

Creating AutocompleteHandlers

A valid AutocompleteHandlers must inherit AutocompleteHandler base type and implement all of its abstract methods.

GenerateSuggestionsAsync()

The Interactions Service uses this method to generate a response of an Autocomplete Interaction. This method should return AutocompletionResult.FromSuccess(IEnumerable<AutocompleteResult>) to display parameter suggestions to the user. If there are no suggestions to be presented to the user, you have two results:

1. Returning the parameterless AutocompletionResult.FromSuccess() will display a "No options match your search." message to the user.
2. Returning AutocompleteResult.FromError() will make the Interaction Service not respond to the interaction, consequently displaying the user a "Loading options failed." message. AutocompletionResult.FromError() is solely used for error handling purposes. Discord currently doesn't allow you to display custom error messages. This result type will be directly returned to the AutocompleteHandlerExecuted method.

Resolving AutocompleteHandler Dependencies

AutocompleteHandler dependencies are resolved using the same dependency injection pattern as the Interaction Modules. Property injection and constructor injection are both valid ways to get service dependencies.

Because [AutocompleterHandlers] are constructed at service startup, class dependencies are resolved only once.

Note

If you need to access per-request dependencies you can use the IServiceProvider parameter of the GenerateSuggestionsAsync() method.

[AutoCompleteAttribute]:

---

This page was last modified at 12/13/2021 04:47:54 -04:00 (UTC).

Commit Message

Author:    Quin Lynch
Commit:    5a7e43a8cb33d0e04af3c754ba36926c5d2b936e

V3 Final merge (#1966)

* Update azure-pipelines.yml

* Update deploy.yml

* Remove version tag from proj

* Update deploy.yml

* Removed versions from project files

* Removed style of the nuget badge and added logo (#201)

The style was not properly added to it and the plastic version does not look good with the discord badge.
I thought it would look better with a logo

* Fix Type not be...