一、申请类目 1.1 申请工具-设备管理类目
进入小程序的后台管理系统,点击左侧界面最下方的“设备”选项,接着选择“基本设置”中的“服务类目”,在此处新增“工具-设备管理”这一类别(请注意,此类别无需提供相关资质证明。若该类别已存在,则无需重复此步骤)。
二、设备接入2.1 开通设备管理功能
进入小程序的案例展示区,浏览功能模块下的硬件设备相关内容,了解设备的使用规定和接入步骤,随后点击“开通”按钮。管理员通过扫描二维码进行验证,确认无误后,开通操作即告完成,并自动跳转至设备管理界面。
2.2 添加硬件设备 (需审核)
进入硬件设备界面,需点击“添加设备”按钮,然后根据每个字段的具体指示输入信息。务必准确无误地填写设备各项详细信息,若信息填写有误,将可能引发审核不通过的结果。
若缺乏适宜的设备型号,您可通过加入交流群(下方二维码所示)进行咨询,我们将在审慎评估后给予答复。
2.3 获取设备
设备注册完成,用户将获得平台赋予的特定标识,这一标识对于调用小程序中与设备功能相关的接口至关重要。拥有该标识后,小程序能够依据官方提供的文档指导,实现如“设备消息”等硬件功能的调用。
2.4 申请设备能力(需审核)
获取之后,在设备管理入口,点击右侧“申请设备能力”。
(设备消息能力审核通过状态)
三、获取设备消息
“小程序设备消息”功能意味着,一旦用户在小程序中选择了接收通知,开发者便可以将相关事件以订阅消息的方式推送给用户。这类消息在微信平台上的呈现形式主要是“服务通知”。若要申请使用设备消息功能,开发者需先完成“二、设备接入”的相关步骤。更多关于小程序订阅消息的详细信息,请查阅相关文档。
3.1 获取模板
进入小程序的管理界面,点击“功能”选项,选择“订阅消息”,接着浏览“公共模板库”,在此可以找到适用于长期订阅的设备消息模板。
若公共模板库中缺乏您所需的模板信息,您可通过下方二维码加入交流群,并按照以下格式提出申请:
小程序名称:
小程序主体:
:
设备消息场景描述:
所属行业:如:智能家居
设备型号:如:空气净化器
模板框架:如:
标题:空气净化器耗材提醒
提醒时间:mmdd hhmm
所在位置:卧室
提示说明:空气净化器滤网已到达更换时间,请及时更换。
属于哪种情况:
1、对生命财产可能造成影响的告警
2、影响到设备正常使用的提前预警
3、需要人工介入做进一步操作的提醒
4、其他,请补充具体内容
加群二维码:
3.2 获取模板ID
选择设备消息模板中需要的关键词,并提交。
请注意:该位置对应的是序号,部分字段允许上传特定格式的字符。至于其他关键词,目前尚不支持用户进行自定义设置。
提交成功后,您可以在“我的模板”栏目内查找到相应的模板编号,每个模板均以特定符号进行标识。
3.3 获取设备票据
请获取相关数据,用于执行“发起订阅”的操作环节。具体信息请参考服务端设备票据的接口说明。
四、触发设备消息4.1 发起用户订阅
调用“发起订阅”功能时,通过wx接口会触发一系列授权提示,只有用户确认接受订阅消息,设备才能将消息发送到用户的微信对话中。
用户可在小程序内进行设备消息订阅操作,具体步骤包括:选择相应的消息标题,然后点击页面右侧的显著提醒按钮,最后完成提交时确认“同意”即可。
示例代码
调用wx.requestSubscribeDeviceMessage接口,以实现设备消息订阅功能。 sn: 'xxxx', snTicket: 'xxxxx', modelId: 'xxxxx', tmplIds: ['xxxxx'], success(res) { console.log(成功触发请求订阅设备消息接口:'[wx.requestSubscribeDeviceMessage success]:', res) 该对象中的键“QCpBsp1TGJ1ML-UIwAIMkdXpPGzxSfwJqsKsvMVs3io”对应的值是“接受”。 }, fail(res) { console.log(在调用wx.requestSubscribeDeviceMessage函数时,出现了失败的情况。, res) } })
4.2 发送设备消息
开发者利用微信平台的服务端接口,向用户发送有关设备的资讯。具体操作可参考服务端设备消息发送的相关接口,即.send接口。
开发者应在小程序的适宜情境中,向用户展示一段关于长期消息授权的提示窗口。例如,当用户完成房屋验证后,通过用户操作激活“门禁机呼叫提醒”的订阅提示。