小程序插件接入步骤
1.开发者在小程序管理后台申请使用插件,添加路径:设置 ->第三方服务 -> 插件管理 -> 添加插件,搜索并添加插件ID: wx104a1a20c3f81ec2
,无需审核确认。
设置
第三方服务
插件管理
添加插件
2.开发者在小程序app.json 文件中添加对插件的引用
"plugins": {
"contactPlugin": {
"version": "1.4.3",
"provider": "wx104a1a20c3f81ec2"
}
}
3.开发者在具体引用插件的页面文件json文件中,添加对组件的引用,例如:
在要使用的页面对应 的.json
文件里配置
"plugins": {
"contactPlugin": {
"version": "1.4.3",
"provider": "wx104a1a20c3f81ec2"
}
}
博主这里使用的是Taro所以配置文件是 .config
,写法还是一样的所以各位看客姥爷不用担心!
4.开发者在引用插件的wxml文件中添加组件的具体代码,其中plugid为在企业微信管理后台配置的客服ID,将该ID作为参数传入组件,例如:
<cell bind:startmessage='startmessage' bind:completemessage="completemessage" plugid='plugid' />
参数说明:
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
startmessage | function | 否 | 监听按钮点击事件执行开始时的回调 | |
completemessage | function | 否 | 监听按钮点击事件执行完毕后的回调 | |
plugid | string | 是 | 在企业微信管理后台配置的唯一客服ID |
其中completemessage
回调接收的参数格式如下:
{
errcode: 0, // 消息发送状态
name: '', // 推送的客服人员姓名
headurl: '' // 推送的客服人员头像
notifytype: 0, // 0: 表示消息通知的方式 1:表示二维码的方式
}
总结
一般startmessage
和completemessage
用的都不多,只要记得plugid
才是重中之重
正常使用流程(为啥这里会飘红,下期解释)