my.showauthguide(object object)

支付宝客户端 10.0.18 或更高版本； 若版本较低，建议采取 兼容处理 。

支小宝客户端 支持

安诊儿客户端 支持

主体： 企业支付宝小程序 、 个人支付宝小程序

相关文档： my.getsysteminfo 、 my.getsetting

• 调用 my.showauthguide 时，如果指定的权限类型已被授予，在 ios 上不会再次弹出引导，但在 android 的某些版本/机型上针对部分权限每次都会弹出引导。因而，请先通过 my.getsysteminfo 判断权限开启/授予情况，或在目标 api 调用失败以后，再酌情调用 my.showauthguide。可点此查看示例。
• my.chooseimage 等 api 的成功调用也依赖用户在支付宝里授权给当前小程序，可点此查看示例，相关内容可参考 my.getsetting 文档简介部分的描述。

object object

查看示例

success 回调函数

参数

object res

fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。

my.showauthguide({
  authtype: "lbs"
});

page({
  getlocationexample1() {
    my.getsysteminfo({
      success(res) {
        if (res.locationenabled && res.locationauthorized) {
          my.getlocation({
            complete: (res) => my.alert({ title: "getlocation compete", content: json.stringify(res)}),
          });
        } else {
          console.log(`${res.locationenabled} ？ "定位权限未授予支付宝" : "定位功能未开启"`);
          my.showauthguide({ authtype: "lbs" });
        }
      }
    });
  },
});

page({
  getlocationexample2() {
    my.getlocation({
      success: (res) => my.alert({ title: "getlocation success", content: json.stringify(res) }),
      fail: (res) => {
        if (res.error == 11) {
          console.error("定位功能未开启或定位权限未授予支持宝");
          my.showauthguide({ authtype: "lbs" });
        } else {
          console.error('getlocation failed: ', json.stringify(res));
        }
      }
    });
  },
});

• tip

  调用 my.showauthguide 时，如果指定的权限类型已被授予，在 ios 上不会再次弹出引导，但在 android 的某些版本/机型上针对部分权限每次都会弹出引导。因而，请先通过 my.getsysteminfo 判断权限开启/授予情况，或在目标 api 调用失败以后，再酌情调用 my.showauthguide。
• tip

  my.chooseimage 等 api 的成功调用也依赖用户在支付宝里授权给当前小程序，相关内容可参考 my.getsetting 文档简介部分的描述。
• tip

  可通过 my.caniuse('showauthguide.object.authtype.bluetooth') 检测蓝牙的引导权限是否支持。
• tip

  在 ios 设备中，如果从未尝试使用过某个系统权限，则该权限在应用的系统级权限设置页面里不会罗列，这是 ios 系统特性。 建议在 ios 端尽量不要在使用某个系统权限之前申请权限，避免用户在应用的系统级权限设置页面里找不到该系统权限。