接入流程-小程序设备消息_微信小程序

# 1. 设备接入

小程序想要使用设备消息能力，首先需要接入设备，详见「设备接入」文档。

完成接入后，开发者可获得由平台分配的 model_id 。model_id 对应一种设备类型，也是调用小程序设备能力相关接口的重要凭证。

# 2. 获取模版 ID

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

选择设备消息模板中需要的关键词，并提交。

注意：设备消息模版的关键词内容由平台生成，为枚举值，开发者不能够自定义内容。

提交后，可在“我的模板”中找到对应模板的模板 ID ，每个模板以 template_id 标记。

# 3. 获取设备票据

获取 snTicket 用于「发起订阅」步骤。

详见服务端设备票据接口 hardwareDevice.getSnTicket 。

# 4. 发起订阅

调用 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)
    }
})

# 5. 发送设备消息

开发者通过微信服务端接口向用户推送设备消息。

详见服务端设备消息发送接口 hardwareDevice.send 。

服务通知 - 设备消息

设备消息具体形式