wechat/officialaccount/device/authorize.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
}