设备数据共享

概述

欧盟数据法（Data Act），全称为《关于公平获取和使用数据的协调规则的条例》（Regulation on Harmonised Rules on Fair Access to and Use of Data），于 2023 年 11 月经欧盟委员会正式通过，2024 年 1 月生效，其主要条款将于 2025 年 9 月起正式全面适用。

该法案的核心目标之一是确保用户（数据持有者）能够公平、安全地访问和使用自身产生的数据，这类数据通常由设备制造商存储。其中的关键要求是，联网设备（IoT）用户有权授权第三方服务提供商访问其设备数据，以促进数据驱动的创新和服务竞争。关于该法案的详细内容，可访问 官方网站 了解。

涂鸦平台已提供符合欧盟数据法的 设备数据共享 服务，帮助 OEM/ODM app 用户和 SDK 用户（数据持有者）便捷地履行数据共享的法律义务，方便第三方企业使用设备数据开发新服务。本文为您介绍如何设置和使用设备数据共享。

名词解释

名词	说明
终端用户	App 的使用者。他们通过 App 配网并控制设备，是其设备数据的所有权主体。根据欧盟数据法，App 使用者拥有授权第三方访问其设备数据的权利。（下文提及该主体时，统一简称为 用户）
设备配网 App 的所有者	App 的所有者。开发并运营用于设备配网和控制 App 的企业，是数据的持有者。（下文提及该主体时，统一简称为 App 所有者）
三方企业	希望获得终端用户设备数据以提供增值服务（如数据分析、节能服务、保险等）的欧盟企业。三方企业可能与终端用户无直接商业关系，需通过法定的授权流程获取数据访问权限

服务面向的客户和地区

根据数据法案要求，只有欧盟地区的用户和企业可共享或获取设备数据。因此，三方企业需要满足以下条件才可使用涂鸦平台的服务：

• 云项目部署在中欧数据中心。
• 开发者账号和用户账号所在数据中心为中欧数据中心。
• 已在涂鸦开发平台完成企业账号认证。
• 您的企业不在守门人名单范围内。

满足上述条件后，您可以在 涂鸦开发者平台 > 项目管理 下访问项目详情，并看到服务入口。

使用流程

实现设备数据共享需要完成以下步骤：

1. 三方企业配置 H5 授权页面并集成。
2. 用户通过授权页执行授权。
3. App 所有者开启授权。
4. 三方企业订阅云服务，并获取设备数据。

更多详细操作，请参考下文的介绍。

三方企业配置 H5 授权页

设备数据共享通过标准的 Oauth2.0 协议进行授权。配置生成 H5 授权登录页面后，三方企业可以将该页面集成到您的终端中（例如 App、中控屏等）。操作如下：

1. 前往 涂鸦开发者平台 > 项目管理 页面，找到目标项目，单击 操作 列下的 进入项目 进入项目详情页面。

   

2. 单击 设备 页签，在页面右上角选择 中欧数据中心，然后在 关联 App 账号 下，单击 添加 App 账号 > App 设备数据共享。

   

3. 在 App 设备数据共享 页面，完成授权密钥和 H5 授权页面配置，并单击 保存。

   

   • 配置授权秘钥：授权秘钥即 App 授权的秘钥信息。获取 App 秘钥信息，请参考 App 授权。

   • 配置授权页信息和回调地址，获取 H5 授权页地址。

     

4. 用户确认授权后，会通过回调地址传递生成的 OAuth 2.0 授权码，该授权码仅可在用户所属的数据中心使用。

授权流程

用户授权流程

用户进入 App 后，点击页面右上角的 + > 扫一扫，并扫描三方企业提供的授权二维码进入授权流程页面，然后完成以下操作：

1. 输入手机号，获取可授权的 App。

   

2. 选择 App，进入登录页面。

   

3. 输入密码登录，也可以切换为通过扫码登录。

   

4. 登录成功后，进入到授权页面，点击 选择设备，然后选择家庭及家庭下需要共享的设备，并点击 确认 保存选择。

   

5. 点击 确认授权，授权成功。涂鸦云会根据回调地址，回传生成的 OAuth 2.0 授权码给三方云。

授权流程图

获取访问令牌

App 所有者管理授权

获得用户授权后，还需要获得 App 所有者授权。授权后，三方企业才能获取这些数据。

App 所有者访问 涂鸦开发者平台 > App 用户管理 页面，在页面右上角选择 中欧数据中心，单击 欧盟数据共享授权，然后在弹窗中开启 授权启用状态。

App 所有者也可关闭授权。关闭后，该所有者名下的 App 将终止授权，用户无法为三方企业授权这些 App 下的设备。

三方企业订阅云服务

涂鸦针对欧盟地区设备数据共享打包了消息订阅云服务。三方企业可通过订阅该云服务，获取这些已授权设备的实时上报消息。

• 订阅云服务：

  1. 前往 涂鸦开发者平台 > 云服务 页面。
  2. 在 我的服务 下，搜索 设备数据共享，并单击 操作 列下的 订阅资源包 订阅服务。

• 设置消息订阅：

  1. 前往 涂鸦开发者平台 > 项目管理 页面，找到目标项目，单击 操作 列下的 进入项目 进入其详情页面。
  2. 在 消息订阅 下开启 消息订阅 并设置消息订阅规则，详细操作可参考 管理订阅消息。
  3. 设置完成后，可接收到已授权设备的上报消息。了解消息指令，请参考 标准指令集。

用户管理授权

用户可管理授权，操作如下：

1. 在 App 中进入 我的 > 设置 > 账号与安全 页面。

2. 在 授权管理 > 云开发项目 下，选择已授权的项目，点击 已绑定，可取消授权。