mirror of
https://github.com/silenceper/wechat.git
synced 2026-02-07 22:22:28 +08:00
118 lines
5.1 KiB
Go
118 lines
5.1 KiB
Go
// Package device 设备相关接口
|
||
package device
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
|
||
"github.com/silenceper/wechat/v2/util"
|
||
)
|
||
|
||
const (
|
||
// DeviceAdd 添加设备标识
|
||
DeviceAdd = iota
|
||
// DeviceUpgrade 更新设备标识
|
||
DeviceUpgrade
|
||
)
|
||
|
||
type reqDeviceAuthorize struct {
|
||
// 设备 id 的个数
|
||
DeviceNum string `json:"device_num"`
|
||
// 设备 id 的列表，json 的 array 格式，其 size 必须等于 device_num
|
||
DeviceList []ReqDevice `json:"device_list"`
|
||
// 请求操作的类型，限定取值为：0：设备授权（缺省值为 0）1：设备更新（更新已授权设备的各属性值）
|
||
OpType string `json:"op_type,omitempty"`
|
||
// 设备的产品编号（由微信硬件平台分配）。可在公众号设备功能管理页面查询。
|
||
// 当 op_type 为‘0’，product_id 为‘1’时，不要填写 product_id 字段（会引起不必要错误）；
|
||
// 当 op_typy 为‘0’，product_id 不为‘1’时，必须填写 product_id 字段；
|
||
// 当 op_type 为 1 时，不要填写 product_id 字段。
|
||
ProductID string `json:"product_id,omitempty"`
|
||
}
|
||
|
||
// ReqDevice 设备授权实体
|
||
type ReqDevice struct {
|
||
// 设备的 device id
|
||
ID string `json:"id"`
|
||
// 设备的 mac 地址 格式采用 16 进制串的方式（长度为 12 字节），
|
||
// 不需要 0X 前缀，如：1234567890AB
|
||
Mac string `json:"mac"`
|
||
// 支持以下四种连接协议：
|
||
// android classic bluetooth – 1
|
||
// ios classic bluetooth – 2
|
||
// ble – 3
|
||
// wifi -- 4
|
||
// 一个设备可以支持多种连接类型，用符号"|"做分割，客户端优先选择靠前的连接方式（优先级按 | 关系的排序依次降低），举例：
|
||
// 1：表示设备仅支持 andiod classic bluetooth 1|2：表示设备支持 android 和 ios 两种 classic bluetooth，但是客户端优先选择 android classic bluetooth 协议，如果 android classic bluetooth 协议连接失败，再选择 ios classic bluetooth 协议进行连接
|
||
// （注：安卓平台不同时支持 BLE 和 classic 类型）
|
||
ConnectProtocol string `json:"connect_protocol"`
|
||
// auth 及通信的加密 key，第三方需要将 key 烧制在设备上（128bit），格式采用 16 进制串的方式（长度为 32 字节），不需要 0X 前缀，如：1234567890ABCDEF1234567890ABCDEF
|
||
AuthKey string `json:"auth_key"`
|
||
// 断开策略，目前支持：1：退出公众号页面时即断开连接 2：退出公众号之后保持连接不断开
|
||
CloseStrategy string `json:"close_strategy"`
|
||
// 连接策略，32 位整型，按 bit 位置位，目前仅第 1bit 和第 3bit 位有效（bit 置 0 为无效，1 为有效；第 2bit 已被废弃），且 bit 位可以按或置位（如 1|4=5），各 bit 置位含义说明如下：
|
||
// 1：（第 1bit 置位）在公众号对话页面，不停的尝试连接设备
|
||
// 4：（第 3bit 置位）处于非公众号页面（如主界面等），微信自动连接。当用户切换微信到前台时，可能尝试去连接设备，连上后一定时间会断开
|
||
ConnStrategy string `json:"conn_strategy"`
|
||
// auth version，设备和微信进行 auth 时，会根据该版本号来确认 auth buf 和 auth key 的格式（各 version 对应的 auth buf 及 key 的具体格式可以参看“客户端蓝牙外设协议”），该字段目前支持取值：
|
||
// 0：不加密的 version
|
||
// 1：version 1
|
||
AuthVer string `json:"auth_ver"`
|
||
// 表示 mac 地址在厂商广播 manufacture data 里含有 mac 地址的偏移，取值如下：
|
||
// -1：在尾部、
|
||
// -2：表示不包含 mac 地址 其他：非法偏移
|
||
ManuMacPos string `json:"manu_mac_pos"`
|
||
// 表示 mac 地址在厂商 serial number 里含有 mac 地址的偏移，取值如下：
|
||
// -1：表示在尾部
|
||
// -2：表示不包含 mac 地址 其他：非法偏移
|
||
SerMacPost string `json:"ser_mac_post"`
|
||
// 精简协议类型，取值如下：计步设备精简协议：1（若该字段填 1，connect_protocol 必须包括 3。非精简协议设备切勿填写该字段）
|
||
BleSimpleProtocol string `json:"ble_simple_protocol,omitempty"`
|
||
}
|
||
|
||
// ResBaseInfo 授权回调实体
|
||
type ResBaseInfo struct {
|
||
BaseInfo struct {
|
||
DeviceType string `json:"device_type"`
|
||
DeviceID string `json:"device_id"`
|
||
} `json:"base_info"`
|
||
}
|
||
|
||
// 授权回调根信息
|
||
type resDeviceAuthorize struct {
|
||
util.CommonError
|
||
Resp []ResBaseInfo `json:"resp"`
|
||
}
|
||
|
||
// DeviceAuthorize 设备授权
|
||
func (d *Device) DeviceAuthorize(devices []ReqDevice, opType int, product string) (res []ResBaseInfo, err error) {
|
||
var accessToken string
|
||
accessToken, err = d.GetAccessToken()
|
||
if err != nil {
|
||
return
|
||
}
|
||
|
||
uri := fmt.Sprintf("%s?access_token=%s", uriAuthorize, accessToken)
|
||
req := reqDeviceAuthorize{
|
||
DeviceNum: fmt.Sprintf("%d", len(devices)),
|
||
DeviceList: devices,
|
||
OpType: fmt.Sprintf("%d", opType),
|
||
ProductID: product,
|
||
}
|
||
var response []byte
|
||
response, err = util.PostJSON(uri, req)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
var result resDeviceAuthorize
|
||
err = json.Unmarshal(response, &result)
|
||
if err != nil {
|
||
return
|
||
}
|
||
if result.ErrCode != 0 {
|
||
err = fmt.Errorf("DeviceAuthorize Error , errcode=%d , errmsg=%s", result.ErrCode, result.ErrMsg)
|
||
return
|
||
}
|
||
res = result.Resp
|
||
return
|
||
}
|