137 lines
3.8 KiB
Markdown
137 lines
3.8 KiB
Markdown
# 通讯与服务类消息发送说明
|
||
|
||
## 概述
|
||
|
||
本文档说明如何使用本后台服务发送**通讯与服务（原私信）类消息**。
|
||
|
||
根据 [OPPO推送服务官方文档](https://open.oppomobile.com/documentation/page/info?id=13189)，通讯与服务类消息需要特殊的参数配置。
|
||
|
||
## 关键配置参数
|
||
|
||
### 1. 频道ID（channel_id）
|
||
- **值**: `previte_message`
|
||
- **位置**: `src/main/resources/application.properties`
|
||
- **配置项**: `oppo.push.channel.id.im=previte_message`
|
||
|
||
### 2. 频道名称（channel_name）
|
||
- **值**: `消息推送`
|
||
- **位置**: `src/main/resources/application.properties`
|
||
- **配置项**: `oppo.push.channel.name.im=消息推送`
|
||
|
||
## 代码实现
|
||
|
||
在 `OppoPushService.java` 中，发送消息时会自动设置以下参数：
|
||
|
||
```java
|
||
// 通讯与服务（原私信）类消息特殊参数
|
||
notification.put("channel_id", config.getChannelIdIm()); // previte_message
|
||
notification.put("channel_name", config.getChannelNameIm()); // 消息推送
|
||
|
||
// extra参数（可选）
|
||
Map<String, Object> extra = new HashMap<>();
|
||
extra.put("message_type", "chat"); // 标识为私信类消息
|
||
notification.put("extra", extra);
|
||
```
|
||
|
||
## 消息体结构
|
||
|
||
发送通讯与服务类消息时，完整的消息体结构如下：
|
||
|
||
```json
|
||
{
|
||
"target_type": 1,
|
||
"target_value": "设备的registration_id",
|
||
"notification": {
|
||
"title": "消息标题",
|
||
"content": "消息内容",
|
||
"click_action_type": 1,
|
||
"click_action_type_value": "",
|
||
"channel_id": "previte_message",
|
||
"channel_name": "消息推送",
|
||
"extra": {
|
||
"message_type": "chat"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 测试步骤
|
||
|
||
### 1. 确保配置正确
|
||
|
||
检查 `application.properties` 文件：
|
||
```properties
|
||
oppo.push.channel.id.im=previte_message
|
||
oppo.push.channel.name.im=消息推送
|
||
```
|
||
|
||
### 2. 启动服务
|
||
|
||
```bash
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
### 3. 发送测试消息
|
||
|
||
使用 curl 命令：
|
||
```bash
|
||
curl -X POST http://localhost:8080/api/push/send \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"targetValue": "您的registration_id",
|
||
"title": "测试私信",
|
||
"content": "这是一条通讯与服务类消息",
|
||
"messageType": "1"
|
||
}'
|
||
```
|
||
|
||
### 4. 验证结果
|
||
|
||
- 检查API返回：`success` 应为 `true`
|
||
- 检查设备：消息应出现在OPPO手机的"消息推送"频道中
|
||
- 检查日志：查看控制台输出的详细日志
|
||
|
||
## 注意事项
|
||
|
||
1. **频道ID必须正确**：`channel_id` 必须设置为 `previte_message`，否则消息不会被识别为普通通知
|
||
|
||
2. **频道名称**：`channel_name` 设置为 `消息推送`，这是OPPO系统识别的标准名称
|
||
|
||
3. **设备端配置**：确保移动应用已正确集成OPPO推送SDK，并且应用已获得通知权限
|
||
|
||
4. **registration_id**：必须使用真实的设备registration_id，不能随意填写
|
||
|
||
5. **消息分类**：通过设置 `channel_id` 为 `previte_message`，消息会被OPPO系统自动分类为"通讯与服务"类消息
|
||
|
||
## 常见问题
|
||
|
||
### Q1: 消息发送成功但设备收不到？
|
||
**A**: 检查以下几点：
|
||
- 设备是否在线
|
||
- 应用是否已获得通知权限
|
||
- registration_id是否正确
|
||
- 应用是否已正确集成OPPO推送SDK
|
||
|
||
### Q2: 消息收到了但不是通讯与服务类？
|
||
**A**: 检查：
|
||
- `channel_id` 是否正确设置为 `previte_message`
|
||
- 查看日志确认消息体中的参数是否正确
|
||
|
||
### Q3: 如何确认消息类型？
|
||
**A**:
|
||
- 在OPPO手机上，通讯与服务类消息会显示在"消息推送"频道中
|
||
- 可以通过OPPO开放平台的推送统计查看消息分类
|
||
|
||
## 相关文档
|
||
|
||
- [OPPO推送服务文档 - 通讯与服务类消息](https://open.oppomobile.com/documentation/page/info?id=13189)
|
||
- [OPPO开放平台](https://open.oppomobile.com)
|
||
|
||
## 技术支持
|
||
|
||
如有问题，请：
|
||
1. 查看控制台日志获取详细错误信息
|
||
2. 检查OPPO开放平台的推送统计
|
||
3. 参考OPPO官方文档
|
||
|