건유1019

갤럭시 워치로 실시간 버스도착 정보를?!

건유1019 — Thu, 14 Apr 2022 01:37:10 +0900

MyBUS

갤럭시워치를 통하여 대중교통 정보를 보다 쉽게 알아볼 수 있습니다.

시연 사진

1. 청량리 (주변정류소)

2. 잠실역 (실시간 버스 도착정보)

3. 잠실역 (실시간 버스 도착정보)

4. 어린이대공원.세종대학교 (실시간 버스 도착정보)

5. 은행사거리 (주변정류소)

기능 소개

주변 정류소 검색

정류소 검색

실시간 버스 도착정보

지원하는 지역

수도권 (서울특별시, 경기도, 인천광역시)

~~부울권~~ ~~(부산광역시, 울산광역시, 창원시, 양산시, 김해시)~~

목표는 전국 지원입니다!

< 링크 >

플레이스토어: https://play.google.com/store/apps/details?id=kr.yhs.traffic

소스코드: https://github.com/gunyu1019/TrafficApplication

< 주의사항 >

플레이스토어 버그로 인하여 조건에 충족한 웨어러블 디바이스에서 페어링된 모바일 디바이스으로 호환성 버그로 다운로드 버튼이 비활성화되는 문제가 계속 발생하고 있습니다.

"기기가 이 버전과 호환되지 않습니다."

따라서 웹사이트에서 "다른 기기에 설치"를 통해 어플을 설치해주시거나,

WearOS 기기의 플레이스토어에서 "MyBUS"를 검색해서 다운로드 해주셔야합니다.

아직 원인을 찾고 있으며, 빠른 시일내에 해결하도록 하겠습니다.

불편을 드려 대단히 죄송합니다.

PUBG BOT v2.0 패치노트 & 공지사항

건유1019 — Tue, 3 Aug 2021 02:20:35 +0900

안녕하세요. PUBG BOT으로는 오랜만으로 찾아뵙게 되었습니다. 10월 27일에 v1.1을 패치하고 나서 약 10개월이 지난 지금 패치노트를 써보게 되었습니다. PUBG BOT은 2020년에 봇 인증 관련 문제가 장기적으로 이어지면서, 개발에 대한 차질도 피하지 못했습니다. 그러나 10개월이 지난 지금 200개 이상의 서버가 PUBG BOT을 지지해주고 있으며, PUBG BOT의 많은 부분을 개선하였습니다. PUBG BOT이 업그레이드되기까지 기다려주신 분들 많은 감사드립니다.

이번 글에서는 PUBG BOT의 v2.0 패치노트에 대하여 알아보고자 합니다.

PUBG BOT이 드디어 빗금 명령어을 지원 합니다.

지금으로부터 약 한 달 전, PUBG BOT에 빗금 명령어가 지원한다는 많은 떡밥을 뿌리고 다녔었습니다. 정작 명령어는 추가되었지만 작동되지 않는다는 점에서 많은 유저분들이 의문을 품기도 했을 것입니다. 이토록 오랜 시간 동안 떡밥만 뿌리고 정식으로 패치 못하였던 이유는 이 기능을 준비하기 위해 많은 시간을 투자하였습니다. 빗금 명령어는 약 1년 전에 디스코드에 추가되었지만, 메시지를 보내는 방법과 구조가 다른 바람에 시간이 좀 걸렸습니다. 어쨌든 PUBG BOT의 명령어가 드디어 빗금 명령어와 호환됩니다. 아무래도 빗금 명령어가 대세가 되고 있는 지금 PUBG BOT이 선제적으로 지원합니다!

(좌) 기존 전적 기능 / (우) 새로운 전적 기능

전적 기능에 버튼이 도입되었습니다.

기존 전적 기능을 사용하면 아래의 반응을 통하여 자세한 정보를 확인할 수 있었습니다. 그러나 반응을 사용하기 위해서는 "메시지 관리 권한"이라는 것이 필요했고, 반응이 모두 생성되기까지 시간이 걸렸다는 점에서 걸림돌이 되기도 하였습니다. 이제부터는 아래에 버튼과 더 세련된 이모지를 통하여 빠르고 편리하게 상호작용할 수 있도록 업데이트하였습니다.

매치 로그 기능에 많은 부분을 개선하였습니다.

(좌) 기존 매치 선택 / (우) 새로운 매치 선택

우선 매치 로그 기능 전부분인 매치 선택 부분부터 확인해보자면, 위 사진과 같이 반응에서 선택하는 방식으로 변경되었습니다. 그리고 기존 5개까지 밖에 확인할 수밖에 없었던 매치 로그가 24개로 늘어났습니다!

(좌) 팀원 매치 전적 / (중) 개편된 매치 전적(종합창) / (우) 매치 전적 요약 지도

특히 매치 전적을 더 보기 좋게, 다양한 정보를 담아보았습니다. 플레이어가 보급 상자를 오픈한 위치, 타 플레이어를 길한 위치, 팀원에게 회복하는 위치까지 다양한 위치를 표시하도록 업데이트하였습니다.

서버 상태 기능을 개선하였습니다.

기존 스팀 서버의 상태 기능은 디스코드 봇을 점검하거나 일시적으로 중지되었을 때 데이터가 날아가버리는 문제가 있었습니다. 이제부터는 디스코드 봇이 갑작스럽게 중지되거나, 일시 정지되어도 데이터가 정상적으로 불러와집니다.

이렇게 PUBG BOT v2.0의 업데이트 내역을 알아보았습니다. PUBG BOT은 오는 8월 9일에 정식 패치를 진행합니다! 또한, 오늘 8월 3일부터 Pre-Launch-Test를 통하여 미리 체험해보실 수 있습니다. 꼭 새로운 PUBG BOT을 이용해 보세요! 감사합니다.

디스코드봇(Components) - 03ㅣComponents를 상호작용해보자.

건유1019 — Sun, 13 Jun 2021 03:40:19 +0900

안녕하세요. 지난 강의에서는 디스코드 봇(Components)을 통하여 버튼을 만들어 보도록 하였습니다.

저번 강의가 생각보다 내용이 많았던 것 같았어요. 사실 이번 강의는 2편에 넣으려고 했던 내용이었지만, 내용이 길어지다 보니 어쩔 수 없이 분리하게 됐습니다. 그래서 그렇게 저번처럼 매우 길어지지는 않을 거라고 봅니다. 저번 강의에서는 디스코드 봇(Componnents)을 통하여 버튼을 만들어 보았더라면, 이번 강의에서는 버튼을 클릭한 여부, 즉 상호작용을 해보도록 하겠습니다.

이번 강의는 discord.py(Python)을 기준으로 강의를 진행할 예정이며, discord.py(v1.7 기준) 내에는 기본적으로 지원하지 않기 때문에, 저희는 discord.py 내에 있는 웹소켓을 받아서 직접 상호작용을 진행할 예정입니다.

우리는 디스코드의 통신 방법을 알아야 합니다.

우리는 지금까지 on_message 등의 다양한 이벤트 핸들러와, cogs를 통하여 메시지를 받고자 하였습니다.

그러나, 우리는 지금까지 on_message와 cogs의 수신 방법을 아시는 분들도 있겠지만, 모르는 사람이 대부분 일 겁니다.

discord.py 내에서는 사실 간단한 코드 일지라도 많은 처리 프로세스가 동작하고 있는 것 다들 알고 계셨나요?

Discord API에서는 어떠한 이벤트가 발생했을 때, 웹소켓 통신 방법을 활용하여 아래와 비슷한 코드를 리턴합니다.

{
  t: 'GUILD_MEMBERS_CHUNK',
  s: 3,
  op: 0,
  d: {
    not_found: [ 123123 ],
    members: [],
    guild_id: '308994132968210433'
  }
}

우선 저 위 내용과 관련된 내용은 아래의 Discord API 문서에서 확인하실 수 있습니다.

https://discord.com/developers/docs/topics/gateway

필드(키)	타입	설명
op	int(정수형)	opcode에 대한 값
d	mixed(혼합형, JSON)	이벤트 데이터
s	int(정수형)	세션 및 하트 비트 재개에 사용되는 시퀀스 번호
t	string(문자열)	페이로드의 이벤트 이름

위 정보를 파악한다면, 't'라는 곳에는 이벤트 이름이 들어가 있으며, 'd'에는 관련된 데이터 값이 들어 있다는 것을 알 수 있습니다.

이로써 discord.py가 처리하기 전에 받는 데이터를 대하여 분석해보았습니다.

discord.py 안에서는 socket_response라는 이벤트 함수를 통하여 Discord API와 서로 간 상호작용하는 내용 중 Discord API가 발신하는 되는 모든 정보를 읽어올 수 있습니다.

async def on_socket_response(payload):
	print(payload)

위 함수를 추가한다면, 웹소켓을 통하여 받는 모든 내용을 읽을 수 있습니다. 위 소스를 통하여 불러온 payload를 중에서 우리가 익숙한 두 가지를 분석해보고자 합니다.

+ 추가 (2022-02-18)
discord.py v2.0 이상의 버전에서는 더 이상 "on_socket_response" 이벤트를 통하여 상호작용하는 내역을 수집할 수 없습니다. 따라서 아래의 과정을 추가함으로써, discord.py v2.0 이상의 버전에서도 디스코드와 상호작용한 값을 수집할 수 있습니다.

1. Client에 enable_debug_events 인자를 True 값으로 설정합니다.
client = discord.Client(enable_debug_events=True)
이 방법은 discord.AutoShardedClient, command.Bot, command.AutoShardedBot에도 동일하게 사용됩니다.

2. "on_socket_response" 대신 "on_socket_raw_receive"를 사용합니다.
대신 해당 함수를 사용하게 되면, 압축 상태의 값이 들어오기 때문에, 압축 해체(decompress) 과정이 필요합니다.
Discord 공식 문서(#)에서도 서술되어 있으며, 아래의 소스 코드를 통해 동일한 값을 얻으실 수 있습니다.
# Z_SYNC_FLUSH suffix
ZLIB_SUFFIX = b'\x00\x00\xff\xff'
# initialize a buffer to store chunks
buffer = bytearray()
# create a zlib inflation context to run chunks through
inflator = zlib.decompressobj()

# ...
@client.event()
def on_socket_raw_receive(msg):
  # always push the message data to your cache
  buffer.extend(msg)

  # check if the last four bytes are equal to ZLIB_SUFFIX
  if len(msg) < 4 or msg[-4:] != ZLIB_SUFFIX:
    return

  # if the message *does* end with ZLIB_SUFFIX,
  # get the full message by decompressing the buffers
  # NOTE: the message is utf-8 encoded.
  msg = inflator.decompress(buffer)
  buffer = bytearray()

  # here you can treat `msg` as either JSON or ETF encoded,
  # depending on your `encoding` param
이 소스코드를 다소 보기좋게 수정한다면 아래의 소스코드를 대신 적용해도 됩니다.
_zlib = zlib.decompressobj()
_buffer = bytearray()

@client.event()
def on_socket_raw_receive(msg):
	if type(msg) is bytes:
		_buffer.extend(msg)
		if len(msg) < 4 or msg[-4:] != b'\x00\x00\xff\xff':
			return
		msg = _zlib.decompress(self.__buffer)
		msg = msg.decode('utf-8')
		_buffer = bytearray()
	msg = json.loads(msg)
물론 discord.py v2.0 에서부터는 컴포넌트 수신을 지원하기 때문에, 꼭 이 방법을 적용하실 필요는 없지만, 혹시나 필요하신 분을 위해 작성해드렸습니다.

위에 설명한 것을 기반으로 아래의 두 가지 데이터를 분석해보도록 하겠습니다. 두 데이터는 우리가 디스코드 봇을 운영한다면 무조건 받은 payload입니다. 한번 차근차근 분석해보도록 하겠습니다.

on_ready (READY)

{
  't': 'READY',
  's': 1,
  'op': 0,
  'd': {
    'v': 6,
    'user_settings': {},
    'user': {
      'verified': True,
      'username': '<name>',
      'mfa_enabled': True,
      'id': '<ID>',
      'flags': 0,
      'email': None,
      'discriminator': '<tag>',
      'bot': True,
      'avatar': '<avatar>'
    },
    'session_id': '<Session ID>',
    'relationships': [],
    'private_channels': [],
    'presences': [],
    'guilds': ['guild'],
    'guild_join_requests': [],
    'geo_ordered_rtc_regions': ['south-korea', 'japan', 'hongkong', 'singapore', 'india'],
    'application': {
      'id': '<ID>',
      'flags': 303104
    },
    '_trace': []
    'shard_id': None
  }
}

해당 기능은 't'값에 READY라는 내용이 있는 것을 보아, 준비되었다는 것을 알리기 위한 이벤트라고 보입니다.

실제로 해당 payload가 들어오고 나서 on_ready() 이벤트 함수가 작동하게 됩니다.

우리는 이때, 성공적으로 실행됐다는 것만 알 수 있지만, 사실은 들어가 있는 길드 정보, 서버 정보, 앱 정보, 봇 사용자 정보 등 다양한 정보가 들어가 있었습니다.

on_message (MESSAGE CREATE)

{
  't': 'MESSAGE_CREATE',
  's': 4,
  'op': 0,
  'd': {
    'type': 0,
    'tts': False,
    'timestamp': '<time>',
    'referenced_message': None,
    'pinned': False,
    'nonce': '<nonce ID>',
    'mentions': [],
    'mention_roles': [],
    'mention_everyone': False,
    'member': {
      'roles': ['<role ID>'],
      'premium_since': None,
      'pending': False,
      'nick': None,
      'mute': False,
      'joined_at': '<joined_at>',
      'is_pending': False,
      'hoisted_role': '<role>',
      'deaf': False,
      'avatar': None,
      'user': {
        'username': '<name>',
        'id': <User ID>,
        'avatar': '<avatar>',
        'discriminator': '<tag>',
        'bot': False
      }
    },
    'id': '<message ID>',
    'flags': 0,
    'embeds': [],
    'edited_timestamp': None,
    'content': '.',
    'components': [],
    'channel_id': '<channel ID>',
    'author': {
      'username': '<name>',
      'public_flags': 131136,
      'id': '<User ID>',
      'discriminator': '<tag>',
      'avatar': '<avatar>'
    },
    'attachments': [],
    'guild_id': '<guild ID>'
  }
}

다음은 위에 있는 예제를 분석해보도록 하겠습니다. 't'의 값이 "MESSAGE CREATE"라는 것을 보아, 메시지가 만들어졌을 때 발생하는 이벤트 함수인 것을 알 수 있습니다.

'd'라는 키값에 데이터 값이 상당히 많다는 것을 알 수 있는데요. 수신받은 메시지, 임베드, 자료(attachments), 서버 정보, 채널 정보, 유저 정보, 맨션 유무 등의 상당한 많은 양에 데이터가 들어 있음을 알 수 있습니다. 이 데이터들이 discord.py에서는 message라는 데이터 모델(Data Model) 안에 들어가게 되어, 보다 쉽게 수집할 수 있었습니다.

그러면 버튼을 눌렀을 때도 이벤트가 발생한다는 것을 대충 눈치채셨을까요? 맞습니다. 버튼을 만들었을 때에도, "INTERACTION_CREATE"라는 이벤트가 발생합니다.

{
  't': 'INTERACTION_CREATE',
  's': 7,
  'op': 0,
  'd': {
    'version': 1,
    'type': 3,
    'token': '<token>',
    'message': '<message>',
    'member': {
      'user': {
        'username': '<name>',
        'public_flags': 131136,
        'id': '<id>',
        'discriminator': '<tag>',
        'avatar': '<avatar>'
      },
      'roles': ['<role>'],
      'premium_since': None,
      'permissions': '<permissions>',
      'pending': False,
      'nick': None,
      'mute': False,
      'joined_at': '<joined_at>',
      'is_pending': False,
      'deaf': False,
      'avatar': None
    },
    'id': '<id>',
    'guild_id': '<guild_id>',
    'data': {
      'custom_id': 'python',
      'component_type': 2
    },
    'channel_id': '<channel_id>',
    'application_id': '<application_id>'
  }
}

이렇게 생긴 payload가 들어오며, 사실 상당히 긴 내용의 데이터지만 일부 중복되는 데이터를 축약하여 알려드리겠습니다. 우선 member에는 버튼을 누른 사용자의 데이터가 들어가 있었습니다. 그리고, message에는 INTERACTION(상호작용)이 발생한 메시지 데이터가 들어 있었습니다. data 값에는 사용자가 누른 버튼의 데이터와 ID값이 들어 있습니다.

여기서 ID 값은 저번 2편에서 다루었던 'custom_id'라는 것을 알 수 있었습니다. 즉, 우리는 'custom_id'값이 버튼을 찾기 위한 고유의 키값이라는 것을 또 알 수 있습니다.

버튼을 받아볼까요?

이제 한번 사용자가 택한 버튼을 읽어보고 분석해보도록 하겠습니다.

이번 강의는 저번 편에 이어서 진행할 예정입니다. 저번 편에 있던 마지막 소스를 이어서 나갈 예정이니 지난 강의를 보지 못한 분들은 지난 강의를 보고 오시는 것이 편할 것입니다.

2021.06.01 - [개발 강좌/기타 강좌] - 디스코드봇(Components) - 02ㅣComponents를 통하여 버튼을 만들어보자!

우선 위에 말했듯 discord.py에서는 기본적으로 상호작용에 대한 이벤트가 존재하지 않기 때문에 직접 만들어야 합니다.

@client.event
async def on_socket_response(payload):
	if payload.get("t", "") == "INTERACTION_CREATE":
		return

그다음은 INTERACTION_CREATE이라는 이벤트만 받아야 하기 때문에 위 조건문을 추가해야 합니다.

+ 추가 (2021-06-13)
해당 이벤트는 버튼을 누르는 경우 외에도, "/" 명령어라는 빗금 명령어를 사용해도 발생합니다. 따라서 type를 통하여 구분을 할 필요가 있습니다.

상호작용 이벤트가 발생하는 타입(type)에는 총 3가지가 있으며, 아래의 표와 같습니다.

해당 내용을 아래의 표에 추가로 정리해두겠습니다.

이름 값

핑 1

빗금 명령어('/') 2

메시지 컴포넌트 3

따라서 data 값내에 있는 type 에서 "3" 값일 경우에만 작동하도록 만들어야 합니다.
@client.event
async def on_socket_response(payload):
	if payload.get("t", "") == "INTERACTION_CREATE" and payload.get("d", {}).get("type") == 3:
		return

왜냐하면 해당 이벤트를 통하여, 상호작용이라는 이벤트뿐만 아닌, 다른 다양한 이벤트가 발생하기 때문에 우리는 우리가 필요한 이벤트만 잡아줄 필요가 있습니다.

't에 이벤트 이름이 들어 있으니, 't' 값을 통하여 이벤트를 필터링해줍니다. 그다음 우리는 해당 이벤트에서 제공하는 데이터 값을 수집해야 합니다. 우선 사용자가 무엇을 선택했는지에 대한 정보와, 메시지 정보를 직접 수집해봅시다.

참고로, discord.py에서는 해당 값들이 모두 Data Class안에 내장되어 보다 쉽게 불러올 수 있지만, 직접 수집할 때에는 payload라는 변수 안에 dict형태의 데이터가 들어 있으므로 직접 수집해줘야 합니다.

d = payload.get("d", {})
message = d.get("message", {})
custom_id = d.get("data", {}).get("custom_id")

data 값을 불러오지 않고, custom_id를 바로 불러왔냐면, 굳이 Button 인 것을 아는데, 불러올 필요가 있을 까라는 생각이 들어서였습니다. 물론 data라는 변수가 없어서는 안 되겠지만, 만약에 없을 경우 None값을 불러오기 때문에 에러를 유발할 수 있습니다. 따라서, 우리는 dict의 기본값을 넣어주어서 값을 확인합니다.

마지막으로 print()를 사용하여, 사용자가 선택받은 값을 읽어보도록 합시다.

@client.event
async def on_socket_response(payload):
	if payload.get("t", "") == "INTERACTION_CREATE":
		d = payload.get("d", {})
		message = d.get("message", {})
		custom_id = d.get("data", {}).get("custom_id")
		print(custom_id)
	return

그런데 말입니다. 어찌 버튼을 눌러도 이상한 점을 발견하지 않으셨나요? 분명히 값은 잘 불러와지는데, 아래 사진과 같은 현상이 발생합니다.

상호작용 실패? 분명히 잘 받았는데, 왜 상호작용에 실패하였다는 메시지가 뜰까요? 그것은 디스코드 봇이 올바르게 버튼을 수신받았는지 알 수 없기 때문입니다. 따라서, 상호작용을 성공적으로 맞추었다는 내용을 Discord API에 발신해야 합니다.

상호작용(Ineraction Callback) 성공해보자!

나는 올바르게 수신받았다! 를 전달하기 위해선 메시지를 보내는 것처럼 HTTP 클래스를 활용해야 합니다.

사용방법은 아래의 디스코드 API 공식 문서에 작성돼 있긴 하지만, 이 강의에서 차근차근 다루어볼 것입니다.

https://discord.com/developers/docs/interactions/slash-commands#create-interaction-response

내용을 참조하자면 /interactions/{상호작용 ID}/{상호작용 token}/callback에 POST를 보내야 합니다.

방식은 2편에서 다루었던 메시지를 보내는 방법과 동일합니다. 근데 의문점이 발생합니다. 도대체 어디서 상호작용 ID와 토큰 값을 얻어오는 걸까요?

바로 위 이벤트에서 받았던 데이터 안에 포함되어 있습니다. 따라서 ID값과 토큰 값도 불러와야 합니다.

interaction_id = d.get("id")
interaction_token = d.get("token")

그러면 무슨 데이터를 보내야 할까요? 상호작용 ID 만과 토큰으로는 충분하지 않을 텐데 무엇이 더 필요할까요?

상호작용 유형(Type)과 그에 알맞은 데이터가 필요합니다. 우선 유형을 지정해볼까요?

우선 위 사진을 참조해보면 총 5가지의 콜백 유형이 존재합니다.

해당 표를 아래에 번역해보도록 하겠습니다.

이름	값	설명
퐁(Pong)	1	ACK 핑(아직 무슨 기능인지는 잘 모릅니다. ㅎㅎ)
ChannelMessageWithSource	4	새로운 메시지를 전송합니다. 이 메시지가 사용자만 볼 수 있는 메시지 인지 선택할 수도 있습니다.
DeferredChannelMessageWithSource	5	"생각 중 입니다."라는 메시지를 보냅니다. 만약에 처리하는데 시간이 걸리는 상호작용이라면 해당 값을 리턴시키는 것을 추천드립니다.
DeferredUpdateMessage	6	우선 성공적으로 상호작용에 성공했다는 메시지를 보냅니다. 그러나 추후 메시지 수정이 필요합니다.
UpdateMessage	7	data 내에 첨부된 내용을 기반으로 메시지를 수정합니다.

6번과 7번은 특히 컴포넌트(Components)를 사용했을 때만 사용이 가능한 기능인 점도 아래에 서술되어 있습니다.

5번과 6번을 리턴할 경우에는 추가적으로 데이터를 제공할 필요는 없지만, 4번과 7번을 보냈을 경우에는 리턴되는 데이터가 data라는 값 안에 포함되어야 합니다.

data에 전송해야 되는 값은 2편에서 다루었던 메시지를 출력하는 방식과 방식이 동일하지만 Message 안에 있는 flag값이 0일 경우 그리고 64 일 경우에 따라, 메시지를 공개할 것인지, 본인만 볼 수 있는지를 고를 수 있습니다.

flag값이 64일 경우 이렇게 리턴됩니다.

다시 우리가 개발하고 있었던 소스코드에 돌아와서 위 문서를 참조해준 뒤, 저는 사용자에게 ㅇㅇ을 골랐다고 알려주는 메시지를 추가하였습니다.

await bot.http.request(
	Route("POST", f"/interactions/{interaction_id}/{interaction_token}/callback"),
	json={"type": 4, "data": {
		"content": "당신은 {}를 고르셨군요!".format(custom_id),
		"flags": 64
	}},
)

이렇게 상호작용을 하는 방법까지 알아보았습니다.

지금까지 배운 것을 응용해봅시다

이번 강의에서 배운 상호작용(콜백)과 상호작용 수신을 토대로 어제 다루었던 프로젝트를 이어서 나가보도록 하겠습니다. 해당 내용은 이전 강의 글을 이어서 나가기 때문에 이전에 다루었던 코드가 필요합니다!

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

default_components = [
    {
        "type": 1,
        "components": [
            {
                "type": 2,
                "label": "Python",
                "style": 2,
                "custom_id": "python",
                "emoji": {
                    "id": "847876880257908757",
                    "name": "python"
                }
            }, {
                "type": 2,
                "label": "Kotlin",
                "style": 2,
                "custom_id": "kotlin",
                "emoji": {
                    "id": "847876848662216714",
                    "name": "kotlin"
                }
            }, {
                "type": 2,
                "label": "C언어",
                "style": 2,
                "custom_id": "c"
            }, {
                "type": 2,
                "label": "C++",
                "style": 2,
                "custom_id": "cpp",
                "emoji": {
                    "id": "847876987778629722",
                    "name": "cpp"
                }
            }, {
                "type": 2,
                "label": "Java",
                "style": 2,
                "custom_id": "java",
                "emoji": {
                    "id": "847876915619954708",
                    "name": "java"
                }
            }
        ]

    }
]

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: 0표
				<:kotlin:847876848662216714> Kotlin: 0표
				C언어: 0표
				<:cpp:847876987778629722> C++: 0표
				<:java:847876915619954708> Java: 0표""",
			colour=0x0080ff
		)
        
		r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
		payload = {
			"embed": embed.to_dict()
			"components": default_components
		}
		http.request(r, json=payload)
		return
       
bot.run("<토큰>")

(2편에서 다루었던 코드)를 편의상 가져와보았습니다. 이곳에 오늘 배운 소스를 모두 추가해줄 예정입니다.

우선, 위에서 말했듯이 이벤트를 저희가 직접 받아서 만들어 줘야 합니다.

@bot.event
async def on_socket_response(payload: dict):
	return

그다음 우리는 특정 이벤트 일 경우에만 작동할 수 있도록 필터링을 해준 뒤, 데이터 값과 이벤트 이름을 변수에 저장해둡니다.

@bot.event
async def on_socket_response(payload: dict):
	d = payload.get("d", {})
	t = payload.get("t")
	if t == "INTERACTION_CREATE" and d.get("type") == 3:
		return
	return

그다음, 사용자가 선택한 값을 불러옵니다. 그리고 메시지 값 또한, payload 데이터에서 꺼낸 뒤 변수에 저장해 둡니다. 해당 값은 추후 사용할 필요가 있습니다.

# + custom_id = d.get("data", {}).get("custom_id")
# + message = d.get("message")
@bot.event
async def on_socket_response(payload: dict):
	d = payload.get("d", {})
	t = payload.get("t")
	if t == "INTERACTION_CREATE" and d.get("type") == 3:
		custom_id = d.get("data", {}).get("custom_id")
		message = d.get("message")
	return

우선 저희는 최고의 프로그래밍 언어를 선택하는 프로그램을 만들 예정이기 때문에, 투표한 데이터 값을 저장해야 합니다.

voted_data = {}

맨 위에 해당 변수를 선언하여 전역 변수를 만들어 주고 나서, 아래처럼 메시지를 보내고 난 뒤에도 데이터를 저장할 수 있도록 값을 저장해 둡니다.

voted_data[response.get("id")] = {
	"python": 0, "kotlin": 0, "java": 0, "cpp": 0, "c": 0
}

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: 0표
				<:kotlin:847876848662216714> Kotlin: 0표
				C언어: 0표
				<:cpp:847876987778629722> C++: 0표
				<:java:847876915619954708> Java: 0표""",
			colour=0x0080ff
		)

		component1 = {
			"embed": embed.to_dict(),
			"components": default_components
		}

		response = await http.request(
			Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id), json=component1
		)
		voted_data[response.get("id")] = {
			"python": 0, "kotlin": 0, "java": 0, "cpp": 0, "c": 0
		}

그러고 나서, 사용자가 선택한 값을 변수에 저장해둔 뒤에 embed를 재생성합니다.

embed = discord.Embed(
	title="최고의 프로그래밍 언어",
	description="""<:python:847876880257908757> Python: {}표
				<:kotlin:847876848662216714> Kotlin: {}표
				C언어: {}표
				<:cpp:847876987778629722> C++: {}표
				<:java:847876915619954708> Java: {}표""".format(
		voted_data[message.get("id", 0)]['python'], voted_data[message.get("id", 0)]['kotlin'],
		voted_data[message.get("id", 0)]['c'], voted_data[message.get("id", 0)]['cpp'],
		voted_data[message.get("id", 0)]['java']),
	colour=0x0080ff
)

@bot.event
async def on_socket_response(payload: dict):
	d = payload.get("d", {})
	t = payload.get("t")
	if t == "INTERACTION_CREATE" and d.get("type") == 3:
		custom_id = d.get("data", {}).get("custom_id")
		message = d.get("message")
		
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: {}표
						<:kotlin:847876848662216714> Kotlin: {}표
						C언어: {}표
						<:cpp:847876987778629722> C++: {}표
						<:java:847876915619954708> Java: {}표""".format(
				voted_data[message.get("id", 0)]['python'], voted_data[message.get("id", 0)]['kotlin'],
				voted_data[message.get("id", 0)]['c'], voted_data[message.get("id", 0)]['cpp'],
				voted_data[message.get("id", 0)]['java']),
			colour=0x0080ff
		)
	return

그러고 나서 변경한 메시지를 사용자에게 전달해 주어야 합니다. 투표 후 수정된 값을 전송해 줍니다. 이 방법 역시 메시지를 송신할 때와 방법이 동일합니다.

component2 = {
	"embed": embed.to_dict(),
	"components": default_components
}

await http.request(
	Route('PATCH', '/channels/{channel_id}/messages/{message_id}',
	channel_id=message.get("channel_id"), message_id=message.get('id')), json=component2
)

@bot.event
async def on_socket_response(payload: dict):
	d = payload.get("d", {})
	t = payload.get("t")
	if t == "INTERACTION_CREATE" and d.get("type") == 3:
		custom_id = d.get("data", {}).get("custom_id")
		message = d.get("message")
		
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: {}표
						<:kotlin:847876848662216714> Kotlin: {}표
						C언어: {}표
						<:cpp:847876987778629722> C++: {}표
						<:java:847876915619954708> Java: {}표""".format(
				voted_data[message.get("id", 0)]['python'], voted_data[message.get("id", 0)]['kotlin'],
				voted_data[message.get("id", 0)]['c'], voted_data[message.get("id", 0)]['cpp'],
				voted_data[message.get("id", 0)]['java']),
			colour=0x0080ff
		)

		component2 = {
			"embed": embed.to_dict(),
			"components": default_components
		}

		await http.request(
			Route('PATCH', '/channels/{channel_id}/messages/{message_id}',
			channel_id=message.get("channel_id"), message_id=message.get('id')), json=component2
		)
	return

여기서 메시지는 "PATCH"라는 method와 "/channels/{채널 ID}/messages/{메시지 ID}"(https://discord.com/api/v9/channels/{채널 ID}/messages/{메시지 ID})로 수정할 수 있음을 알 수 있습니다. 채널 ID, 메시지 ID는 위에서 불러온 message 변수에서 꺼내왔습니다.

이제 다 왔습니다. 이제 사용자가 정상적으로 수신했다는 메시지만 얻어오면 됩니다.

interaction_id = d.get("id")
interaction_token = d.get("token")
		
await bot.http.request(
	Route("POST", f"/interactions/{interaction_id}/{interaction_token}/callback"),
	json={"type": 4, "data": {
		"content": "당신은 {}를 고르셨군요!".format(custom_id),
		"flags": 64
	}},
)

@bot.event
async def on_socket_response(payload: dict):
	d = payload.get("d", {})
	t = payload.get("t")
	if t == "INTERACTION_CREATE" and d.get("type") == 3:
		custom_id = d.get("data", {}).get("custom_id")
		message = d.get("message")
		
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: {}표
						<:kotlin:847876848662216714> Kotlin: {}표
						C언어: {}표
						<:cpp:847876987778629722> C++: {}표
						<:java:847876915619954708> Java: {}표""".format(
				voted_data[message.get("id", 0)]['python'], voted_data[message.get("id", 0)]['kotlin'],
				voted_data[message.get("id", 0)]['c'], voted_data[message.get("id", 0)]['cpp'],
				voted_data[message.get("id", 0)]['java']),
			colour=0x0080ff
		)

		component2 = {
			"embed": embed.to_dict(),
			"components": default_components
		}

		await http.request(
			Route('PATCH', '/channels/{channel_id}/messages/{message_id}',
			channel_id=message.get("channel_id"), message_id=message.get('id')), json=component2
		)
        
		interaction_id = d.get("id")
		interaction_token = d.get("token")
		
		await bot.http.request(
			Route("POST", f"/interactions/{interaction_id}/{interaction_token}/callback"),
			json={"type": 4, "data": {
				"content": "당신은 {}를 고르셨군요!".format(custom_id),
				"flags": 64
			}},
		)
	return

이 중에 사용자만 무엇을 택했는지 확인할 수 있도록 flags 값을 64로 제공하였습니다. 위에서 설명했듯이 0을 주면 전부 다 메시지를 볼 수 있지만, 64를 주면 버튼을 누른 사용자만 메시지를 확인하게 만들 수 있습니다.

이렇게 사용자가 버튼을 누른 값을 확인하고 이에 알맞은 값을 보내는 방법까지 알아보았습니다.

앞서 말한 코드는 Github Gist를 통하여 배포하고 있습니다. 저 위에 있는 코드가 잘보이지 않는다면 아래의 소스코드를 써보는 것도 나쁘지 않다고 생각합니다.

https://gist.github.com/gunyu1019/39bb26eccd23da99f2d8f7c6d5f22308

이렇게 이번 강의에서는 사용자가 버튼을 누른 값을 확인하고, 정상적으로 상호작용을 했다는 콜백 부분에 대하여 알아보았습니다. 사실은 이렇게 하면 디스코드 봇 버튼 만드는 과정은 마스터하신 거지만, 강의의 내용이 아직 하나 남아 있습니다. 다음 마지막 편에서는 아직 배포되지 않은 숨겨진 기능, Select에 대하여 다루어 보도록 하겠습니다.

이번 강의도 길이가 만만치 않은 편인데, 끝까지 읽어주신 분들께 감사인사를 드립니다. 모두들 수고하셨습니다!

디스코드봇(Components) - 02ㅣComponents를 통하여 버튼을 만들어보자!

건유1019 — Tue, 1 Jun 2021 02:42:25 +0900

안녕하세요. 이번 강의에서는 디스코드 봇(Components)을 통하여 버튼을 만들어 보도록 하겠습니다!

우선 오늘 배우는 것은 discord.py를 사용할 거지만, discord.py를 굳이 사용하지 않고, aiohttp나 requests 등을 통하여 HTTP 세션을 보낼 수 있다면, 충분히 가능합니다

우선 이번 강좌도 저번 강좌에 예고했듯이 난이도가 있는 편입니다. 본인이 "네트워크에 대한 지식이 없다", "프로그래밍 언어에 대한 기초 지식이 없다.", "디스코드 봇을 모른다" 그러면 많은 어려움이 따를 수 있습니다. 최소한 네트워크 지식을 알고 하시는 것을 추천합니다.

우선 Components를 활용한 버튼을 만드는 작업은 정식적으로 discord.py에서 지원해주지 않기 때문에 API를 통해야 합니다. 우선 Discord API 사용법에 대하여 알아봅시다.

Discord API 사용법?

우선 우리가 알아야 할 부분에 대해서만 집중적으로 다루겠습니다.

Discord API를 다루기 위해선 HTTP 세션을 Discord에 보내주어야만 합니다.

Discord API 주소는 <BASE URL>/v <버전>/<path>로 구성되어 있습니다.

우선 Discord API의 BASE URL는 "https://discord.com/api"입니다.

버전은 Components는 최근에 추가되었기 때문에 9 버전을 택하도록 하겠습니다.

따라서 디스코드 API를 사용하기 위해선 앞에 "h ttps://discord.com/api/v9"을 입력해야 합니다.

다음은 우리는 무슨 path를 보낼지 정해야 합니다.

우리는 메시지를 보낼 것이기 때문에 https://discord.com/developers/docs/resources/channel#create-message를 참고해서 사용해야만 합니다.

내용이 많이 복잡하지만 천천히 읽으면 모두 이해할 수 있는 사항입니다.

method는 POST 형태로, path는 "/channels/{채널 ID}/messages"를 통하여 메시지를 보낼 수 있다고 기재되어 있습니다.

Limitations(한계)에서는 아래와 같이 분석할 수 있습니다.

보낼 봇이 "메시지 보내기" 권한이 필요합니다.
TTS 메시지를 보낼 경우에는 "TTS 메시지 보내기" 권한이 필요합니다.
회신(답변)을 하기 위해서는 "메시지 역사 보기" 권한이 필요합니다.
메시지의 최대 전송 크기는 8MB로 제한됩니다.
임베드를 설정할 때에는 type에 rich 값을 안 주어도 rich 값으로 자동으로 설정합니다.
파일은 "multipart/form-data" 형태의 데이터 타입만 수신할 수 있습니다.

그리고 최소 파일, 메시지, 임베드(embed)를 하나 이상 제공해야 한다고도 하네요.

다음은 필요한 Params를 알아보도록 합시다. 위에 있는 표를 참고하면 됩니다. 위에 있는 표를 아래에 번역해 두도록 하겠습니다.

필드(키)	타입	설명	필수 여부
content	string(문자열)	메시지 내용 (최대 2000 자)	content, tts, file 중 하나는 필수로 작성해야합니다.
tts	boolean	TTS 활성화 여부	기본값이 True로 설정되며, 필수가 아닙니다.
file	file contents	파일 콘텐츠	content, tts, file 중 하나는 필수로 작성해야합니다.
embed	embed 모델	임베드 콘텐츠	content, tts, file 중 하나는 필수로 작성해야합니다.
payload_json	string (문자열)	파일이 아닌 매개 변수의 json 인코딩 본문	multipart/form-data만 받을 수 있습니다
allowed_mentions	allowed_mentions 모델	맨션 허가 여부	필수가 아닙니다.
message_reference	message_reference 모델	답장(회신)을 하기위한 메시지 콘텐츠	필수가 아닙니다.
components	components 모델	components 내용	필수가 아닙니다.

문서 내에 일부 누락되어 있지만, "components"에 대한 내용을 추가하였습니다.

따라서, Postman 등을 통하여 직접 보낼 때에는 아래처럼 보내야 합니다.

물론 그대로 보내게 된다면, 아래의 에러가 리턴될 겁니다.

{
    "message": "401: Unauthorized",
    "code": 0
}

이 문제는 토큰 값이 저장되어 있지 않기 때문에 사용자가 누군지 확인할 수 없어서 발생한 현상입니다.

그래서 우리는 우리가 누구인지 증명을 해줘야 합니다. 따라서 Headers 값에 "authorization"를 추가해줘야 합니다.

따라서 봇을 통하여 사용할 때에는 저렇게 작성해주시고 <token> 값에는 디스코드 봇의 토큰 값을 작성해줍니다.

(저기에 들어가는 값에 따라 유저 봇이라는 사용자가 봇이 되는 것도 가능하지만, 이용약관에 위배되는 사항이므로 다루지는 않겠습니다)

사실 이 과정은 discord.py가 없어도, 충분히 가능한 사항입니다. 다음은 discord.py를 통하여 메시지를 출력하는 방법을 알려드리겠습니다.

discord.py를 통하여 "직접 메시지"를 보내기

discord.py를 통하여 메시지를 보낸다고 하신 다면 어떤 사람들은 아래처럼 보내면 될 거라고도 합니다.

@bot.event
async def on_message(msg):
	await msg.channel.send("블라블라~")
    
@command.commands(name="명령어")
async def command(ctx):
	await ctx.send("블라블라~~")

그러나 최근에 지원을 하기 시작한 Components는 위 방법을 통하여 보내 줄 수 없기 때문에 "직접" 보내줘야 합니다.

우선 이 과정을 알기 위해서는 discord.py를 뜯어볼 필요가 있다고 봅니다. 우리는 우리의 목표를 충족하기 위해서 우리가 사용하는 코드의 일부를 보고 분석해야 할 능력이 있어야 합니다.

따라서 discord.py가 배포 중인 "https://github.com/Rapptz/discord.py"를 가 보록 합시다.

우리가 저렇게 ~. send()를 통하여 보낼 때 discord.py에는 아래의 함수가 실행되어 보내집니다.

discord/abc.py의 1172줄

이 함수를 집중적으로 분석해 봅시다. 참고로 views라는 매개변수는 아직 정식으로 추가된 것은 아니지만 Components와 관련된 매개변수라는 점을 또 알 수 있습니다. (아직 discord.py v1.7을 사용하는 개발자는 사용할 수 없습니다.)

코드를 분석해보자면 아래의 부분을 발견하게 됩니다.

이 부분은 파일을 제외한 tts, content, embed 등이 이곳을 통하여 보내진 다는 것을 알 수 있습니다. 저 함수의 위치를 다시 찾게 된다면 아래에 있다는 것을 알게 됩니다.

discord/http.py의 349줄

우리는 Route라는 함수에 위에 다루었던 method와 path를 볼 수 있습니다. 그렇습니다. 사실 discord.py도 Discord API를 거치고 있는 겁니다. 따라서 우리는 http.py에 있는 Route를 꺼내서, path와 method를 지정한 뒤에 HTTP 클래스에 있는 request 함수를 통하여 보내야 합니다.

HTTP 클래스는 Client 또는 Cog(Bot)을 사용하든 아래의 방법으로 꺼낼 수 있습니다.

http = Client.http # Client를 사용할 때, 대부분 Client이라는 변수를 사용한다는 전재
http = Bot.http # Cog를 사용할 때, 대부분 Bot이라는 변수를 사용한다는 전재

위에서 서술한 헤더(Headers)와 Base URI, 버전은 discord.py에서 자동으로 설정해주기 때문에, 굳이 신경을 쓰실 필요는 없습니다.

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
    if msg.content == "!프로그래밍":
    	return

우선 저는 discord.py에 있는 Client를 기준으로 서술해보겠습니다. cog도 이번에는 과정이 동일하기 때문에 충분히 따라오시면 가능할 겁니다.

우선 discord를 불러옵니다. 그리고 Route 클래스는 discord에 기본 모듈에는 없기 때문에 "직접" 불러와야 합니다.

다음은 우리는 Route를 불러와야 합니다.

r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
    if msg.content == "!프로그래밍":
    	r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
    	return

r값에 Route에서 불러온 클래스를 넣어 주었습니다.

우리는 시험 삼아 "파이썬 최고!"라는 메시지를 보내도록 하겠습니다.

위에 설명했던 content라는 키를 사용하여 보내게 됩니다. 파이썬에서는 params 데이터는 대부분 dict를 통하여 전송할 수 있습니다.

payload = {
	"content": "파이썬 최고!"
}

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
    if msg.content == "!프로그래밍":
    	r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
        payload = {
			"content": "파이썬 최고!"
		}
    	return

이제 우리는 이 메시지를 보내주어야만 합니다. 위에서 불러온 http 변수에 있는 request 함수를 통하여 가능하다고 했기 때문에 아래의 코드를 추가해주면, 우리는 ~. send()를 직접 구현한 것입니다.

http.request(r, json=payload)

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
    if msg.content == "!프로그래밍":
    	r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
        payload = {
			"content": "파이썬 최고!"
		}
        http.request(r, json=payload)
    	return

이렇게 discord.py를 통하여 메시지를 "직접" 보내는 방법에 대하여 알아보았습니다.

Components 사용법에 대하여 알아보자

다음은 Components를 보내보도록 합시다. 위 코드를 이어서 설명해보도록 하겠습니다.

우리는 Components를 사용하기 전에 사용 방법을 알아야 합니다.

https://discord.com/developers/docs/interactions/message-components를 통하여 Components 사용법을 알 수 있으며, (영어를 잘해야 되는 이유) 영어를 하실 줄 아신다면 충분히 저 내용만으로 만 이해하실 수 있을 겁니다.

우선 위에 있던 components라는 키값 안에 저 내용이 들어가야 하는 것이며, content에 있던 것처럼 넣어주시면 됩니다.

{
    "content": "This is a message with components",
    "components": [
        {
            "type": 1,
            "components": []
        }
    ]
}

문서 내에 있는 예제 문처럼 보내면 됩니다. 이렇게 하시면 components는 성공적으로 불러왔습니다.

이제 버튼을 만들어봐야 합니다.

버튼은 components안에 있는 components에 만들어야 합니다.

여기서 우리는 아래 서술되어 있는 components 모델에 대하여 확인해보도록 하겠습니다.

위 내용은 영어로 되어 있기 때문에, 아래에 표로 번역해두겠습니다.

필드(키)	타입	설명
type	int(정수형)	컴포넌트 타입(아래 서술)
style	int(정수형)	스타일 타입(아래 서술)
lable	string(문자열)	내용(아래 서술)
emoji	이모지 모델	이모지 콘텐츠
custom_id	string(문자열)	ID
url	string(문자열)	주소(아래 서술)
disabled	boolean	비활성화 여부

여기서 type은 필수로 사용해야 하며, style, label, custom_id는 버튼을 생성하기 위해 필수로 사용해야 하는 것들입니다.

그리고 위에 작성되어 있는 컴포넌트 타입은 위와 같습니다.

필드(키)	이름	설명
1	ActionRow	컴포넌트 가로 줄
2	버튼	버튼

따라서 type값을 2로 지정하셔야 버튼을 사용할 수 있습니다.

다음은 style에 대하여 서술해보겠습니다.

스타일은 아래와 같이 Primary-CTA(파란색), Primary-success(초록색), Secondary, Destructve(빨간색), Link로 구성할 수 있으며, 1~5의 값을 대입합니다. 따라서 Primary-CTA(파란색) 버튼을 만들고 싶다면, 1이란 값을 style에 넣어주시면 됩니다.

추가로 5번(Link 버튼)을 만들 때에는 위에 서술되어 있는 url 값을 무조건 넣어줘야 합니다.

disabled 키값에 True(참)을 넣게 될 경우 위 사진에 있는 것처럼 되며, 버튼을 누를 수 없도록 설정됩니다.

버튼을 넣어주게 된다면, 아래의 예시 코드가 구성될 것입니다.

{
    "content": "This is a message with components",
    "components": [
        {
            "type": 1,
            "components": [
                {
                    "type": 2,
                    "label": "버튼",
                    "style": 1,
                    "custom_id": "<찾을 버튼의 ID>"
                }
            ]

        }
    ]
}

그리고 버튼을 여러 개 만드신다면, components라는 리스트('[]') 안에 계속해서 넣어주시면 됩니다.

주의하실 점은 저 리스트 안에는 최대 5개의 버튼밖에 들어갈 수 없습니다. 따라서 버튼을 6개 이상을 한 줄에 넣을 수는 없다는 소리입니다.

지금까지 배운 것을 응용해봅시다!

이제 우리가 지금까지 알아온 위 내용을 토대로 1편에 있는 버튼을 만들어 보도록 합시다.

우리가 만들어 볼 디스코드 봇은 이렇습니다. embed안에 Python, Kotlin, C언어, C++, Java 중 최고의 프로그래밍 언어를 선정하는 프로그램입니다.

embed(임베드)의 title(주제) 값은 "최고의 프로그래밍 언어"라는 것을 알 수 있습니다.

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		return

우리는 위에 있는 코드가 있는 상태에서 다시 시작해보도록 하겠습니다.

기본적으로 Route와 http.requests를 설정해주신 뒤에, 위에서 서술했듯이 content, embed, file값은 무조건 하나 이상 포함하고 있어야 한다고 했기 때문에 우리는 embed값을 만들 어 줄 예정입니다.

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
		payload = {}
		http.request(r, json=payload)
		return

위 코드에서 위에서 다루었던, Route와 payload, http.requests를 모두 사용한다는 것을 알 수 있습니다.

embed는 discord.py에서 이미 지원하는 기능이기 때문에, 이미 지원하고 있는 embed를 통하여 만들어 보겠습니다.

embed = discord.Embed(
	title="최고의 프로그래밍 언어",
	description="""<:python:847876880257908757> Python: 0표
		<:kotlin:847876848662216714> Kotlin: 0표
		C언어: 0표
		<:cpp:847876987778629722> C++: 0표
		:java:847876915619954708> Java: 0표""",
	colour=0x0080ff
)

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: 0표
				<:kotlin:847876848662216714> Kotlin: 0표
				C언어: 0표
				<:cpp:847876987778629722> C++: 0표
				<:java:847876915619954708> Java: 0표""",
			colour=0x0080ff
		)
        
		r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
		payload = {}
		http.request(r, json=payload)
		return

embed라는 이름에 저장된 embed 값은. to_dict()를 통하여 dict형태의 embed 문을 불러올 수 있습니다. 따라서 payload에 "embed"라는 키값으로 embed.to_dict()라는 값을 넣어줍니다.

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: 0표
				<:kotlin:847876848662216714> Kotlin: 0표
				C언어: 0표
				<:cpp:847876987778629722> C++: 0표
				<:java:847876915619954708> Java: 0표""",
			colour=0x0080ff
		)
        
		r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
		payload = {
			"embed": embed.to_dict()
		}
		http.request(r, json=payload)
		return

embed를 이렇게 해서 payload라는 곳에 성공적으로 넣을 수 있습니다. 다음은 components 작업을 이어서 하도록 하겠습니다.

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: 0표
				<:kotlin:847876848662216714> Kotlin: 0표
				C언어: 0표
				<:cpp:847876987778629722> C++: 0표
				<:java:847876915619954708> Java: 0표""",
			colour=0x0080ff
		)
        
		r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
		payload = {
			"embed": embed.to_dict()
			"components": default_components
		}
		http.request(r, json=payload)
		return

컴포넌트의 내용은 사실상 매우 길어질 수 있기 때문에 따로 default_components라는 변수 안에 만들어 넣겠습니다.

default_components 에는 우선 우리가 위해서 서술했듯 Action Raw형태의 컴포넌트를 미리 넣어줘야 합니다.

default_components = [
	{
		"type": 1,
		"components": []
	}
]

그다음은 components안에 버튼을 넣어줘야 합니다. 하나하나 차근식 넣어주시면 됩니다.

{
	"type": 2,
	"label": "Python",
	"style": 2,
	"custom_id": "python",
	"emoji": {
		"id": "847876880257908757",
		"name": "python"
	}
}

이렇게 생긴 것을 총 5개 넣어주시면 됩니다. custom_id는 추후 우리가 식별한 id값을 넣어주시면 되고, label 값 안에는 디스코드 버튼의 이름을 넣어 주시면 됩니다.

여기서 우리가 강의 중에서 서술되지 않은 "emoji"부분이 있는데요, emoji 모델은 id와 name으로 구성되어 있으며, 이모지의 ID값과 이모지의 이름을 통하여 불러올 수 있습니다.

저 문장을 반복해서 총 5개의 버튼을 만들어주면 아래의 코드가 탄생합니다.

default_components = [
    {
        "type": 1,
        "components": [
            {
                "type": 2,
                "label": "Python",
                "style": 2,
                "custom_id": "python",
                "emoji": {
                    "id": "847876880257908757",
                    "name": "python"
                }
            }, {
                "type": 2,
                "label": "Kotlin",
                "style": 2,
                "custom_id": "kotlin",
                "emoji": {
                    "id": "847876848662216714",
                    "name": "kotlin"
                }
            }, {
                "type": 2,
                "label": "C언어",
                "style": 2,
                "custom_id": "c"
            }, {
                "type": 2,
                "label": "C++",
                "style": 2,
                "custom_id": "cpp",
                "emoji": {
                    "id": "847876987778629722",
                    "name": "cpp"
                }
            }, {
                "type": 2,
                "label": "Java",
                "style": 2,
                "custom_id": "java",
                "emoji": {
                    "id": "847876915619954708",
                    "name": "java"
                }
            }
        ]

    }
]

이렇게 default_components의 변수를 만들어 주었습니다. 이제 메인코드에 삽입해줍니다.

import discord
from discord.http import Route

bot = discord.Client()
http = bot.http

default_components = [
    {
        "type": 1,
        "components": [
            {
                "type": 2,
                "label": "Python",
                "style": 2,
                "custom_id": "python",
                "emoji": {
                    "id": "847876880257908757",
                    "name": "python"
                }
            }, {
                "type": 2,
                "label": "Kotlin",
                "style": 2,
                "custom_id": "kotlin",
                "emoji": {
                    "id": "847876848662216714",
                    "name": "kotlin"
                }
            }, {
                "type": 2,
                "label": "C언어",
                "style": 2,
                "custom_id": "c"
            }, {
                "type": 2,
                "label": "C++",
                "style": 2,
                "custom_id": "cpp",
                "emoji": {
                    "id": "847876987778629722",
                    "name": "cpp"
                }
            }, {
                "type": 2,
                "label": "Java",
                "style": 2,
                "custom_id": "java",
                "emoji": {
                    "id": "847876915619954708",
                    "name": "java"
                }
            }
        ]

    }
]

@bot.event
async def on_message(msg: discord.Message):
	if msg.content == "!프로그래밍":
		embed = discord.Embed(
			title="최고의 프로그래밍 언어",
			description="""<:python:847876880257908757> Python: 0표
				<:kotlin:847876848662216714> Kotlin: 0표
				C언어: 0표
				<:cpp:847876987778629722> C++: 0표
				<:java:847876915619954708> Java: 0표""",
			colour=0x0080ff
		)
        
		r = Route('POST', '/channels/{channel_id}/messages', channel_id=msg.channel.id)
		payload = {
			"embed": embed.to_dict()
			"components": default_components
		}
		http.request(r, json=payload)
		return
       
bot.run("<토큰>")

이렇게 코드를 완성하였습니다. 아무래도 discord.py에서는 공식적으로 지원하는 것도 아니고, 직접 구현하다 보니 생각보다 난이도가 있었을 거라고 생각합니다. 그럼에도 불구하고 여기까지 따라오셨다면 나중에 discord.py를 안 써보고도 디스코드 봇을 만들 수 있다는 사람입니다. discord.py를 사용하지 않고, 디스코드 봇 만들기 꼭 한번 해보시는 것을 추천드립니다.

이렇게 2편을 끝내게 되었습니다. 사실은 총 3편의 구성으로 알차게 작성하려 했지만, 아직 다루어야 할 부분이 조금 남아있어서 4편으로 끝내게 될 것 같다고 봅니다. 이번 강의 내용이 많이 길었지만 잘 따라와 주셔서 감사합니다.

다음 강의에서는 Components에 있는 버튼을 클릭하면 반응하도록 하는 부분에 대하여 작성해보도록 하겠습니다.

다시 한 번 긴 글을 읽어주신 여러분들 진심으로 감사합니다.

디스코드봇(Components) - 01ㅣComponents에 대하여 알아보자.

건유1019 — Sat, 29 May 2021 03:18:17 +0900

안녕하세요. 이번 강의에서는 디스코드 봇(Components)에 대하여 알아보도록 할 것입니다.

Components에 대한 강의는 총 3편으로 구성될 예정이며, 이번 편에서는 Components에 대한 개념을 알려드릴 껍니다.

여러분들은 동적(반응형) 디스코드 보라고 들어보신 적 있나요?

동적(반응형) 디스코드 보란 사용자와 디스코드 봇을 서로 상호작용하는 것을 의미합니다.

예를 들어 사용자는 특정 명령어를 요구한다면, 봇은 그것에 대한 정보를 반환합니다. 사용자는 그 정보를 기반으로 다시 특정 명령어를 요구하게 되고, 봇은 또 새롭게 들어온 특정 요구에 대하여 정보를 반환하는 것이라고 보면 됩니다.

Components는 "동적(반응형) 디스코드 봇"을 만들기 위해선 필수 요소라고 생각합니다. 기존에는 "반응(Reaction)"을 기반으로 꼼수를 사용하였다면, "컴포넌트(Components)"는 공식적으로 디스코드가 만들어 준 서로 간 상호작용하는 길이라고 봅니다.

처음 들어보는데, Components가 뭐예요?

Components는 슬래시 커맨드(빗금 명령어)의 기능 중 하나로, 2021년 5월 28일에 정식 추가된 기능입니다.

위 GIF와 같이, 메시지 아래에 버튼을 만들어 주어서, 봇과 사용자 간 서로 상호작용을 수월하게 해 주기 위하여 만들어진 기능입니다. 버튼뿐만 아닌, 드롭다운 등의 더욱 다양한 Components가 추가될 것이라고 합니다.

Components에 대한 여러 예시를 설명해보도록 하겠습니다.

위 사진을 비교해봅시다. 우리는 가위바위보라는 명령어를 만들었다고 가정하였을 때, 왼쪽은 직접 입력하는 방식이고 오른쪽은 버튼 하나로 해결됩니다. 이런 면에서는 사용자가 직접 작성하는 것보다는 버튼을 누르는 것이 효과적이며, 이런 점에서 유용하다고 봅니다.

다음의 예시는 디스코드 봇을 활용한 계산기입니다. 디스코드 봇 계산기의 경우 유저가 직접 입력할 수도 있으나, Code Injection 등의 보안 위협이 따르며, 보안면에서는 유저가 직접 입력하게 하는 것보다는 특정 값을 입력할 수 있도록 제한을 두어야만 합니다. 계산기의 경우도 우리는 특정 값만 요구하는 "화이트 리스트" 개념을 충족합니다. 만약에 Components를 사용하신 다면 이런 것도 만들어 볼 수 있다고 보겠습니다.

우리는 discord.py를 응용하여, "직접" 버튼을 만들어 보고자 합니다. 아직 discord.py에서도 해당 기능은 정식적으로 지원하지 않으나, discord.py를 통하여 Discord API와 통신하여 Components를 구현해볼 것입니다.

본 강의는 Discord Bot의 기초를 모를 경우, 많은 어려움이 따를 수 있습니다. 만약 디스코드 봇에 대하여 기초 지식이 부족할 경우, 디스코드 강의를 먼저 보시고 오시기 바랍니다.

이상 1편을 마치도록 하겠습니다. 2편에서는 위에 있는 사진 처럼 버튼을 불러오고 리턴된 값을 불러오는 방법까지 세세히 다루도록 하겠습니다!