微信蓝牙BLE接入调试指引 测试公众号篇(根据别人调试通过,做下记录)

2023-12-27 11:50

本文主要是介绍微信蓝牙BLE接入调试指引 测试公众号篇(根据别人调试通过,做下记录),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

微信蓝牙BLE接入调试指引

测试公众号篇

微信测试公众号

2.1 申请测试公众号

可以在http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login申请到一个用于测试的公众号,这个帐号可以用于调试具用AirSync协议的蓝牙设备,简精协议好像调不了。

申请步骤:

打开网址,点击登陆后,出来二维码,用微信扫一下,在弹出的页面点确认登陆,然后网页会自动进入测试号界面

 

进入后,注意一下上图标红线的值,BLE固件里的DEVICE_TYPE的值要改成上面标红微信号的值,而appIDappsecret这两个值在获取access_token时会用到。

2.2 添加蓝牙产品

在测试号界面,找到“功能服务”-》“设备功能”,点开启,然后进行设置,进去后添加产品,然后参考下图填写,就红圈要注意,其他随便填。

 

 

 

 

 

添加完后,并不表示进入公众号后就可以去连蓝牙了,这只是将公众号配置成具有蓝牙功能,想要连接蓝牙设备,还得继续往下。另外,注意上图标红圈的那个值6563,它是产品IDproduct_id),在授权时会用到。

 

另外,说明一下,这里提到的产品是什么意思,要是以为是一个设备就是一样产品,那就惨了,因为测试帐号的限额就5个产品。我的理解是,一个产品,是指具有相同接口功能的硬件,比如蓝牙手表,就一个产品,所有手表都是同一个产品,蓝牙手环也是一样产品,WIFI功能的设备,就另一个产品,是一样大种类,或者叫做功能类别。

 

刚创建的这个产品,只是个空壳,接下来使用“微信公众平台接口调试工具”

http://mp.weixin.qq.com/debug

来向产品添加蓝牙设备。

2.3 添加蓝牙设备

打开http://mp.weixin.qq.com/debug,接口类型和接口列表按下图填写:

 

然后再一下appidsecret的值,appid是测试号界面的appID,secretappsecret。填好后点一下“检查问题”,正常的话,会返回:

 

上面的请求地址,意思是,点击“检查问题”按钮时,实际执行的就是这个指令,你把这个地址拷到网页浏览,显示的信息就是返回结果。

access_token 叫访问令牌,它的有效期是2小时,它的作用是下面提到的指令都得带访问令牌,否则测试号后台是不会接受的。

 

获取到access_token后,我们就可以添加设备了。将接口类型选择为“硬件接入API接口调试”,接口列表选择为“设备授权”:

 

body里填入下面信息:

{

    "device_num": "1", 

    "device_list": [

        {

            "id": "device3", 

            "mac": "f4e6f41549f2", 

            "connect_protocol": "3", 

            "auth_key": "000102030405060708090a0b0c0d0e0f", 

            "close_strategy": "1", 

            "conn_strategy": "1", 

            "crypt_method": "1", 

            "auth_ver": "1", 

            "manu_mac_pos": "-1", 

            "ser_mac_pos": "-2"

        }

    ], 

    "op_type": "0", 

    "product_id": "6563"

}

正常返回如下:

 

 

我们来解读一下BODY的信息,BODY是一个json结构,即“变量”:“值”的格式构成,不清楚的可以查一下。

{

    "device_num": "1", //表示device_list里有多少项,1表示1项,如果是2list就得有两项。 

    "device_list": [ //设备列表

        {

            "id": "device3", //这个值要与BLE固件里的DEVICE_ID一致,可以自定义,也可通过微信HTTP接口生成。

            "mac": "f4e6f41549f2", //这个值是硬件篇提到的BLE设备的MAC地址,与广播数据里的MAC地址顺序一样,也和手机扫描到的MAC地址顺序一样。

            "connect_protocol": "3", //3 表示BLE蓝牙协议

            "auth_key": "000102030405060708090a0b0c0d0e0f", //BLE固件里的aes_key值一致。

            "close_strategy": "1", //1:退出公众号页面时即断开连接

            "conn_strategy": "1", //1:(第1bit 置位)在公众号对话页面,不停的尝

试连接设备

            "crypt_method": "1", //1:AES 加密

            "auth_ver": "1", //加密版本,0是不加密

            "manu_mac_pos": "-1", //-1:MAC地址在尾部

            "ser_mac_pos": "-2" //-2:表示serial number不包含mac 地址

        }

    ], 

    "op_type": "0", //0 表示新增,1表示更改,第一次用0,之后用1

    "product_id": "6563" //对用添加的产品号,op_type = 0时需要。

}

 

设备授权,不表示进入微信号后就会连接设备,只是表示在后面的配置里可以被引用。

 

对上面的“id”项,详细说明一下,id指的是device_id,是唯一的,不能重名,它有两种产生方式,一种是用户自己定义,如上的device3就是我自己取的,另一种是调用微信接口产生:

 

一般在这里只填access_token,会产生错误提示:

{

    "base_resp": {

        "errcode": 100020, 

        "errmsg": "account quota not enough"

    }

}

原因是deviceid的产生需要指定产品ID,表明它是基于哪个产品。解决方法是:在access_tokey里填写ACCESS_TOKEN&product_id=PRODUCT_ID,如下:

向上滚动鼠标到这个界面,并填写如图所示内容,其中的access_token填写刚才获取到的那个字符串并在末尾加上&product_id=21816(注意,这个数字是在第一阶段的第7步所得到的那个,这里的21816是我自己的,需要填写自己对应的那个)。

 

 

http的请求方式:

https://api.weixin.qq.com/device/getqrcode?access_token=ue48NdvmlCrEcknhRP0FJwmeg0d0hOu9aB9Q9ZW0d6HB-RhM6O2ffnSxhzXvH8ClAgSJ1mYnHiQLRScXCH3tMfXv5X-Wlk5kYC6waMPCpyMIYKgAGAQGS&product_id=6563

 

正常返回结果:

 

会产生一个deviceid和一个二维码地址。这个二维码地址是对应该设备的,它与公众号二维码的不同是,它加入了设备信息,用户在扫描二维码后,可以绑定设备,而扫描公众号二维码,则不会要求绑定设备。

 

二维码地址可以通过这个网站http://cli.im/url来产生二维码图片。

 

另外,自己定义的device id,可以通过下命令来产生二维码地址:

curl https://api.weixin.qq.com/device/create_qrcode?access_token=ACCESS_TOKEN -d "{\"device_num\":\"1\", \"device_id_list\":[\"device3\"]}"

上面的access_tokendevice3要换成自己的。

Curl命令一般在Linux终端下使用比较方便,WINDOWS的自己查一下。

2.4 绑定设备

二维码图片产生后,在微信扫一扫,就会跳出绑定界面,已绑过的除外。

 

点击绑定后,微信就会将device3与用户的微号进行绑定,可以通调试接口工具,在“查询用户绑定的设备”中查到,

 

Openid是用户微信号,当用户微信关注设备后,可以在测试号界面里的用户列表上看到。

查询用户绑定的设备”也可通过下面命令查到:

https://api.weixin.qq.com/device/get_bind_device?access_token=ACCESS_TOKEN&openid=微信号

 

这里的绑定,不是实际物理意义上的绑定,只是软件的配置,并没有形成实际的连接。在绑定后,进入公众号,公众号就才会根据它绑定的设备去扫描,当找到对应的设备后,才去连接。所以,如果没有配置好绑定信息,进入公众号后是不会去连接设备的。

 

另外,除了通过扫描设备二维码去绑定设备,还可以通过HTTP接口来绑定设备,这个可以参考下面2.6提到的强制绑定设备。

 

至此,绑定设备后就可以在公众号里连接BLE设备,完成第一阶段的握手,当然,数据的互发还得等第三方服务器建好后。

2.5 设备接入接口协议

可以看到,调试工具的每个接口都有对应的http请求方式,这些请求方式,在《设备接入接口协议V2.3.2》里有详细解释,可以在http://iot.weixin.qq.com/wiki/new/index.html?page=6-1下载。

 

接入接口协议有涉及第三方服务器接口,也有微信本身接口,下面做一下简单导读。

 

打开文档后,翻到目录,前缀是“消息接口”的,是微信发给第三方服务器的,方式是向地址http://URL?signature=SIGNATURE×tamp=12345678&nonce=NONCE发送一段格式如下的xml数据:

<xml>

<ToUserName><![CDATA[%s]]></ToUserName>

<FromUserName><![CDATA[%s]]></FromUserName>

<CreateTime>%u</CreateTime>

<MsgType><![CDATA[%s]]></MsgType>

<DeviceType><![CDATA[%s]]></DeviceType>

<DeviceID><![CDATA[%s]]></DeviceID>

<Content><![CDATA[%s]]></Content>

<SessionID>%lu</SessionID>

<MsgID>%lu</MsgID>

<OpenID><![CDATA[%s]]></OpenID>

</xml>

然后,第三服务器也会回应一段xml数据,格式如下:

<xml>

<ToUserName><![CDATA[%s]]></ToUserName>

<FromUserName><![CDATA[%s]]></FromUserName>

<CreateTime>%u</CreateTime>

<MsgType><![CDATA[%s]]></MsgType>

<DeviceType><![CDATA[%s]]></DeviceType>

<DeviceID><![CDATA[%s]]></DeviceID>

<SessionID>%u</SessionID>

<Content><![CDATA[%s]]></Content>

</xml>

 

在目录中,前缀为“API”的,是对微信进行操作的接口,比如配置微信,上面2.32.4提到的添加设备、查询绑定,以及通过微信往设备发数据等。API方式,是请求微信的API地址,如果附带有参数或数据,则发一段JSCON格式的数据,如获取设备二维码:

curl https://api.weixin.qq.com/device/create_qrcode?access_token=ATOKEN -d

"{\"device_num\":\"2\", \"device_id_list\":[\"ID1\",\"ID2\"]}"

2.6 API调试

调试公众号后台,常用到的几个API

 

获取ACCESS_TOKEN:

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=appID&secret=appsecret

appIDappsecret可以在测试号界面找到。

ACCESS_TOKEN是其他API的访问令牌,有效期是2小时。

 

获取设备二维码:

curl https://api.weixin.qq.com/device/create_qrcode?access_token=ACCESS_TOKEN -d "{\"device_num\":\"1\", \"device_id_list\":[\"device1\"]}"

device1是用户自定义的设备ID

 

授权设备:

curl https://api.weixin.qq.com/device/authorize_device?access_token=ACCESS_TOKEN -d '{"device_num": "1","device_list": [{"id": "device1", "mac": "f4e6f41549f2", "connect_protocol": "3","auth_key": "", "close_strategy": "1","connect_protocol": "3","conn_strategy": "1","crypt_method": "0","auth_ver": "0","manu_mac_pos": "-1","ser_mac_pos": "-2"}], "op_type": "1", "product_id": "6563"}'

各项参数在2.3有提到。

 

查询用户绑定的设备:

https://api.weixin.qq.com/device/get_bind_device?access_token=ACCESS_TOKEN&openid=OPEN_ID

OPEN_ID是用户的微信号。查询该微信号已绑定的设备。

 

强制绑定设备

Curl https://api.weixin.qq.com/device/compel_bind?access_token=ACCESS_TOKEN -d ‘{"device_id": "device1","openid": "OPEN_ID"}’

device1是用户自定义的设备IDOPEN_ID是用户微信号

 

强制解绑设备

Curl https://api.weixin.qq.com/device/compel_unbind?access_token=ACCESS_TOKEN -d ‘{"device_id": "device1","openid": "OPEN_ID"}’

device1是用户自定义的设备IDOPEN_ID是用户微信号

这篇关于微信蓝牙BLE接入调试指引 测试公众号篇(根据别人调试通过,做下记录)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



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

相关文章

SpringBoot3应用中集成和使用Spring Retry的实践记录

《SpringBoot3应用中集成和使用SpringRetry的实践记录》SpringRetry为SpringBoot3提供重试机制,支持注解和编程式两种方式,可配置重试策略与监听器,适用于临时性故... 目录1. 简介2. 环境准备3. 使用方式3.1 注解方式 基础使用自定义重试策略失败恢复机制注意事项

Python UV安装、升级、卸载详细步骤记录

《PythonUV安装、升级、卸载详细步骤记录》:本文主要介绍PythonUV安装、升级、卸载的详细步骤,uv是Astral推出的下一代Python包与项目管理器,主打单一可执行文件、极致性能... 目录安装检查升级设置自动补全卸载UV 命令总结 官方文档详见:https://docs.astral.sh/

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

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

统一返回JsonResult踩坑的记录

《统一返回JsonResult踩坑的记录》:本文主要介绍统一返回JsonResult踩坑的记录,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录统一返回jsonResult踩坑定义了一个统一返回类在使用时,JsonResult没有get/set方法时响应总结统一返回

Go学习记录之runtime包深入解析

《Go学习记录之runtime包深入解析》Go语言runtime包管理运行时环境,涵盖goroutine调度、内存分配、垃圾回收、类型信息等核心功能,:本文主要介绍Go学习记录之runtime包的... 目录前言:一、runtime包内容学习1、作用:① Goroutine和并发控制:② 垃圾回收:③ 栈和

java对接海康摄像头的完整步骤记录

《java对接海康摄像头的完整步骤记录》在Java中调用海康威视摄像头通常需要使用海康威视提供的SDK,下面这篇文章主要给大家介绍了关于java对接海康摄像头的完整步骤,文中通过代码介绍的非常详细,需... 目录一、开发环境准备二、实现Java调用设备接口(一)加载动态链接库(二)结构体、接口重定义1.类型

IDEA如何实现远程断点调试jar包

《IDEA如何实现远程断点调试jar包》:本文主要介绍IDEA如何实现远程断点调试jar包的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录问题步骤总结问题以jar包的形式运行Spring Boot项目时报错,但是在IDEA开发环境javascript下编译

apache的commons-pool2原理与使用实践记录

《apache的commons-pool2原理与使用实践记录》ApacheCommonsPool2是一个高效的对象池化框架,通过复用昂贵资源(如数据库连接、线程、网络连接)优化系统性能,这篇文章主... 目录一、核心原理与组件二、使用步骤详解(以数据库连接池为例)三、高级配置与优化四、典型应用场景五、注意事

SpringBoot实现文件记录日志及日志文件自动归档和压缩

《SpringBoot实现文件记录日志及日志文件自动归档和压缩》Logback是Java日志框架,通过Logger收集日志并经Appender输出至控制台、文件等,SpringBoot配置logbac... 目录1、什么是Logback2、SpringBoot实现文件记录日志,日志文件自动归档和压缩2.1、

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

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