디스코드 봇 - 쉽게 embed 메시지 꾸미는 법

embed로 디스코드 봇 메시지를 꾸며보자

디스코드 봇에서 메시지를 출력할 때, 틀을 잡고 꾸며주기 위해 사용할 수 있는 것으로 embed라는 것이 있다.

embed를 사용하여 메시지 틀을 잡는 법에 대해 살펴보자.

 

디스코드 봇 embed 공식 가이드

embed에 대해 자세히 알고자 하면, 아래의 공식 API 가이드 문서를 참고하자.

https://discordpy.readthedocs.io/en/latest/api.html?highlight=embed#embed

참고로, embed는 위와 같은 자료 구조를 갖추고 있다.

 

 

embed 기본 문법

여러가지 옵션을 사용하면 다양한 표현이 가능하겠지만, 기본적인 사용법만 먼저 알고 넘어가자.

 

embed 생성

embed = discord.Embed(title='타이틀 이름', description='설명', color=색상)

위와 같이 기본 embed 객체를 먼저 생성한다.

 

embed 필드 추가

embed.add_field(name='필드 이름', value='필드 값', inline=True 또는 False)

embed 밑에 필드는 위와 같은 형식으로 적어준다.

필드는 여러 개를 계속 추가할 수 있다.

 

embed footer 추가

embed.set_footer(text='꼬릿말')

위와 같이 꼬릿말 문구를 적어준다.

반응형

 

쉽게 작성하는 embed

위와 같이 기본 문법의 특성을 살펴 보았다.

이제 코드에 옮겨보자.

그런데, 이 embed를 쉽게 작성할 수 있는 사이트가 있다.

이 사이트를 사용하여 기본 윤곽을 잡고 시작하면 보다 시간을 절약할 수 있을 것이다.

https://cog-creators.github.io/discord-embed-sandbox/

이 사이트에서 기본 값을 입력해 보자.

위와 같이 기본 값을 입력하면, 아래와 같이 미리보기를 할 수 있다.

만약 필드 옵션에서 inline=False로 변경한다면 아래와 같이 레이아웃이 변경된다.

 

자동 생성되는 파이썬 코드 확인

사이트 하단으로 스크롤해보면, 앞서 직접 입력한 옵션에 맞게 파이썬 코드가 자동 생성되어 있는 것을 확인할 수 있다.

embed=discord.Embed(title="연관 검색어 조회", url="https://luran.me", description="사이트별 검색 결과가 어떻게 될까요?", color=0x0aa40f)
embed.set_author(name="luran", url="https://luran.me")
embed.add_field(name="Daum", value="테스트3,테스트4", inline=False)
embed.add_field(name="Naver", value="테스트1, 테스트2", inline=False)
embed.set_footer(text="연관 검색어 결과는 위와 같습니다.")
await ctx.send(embed=embed)

따라서, 이 코드를 바탕으로 본인의 입맛에 맞게 세부 변경을 하여 디스코드 봇에서 사용하면 될 것이다.

 

참고사항

inline=True/False 옵션은, 디스코드 PC 클라이언트에서는 정상적으로 잘 동작한다.

그러나, 휴대폰 등 모바일 클라이언트에서는 inline 옵션을 부여해도 정상 동작하지 않는다.
(2021/12월 기준)