websocket-client 是一个在 Python 中广泛使用的库，用于创建 WebSocket 客户端并实现与 WebSocket 服务器的双向通信。更多的关于websocket协议介绍，可以看看我之前写的文章哦！

【学习心得】websocket协议简介并与http协议对比http://t.csdnimg.cn/C3hEQ

一、安装和快速入门

pip install websocket-client

两个基本的使用示例来说明如何创建一个 WebSocket 客户端、连接到服务器、发送消息。

（1）websocket短连接

# 安装websocket-client库
# pip install websocket-client# 导入websocket
import websocket# 创建客户端实例
ws = websocket.WebSocket()# 连接指定的ws服务器
ws.connect("ws://echo.websocket.events")   # 这个网址是官方测试网址# 发送消息
ws.send("Hello!")
# print(ws.send("Hello!"))  # 返回的是你发送信息的字节大小，并不是真的服务器响应给你的数据# 接收响应
res = ws.recv()
print(res)  # recv方法才能得到服务器响应给你的数据# 关闭ws连接
ws.close()

（2）websocket长连接

# 导入websocket-client包
import websocket# 定义on_message回调函数用来处理 websocket事件——客户端接收服务端数据时触发
def on_message(ws_app, message):print(message)  # 当客户端接收到服务器响应回的数据时，把他打印出来显示一下# 实例化一个ws客户端
url = "wss://testnet-explorer.binance.org/ws/block"
ws = websocket.WebSocketApp(url=url, on_message=on_message)  # 传入的是回调函数所以不要小括号# 开启ws长连接
# 启动一个无限循环，保持WebSocket连接的持续开放状态，并监听来自服务器的数据流。
# 当有新的消息到达时，将通过 on_message 回调函数处理这些消息。
ws.run_forever()

二、websocket的所有事件介绍

WebSocket 对象的相关事件：

事件	事件回调函数	描述
open	on_open	连接建立时触发
message	on_message	客户端接收到服务器数据时触发
error	on_error	通信发生错误时触发
close	on_close	连接关闭时触发

# 导入websocket-client库
import websocket# 定义on_message事件回调函数
def on_message(ws_app, message):print("接收到服务器响应：", message)# 定义on_error事件回调函数
def on_error(ws_app, error):print(error)# 定义on_open事件回调函数
def on_open(ws_app):print('已连接到WebSocket服务器')# 定义on_close事件回调函数
def on_close(ws_app):print('已关闭和WebSocket服务器的连接')# 实例化一个ws客户端
url = "ws://echo.websocket.events"
ws = websocket.WebSocketApp(url=url,on_open=on_open,on_message=on_message,on_error=on_error,on_close=on_close,
)# 开启长连接，开始监听
ws.run_forever()# 发送信息
ws.send("hello!")# 关闭连接
ws.close()

三、如何主动退出长连接？

"""
设置一个退出标志：
在运行 run_forever() 的外部定义一个全局变量作为退出标志，
并在需要关闭连接的地方将其设置为True。
然后，在 on_message() 或其他回调函数（如 on_error()、on_close() 等）中检查这个标志，
当满足特定条件或接收到信号时调用 ws_app.close()。
"""
import websocketshould_close = Falsedef on_message(ws_app, message):print(message)# 检查是否需要关闭连接if should_close:ws_app.close()ws = websocket.WebSocketApp("wss://testnet-explorer.binance.org/ws/block", on_message=on_message
)# 当你需要关闭连接时
def close_websocket():global should_closeshould_close = Truews.close()# 开始监听
ws.run_forever()