一、核心说明
图1:TUTK 推送服务整体架构图
二、主要的交互流程
图2:TUTK 推送服务完整流程图
1. APP 从第三方服务器获取推送 Token;
2. APP 向 TUTK 推送服务(KPNS)完成注册;
3. APP 向 KPNS 服务器发起设备绑定请求(建立设备与手机的关联);
4. 设备向 KPNS 服务器推送事件消息;
5. KPNS 服务器将消息分发给对应的第三方服务器;
6. 第三方服务器通过集成的厂商通道向目标手机推送消息。
三、APP 端关键操作
注册-client: 添加设备时,或者第三方token过期重新获取token后。
绑定-mapping: 添加设备时,或者第三方token过期重新获取token后,每次只能操作一个uid。
同步-sync: 每次打开APP,sync可以同时具有mapping和rm_mapping的功能,一次可以操作多个uid,所以不需要重复再调用mapping以及rm_mapping。
解绑-rm_mapping:用户删除设备,每次只能操作一个uid。
同步-sync: 每次打开APP,sync可以同时具有mapping和rm_mapping的功能,一次可以操作多个uid,所以不需要重复再调用mapping以及rm_mapping。
四、设备端推送实现
设备端推荐使用 HTTP POST 方式 向服务器推送消息,支持通过 curl 等第三方库快速实现,无需依赖复杂SDK,降低集成成本。
五、快速测试与调试
- {uid}:替换为设备 UID;
- {event_type}:替换为推送消息类型(参考下方「常见推送消息对照表」)。
六、关键配置对照表
| event_type | 中文(zh_CN) | 英文(enUS) | 法语(fr_FR) | 日语(ja_JP) | 繁体中文(zh_TW) |
|---|---|---|---|---|---|
| 1 或 4 | 移动侦测 | Motion Detection | Détection de mouvement | モーション検知 | 位移偵測 |
| 2000 | 用户呼叫 | User call | - | ユーザー呼び出し | 用戶呼叫 |
| 55 | 门磁报警 | door alarm | - | - | - |
| 37 | 您的门铃已经断线,请尽速确认! | Your doorphone is not connected with network, please confirm soon. | - | - | 您的門鈴已經斷線,請盡速確認! |
| 52 | 影像遗失 | video loss | - | - | - |
| 100 | 空白字串,配合&msg=自定义消息使用 | Custom Message (with &msg=) | - | - | 空白字串,配合&msg=自訂訊息使用 |
| 推送通道 | 域名 | HTTP 端口 | HTTPS 端口 |
|---|---|---|---|
| APNS、FCM(海外) | push.iotcplatform.com | 80 / 7379 | 7380 |
| 小米、华为、OPPO、VIVO、极光、信鸽(国内) | push.kalay.net.cn | 80 / 7379 | 7380 |
| 推送通道 | 所需资料 |
|---|---|
| APNS(苹果) | bundle id、pem 证书(或者p8证书)、pem 类型(dev 或 dis)、pem 证书密码(可选,建议不设) |
| FCM(谷歌) | APPID、服务器密钥 |
| 信鸽 | APPID、SECRET KEY |
| 小米/华为/OPPO/VIVO | 厂商开发者账号对应的 APP 配置信息 |
