提交 6ab1227a 编写于 作者: DCloud_JSON's avatar DCloud_JSON

Merge branch 'master' of https://gitee.com/dcloud/unidocs-zh

### uni.getEnterOptionsSync()
#### App、web 端
获取启动时的参数。返回值与App.onLaunch的回调参数一致
#### 小程序端
获取本次启动时的参数。如果当前小程序是冷启动,则返回值与 App.onLaunch 的回调参数一致;如果当前是热启动,则返回值与 App.onShow 一致。
关于微信小程序冷启动热启动的概念,[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/operating-mechanism.html)
......
......@@ -90,8 +90,8 @@ export default {
| 属性名 | 类型 | 可选值 | 默认值 | 说明 |
| :-----------: | :-----------: | :----: | :------: | :-----------------------------------------------------------------: |
| value/v-model | String/Number | - | - | 默认值,multiple=true 时为 Array 类型,否则为 String 或 Number 类型 |
| localdata | Array | - | - | 本地渲染数据 |
| value/v-model | String/Number | - | - | 已选择数据的 value 值 |
| localdata | Array | - | - | 本地渲染数据 |
| clear | Boolean | - | - | 是否可以清空已选项 |
| label | String | | | 左侧标题 |
| placeholder | String | - | 请选择 | 输入框的提示文字 |
......
......@@ -107,8 +107,8 @@
|事件称名 |说明 | 返回参数 |
|:-: |:-: | :-: |
||sort-change | 点击排序时会触发该事件 | Function(Object)|
||filter-change | 筛选数据时会触发该事件 | Function(Object)|
|sort-change | 点击排序时会触发该事件 | Function(Object)|
|filter-change | 筛选数据时会触发该事件 | Function(Object)|
filter-change(e) 说明
```json
......
......@@ -125,7 +125,6 @@ context对象的属性清单如下:
|SOURCE |string |云函数调用来源 [详见](?id=context-source) |
|FUNCTION_NAME |string |获取云函数名称 |
|FUNCTION_TYPE |string |获取云函数类型,对于云函数来说,这里一定会返回`cloudfunction`,新增于HBuilderX 3.5.1。 |
|FUNCTION_RUNTIME_VERSION |string |云函数sdk版本,本地调试时随HBuilderX版本变动,云端一直保持和最新HBuilderX一致(无论本地版本多少,云端只有一个最新版本的云函数sdk)。新增于HBuilderX 3.5.1 |
|CLIENTIP |string |客户端IP。如果调用来源是其他服务器,会返回调用方的ip |
|CLIENTUA |string |客户端userAgent。注意非本地运行环境下客户端getSystemInfoSync也会获取ua参数并上传给云函数,但是云函数会从http请求头里面获取ua而不是clientInfo里面的ua |
|uniIdToken |string |客户端uni-id token字符串,新增于HBuilderX 3.5.1。 |
......
......@@ -289,6 +289,18 @@ errMsg用于存放具体错误信息,包括展示给开发者、终端用户
|uniCloud.init() |获取指定服务空间的uniCloud实例 [详见](uniCloud/concepts/space.md?id=multi-space) |
|uniCloud.logger |云函数中打印日志到[uniCloud web控制台](https://unicloud.dcloud.net.cn/)的日志系统(非HBuilderX控制台)[详情](rundebug.md?id=uniCloudlogger) |
## 错误对象@uni-cloud-error
云函数调用uniCloud接口时(包括请求云函数、云对象、云存储等)可能存在抛出错误的场景,此时会抛出uniCloud标准的错误对象(以下记为uniCloudError),uniCloudError包含以下属性
|属性 |类型 |必备 |说明 |
|-- |-- |-- |-- |
|errCode |string |是 |错误码 |
|errMsg |string |是 |错误信息 |
|requestId |string |否 |请求Id,用于排查错误 |
|detail |object |否 |仅云对象主动返回错误对应的响应体规范时会有此属性 |
另外uniCloudError对象上还有code属性和message属性,两者均不推荐使用。
## 访问数据库
......@@ -425,6 +437,7 @@ uniCloud的api中,有些api对应的实现,其代码体积较大,且这些
- redis扩展库[uni-cloud-redis]:云函数内使用redis,详见:[redis扩展库](uniCloud/redis.md)
- 发送短信扩展[uni-cloud-sms]:云函数中发送短信,详见:[sms扩展](uniCloud/send-sms?id=extension)
- 一键登录API扩展[uni-cloud-verify]:手机App调用运营商一键登陆服务时,云函数中获取到真实手机号, 详见:[一键登陆扩展库](uniCloud/univerify?id=extension)
- 统一推送服务扩展库[uni-cloud-push]:云函数内使用uni-push,详见:[uniCloud/uni-cloud-push/api]
以下是一个开启了redis扩展库的云函数package.json示例,注意此文件不支持注释,下方示例中的注释仅为演示
......
......@@ -372,3 +372,16 @@ uniCloud.offNeedLogin(log)
用法:`uniCloud.config.provider`
访问此属性会返回`tencent``aliyun`分别代表腾讯云和阿里云
## 错误对象@uni-cloud-error
客户端请求云端时(包括请求云函数、云对象、clientDB、云存储等)可能存在抛出错误的场景,此时会抛出uniCloud标准的错误对象(以下记为uniCloudError),uniCloudError包含以下属性
|属性 |类型 |必备 |说明 |
|-- |-- |-- |-- |
|errCode |string |是 |错误码 |
|errMsg |string |是 |错误信息 |
|requestId |string |否 |请求Id,用于排查错误 |
|detail |object |否 |仅云对象主动返回错误对应的响应体规范时会有此属性 |
另外uniCloudError对象上还有code属性和message属性,两者均不推荐使用。
......@@ -310,7 +310,6 @@ module.exports = {
// cloudInfo = {
// provider,
// spaceId,
// functionRuntimeVersion,
// functionName,
// functionType,
// }
......@@ -324,7 +323,6 @@ module.exports = {
|-- |-- |-- |-- |
|provider |string |是 |服务空间供应商,阿里云为:`aliyun`,腾讯云为:`tencent` |
|spaceId |string |是 |服务空间Id |
|functionRuntimeVersion |string |是 |服务端sdk版本,本地调试插件随HBuilderX更新,云端保持与最新HBuilderX一致(无论本地版本多少,云端只有一个最新版本的云函数sdk),新增于`HBuilderX 3.5.1` |
|functionName |string |是 |云对象名称,新增于`HBuilderX 3.5.1` |
|functionType |string |是 |云对象此值固定为`cloudobject`,新增于`HBuilderX 3.5.1` |
......
......@@ -48,7 +48,8 @@ url化后需要注意以下几点
- 每个服务空间最多绑定1个自定义域名
- uniCloud提供默认域名供体验和测试该特性
- 需要注意的是绑定的域名必须已经备案
- 单个服务空间可支持被访问的最大 QPS 为5000,单个云函数可支持被访问的最大 QPS 为2000(具体频次受函数并发限制)
- 腾讯云单个服务空间可支持被访问的最大 QPS 为5000,单个云函数可支持被访问的最大 QPS 为2000(具体频次受函数并发限制)
- 阿里云单个服务空间可支持被访问的最大 QPS 为1000(具体频次受函数并发限制)
- 默认域名可支持被访问的最大 QPS 为200,推荐您绑定自定义域名以获取更大的访问频次
- 阿里云绑定自定义域名要求此域名在阿里云保留备案信息,参考:[新增备案信息](https://help.aliyun.com/document_detail/36926.html)
......
......@@ -255,20 +255,24 @@ const hour = getOffsetDate(8).getHours()
"APPID": "", // 应用DCloud AppId
"LOCALE: "", // 客户端语言
// HBuilderX 3.5.1及更高版本无需传入大写参数,以上参数对应写法如下
"osName": "ios" // 系统类型 ios、android
"osName": "ios", // 系统类型 ios、android
"uniPlatform": "web", // 客户端类型 app-plus、h5、mp-weixin、mp-alipay等
"deviceId": "", // 设备id
"appId": "", // 应用DCloud AppId
"locale": "", // 客户端语言
// HBuilderX 3.5.1及更高版本还允许模拟调用来源(context.SOURCE)、客户端ip(context.CLIENTIP)、客户端ua(context.CLIENTUA)
"source": "client",
"clientIP": "127.0.0.1",
"ua": "xx MicroMessenger/xxx" // 注意非本地运行环境下客户端getSystemInfoSync也会获取ua参数并上传给云函数,但是云函数会从http请求头里面获取ua而不是clientInfo里面的ua
"source": "client", // 调用来源,不传时默认为 client
"clientIP": "127.0.0.1", // 客户端ip,不传时默认为 127.0.0.1
"ua": "xx MicroMessenger/xxx" // 客户端ua,不传时默认为 HBuilderX
// ...其他客户端信息
}
}
```
**注意**
- 非本地运行环境下客户端getSystemInfoSync也会获取ua参数并上传给云函数,但是云函数会从http请求头里面获取ua而不是clientInfo里面的ua
### 传入uniIdToken@mock-uni-id-token
客户端调用云函数时自动在data内加入了uniIdToken,使用配置参数运行时也一样在参数内传入即可
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册