一、申请类目

1.1 申请工具-设备管理类目

登录小程序管理后台mp.weixin.qq.com，左侧最下方“设备”-基本设置-服务类目，添加“工具-设备管理”类目（该类目无需资质。如已有该类目可忽略此流程）

二、设备接入

2.1 开通设备管理功能

进入小程序案例台-功能-硬件设备，阅读设备使用条件和接入流程等，点击“开通”。管理员扫码确认后开通成功，进入设备管理页面。

2.2 添加硬件设备 （需审核）

进入硬件设备，点击添加设备，按照每个字段对应的说明填写信息，如实填写设备相关信息，否则会导致审核不通过。

如没有合适的设备类型，可以加群沟通（底部二维码），我们将评估后予以回复。

2.3 获取设备 model_id

设备注册成功后，可获得平台分配的 model_id ，model_id 是调用小程序设备能力相关接口的重要凭证。获取 model_id 后，小程序可按照相关文档指引调用「设备消息」等硬件能力。

2.4 申请设备能力（需审核）

model_id 获取之后，在设备管理入口，点击右侧“申请设备能力”。

（设备消息能力审核通过状态）

三、获取设备消息

「小程序设备消息」能力指的是，只要用户在小程序内订阅通知，开发者就可以将这些事件以订阅消息的形式发送给用户。消息在微信内的产品形态，目前以“服务通知”形式呈现。 申请设备消息必须先完成“二、设备接入”。关于小程序订阅消息的基础介绍可参考文档

3.1 获取模板

登录小程序管理后台——功能——订阅消息——公共模板库——长期订阅，查看可选用的设备消息模板。

注意：如公共模板库没有你所需要的模板消息，可以加群沟通（底部二维码） ，申请格式如下：

小程序名称：

小程序主体：

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 

注意：开发者需要在小程序的合理场景内，给用户提供长期消息的授权弹窗。如用户实现房屋认证后通过用户操作触发“门禁机呼叫提醒”的订阅弹窗。