模板变量的使用

# 模板变量使用文档

## 概述

本文档描述了微设备支持的模板变量，这些变量可以在通道模板中使用，用于动态替换为实际的消息数据或设备信息。

## 变量分类

### 1. 短信相关变量

当消息类型为 `sms` 时可用：

| 变量名 | 说明 | 示例值 |
|--------|------|--------|
| `{{短信内容}}` | 短信的具体内容 | "您的验证码是 123456" |
| `{{短信号码}}` | 发送短信的号码 | "10086" |
| `{{短信时间}}` | 接收短信的时间 | "2026-01-28 14:30:00" |

### 2. 来电相关变量

当消息类型为 `call` 时可用：

| 变量名 | 说明 | 示例值 |
|--------|------|--------|
| `{{来电类型}}` | 来电类型，"来电"或"未接来电" | "未接来电" |
| `{{来电号码}}` | 来电号码 | "13800138000" |
| `{{来电时间}}` | 来电时间 | "2026-01-28 15:45:00" |

### 3. 开机相关变量

当消息类型为 `boot` 时可用：

| 变量名 | 说明 | 示例值 |
|--------|------|--------|
| `{{启动时间}}` | 设备启动时间 | "2026-01-28 08:00:00" |

### 4. 通用变量

适用于所有消息类型：

| 变量名 | 说明 | 示例值 |
|--------|------|--------|
| `{{时间}}` | 消息发生的时间 | "2026-01-28 14:30:00" |
| `{{时间戳}}` | 消息发生的时间戳 | "1738125000" |
| `{{事件类型}}` | 消息类型，如 "sms"、"call"、"boot" | "sms" |

### 5. 选项变量

由调用时传入的 `options` 参数提供：

| 变量名 | 说明 | 示例值 |
|--------|------|--------|
| `{{标题}}` | 自定义标题 | "重要通知" |
| `{{内容}}` | 自定义内容 | "这是一条测试消息" |

### 6. 设备信息变量

基于设备的实际信息：

| 变量名 | 说明 | 示例值 |
|--------|------|--------|
| `{{设备名称}}` | 设备的自定义名称 | "我的 iPhone" |
| `{{设备型号}}` | 设备的型号 | "iPhone 12" |
| `{{imei}}` | 设备的 IMEI 号 | "123456789012345" |
| `{{设备号码}}` | 设备的手机号码 | "138****8888" |
| `{{iccid}}` | SIM 卡的 ICCID | "89860112345678901234" |
| `{{运营商}}` | 移动网络运营商 | "中国移动" |
| `{{固件版本}}` | 设备固件版本 | "1.0.0" |
| `{{开机时长}}` | 设备已开机的时间 | "2小时30分钟" |
| `{{纬度}}` | 设备当前位置的纬度 | "39.9042" |
| `{{经度}}` | 设备当前位置的经度 | "116.4074" |
| `{{地图链接}}` | 设备当前位置的地图链接 | "https://maps.google.com/?q=39.9042,116.4074" |
| `{{信号强度}}` | 设备当前的信号强度 | "-75 dBm" |

## 使用示例

### 短信通知模板示例

```
收到新短信
来自：{{短信号码}}
内容：{{短信内容}}
时间：{{短信时间}}
设备：{{设备名称}}
```

### 来电通知模板示例

```
{{来电类型}}提醒
号码：{{来电号码}}
时间：{{来电时间}}
设备：{{设备名称}}
信号：{{信号强度}}
```

### 开机通知模板示例

```
设备已开机
时间：{{启动时间}}
设备：{{设备名称}}
位置：{{纬度}}, {{经度}}
地图：{{地图链接}}
```

## 注意事项

1. 变量名区分大小写，请严格按照文档中的格式使用
2. 变量使用双大括号 `{{}}` 包围
3. 对于不存在的变量，系统会将其替换为空字符串
4. 变量中的特殊字符（如 `%`）会被自动转义，无需手动处理
5. 设备信息变量依赖于设备的实际状态，某些变量可能在特定情况下为空