Appearance
JS-SDK 概述
JS-SDK是面向网页开发者提供的基于客户端内的网页开发工具包。
通过使用JS-SDK,网页开发者可借助客户端高效地使用客户端原生能力,为客户端用户提供更优质的网页体验。
此文档面向网页开发者介绍JS-SDK如何使用及相关注意事项。
使用说明
在需要调用JS接口的页面引入如下JS文件,即可直接调用客户端方法。
txt
本JS-SDK从客户端主线版本https://dapp.tmuyun.com/oss-static/app/jcommind.js
v6.7.0
开始支持,直接调用任意方法时,若版本不支持会直接返回错误码11000,可通过老版本JS-SDK或其他方式兼容实现场景。javascript
{
"code": 11000,
"data": {
"version": "6.6.1",
"type": "xsb",
"support": -1,
"supportVersion": "6.7.0"
},
"message": "当前版本不支持,请升级"
}
// window.CP2.appInfo 内也会返回相关信息,完全加载后生成
{
type: "xsb", // xsb-区县客户端内 wx-微信内 ""-其他
version: "6.7.0"
}
// window.CP2.bridgeType 为 undefined 时即代表jssdk不可用
如何快速debug
在使用此js-sdk的页面链接上拼接参数即可自动执行debug工具
参数名称 | 说明 |
---|---|
sdkDebug | 1:eruda 2:vConsole |
txt
https://vip.tmuyun.com/jcommind/all?sdkDebug=1
https://vip.tmuyun.com/jcommind/all?sdkDebug=2
返回码说明
code | 说明 |
---|---|
0 | 调用失败 |
1 | 调用成功 |
10042 | 没有地图客户端 |
11000 | 当前版本不支持,请升级 |
11001 | API方法不存在 |
11002 | API参数不合法 |
11003 | 指定参数不存在 |
12001 | 用户取消操作 |
12002 | 用户未登录 |
13001 | 服务器连接失败,包含404、500等各种服务器错误 |
13002 | 服务器超时 |
13003 | 服务器白名单返回无权限 |
13004 | 调用次数超限 |