從零開始微信機(jī)器人(一):wxpy簡(jiǎn)介(登錄、消息發(fā)送、注冊(cè)回復(fù))

在過去的幾個(gè)月中,由于在新生群中回答問題費(fèi)時(shí)費(fèi)力,同時(shí)又有許多重復(fù)而又有固定答案的回答,我受到一些知乎文章的啟發(fā),維護(hù)了一個(gè)基于itchat的群聊機(jī)器人。從剛開始接入圖靈機(jī)器人時(shí)只會(huì)尬聊的機(jī)器人,之后又加入了api.ai的按照消息內(nèi)容自動(dòng)回復(fù),而后再加入了回復(fù)表情功能,使得機(jī)器人變得越來越有趣。

現(xiàn)在,由于itchat的更新和被wxpy一些更有趣的功能所吸引,我計(jì)劃將這個(gè)機(jī)器人分步重寫,并將完整的機(jī)器人構(gòu)建步驟展現(xiàn)給大家。這是我第一次做這樣的事,有諸多不足之處,也希望多多諒解和指正。

本文很大程度上面向僅對(duì)python入門或是了解較少的開發(fā)者因此較為詳細(xì),希望最大程度上幫助大家從零開始構(gòu)建一個(gè)屬于自己的微信機(jī)器人,哪怕僅有很少的編程基礎(chǔ)。每一篇會(huì)將長(zhǎng)度控制在較短、能夠快速閱讀完的范圍內(nèi)。

本文基于python 2.7,與python 3.5可能有語(yǔ)法上區(qū)別。

安裝wxpy

安裝wxpy非常簡(jiǎn)單,如果你擁有pip,請(qǐng)直接按照Github中的方法安裝:

從 PYPI 官方源下載安裝 (在國(guó)內(nèi)可能比較慢或不穩(wěn)定):

pip install -U wxpy

從豆瓣 PYPI 鏡像源下載安裝 (推薦國(guó)內(nèi)用戶選用):

pip install -U wxpy -i "https://pypi.doubanio.com/simple/"

登錄微信

(這里吐槽一下wxpy文檔中登錄錯(cuò)寫為登陸)

Github上和文檔中給出了最簡(jiǎn)單的登錄機(jī)器人的方式,在程序中寫上這兩行并運(yùn)行,會(huì)通過圖片掃描二維碼并登錄微信。

# 導(dǎo)入模塊
from wxpy import *
# 初始化機(jī)器人,掃碼登陸
bot = Bot()

有些情況下,可能不能通過終端打開圖片(例如部署在服務(wù)器上時(shí)),我們可以通過參數(shù)選擇在終端內(nèi)顯示二維碼,這樣代碼會(huì)變?yōu)椋?/p>

from wxpy import *
bot = Bot(console_qr=True)

如果你發(fā)現(xiàn)這樣設(shè)置終端中的二維碼變形了,可以嘗試傳入console_qr=1(或其他倍數(shù))來進(jìn)行調(diào)整字幅寬度。如果需要反色顯示,可以使用負(fù)數(shù)來進(jìn)行反色操作。

如果你認(rèn)為每次都需要掃描二維碼很麻煩,可以啟用緩存,來保存自己的登錄狀態(tài):

bot = Bot(console_qr=True, cache_path=True)

發(fā)送消息

首先我們嘗試給自己和文件傳輸助手發(fā)消息:

# 給機(jī)器人自己發(fā)送消息
bot.self.send('Hello World!')
# 給文件傳輸助手發(fā)送消息
bot.file_helper.send('Hello World!')

如果無法給機(jī)器人自身發(fā)送消息,請(qǐng)參考http://wxpy.readthedocs.io/zh/latest/bot.html#wxpy.Bot.self

# 查找昵稱為'乙醚。'的好友
my_friend = bot.friends().search(u'乙醚。')[0]
# <Friend: 乙醚。>

wxpy同時(shí)也包括了發(fā)送不同類型消息的方法,通過這些方法我們可以發(fā)送各種不同類型的消息。以下是文檔給出的樣例使用方式:

# 發(fā)送文本
my_friend.send('Hello, WeChat!')
# 發(fā)送圖片
my_friend.send_image('my_picture.png')
# 發(fā)送視頻
my_friend.send_video('my_video.mov')
# 發(fā)送文件
my_friend.send_file('my_file.zip')
# 以動(dòng)態(tài)的方式發(fā)送圖片
my_friend.send('@img@my_picture.png')

通過使用這些方法,我們就可以自定義一個(gè)在合適的時(shí)候做合適的事情的機(jī)器人了!

由于群聊機(jī)器人設(shè)計(jì)暫時(shí)需要好友相關(guān)內(nèi)容不多,此處不再作過過多贅述,如果有需要搜索好友的可以參考http://wxpy.readthedocs.io/zh/latest/chats.html#module-wxpy

自動(dòng)處理消息

wxpy提供了注冊(cè)消息的方法,可以簡(jiǎn)單將各種類型的消息注冊(cè)并自定義處理方式。

注冊(cè)消息使用簡(jiǎn)單的@bot.register()方法,

# 獲取所有類型的消息(好友消息、群聊、公眾號(hào),不包括任何自己發(fā)送的消息)
# 并將獲得的消息打印到控制臺(tái)
@bot.register()
def print_others(msg):
    print(msg)

同時(shí)wxpy也可以給注冊(cè)消息的類型加上限制,

# 回復(fù) my_friend 發(fā)送的消息
@bot.register(my_friend)
def reply_my_friend(msg):
    return 'received: {} ({})'.format(msg.text, msg.type)

# 回復(fù)發(fā)送給自己的消息,可以使用這個(gè)方法來進(jìn)行測(cè)試機(jī)器人而不影響到他人
@bot.register(bot.self, except_self=False)
def reply_self(msg):
    return 'received: {} ({})'.format(msg.text, msg.type)

# 打印出所有群聊中@自己的文本消息,并自動(dòng)回復(fù)相同內(nèi)容
# 這條注冊(cè)消息是我們構(gòu)建群聊機(jī)器人的基礎(chǔ)
@bot.register(Group, TEXT)
def print_group_msg(msg):
    if msg.is_at:
        print(msg)
        msg.reply(meg.text)

當(dāng)然僅僅寫以上內(nèi)容,會(huì)導(dǎo)致你的程序主程序運(yùn)行結(jié)束自然退出。wxpy給出了embed()方法,在程序末尾(或其他你想要暫停調(diào)試的地方)加上embed()方法就可以讓程序保持運(yùn)行,同時(shí)進(jìn)入Python命令行。

# 進(jìn)入 Python 命令行、讓程序保持運(yùn)行
# 推薦使用
embed()

# 或者僅僅堵塞線程
# bot.join()

關(guān)于消息注冊(cè)的文檔,更多內(nèi)容可以參考http://wxpy.readthedocs.io/zh/latest/messages.html#id11

現(xiàn)在,你已經(jīng)可以用這個(gè)微信機(jī)器人和自動(dòng)回復(fù)消息玩了!刺不刺激呢!

下一篇中,我將就如何將API接入機(jī)器人進(jìn)行闡述。

你可能會(huì)遇到的一些問題

報(bào)錯(cuò)[SSL: CERTIFICATE_VERIFY_FAILED]

可能的解決方案一:

pip install -U requests[security]

可能的解決方案二:

進(jìn)如python后運(yùn)行:

import certifi 
print(certifi.old_where())

把打印出的路徑(例如我的是/usr/local/lib/python2.7/site-packages/certifi/weak.pem)放入環(huán)境變量REQUESTS_CA_BUNDLE中。具體而言是在*nix環(huán)境下運(yùn)行:

export REQUESTS_CA_BUNDLE='What you get'

或是在Windows中使用系統(tǒng)面板進(jìn)行修改。

機(jī)器人代碼

我的微信機(jī)器人的代碼在GitHub托管,歡迎查看(づ ̄3 ̄)づ╭?~

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容