qing.js 是为了方便前端人员在云之家环境调用native代码的工具类,兼容新版桌面端、老版桌面端、移动端、微信
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>示例</title>
</head>
<body>
<!-- 引入qing -->
<script src="//static.yunzhijia.com/public/js/qing/latest/qing.js"></script>
<script>
// 在 qing.config 执行前,所有其它的 ydk api 都不会真正被调用
// 这里是一个简单的配置,其它 API list 请参考详细文档
qing.config({
debug : false,
// 声明需要调用的API
jsApiList : ['checkJsApi', 'share'],
// 声明需要监听的事件,声明后可通过 document.addEventListener 绑定监听函数
jsEventList: ['appear', 'disappear']
});
// 获取个人信息
qing.call('getPersonInfo', {
success : function(res){}
});
// 监听appear事件
qing.on('appear', function(res){});
</script>
</body>
</html>
所有接口的调用形式为 qing.call('xxx', {...}),参数必须是一个对象。
每个接口除了自身必须的参数外,还支持以下通用参数:
success:接口调用成功时执行的回调函数。error:接口调用失败时执行的回调函数。complete:接口调用完成时执行的回调函数,无论成功或失败都会执行。以上所述的回调函数的参数说明,如 success : function (res) { ... },这里的 res 为对象,除了每个接口自身返回的数据之外,还有两个通用属性 code 和 errMsg,其值格式如下:
success):{code: 200, errMsg: "", data: {}}error):{code: 500, errMsg: "不合法的图片文件大小", data: {}}注: code 类型为数字,非字符串。
Object.hasOwnPropertyArray.prototype.forEachObject.keys"a.b.c" 1.> {a:{b:{c:{}}}}qing.isIe() or qing.isIe(6)注: code类型为数字,非字符串。
| 返回码 | 说明 |
|---|---|
| 100 | 调用成功,并且有多次返回 |
| 200 | 调用成功 |
| 404 | 接口不存在 |
| 500 | 全局调用失败code |
云之家App轻应用的UserAgent获取到的信息如下:
| deviceId | 设备ID |
|---|---|
| deviceName | 设备名称 |
| clientId | 客户端ID,10200表示iOS端,10201表示Android端,10208表示iPad端 |
| os | 系统版本 |
| brand | 手机品牌 |
| model | 手机型号 |
| lang | 客户端当前语言,zh开头为中文,en开头为英文,目前仅支持中文和英文 |
| fontNum | 客户端当前字体大小,0表示标准字体,-1表示小号字体,1、2、3、4依次表示更大号字体(目前仅iOS端支持) |