Uniapp – API使用说明 – 授权操作

授权操作

uni.authorize(OBJECT)

提前向用户发起授权请求。调用后会立刻弹窗询问用户是否同意授权小程序使用某项功能或获取用户的某些数据，但不会实际调用对应接口。如果用户之前已经同意授权，则不会出现弹窗，直接返回成功。如果用户之前拒绝了授权，此接口会直接进入失败回调，一般搭配uni.getSetting和uni.openSetting使用。

OBJECT 参数说明

#scope 列表

注意：scope.userLocation 权限需要在 manifest.json 配置 permission， 详见：https://uniapp.dcloud.io/collocation/manifest

uni.authorize({
    scope: 'scope.userLocation',
    success() {
        uni.getLocation()
    }
})

uni.openSetting(OBJECT)

调起客户端小程序设置界面，返回用户设置的操作结果。

success 返回参数

uni.openSetting({
  success(res) {
    console.log(res.authSetting)
  }
});

uni.getSetting(OBJECT)

获取用户的当前设置。

success 返回参数

uni.getSetting({
   success(res) {
      console.log(res.authSetting)
   }
})

收货地址

uni.chooseAddress(OBJECT)

获取用户收货地址。调起用户编辑收货地址原生界面，并在编辑完成后返回用户选择的地址，需要用户授权 scope.address。

OBJECT参数说明

success返回参数说明

uni.chooseAddress({
  success(res) {
    console.log(res.userName)
    console.log(res.postalCode)
    console.log(res.provinceName)
    console.log(res.cityName)
    console.log(res.countyName)
    console.log(res.detailInfo)
    console.log(res.nationalCode)
    console.log(res.telNumber)
  }
})

获取发票抬头

uni.chooseInvoiceTitle(OBJECT)

选择用户的发票抬头，需要用户授权 scope.invoiceTitle。

在微信小程序中，当前小程序必须关联一个公众号，且这个公众号是完成了微信认证的，才能调用 chooseInvoiceTitle。

OBJECT参数说明

success返回参数说明

uni.chooseInvoiceTitle({
    success(res) {
        console.log(res.type);
        console.log(res.title);
        console.log(res.taxNumber);
        console.log(res.companyAddress);
        console.log(res.telephone);
        console.log(res.bankName);
        console.log(res.bankAccount);
  }
})

小程序跳转

uni.navigateToMiniProgram(OBJECT)

打开另一个小程序。

OBJECT 参数说明

uni.navigateToMiniProgram({
  appId: '',
  path: 'pages/index/index?id=123',
  extraData: {
    'data1': 'test'
  },
  success(res) {
    // 打开成功
  }
})

uni.navigateBackMiniProgram(OBJECT)

跳转回上一个小程序，只有当另一个小程序跳转到当前小程序时才会能调用成功。

OBJECT参数说明

uni.navigateBackMiniProgram({
  extraData: {
    'data1': 'test'
  },
  success(res) {
    // 返回成功
  }
})

uni.openEmbeddedMiniProgram(OBJECT)

微信小程序跳转小程序（半屏模式）（从微信础库 2.20.1 开始支持）

当小程序需要打开另一个小程序让用户进行快捷操作时，可将要打开的小程序以半屏的形态跳转。

调用流程

1. 微信小程序2.23.1以下版本基础库，开发者需要在全局配置manifest.json-->mp-weixin节点下添加embeddedAppIdList字段并声明需要半屏跳转的小程序，若不配置将切换为普通的小程序跳转小程序。2.23.1及以上版本起无需配置。

	{
		"mp-weixin" : {
		   "embeddedAppIdList": ["wxe5f52902cf4de896"]//需要半屏跳转的小程序appid
		}
	}

2. 开发者通过调用uni.openEmbeddedMiniProgram半屏跳转小程序：

uni.openEmbeddedMiniProgram({
	appId: '',
	path: 'pages/index/index?id=123',
	extraData: {
		'data1': 'test'
	},
	success(res) {
    // 打开成功
	}
})

使用限制

2022年3月18日后，使用过程有以下限制，若不符合以下所有条件将被自动切换为普通的小程序跳转小程序，不影响用户使用：

1. 被半屏跳转的小程序需要通过来源小程序的调用申请，开发者可在 小程序管理后台「设置」-「第三方设置」-「半屏小程序管理」板块发起申请，最多可以申请10个小程序；
2. 微信小程序2.23.1版本以下基础库，被半屏打开的小程序需要在全局配置manifest.json-->mp-weixin节点下添加embeddedAppIdList字段并声明；
3. 当前小程序需为竖屏；
4. 被半屏跳转的小程序需为非个人主体小程序（不含小游戏）

2022年3月18日前，使用过程有以下限制，若不符合以下所有条件将被自动切换为普通的小程序跳转小程序，不影响用户使用：

1. 不能在横屏下打开半屏小程序
2. 能打开小游戏
3. 跳转目标小程序需符合以下类目，详见小程序文档

账号信息

uni.getAccountInfoSync()

获取当前帐号信息，可以返回小程序的Appid。如果使用了微信小程序的云端插件，还可以返回当前插件Appid、版本号。

返回值

Object

帐号信息

miniProgram 的结构

plugin 的结构

const accountInfo = uni.getAccountInfoSync();
console.log(accountInfo.miniProgram.appId); // 小程序 appId
console.log(accountInfo.plugin.appId); // 插件 appId
console.log(accountInfo.plugin.version); // 插件版本号， 'a.b.c' 这样的形式