WeRoBot 1.2.0 微信公众号开发框架文档

《WeRoBot 1.2.0 微信公众号开发框架文档》总结 WeRoBot 1.2.0 是一个功能强大的微信公众号开发框架，支持消息处理、自定义菜单、消息加解密、会话管理等核心功能，并提供了与 Django、Flask 等 Web 框架的集成能力。以下是文档的核心内容总结： ### 1.框架概述 WeRoBot 是一个基于 Bottle 框架的微信公众号开发框架，支持多种消息类型（文本、图片、链接、地理位置、语音、视频等）和事件（关注、扫描二维码、点击菜单等）的处理。框架通过 Handler decorators 提供灵活的消息处理机制，用户可以根据需要编写特定类型的 Handler。 ### 2.快速入门 - 安装框架并创建一个简单的微信机器人。 - 使用 `@robot.handler` 装饰器定义消息处理逻辑。 - 配置服务器监听地址和端口，运行机器人。 示例代码： ```python import werobot robot = werobot.WeRoBot(token='token') @robot.handler def hello(message): return 'Hello World!' robot.run() ``` ### 3.核心功能 #### 消息处理 WeRoBot 支持多种消息类型和事件的处理，包括： - **消息类型**：文本消息（`@robot.text`）、图片消息（`@robot.image`）、视频消息（`@robot.video`）等。 - **事件处理**：关注事件（`@robot.subscribe`）、取消关注事件（`@robot.unsubscribe`）、自定义菜单点击事件（`@robot.key_click`）等。 #### 自定义菜单 支持创建、删除和查询自定义菜单。 #### 会话管理 WeRoBot 提供了 Session 功能，支持记录用户状态，存储方式包括 Redis、 SQLite 和简单的键值存储。 #### 消息加解密 支持微信公众号的安全模式，需配置 AppID 和 EncodingAESKey，通过 `cryptography` 库实现加密和解密。 ### 4.框架集成 - **Django**：通过 `werobot.contrib.django.make_view` 将 WeRoBot 集成到 Django 项目中。 - **Flask**：在 Flask 项目中创建 WeRoBot 实例并配置路由。 ### 5.框架配置 通过 `WeRoBot.Config` 类管理配置，支持从对象或文件导入配置。常用配置项包括： - 服务器监听地址（`HOST`）和端口（`PORT`）。 -微信公众号 AppID、AppSecret 和 EncodingAESKey。 - 会话存储类型（`SESSION_STORAGE`）。 ### 6.更新日志 - **Version 1.2.0**：新添了对短视频消息的支持。 - **Version 0.6.1**：修复了上传媒体文件的URL错误。 - **Version 0.6.0**：新增了对微信支付的支持。 ### 7.API文档 提供了完整的 API 参考，包含 Client 类和 BaseRoBot 类的方法，用于操作微信公众号的各种功能，如用户管理、素材管理、菜单管理等。 总结：WeRoBot 1.2.0 是一个功能齐全、易于集成的微信公众号开发框架，适合快速搭建和开发微信公众号应用。