50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
|
# 推广二维码背景图片说明
|
|||
|
|
|
|||
|
|
## 目录结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
static/images/
|
|||
|
|
├── tg_qrcode_1.jpg # promote 类型的背景图片（推广）
|
|||
|
|
├── yq_qrcode_1.png # invitation 类型的背景图片（邀请）
|
|||
|
|
└── README.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 支持的二维码类型
|
|||
|
|
|
|||
|
|
- `promote`: 使用 tg_qrcode_1.jpg 作为背景（推广二维码）
|
|||
|
|
- `invitation`: 使用 yq_qrcode_1.png 作为背景（邀请二维码）
|
|||
|
|
|
|||
|
|
## 路径计算说明
|
|||
|
|
|
|||
|
|
程序运行时的路径计算：
|
|||
|
|
|
|||
|
|
- 工作目录：`D:\Code\qnc-project\qnc-server`
|
|||
|
|
- 相对路径：`static/images`
|
|||
|
|
- 完整路径示例：
|
|||
|
|
- promote: `D:\Code\qnc-project\qnc-server\static\images\tg_qrcode_1.jpg`
|
|||
|
|
- invitation: `D:\Code\qnc-project\qnc-server\static\images\yq_qrcode_1.png`
|
|||
|
|
|
|||
|
|
## 背景图片要求
|
|||
|
|
|
|||
|
|
- 格式：支持 PNG、JPEG 等常见格式
|
|||
|
|
- 尺寸：建议不小于 600x600 像素
|
|||
|
|
- 设计：考虑到二维码会放置在图片中心，请在设计时预留中心区域
|
|||
|
|
|
|||
|
|
## API 使用示例
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 生成推广二维码
|
|||
|
|
GET /api/v1/agent/promotion/qrcode?qrcode_type=promote&qrcode_url=https://example.com/promotion/12345
|
|||
|
|
|
|||
|
|
# 生成邀请二维码
|
|||
|
|
GET /api/v1/agent/promotion/qrcode?qrcode_type=invitation&qrcode_url=https://example.com/invite/67890
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. 确保 tg_qrcode_1.jpg 和 yq_qrcode_1.png 文件存在于此目录下
|
|||
|
|
2. 二维码会自动添加白色半透明背景以确保可读性
|
|||
|
|
3. 二维码大小会根据背景图片尺寸自动调整，范围在 120px-300px 之间
|
|||
|
|
4. 默认二维码类型是 `promote`
|
|||
|
|
5. 程序启动时必须在项目根目录（qnc-server）下执行
|