微信硬件平台框架说明及接入流程

2024-04-30 00:18

本文主要是介绍微信硬件平台框架说明及接入流程,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

微信硬件平台框架说明及接入流程
1 / 15 



硬件平台框架说明
及接入流程 
V0.5 
Tencent Confidential 硬件平台框架说明及接入流程 
2 / 15 

文档变更日志 


部门 微信事业群\开放平台创新部\创新二组 
版本 描述 撰写人员 更新日期 
V0.1 初稿 jeffqi、genewu 2014/07/8 
V0.2 加入Q&A jeffqi、genewu 2014/07/8 
V0.3 针对常见问题,增加说明。流程图优化。 jeffqi、genewu 2014/07/9 
V0.4 添加“保密”水印,文档名字修正。 jeffqi、genewu 2014/07/10 
V0.5 Q&A补充 jeffqi、genewu 2014/07/15 







硬件平台框架说明及接入流程 
3 / 15 

目录 
1. 微信硬件公众平台整体架构 ................................................................................. 4 
1.1 经典蓝牙(BT) 、低功耗蓝牙(BLE)连接方案 ................................................ 4 
1.2 Wifi、GPRS、3G连接方案 ....................................................................................... 6 
2. 微信硬件公众平台接入流程 ................................................................................. 8 
2.1 目的 ................................................................................................................................. 8 
2.2 前提 ................................................................................................................................. 8 
2.3 接入流程 ......................................................................................................................... 8 
2.3.1 开发阶段 ................................................................................................................. 9 
2.3.2 正式上线与发售 .................................................................................................. 10 
3. Q&A .................................................................................................................................. 13 
4. 参考文档 .......................................................................................................................... 15 
4.1 微信蓝牙外设协议 1.0.1beta ................................................................................... 15 
4.2 设备接入接口协议 V2.0beta(PDF) ................................................................... 15 



硬件平台框架说明及接入流程 
4 / 15 

1. 微信硬件公众平台整体架构 
1.1 经典蓝牙(BT) 、低功耗蓝牙(BLE)连接方案 




外设和厂商服务器,由厂商开发完成。 
微信提供手机接口以对接厂商的外设(如下文中的微信蓝牙外设协议),提供服务器接口以
对接厂商的服务器。 
A. 外设与手机 WeChat 通过 BT/BLE 连接,蓝牙协议见参考文档 《微信蓝牙外设协议
1.0.1beta》 。 
B. 未涉及外设数据传输的请求(如同步后的数据查询、排行查询等),数据流通过路径①
传输。此时需要调用的接口为微信的公共接口,详细见 
http://mp.weixin.qq.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5 

② ① 
蓝牙设备连接示意图 
手机WeChat 
外设 
微信服务器 
厂商服务器 
BT/BLE 
① 
② 
② 硬件平台框架说明及接入流程 
5 / 15 

C. 涉及外设数据传输的请求(如数据同步、电量查询等),数据流通过路径②传输。此时
需要调用的接口为微信的硬件接口。此外,设备授权、设备二维码生成、设备绑定/解绑
等都涉及到微信的硬件接口。 
相关接口文档详见参考文档《设备接入接口协议V2.0beta》 。 


以下是设备接入流程以及相关接口的简单介绍: 
a. 设备授权。通过调用设备授权的 API,厂商将设备 deviceID 以及其属性信息提交公众
平台进行授权(详见《设备接入接口协议 2.0》中1.6 节) 
b. 由 deviceID生成二维码。 调用设备二维码获取API,厂商可通过授权后的设备deviceID
从公众平台批量获取设备二维码(详见《设备接入接口协议2.0》中 1.5 节) 
c. 绑定设备/解绑设备。微信用户绑定设备后,设备会通过微信给第三方发送消息。 (详见
《设备接入接口协议 2.0》中1.2节) 
d. 设备收信息。第三方发送消息给设备主人的微信终端,并最终送达设备。 (详见《设备
接入接口协议2.0》中1.3节) 
e. 设备发信息。设备通过微信同第三方通信,并且接收第三方的响应。 (详见《设备接入
接口协议2.0》中1.1 节) 
f. 其他辅助功能。其他功能如设备状态查询、验证二维码等接口内容详细介绍见接口协议
文档。 


硬件平台框架说明及接入流程 
6 / 15 

1.2 Wifi、GPRS、3G 连接方案 









外设和厂商服务器,由厂商开发完成。 
微信提供连接方案以及相关接口对接厂商服务器,使外设与微信之间能进行通信。 

A. 外设和手机 WeChat 无直接连接关系。微信提供连接方案以及相关接口,将设备 ID
(deviceID)与用户微信号(openID)绑定,从而实现外设与微信之间的通信。 
B. 设备授权、设备二维码生成、设备绑定/解绑等涉及到微信的硬件接口。相关接口文档
详见参考文档《设备接入接口协议V2.0beta》 。 

以下是设备接入流程以及相关接口的简单介绍: 
a. 设备授权。通过调用设备授权的 API,厂商将设备 deviceID 以及其属性信息提交公众
平台进行授权(详见《设备接入接口协议 2.0》中1.6 节) 

手机WeChat 
外设 
微信服务器 
厂商服务器 
wifi设备连接示意图 硬件平台框架说明及接入流程 
7 / 15 

b. 由 deviceID生成二维码。 调用设备二维码获取API,厂商可通过授权后的设备deviceID
从公众平台批量获取设备二维码(详见《设备接入接口协议2.0》中 1.5 节) 
c. 绑定设备/解绑设备。微信用户绑定设备后,设备会通过微信给第三方发送消息。 (详见
《设备接入接口协议 2.0》中1.2节) 
d. 设备收/发信息。 Wifi设备收发信息需要调用微信的公共接口,而不需要调用硬件接口,
厂商可忽略《设备接入接口协议 2.0》中的1.1 节与 1.3节。 
e. 其他辅助功能。其他功能如设备状态查询、验证二维码等接口内容详细介绍见接口协议
文档。 










硬件平台框架说明及接入流程 
8 / 15 

2. 微信硬件公众平台接入流程 
2.1 目的 
微信硬件公众平台接入流程详细介绍了接入平台的各个步骤,帮助厂商更好地接入微信硬件
公众平台和使用微信硬件公众号。 
2.2 前提 
厂商已经与微信硬件团队接触并达成合作意愿。 
2.3 接入流程 
接入流程图: 


正 式 上 线 与 发 售 阶 段 
开 发 阶 段 硬件平台框架说明及接入流程 
9 / 15 

接入流程分为两部分,一为开发阶段,二为正式上线与销售阶段。开发阶段厂商可以通过测
试号进行设备的开发与测试;正式上线与销售阶段,厂商必须要注册服务号并通过微信认证
才能正式上线产品与销售。 
2.3.1 开发阶段 
1.申请测试号 
要接入微信硬件公众平台的厂商需要先申请测试号以便于硬件功能的开发与测试。 
测试号折叠在订阅号中,头像与名称不可更改。除了模版消息功能外,测试号拥有服务号所
具有的功能。 
测试号申请地址为: 
http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login 

2.开通硬件功能权限 
测试号与正式硬件公众号都需要开通硬件功能权限才可以使用硬件功能。 
厂商需要向微信硬件团队产品经理提供公众帐号原始 ID(原始ID为“gh_”开头的一串字
符)以申请开通公众号的硬件功能。 

3.设备开发 
A.设备授权:通过调用设备授权的 API,厂商将设备 deviceID 以及其属性信息提交公众
平台进行授权。 (详见《设备接入接口协议 2.0》中1.6 节) 
B.获取设备专属二维码:调用设备二维码获取 API,厂商可通过授权后的设备 deviceID
从公众平台批量获取设备二维码。 (详见《设备接入接口协议2.0》中 1.5 节) 
C.设备测试:生产样品设备并测试。 
硬件平台框架说明及接入流程 
10 / 15 

2.3.2 正式上线与发售 
1.注册服务号 
厂商需在微信公众平台注册服务号作为正式的硬件公众号。 
服务号注册地址为:https://mp.weixin.qq.com/ 

2.微信认证 
厂商需要对此硬件公众帐号进行“微信认证”,认证成功后,会在公众帐号上的 Profile 页
面看到“微信认证”标识。 


3.开通硬件功能权限 
测试号与正式硬件公众号都需要开通硬件功能权限才可以使用硬件功能。 
厂商需要向微信硬件团队产品经理提供公众帐号原始 ID(原始ID为“gh_”开头的一串字
符)以申请开通公众号的硬件功能。 
硬件平台框架说明及接入流程 
11 / 15 

4.设备生产 
A.设备授权:通过调用设备授权的 API,厂商将设备 deviceID 以及其属性信息提交公众
平台进行授权。 (详见《设备接入接口协议 2.0》中1.6 节) 
B.获取设备专属二维码:调用设备二维码获取 API,厂商可通过授权后的设备 deviceID
从公众平台批量获取设备二维码。 (详见《设备接入接口协议2.0》中 1.5 节) 
C.设备生产,贴二维码:生产设备过程中,将二维码与其对应的设备统一包装。 
(有屏幕的设备亦可在屏幕上显示二维码) 

5.设备销售 
A.设备销售:设备将与专属二维码一起销售给消费者。 
B.扫描二维码:用户获取设备后,可通过微信扫描设备专属二维码与设备建立关系。 

C.关注公众账号:用户关注厂商的硬件公众号后,该公众号可以接收用户消息以及向用户
发送消息,同时设备的 deviceID 与用户微信号的 openID 将绑定。通过调用获取绑定
的 openID的API,硬件公众号可获取绑定设备的用户 openID。 (详见《设备接入接口
协议2.0》中1.4 节) 硬件平台框架说明及接入流程 
12 / 15 

D.连接状态显示:用户关注厂商的硬件公众号后,公众号会向用户发出问候消息,用户与
厂商硬件公众号的聊天对话页面上也会显示设备与手机的连接状态。对于蓝牙设备,微
信通过手机可以获取连接状态;对于 Wi-Fi 设备,需要通过厂商服务器向微信硬件公众
平台提供设备的网络连接状态再在微信上显示(此功能正在开发中)。 

E.更多功能:用户可以通过微信硬件公众号以语音消息、文本消息、HTML5 页面等途径
获得厂商提供的多种服务。 






硬件平台框架说明及接入流程 
13 / 15 

3. Q&A 
Q:公众账号原始ID就是公众账号的微信号吗? 
A:否。登录mp.weixin.qq.com ,在设置公众号设置内查看。 

Q:接入微信硬件公众平台需要缴费吗? 
A:暂时不需要。 

Q:如何申请测试号? 
A: http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login 用手机扫描
网页上二维码,按照网站提示申请。 

Q:测试号有限制吗? 
A: 测试号折叠在订阅号中,头像与名称不可更改。除了模版消息功能外,测试号拥有服务
号所具有的功能。此外,测试号有效期为 1年。 

Q:注册服务号后如何开通硬件权限? 
A: 厂商需要向微信硬件团队产品经理提供公众帐号原始ID以申请开通公众号的硬件功能。 

Q:申请微信认证是否需要缴纳300 元? 
A:是。 
硬件平台框架说明及接入流程 
14 / 15 

Q:设备授权有数量上限吗? 
A: 测试过程中数量上限为1000 个。正式生产时,按照需求与微信硬件产品经理协商沟通。 

Q:“注册服务号”与“微信认证”在开发过程中非必须流程,具体什么意思? 
A:测试与开发的过程中,仅需测试号,不需要注册服务号,也不需要对账号进行微信认证。 

Q:一个用户只能绑定一个设备吗? 
A:是。在已绑定设备且未解绑的情况下,再扫描绑定另一设备时,前者会被取代,绑定的
是后一设备。 
微信不建议允许同一用户绑定多个设备,若一定需要绑定多个设备,微信能在自定义菜单中
提供“添加设备”功能,由厂商负责管理。此时,通过扫描二维码的方式不能绑定新设备,
而需要用户在公众号内输入新设备的deviceID,由厂商在后台处理。 

Q:同一设备是否能被多个用户扫描绑定吗? 
A:是。 

Q:能否实现以下情况:用户A 与用户B都同时绑定设备 1和设备2? 
A:否。 硬件平台框架说明及接入流程 
15 / 15 

4. 参考文档 
4.1 微信蓝牙外设协议 1.0.1beta 
4.2 设备接入接口协议 V2.0beta 
(以上文档请见附件)

这篇关于微信硬件平台框架说明及接入流程的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/947529

相关文章

SpringBoot整合Flowable实现工作流的详细流程

《SpringBoot整合Flowable实现工作流的详细流程》Flowable是一个使用Java编写的轻量级业务流程引擎,Flowable流程引擎可用于部署BPMN2.0流程定义,创建这些流程定义的... 目录1、流程引擎介绍2、创建项目3、画流程图4、开发接口4.1 Java 类梳理4.2 查看流程图4

Before和BeforeClass的区别及说明

《Before和BeforeClass的区别及说明》:本文主要介绍Before和BeforeClass的区别及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Before和BeforeClass的区别一个简单的例子当运行这个测试类时总结Before和Befor

Python pip下载包及所有依赖到指定文件夹的步骤说明

《Pythonpip下载包及所有依赖到指定文件夹的步骤说明》为了方便开发和部署,我们常常需要将Python项目所依赖的第三方包导出到本地文件夹中,:本文主要介绍Pythonpip下载包及所有依... 目录步骤说明命令格式示例参数说明离线安装方法注意事项总结要使用pip下载包及其所有依赖到指定文件夹,请按照以

java Long 与long之间的转换流程

《javaLong与long之间的转换流程》Long类提供了一些方法,用于在long和其他数据类型(如String)之间进行转换,本文将详细介绍如何在Java中实现Long和long之间的转换,感... 目录概述流程步骤1:将long转换为Long对象步骤2:将Longhttp://www.cppcns.c

Python基于微信OCR引擎实现高效图片文字识别

《Python基于微信OCR引擎实现高效图片文字识别》这篇文章主要为大家详细介绍了一款基于微信OCR引擎的图片文字识别桌面应用开发全过程,可以实现从图片拖拽识别到文字提取,感兴趣的小伙伴可以跟随小编一... 目录一、项目概述1.1 开发背景1.2 技术选型1.3 核心优势二、功能详解2.1 核心功能模块2.

Spring中管理bean对象的方式(专业级说明)

《Spring中管理bean对象的方式(专业级说明)》在Spring框架中,Bean的管理是核心功能,主要通过IoC(控制反转)容器实现,下面给大家介绍Spring中管理bean对象的方式,感兴趣的朋... 目录1.Bean的声明与注册1.1 基于XML配置1.2 基于注解(主流方式)1.3 基于Java

spring-gateway filters添加自定义过滤器实现流程分析(可插拔)

《spring-gatewayfilters添加自定义过滤器实现流程分析(可插拔)》:本文主要介绍spring-gatewayfilters添加自定义过滤器实现流程分析(可插拔),本文通过实例图... 目录需求背景需求拆解设计流程及作用域逻辑处理代码逻辑需求背景公司要求,通过公司网络代理访问的请求需要做请

如何基于Python开发一个微信自动化工具

《如何基于Python开发一个微信自动化工具》在当今数字化办公场景中,自动化工具已成为提升工作效率的利器,本文将深入剖析一个基于Python的微信自动化工具开发全过程,有需要的小伙伴可以了解下... 目录概述功能全景1. 核心功能模块2. 特色功能效果展示1. 主界面概览2. 定时任务配置3. 操作日志演示

使用JavaConfig配置Spring的流程步骤

《使用JavaConfig配置Spring的流程步骤》JavaConfig是Spring框架提供的一种基于Java的配置方式,它通过使用@Configuration注解标记的类来替代传统的XML配置文... 目录一、什么是 JavaConfig?1. 核心注解2. 与 XML 配置的对比二、JavaConf

Redis迷你版微信抢红包实战

《Redis迷你版微信抢红包实战》本文主要介绍了Redis迷你版微信抢红包实战... 目录1 思路分析1.1hCckRX 流程1.2 注意点①拆红包:二倍均值算法②发红包:list③抢红包&记录:hset2 代码实现2.1 拆红包splitRedPacket2.2 发红包sendRedPacket2.3 抢