【Discord bot 2.0.1】（discord.ui.View）如何將舊機器人升級至目前最新版本 @小編過路君子

[無邊框]

1228

【Discord bot 2.0.1】（discord.ui.View）如何將舊機器人升級至目前最新版本

“

很多時候升級軟體是為了讓別人覺得你的程式很先進，但這次卻是因為要使用某個新功能

„

分享此文連結 //n.sfs.tw/15962

分享連結【Discord bot 2.0.1】（discord.ui.View）如何將舊機器人升級至目前最新版本@小編過路君子

(文章歡迎轉載，務必尊重版權註明連結來源)

2022-10-30 00:48:09 最後編修

2022-10-29 04:08:21 By 過路君子

哈囉大家好，這裡是錢包超級大失血的小編過路君子

要去考證照(LPIC-1 101-500)，報名費 200 美金......如果順利考過之後會發心得。

小編從很早之前就開始撰寫 Discord 機器人了，準確來說是從 2021/06/22(1.7.3 版本) 時就開始撰寫了，算算也寫了一年多了。

在這一年間陸陸續續新增及優化許多功能，想當初剛開始寫得時候機器人背後甚至連個資料庫都沒有，也是後來才長出來的。

(所有圖片點擊都可以放大、變高清)

小編本來沒有打算要更新 Discord 機器人的版本，但是最近想要使用 discord.ui.View 的功能，也就是按鈕的功能啦～

而這個功能是 2.0.0 之後的版本才有，所以小編也只好心不甘情不願的更新上去。

果然，大部分差不多，但是還是有少部分地方出錯了，所以小編這篇文章會提起究竟 1.7.3 和 2.0.1 有哪些細微的差別。

Step1. 更新 discord.py 至目前最新版本

那小編在這邊直接採用 pip 的方式來更新 discord.py，所以直接連下兩道更新指令。

pip install --upgrade discord
pip install --upgrade discord.py

更新完成之後可以使用 pip list 來查看有沒有更新成功。

Step2. 更新機器人加載 Cog 方式

這部分最麻煩，因為 Cog 加載的方式他們有更新了，所以舊的寫法沒有辦法使用了。

那小編這邊會將舊的寫法和新的寫法一併呈現，方便大家來修改自己的程式碼。

那我們先從啟動機器人開始吧～

舊的寫法(1.7.3 及以下版本)：

from sys import path
path.insert(0, "./background/")

import core
import discord
from os import listdir
from discord.ext import commands


bot = commands.Bot(command_prefix="s!", intents=discord.Intents.all())

class main(core.administrator):
    @bot.event
    async def on_ready():
        pass


def setup(bot):
    bot.add_cog(main(bot))

if __name__ == "__main__":
    bot.run(TOKEN)

for pyfile in listdir("./background/"):
    if pyfile[-3:] == ".py":
        bot.load_extension("background." + pyfile[:-3])

新的寫法(2.0.0 及以上版本)：

from sys import path
path.insert(0, "./background/")

import core
import discord
from os import listdir
from discord.ext import commands


bot = commands.Bot(command_prefix="s!", intents=discord.Intents.all())

class main(core.administrator):
    @bot.event
    async def on_ready():
        intents = discord.Intents.default()
        intents.message_content = True

        for pyfile in listdir("./background/"):
            if pyfile[-3:] == ".py":
                await bot.load_extension("background." + pyfile[:-3])


if __name__ == "__main__":
    bot.run(TOKEN)

可以很清楚的發現，bot.load_extension 從一般的函數變成了異步協程(Coroutines)了。

所以沒辦法像舊版一樣直接放在 bot.run 後面，必須找一個 async def 的函數塞進去，小編看來看去還是 on_ready() 最適合。別忘記在前頭加上 "await" 喔！

至於舊寫法裡的 setup 函數小編不確定是否可以省略，但跑了一年多都沒問題，所以小編也沒有特別去測試。

另外，以下兩行不能省：

intents = discord.Intents.default()
intents.message_content = True

如果省略了，那在之後使用 discord.ui.View 時會出事。

另外，如果有用到 unload_extension 或是 reload_extension 這兩個函數。

也必須像上面那樣在前面加上 await 才能正常運作。

相關程式的舊寫法[部分] (1.7.3 及以下版本)：

class core(commands.Cog):
    @commands.command()
    @commands.check(Permission.developer)
    async def load(self, ctx, filename):
        self.bot.load_extension("background." + filename)
        await ctx.send("Loaded " + filename + " done!")

    @commands.command()
    @commands.check(Permission.developer)
    async def unload(self, ctx, filename):
        self.bot.unload_extension("background." + filename)
        await ctx.send("Unloaded " + filename + " done!")

    @commands.command()
    @commands.check(Permission.developer)
    async def reload(self, ctx, filename):
        self.bot.reload_extension("background." + filename)
        await ctx.send("Reloaded " + filename + " done!")

相關程式的新寫法[部分] (2.0.0 及以後版本)：

class core(commands.Cog):
    @commands.command()
    @commands.check(Permission.developer)
    async def load(self, ctx, filename):
        await self.bot.load_extension("background." + filename)
        await ctx.send("Loaded " + filename + " done!")

    @commands.command()
    @commands.check(Permission.developer)
    async def unload(self, ctx, filename):
        await self.bot.unload_extension("background." + filename)
        await ctx.send("Unloaded " + filename + " done!")

    @commands.command()
    @commands.check(Permission.developer)
    async def reload(self, ctx, filename):
        await self.bot.reload_extension("background." + filename)
        await ctx.send("Reloaded " + filename + " done!")

Step3. 更新機器人 Cog 被加載方式

沒錯，既然讀取 Cog 的方式被改成了異步協程(Coroutines)，那當然被讀取的 Cog 也一併被更新成異步協程了。

還記得我們在 load_extension 時會做什麼事情嗎？沒錯，會去呼叫該 py 檔案的 setup 函數來完成加載的動作，而就是我們要來動手腳的部分。

相關程式的舊寫法[部分] (1.7.3 及以下版本)：

import discord
from discord.ext import commands

class core(commands.Cog):
    pass


def setup(bot):
    bot.add_cog(core(bot))

相關程式的新寫法[部分] (2.0.0 及以後版本)：

import discord
from discord.ext import commands

class core(commands.Cog):
    pass


async def setup(bot):
    await bot.add_cog(core(bot))

Step4. 更新部分函式

基本上函數或是相關資料取得的方式都沒有變化，小編目前也只有發現一個跟之前不同，所以特地將此列出。

取得用戶頭像圖片網址的舊寫法 (1.7.3 及以下版本)：

import discord
from discord.ext import commands

class core(commands.Cog):
    @commands.command()
    async def url(self, ctx):
        await ctx.send(ctx.author.avatar_url)


def setup(bot):
    bot.add_cog(core(bot))

取得用戶頭像圖片網址的新寫法 (2.0.0 及以後版本)：

import discord
from discord.ext import commands

class core(commands.Cog):
    @commands.command()
    async def url(self, ctx):
        await ctx.send(ctx.author.avatar.url)


def setup(bot):
    bot.add_cog(core(bot))

嘿，沒錯，就是將 avatar_url 換成 avatar.url 而已，簡單吧！

以上就是如何將 Discord bot 從 1.7.3 升級至 2.0.1 版本。

變動最大的部分果然還是 Cog 的部分，從原本的一般函數變成異步協程的函數，導致有幾個 Cog 檔就要改多少個地方。

後記

這篇文章的標題雖然放了 discord.ui.View，但是好像只有一個小小的地方提到，不知道這算不算是標題詐欺。

END

你可能感興趣的文章

【Nexus Repository Manager】（deploy）使他人可以對遠端資料庫做讀寫使用 Nexus Repository Manager 來讓各個工程師控制自己的 Jar 包，不會有 Github Merge Crashed 問題。

【Maven】如何開始撰寫 Minecraft PaperMC server插件萬事起頭難，要開始寫一個插件最難的一步就是要怎麼開始寫

【Python3】[Django] (Windows / Liunx) 如何從零開始創建一個網站除了最基本的運作以外，還小小的加上了如何自導向特定目錄。

【MySQL】每個類別中取前三高一個由多層次所組成的SELECT述句

【Wickct】如何製作一個簡單的動態響應頁面和傳遞參數至其他頁面身為一個後端架構程式，這個功能當然是非常重要之一

【Arduino／LinkIt 7697】實作小小的 MQTT Publish & Subscribe 若是要多點對多點傳輸資料，那使用 MQTT 即可快速的達成我們所需的目的

隨機好文

高捷少女：地下城的探險少女⑤ 小穹寫好後，耐耐看了一遍。「我想我應該辦得到。」她說完跪坐在地上，然後把古箏安放在大腿上，並將樂譜放在前面的地板。「要開始囉。」耐耐閉上眼睛，深呼吸一口氣，小穹等人在一旁看著她，心中暗自替她打氣。

高捷少女：耐耐的新年驚喜① 耐耐拿出手機。「我回來囉。」她說。幾分鐘後，木門緩緩打開。當它完全開啟的那一刻，小穹手中的包包掉到地上；艾米揉揉雙眼，確定自己看見的景象；婕兒的三魂七魄飛到了九霄雲外。

【歌評】過去の花過去的花～ Fairy of Flower 彼岸花（higan bana），就是歌曲名中所指的花，而彼岸花又有「地獄花jigoku bana」的別稱，請注意，蓮台野的周圍可是長滿彼岸花呢！

【歌評】蓮台野夜行 -月之妖鳥、化貓之幻　月の妖鳥、化猫の幻這是一個很好的問題，現實與幻覺的界線從來沒有如此的模糊，沒有一條明確的界線將其畫開

【數學】徐氏數學簡明講義(三) 第二章直線與園 P2.1-17 Q34 34.設Ｐ(x , y)為座標平面上一點，　且滿足，則Ｐ點的位置可能在哪裡？　 (1)第一象限(2)第二象限(3)

到最底端