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

• 语言: 英语
• 格式: .epub
• 来源: werobot.readthedocs.io

摘要

文档主要介绍了WeRoBot框架的功能、版本更新历史以及如何在微信公众号开发中使用。框架支持多种Web框架集成，如Django、Flask等，并提供了详细的API文档和配置选项。版本更新包括新增功能、修复问题以及对不同环境的兼容性优化。

AI总结

# WeRoBot 微信公众号开发框架总结

## 框架概述
WeRoBot 是一个用于微信公众号开发的框架，提供消息处理、自定义菜单、会话管理等功能，支持多种消息类型（如文本、图片、语音、视频、链接、位置等）的处理，并支持与 Django、Flask、Bottle、Tornado 等 Web 框架集成。

## 核心功能
1. **消息处理**：
- 支持多种消息类型（TextMessage、ImageMessage、LinkMessage、LocationMessage、VoiceMessage、VideoMessage）。
- 提供消息加解密功能。

2. **自定义菜单**：
- 支持创建和管理自定义菜单。

3. **会话管理**：
- 支持开启/关闭会话（Session），默认启用 Session。
- 提供多种 Session 存储方式（如 SQLiteStorage、FileStorage、MySQLStorage 等）。

4. **事件处理**：
- 支持多种微信事件（如用户扫描产品、支付完成、卡片查看等）的处理。

5. **API 支持**：
- 提供完善的微信 API 操作类（WeRoBot.Client），支持消息管理、素材管理、用户管理、账户管理等功能。

6. **错误处理**：
- 返回码支持，如 48001 表示 API 未授权。

## 版本更新
### Version 1.11.0
- 新增错误页面处理。
- 新增多种事件处理类（如 `UserScanProductEvent`、`UserScanProductEnterSessionEvent` 等）。
- 优化消息处理性能。

### Version 1.1.0
- 增加 `client property`，支持在 `BaseRoBot` 初始化时传入 `Config`。
- 支持与 Django 1.6+、Flask、Bottle、Tornado 集成。
- 修复打包时 `error.html` 被忽略的问题。

### Version 1.0.0
- 增加消息加解密功能。
- 支持自定义菜单、素材管理等 API。
- 修复 `FileStorage` 在 PyPy 下的兼容性问题。

### Version 0.6.1
- 修复 `upload_media` 的 URL 错误。
- 增加 `werobot.reply.SuccessReply` 和多种回复类型（如 `ImageReply`、`VoiceReply`、`VideoReply`）。

## API 说明
- **BaseRoBot**：框架的核心对象，负责消息处理和事件管理。
- **Config**：用于配置框架参数（如日志、会话存储等）。
- **Session 存储**：支持 SQLite、File、MySQL 等存储方式。

## 集成支持
- **Django**：支持 Django 1.8+，通过 `make_view` 将 WeRoBot 集成到 Django 应用。
- **Flask**：支持 Flask 框架，提供类似路由的接口。
- **Bottle、Tornado**：支持多种 Web 框架，灵活扩展。

## 注意事项
- 返回码 `48001` 表示 API 未授权。
- 消息处理中可能存在的缩略图不显示问题需注意。

WeRoBot 提供了丰富的功能和灵活的扩展性，适用于微信公众号的开发和管理。