From 63db5347a1537ec5f9e4c177a440b87c3cbcfbac Mon Sep 17 00:00:00 2001 From: linju Date: Tue, 12 Jul 2022 14:43:34 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9Euni-push-mate=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/uniCloud/_sidebar.md | 1 + docs/uniCloud/uni-cloud-push/mate.md | 32 ++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+) create mode 100644 docs/uniCloud/uni-cloud-push/mate.md diff --git a/docs/uniCloud/_sidebar.md b/docs/uniCloud/_sidebar.md index cb91402b0..e6066b1c1 100644 --- a/docs/uniCloud/_sidebar.md +++ b/docs/uniCloud/_sidebar.md @@ -52,6 +52,7 @@ * Push扩展库(socket) * [业务文档](unipush-v2.md) * [开发文档](uniCloud/uni-cloud-push/api.md) + * [uni-push2.0、uni-id、uni统计的组合](uniCloud/uni-cloud-push/mate.md) * [扩展参数](uniCloud/uni-cloud-push/options.md) * [运行与调试](uniCloud/rundebug.md) diff --git a/docs/uniCloud/uni-cloud-push/mate.md b/docs/uniCloud/uni-cloud-push/mate.md new file mode 100644 index 000000000..dab74ed7d --- /dev/null +++ b/docs/uniCloud/uni-cloud-push/mate.md @@ -0,0 +1,32 @@ +## uni-push2.0、uni-id、uni统计的组合说明 + +### 包含的opendb表 + +|数据表名称 |操作（添加/更新）时机 |内容/作用 | +|-- | |-- | +|opendb-tempdata|旧token过期时 |向个推服务器发起请求的token | +|open-device |设备启动、登录 |push_clientid与详细的[设备信息](#deviceInfo)| +|uni-id-device |登录 |主要用于存储user_id 与 device_id的映射关系，完整字段：user_id、device_id、token_expired、push_clientid、appid| + +**详情：** +1. uni统计模块，在设备启动时立即调用[getPushClientId](https://uniapp.dcloud.io/uniCloud/uni-cloud-push/api.html#getpushclientid)获取`push_clientid`，如果获取成功后（应用未在manifest中启用uni-push2.0则会获取失败）则调用`uni-stat-receiver`云对象的`report`方法（参数：`push_clientid`），服务器会向`opendb-device`表写入或更新（存在时）：[设备信息](#deviceInfo)和`push_clientid`。 + +2. uni-id-pages插件，调用[uniCloud.onRefreshToken](https://uniapp.dcloud.io/uniCloud/client-sdk.html#on-refresh-token) 监听token发生变化（即：用户登录和token续期时），调用`uni-id-co`云对象的`setPushCid`方法（参数：`push_clientid`）服务器操作`uni-id-device`表，记录`device_id` 与 `user_id`的映射关系；完整字段包含`user_id`、`device_id`、`token_expired`、`push_clientid`、`appid`。同时再向`opendb-device`表写入或更新（存在时）：[设备信息](#deviceInfo)和`push_clientid`。 + +综上：`push_clientid`被存储在`uni-id-device`和`opendb-device`两个表，前者用于存储`device_id` 与 `user_id`的映射关系，仅用户登录成功后才有对应数据；后者用于存储完整的[设备信息](#deviceInfo)，未登录的用户也有对应的数据。 + +**注意：** +当用户未登录时，我们可以基于`device_id`向用户推送消息，但有被窃听的风险（营销类消息不用太关心这个）。因为`opendb-device`表中存储的[设备信息](#deviceInfo)，底层的技术原理是获取客户端自动上报的信息，理论上存在被篡改可能。如：张三使用李四的`device_id`+张三的`push_clientid`。上报数据；服务器会认为李四的`push_clientid`更新了，从而将李四的`device_id`与`push_clientid`的映射关系，指向张三的`push_clientid`;张三从而窃听到，其他人发给李四的消息。 +而基于`user_id`或者`user_tag`推送消息，是基于`uni-id-device`表，在新增/更新操作时：会校验当前用户的`user_id`，不会被其他用户篡改，即没有被他人窃听消息的风险。 + +#### 设备信息@deviceInfo +来源uniCloud云对象中的[this.getClientInfo](https://uniapp.dcloud.io/uniCloud/cloud-obj.html#get-client-info)方法，完整字段列表参考：[uni.getSystemInfo](https://uniapp.dcloud.net.cn/api/system/info.html#getsysteminfo) + +### 推送接口查库详解： + + + +- 推送目标依据为：`push_clientid`直接执行推送。 +- 推送目标依据为：`device_id`，查`opendb-device`表，获得`push_clientid`执行推送 +- 推送目标依据为：`users_id`查`uni-id-device`表（如果需要验证platform就联查`opendb-device`表）,获得`push_clientid`执行推送 +- 推送目标依据为：`user_tag`查`uni-id-users`表，获得`users_id`查`uni-id-device`表（如果需要验证platform就联查`opendb-device`表）,获得`push_clientid`执行推送 \ No newline at end of file -- GitLab