You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

glossary.md 4.4 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. ---
  2. uid: FAQ.Glossary
  3. title: Common Terminologies / Glossary
  4. ---
  5. # Glossary
  6. This is an additional chapter for quick references to various common
  7. types that you may see within Discord.Net. To see more information
  8. regarding each type of object, click on the object to navigate
  9. to our API documentation page where you might find more explanation
  10. about it.
  11. ## Common Types
  12. * A **Guild** ([IGuild]) is an isolated collection of users and
  13. channels, and are often referred to as "servers".
  14. - Example: [Discord API](https://discord.gg/jkrBmQR)
  15. * A **Channel** ([IChannel]) represents a generic channel.
  16. - Example: #dotnet_discord-net
  17. - See [Channel Types](#channel-types)
  18. [IGuild]: xref:Discord.IGuild
  19. [IChannel]: xref:Discord.IChannel
  20. ## Channel Types
  21. ### Message Channels
  22. * A **Text Channel** ([ITextChannel]) is a message channel from a Guild.
  23. * A **Thread Channel** ([IThreadChannel]) is a thread channel from a Guild.
  24. * A **News Channel** ([INewsChannel]) (also goes as announcement channel) is a news channel from a Guild.
  25. * A **DM Channel** ([IDMChannel]) is a message channel from a DM.
  26. * A **Group Channel** ([IGroupChannel]) is a message channel from a Group.
  27. - This is rarely used due to the bot's inability to join groups.
  28. * A **Private Channel** ([IPrivateChannel]) is a DM or a Group.
  29. * A **Message Channel** ([IMessageChannel]) can be any of the above.
  30. ### Misc Channels
  31. * A **Guild Channel** ([IGuildChannel]) is a guild channel in a guild.
  32. - This can be any channels that may exist in a guild.
  33. * A **Voice Channel** ([IVoiceChannel]) is a voice channel in a guild.
  34. * A **Stage Channel** ([IStageChannel]) is a stage channel in a guild.
  35. * A **Category Channel** ([ICategoryChannel]) (2.0+) is a category that
  36. holds one or more sub-channels.
  37. * A **Nested Channel** ([INestedChannel]) (2.0+) is a channel that can
  38. exist under a category.
  39. > [!NOTE]
  40. > A Channel ([IChannel]) can be all types of channels.
  41. [INestedChannel]: xref:Discord.INestedChannel
  42. [IGuildChannel]: xref:Discord.IGuildChannel
  43. [IMessageChannel]: xref:Discord.IMessageChannel
  44. [ITextChannel]: xref:Discord.ITextChannel
  45. [IGroupChannel]: xref:Discord.IGroupChannel
  46. [IDMChannel]: xref:Discord.IDMChannel
  47. [IPrivateChannel]: xref:Discord.IPrivateChannel
  48. [IVoiceChannel]: xref:Discord.IVoiceChannel
  49. [ICategoryChannel]: xref:Discord.ICategoryChannel
  50. [IChannel]: xref:Discord.IChannel
  51. [IThreadChannel]: xref:Discord.IThreadChannel
  52. [IStageChannel]: xref:Discord.IStageChannel
  53. [INewsChannel]: xref:Discord.INewsChannel
  54. ## Message Types
  55. * An **User Message** ([IUserMessage]) is a message sent by a user.
  56. * A **System Message** ([ISystemMessage]) is a message sent by Discord itself.
  57. * A **Message** ([IMessage]) can be any of the above.
  58. [IUserMessage]: xref:Discord.IUserMessage
  59. [ISystemMessage]: xref:Discord.ISystemMessage
  60. [IMessage]: xref:Discord.IMessage
  61. ## User Types
  62. * A **Guild User** ([IGuildUser]) is a user available inside a guild.
  63. * A **Group User** ([IGroupUser]) is a user available inside a group.
  64. - This is rarely used due to the bot's inability to join groups.
  65. * A **Self User** ([ISelfUser]) is the bot user the client is currently logged in as.
  66. * An **User** ([IUser]) can be any of the above.
  67. [IGuildUser]: xref:Discord.IGuildUser
  68. [IGroupUser]: xref:Discord.IGroupUser
  69. [ISelfUser]: xref:Discord.ISelfUser
  70. [IUser]: xref:Discord.IUser
  71. ## Emoji Types
  72. * An **Emote** ([Emote]) is a custom emote from a guild.
  73. - Example: `<:dotnet:232902710280716288>`
  74. * An **Emoji** ([Emoji]) is a Unicode emoji.
  75. - Example: `👍`
  76. [Emote]: xref:Discord.Emote
  77. [Emoji]: xref:Discord.Emoji
  78. ## Sticker Types
  79. * A **Sticker** ([ISticker]) is a standard Discord sticker.
  80. * A **Custom Sticker ([ICustomSticker]) is a Guild-unique sticker.
  81. [ISticker]: xref:Discord.ISticker
  82. [ICustomSticker]: xref:Discord.ICustomSticker
  83. ## Activity Types
  84. * A **Game** ([Game]) refers to a user's game activity.
  85. * A **Rich Presence** ([RichGame]) refers to a user's detailed
  86. gameplay status.
  87. - Visit [Rich Presence Intro] on Discord docs for more info.
  88. * A **Streaming Status** ([StreamingGame]) refers to user's activity
  89. for streaming on services such as Twitch.
  90. * A **Spotify Status** ([SpotifyGame]) (2.0+) refers to a user's
  91. activity for listening to a song on Spotify.
  92. [Game]: xref:Discord.Game
  93. [RichGame]: xref:Discord.RichGame
  94. [StreamingGame]: xref:Discord.StreamingGame
  95. [SpotifyGame]: xref:Discord.SpotifyGame
  96. [Rich Presence Intro]: https://discord.com/developers/docs/rich-presence/best-practices