更新记录
0.0.1(2024-08-11) 下载此版本
元播插件首次上传
平台兼容性
Vue2 | Vue3 |
---|---|
√ | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.1.0 | × | √ | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
× | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
× | × | × | × | × | × | × | × | × |
元播插件
本插件用于实现在微信小程序浏览元播3D产品内容、客服语音对话、AR实景体验等功能。
使用教程
__1. 下载 Uni-app 插件到 uni_modules
__
2. 添加插件并新建页面
- 本插件建议使用独立分包的方式引入,以避免影响主包体积
- 在微信小程序后台中,点击“设置”->“第三方设置”->“添加插件”,搜索
wx335d2bcebf5abc5f
添加插件到项目中。 依赖插件:wx9b200073a982a111
(用于构建三维内容) 可选插件:wx069ba97219f66d99
(用于虚拟客服语音输入) - 在 app.json 中注册插件和页面,示例如下:
{
"subPackages": [
{
"root": "uni_modules/yuanbo-sdk",
"pages": [
{
"path": "pages/index",
"style": {
"navigationStyle": "custom",
"disableScroll": true
}
}
],
"plugins": {
"YmeiXR": {
"version": "0.1.39",
"provider": "wx9b200073a982a111"
},
"YuanboXR": {
"version": "0.0.29",
"provider": "wx335d2bcebf5abc5f"
}
}
}
]
}
3. 合法域名配置
在微信小程序后台中,点击“设置”->“开发设置”->“服务器域名”
-
在request合法域名和downloadFile合法域名中,添加以下域名:
https://project.cooolar.com
https://cdn.cooolar.com
-
在web-view合法域名中,添加入口H5入口页面域名,有两种方式: 1) 使用提供的默认入口页面(部署于官方服务器),则需要提供web-view校验文件给客服,并在web-view合法域名中添加以下域名:
https://project.cooolar.com
2) 自行部署入口页面,将其放置在web-view合法域名下,入口页面模板下载链接:https://project.cooolar.com/projects/yuanbo/miniprogram-h5/index.html.删除后缀
4. 带参跳转使用
const appId = ''
const appSecret = ''
const webSrc = 'https://project.cooolar.com/projects/yuanbo/miniprogram-h5/index.html'
const template = 'yuanbo'
const skuId = '28359790275309519'
uni.navigateTo({
url: `/uni_modules/yuanbo-sdk/pages/index?appId=${appId}&appSecret=${appSecret}&webSrc=${webSrc}&template=${template}&skuId=${skuId}`
})
可携带参数列表:
参数名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
appId | string |
是 | - | 小程序AppId |
appSecret | string |
是 | - | 与小程序AppId匹配的密钥, 具体请联系客服生成 |
webSrc | string |
是 | - | 入口页面,默认提供上述代码片段中的路径,也可填入自行部署的页面路径 |
skuId | string |
是 | - | 商品SKUID |
template | string |
否 | yuanbo | 模板名称,根据当前项目设定 |
smartId | string |
否 | - | 智能客服ID,若此值存在,则会直接跳转至客服页 |
userId | string |
否 | - | 标识当前用户,用于数据统计 |
webviewPath | string |
否 | - | 小程序内webview容器页面路径(将会传入options.src 作为H5页面),特定情况下,用于访问其他H5页面 |
showARSellingPoints | boolean |
否 | false | 实景体验中是否可播放模型卖点 |
customData | string |
否 | - | 预留字段 |