디스코드 봇 intents - diseukodeu bos intents

어떤 인텐트가 필요한가요?¶

당신의 봇에 필요한 인텐트는 당신만이 알 수 있습니다. Intents 클래스의 각각의 속성들은 어떤 events와 일치하는지와 어떤 캐시를 활성화하는지 문서화합니다.

예를 들면, 만약에 presences와 typing과 같은 대량의 이벤트 없이 작동하는 봇을 원한다면 이렇게 할 수 있습니다:

 import discord
 intents = discord.Intents.default()
 intents.typing = False
 intents.presences = False

 # Somewhere else:
 # client = discord.Client(intents=intents)
 # or
 # from discord.ext import commands
 # bot = commands.Bot(command_prefix='!', intents=intents)

참고로 Intents.members는 Privileged Intent(제한된 인텐트) 이므로 켜지지 않습니다.

또다른 예시로 메시지와 길드 정보만 처리하는 봇은 다음과 같습니다:

 import discord
 intents = discord.Intents(messages=True, guilds=True)
 # If you also want reaction events enable the following:
 # intents.reactions = True

 # Somewhere else:
 # client = discord.Client(intents=intents)
 # or
 # from discord.ext import commands
 # bot = commands.Bot(command_prefix='!', intents=intents)

Privileged Intent(제한된 인텐트)¶

봇 소유자가 인텐트를 특정시켜야 하는 API 변경과 함께, 일부 인텐트는 더 추가 제한이 있고 추가적인 절차가 필요합니다. 이런 인텐트들을 Privileged Intent(제한된 인텐트)라고 합니다.

Privileged Intent(제한된 인텐트)는 Developer Portal에서 수동으로 활성화를 해주어야 합니다. 활성화를 위해서는 다음과 같이 해야 합니다:

1. 디스코드 웹사이트 에 로그인했는지 확인하세요.

2. Navigate to the application page.

3. Privileged Intent(제한된 인텐트)를 활성화 할 봇을 클릭하세요.

4. 화면 왼쪽의 Bot 탭으로 이동합니다.

   

5. 《Privileged Gateway Intents》 부분으로 스크롤하고 원하는 인텐트를 활성화하세요.

   

경고

Enabling privileged intents when your bot is in over 100 guilds requires going through bot verification. If your bot is already verified and you would like to enable a privileged intent you must go through Discord support and talk to them about it.

참고

Developer Portal에서 인텐트를 활성화하더라도, 봇 코드에서도 이 인텐트들을 활성화 해야합니다.

Member Cache¶

Along with intents, Discord now further restricts the ability to cache members and expects bot authors to cache as little as is necessary. However, to properly maintain a cache the Intents.members intent is required in order to track the members who left and properly evict them.

To aid with member cache where we don’t need members to be cached, the library now has a MemberCacheFlags flag to control the member cache. The documentation page for the class goes over the specific policies that are possible.

It should be noted that certain things do not need a member cache since Discord will provide full member information if possible. For example:

• on_message() will have Message.author be a member even if cache is disabled.

• on_voice_state_update() will have the member parameter be a member even if cache is disabled.

• on_reaction_add() will have the user parameter be a member when in a guild even if cache is disabled.

• on_raw_reaction_add() will have RawReactionActionEvent.member be a member when in a guild even if cache is disabled.

• The reaction add events do not contain additional information when in direct messages. This is a Discord limitation.

• The reaction removal events do not have the member information. This is a Discord limitation.

Other events that take a Member will require the use of the member cache. If absolute accuracy over the member cache is desirable, then it is advisable to have the Intents.members intent enabled.

Retrieving Members¶

If cache is disabled or you disable chunking guilds at startup, we might still need a way to load members. The library offers a few ways to do this:

• Guild.query_members()

  • Used to query members by a prefix matching nickname or username.

  • This can also be used to query members by their user ID.

  • This uses the gateway and not the HTTP.

• Guild.chunk()

  • This can be used to fetch the entire member list through the gateway.

• Guild.fetch_member()

  • Used to fetch a member by ID through the HTTP API.

• Guild.fetch_members()

  • used to fetch a large number of members through the HTTP API.

It should be noted that the gateway has a strict rate limit of 120 requests per 60 seconds.

Troubleshooting¶

Some common issues relating to the mandatory intent change.

 import discord
 intents = discord.Intents.default()
 intents.members = True

 # Somewhere else:
 # client = discord.Client(intents=intents)
 # or
 # from discord.ext import commands
 # bot = commands.Bot(command_prefix='!', intents=intents)

python3 -m pip install -U "discord.py>=1.4,<1.5"