uni.showModal(OBJECT)
显示模态弹窗,类似于标准 html 的消息框:alert、confirm。
uni.setStorage(OBJECT)
将数据存储在本地缓存中指定的 key 中,会覆盖掉原来该 key 对应的内容,这是一个异步接口。
uni.getStorage(OBJECT)
从本地缓存中异步获取指定 key 对应的内容。
uni.scanCode(OBJECT)(扫码)
调起客户端扫码界面,扫码成功后返回对应的结果。
// 允许从相机和相册扫码
uni.scanCode({
success: function (res) {
console.log('条码类型:' + res.scanType);
console.log('条码内容:' + res.result);
}
});
// 只允许通过相机扫码
uni.scanCode({
onlyFromCamera: true,
success: function (res) {
console.log('条码类型:' + res.scanType);
console.log('条码内容:' + res.result);
}
});
// 调起条码扫描
uni.scanCode({
scanType: ['barCode'],
success: function (res) {
console.log('条码类型:' + res.scanType);
console.log('条码内容:' + res.result);
}
});
获取用户手机号
button
按钮。
open-type String 开放能力
@getphonenumber Handler 获取用户手机号回调 open-type=“getPhoneNumber” 微信小程序
<body>
<button class='bottom' type='primary' open-type="getPhoneNumber" withCredentials="true" lang="zh_CN"
@getphonenumber="wxGetUserPhone">微信用户一键登录</button>
</body>
<script>
methods: {
wxGetUserPhone(e) {
if (e.detail.errMsg == "getPhoneNumber:ok") {
console.log('用户点击了允许')
this.updateUserInfo(e); //调用更新信息方法
} else {
console.log('用户点击了拒绝')
}
}
}
</script>
获取用户信息,button open-type 开放能力
@getuserinfo Handler 用户点击该按钮时,会返回获取到的用户信息,从返回参数的detail中获取到的值同uni.getUserInfo open-type=“getUserInfo” 微信小程序
// 获取用户信息
wxGetUserInfo() {
let _this = this;
uni.getUserInfo({
provider: 'weixin',
success: function(infoRes) {
_this.nickName = infoRes.userInfo.nickName; //昵称
_this.avatarUrl = infoRes.userInfo.avatarUrl; //头像
_this.updateUserInfo(); //调用更新信息方法
uni.setStorage({
key: "avatarUrl",
data: infoRes.userInfo.avatarUrl
})
uni.setStorage({
key: "nickName",
data: infoRes.userInfo.nickName
})
},
fail(res) {}
});
},
授权uni.authorize(OBJECT)
提前向用户发起授权请求。调用后会立刻弹窗询问用户是否同意授权小程序使用某项功能或获取用户的某些数据,但不会实际调用对应接口。如果用户之前已经同意授权,则不会出现弹窗,直接返回成功。如果用户之前拒绝了授权,此接口会直接进入失败回调,一般搭配uni.getSetting和uni.openSetting使用。
// 获取用户位置信息
getAuthorizeInfo() {
const that = this;
uni.authorize({
scope: 'scope.userLocation',
success() { // 允许授权
that.getLocationInfo();
},
fail() { // 拒绝授权
that.openConfirm();
}
})
},
uni.requestPayment(OBJECT)(支付)
uni.requestPayment是一个统一各平台的客户端支付API,不管是在某家小程序还是在App中,客户端均使用本API调用支付。
本API运行在各端时,会自动转换为各端的原生支付调用API。
注意支付不仅仅需要客户端的开发,还需要服务端开发。虽然客户端API统一了,但各平台的支付申请开通、配置回填仍然需要看各个平台本身的支付文档。
比如微信有App支付、小程序支付、H5支付等不同的申请入口和使用流程,对应到uni-app,在App端要申请微信的App支付,而小程序端则申请微信的小程序支付。
如果服务端使用uniCloud,那么官方提供了uniPay云端统一支付服务,把App、微信小程序、支付宝小程序里的服务端支付开发进行了统一的封装。
前端统一的uni.requestPayment和云端统一的uniPay搭配,可以极大提升支付业务的开发效率,强烈推荐给开发者使用。uniPay的文档另见:https://uniapp.dcloud.io/uniCloud/unipay