一、申请类目
1.1 申请工具-设备管理类目
登录小程序管理后台mp.weixin.qq.com,左侧最下方“设备”-基本设置-服务类目,添加“工具-设备管理”类目(该类目无需资质。如已有该类目可忽略此流程)
二、设备接入
2.1 开通设备管理功能
进入小程序案例台-功能-硬件设备,阅读设备使用条件和接入流程等,点击“开通”。管理员扫码确认后开通成功,进入设备管理页面。
2.2 添加硬件设备 (需审核)
进入硬件设备,点击添加设备,按照每个字段对应的说明填写信息,如实填写设备相关信息,否则会导致审核不通过。
如没有合适的设备类型,可以发送邮件至 wx_iot@tencent.com 进行新增,我们将评估后予以回复。
2.3 获取设备 model_id
设备注册成功后,可获得平台分配的 model_id ,model_id 是调用小程序设备能力相关接口的重要凭证。获取 model_id 后,小程序可按照相关文档指引调用「设备消息」等硬件能力。
2.4 申请设备能力(需审核)
model_id 获取之后,在设备管理入口,点击右侧“申请设备能力”。
(设备消息能力审核通过状态)
三、获取设备消息
「小程序设备消息」能力指的是,只要用户在小程序内订阅通知,开发者就可以将这些事件以订阅消息的形式发送给用户。消息在微信内的产品形态,目前以“服务通知”形式呈现。 申请设备消息必须先完成“二、设备接入”。关于小程序订阅消息的基础介绍可参考文档
3.1 获取模板
登录小程序管理后台——功能——订阅消息——公共模板库——长期订阅,查看可选用的设备消息模板。
注意:如公共模板库没有你所需要的模板消息,则需要人工提交申请,请邮件至 wx_iot@tencent.com ,申请格式如下:
邮件标题:【申请新增设备模板消息】小程序名称+小程序主体
邮件正文:
小程序名称:
小程序主体:
APPID:
设备消息场景描述:
所属行业:如:智能家居
设备型号:如:空气净化器
模板框架:如:
标题:空气净化器耗材提醒
提醒时间:mmdd hhmm
所在位置:卧室
提示说明:空气净化器滤网已到达更换时间,请及时更换。
属于哪种情况:
1、对生命财产可能造成影响的告警
2、影响到设备正常使用的提前预警
3、需要人工介入做进一步操作的提醒
4、其他,请补充具体内容
联系电话:
联系邮箱:
3.2 获取模板ID
选择设备消息模板中需要的关键词,并提交。
注意:所在位置为枚举值,部分字段可以上传字符格式。其他关键词暂不支持自定义
提交后,可在“我的模板”中找到对应模板的模板 ID ,每个模板以 template_id 标记。
3.3 获取设备票据
获取 snTicket 用于「发起订阅」步骤。详见服务端设备票据接口 hardwareDevice.getSnTicket 。
四、触发设备消息
4.1 发起用户订阅
发起订阅调用 wx.requestSubscribeDeviceMessage 接口会有以下授权弹窗出现,用户同意订阅消息后,才会有设备消息发送至用户的微信会话
可以引导用户在小程序内完成设备消息订阅,用户需勾选左侧消息,并点击右侧强提醒按钮后提交“允许”。
(以上为小程序门禁设备长期消息弹窗样式)
示例代码
wx.requestSubscribeDeviceMessage({
sn: 'xxxx',
snTicket: 'xxxxx',
modelId: 'xxxxx',
tmplIds: ['xxxxx'],
success(res) {
console.log('[wx.requestSubscribeDeviceMessage success]: ', res)
// { 'QCpBsp1TGJ1ML-UIwAIMkdXpPGzxSfwJqsKsvMVs3io': 'accept' }
},
fail(res) {
console.log('[wx.requestSubscribeDeviceMessage fail]: ', res)
}
})
4.2 发送设备消息
开发者通过微信服务端接口向用户推送设备消息。详见服务端设备消息发送接口 hardwareDevice.send
注意:开发者需要在小程序的合理场景内,给用户提供长期消息的授权弹窗。如用户实现房屋认证后通过用户操作触发“门禁机呼叫提醒”的订阅弹窗。