基于设置应用的应用权限、通知设置跳转

2024年 5月 8日 70.8k 0

基于设置应用的应用权限、通知设置跳转-1

想了解更多关于开源的内容,请访问:

51CTO 鸿蒙开发者社区

https://ost.51cto.com

引导用户跳转到系统设置页进行权限,通知的相关设置,类似android和iOS应用中常见的应用内跳转到设置进行通知开启或权限设置的操作。

应用经常会遇到如下的业务诉求:

场景一:如果应用首次拒绝了消息通知,应用希望能够引导用户拉起设置应用设置允许通知,用来接收应用内的推送消息;并且在设置完后返回页面可以监听到修改后的状态。

场景二:当用户使用一些需要用户授权的api时(如访问获取联系人信息),若用户首次拒绝授权,则需要引导用户到权限设置页面能够主动进行应用权限的修改。

场景三:支持打开/关闭系统功能如Wi-Fi、NFC、移动网络、蓝牙等。

方案描述

场景一:

如果应用首次拒绝了消息通知,应用希望能够引导用户拉起设置应用设置允许通知,用来接收应用内的推送消息;并且在设置完后返回页面可以监听到修改后的状态。

效果图

基于设置应用的应用权限、通知设置跳转-2

基于设置应用的应用权限、通知设置跳转-3

方案

  • 通过startability显式拉起设置应用-通知管理界面,配置相应的want信息(不推荐使用隐式拉起的方式)。
  • 在进入页面时通过Notification.requestEnableNotification()监听应用请求通知使能。

核心代码

为Button绑定拉起事件。

Button(this.buttonText).onClick(()=>{ 
  let context = getContext(this) as common.UIAbilityContext; 
  let want: Want = { 
    bundleName: 'com.huawei.hmos.settings',//设置应用bundleName 
    abilityName: 'com.huawei.hmos.settings.MainAbility',//设置应用abilityName 
    uri: "systemui_notification_settings",//通知管理页面 
    parameters: { 
      pushParams: { 
        bundleName:context.abilityInfo.bundleName//拉起方应用包名 
      } 
    }; 
    context.startAbility(want) 
  }).margin(10) 
  Text(this.message)

在打开页面时获取通知管理中按钮状态,Notification.requestEnableNotification()请求发送通知的许可,第一次调用会弹窗让用户选择。

onPageShow(): void { 
  Notification.requestEnableNotification().then(() => { 
  //已打开通知 
  this.message = "已允许接收消息推送。" 
  this.buttonText = "去关闭通知" 
  console.info("requestEnableNotification success"); 
}).catch((err:Error) => { 
  //未打开通知 
  this.message = "已禁止接收消息推送。" 
  this.buttonText = "去开启通知" 
  console.info("requestEnableNotification error"); 
}); 
}

场景二:

当用户使用一些需要用户授权的api时(如访问获取联系人信息),若用户首次拒绝授权,则需要引导用户到权限设置页面能够主动进行应用权限的修改。

是否为用户授权可参考允许ACL跨级别申请-应用权限列表-应用权限管控-程序访问控制-Ability Kit(程序框架服务)-开发 | 华为开发者联盟 (huawei.com)

效果图

基于设置应用的应用权限、通知设置跳转-4

基于设置应用的应用权限、通知设置跳转-5

方案

暂无直接跳转权限管理的方式,可通过跳转至应用详情进行用户申请权限的修改。

核心代码

为button绑定获取联系人信息事件:

Button("获取联系人").onClick(async () => { 
  const permissions: Array = ['ohos.permission.READ_CONTACTS']; 
  let context: Context = getContext(this) as common.UIAbilityContext; 
  let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager(); 
  // requestPermissionsFromUser会判断权限的授权状态来决定是否唤起弹窗 
  atManager.requestPermissionsFromUser(context, permissions).then((data: PermissionRequestResult) => { 
    //grantStatus:授权状态:0 已授权 1未授权 2未授权 表示请求无效, 
    let grantStatus: Array = data.authResults; 
    let length: number = grantStatus.length; 
    for (let i = 0; i  { 
    console.error(`Failed to request permissions from user. Code is ${err.code}, message is ${err.message}`); 
  }) 
}).margin(10)

调用 contact.queryContacts获取联系人信息。

getContact(context:Context){ 
  contact.queryContacts(context, (err: BusinessError, data) => { 
    this.contacts = data 
  }); 
}

拒接授权后的引导弹窗:

dialogControllerConfirm: CustomDialogController = new CustomDialogController({ 
  builder: AlertDialog({ 
    content: '已拒绝访问系统通讯录,是否前往开启?', 
    primaryButton: { 
      value: '取消', 
      action: () => {}, 
    }, 
    secondaryButton: { 
      value: '确认', 
      fontColor: $r('sys.color.ohos_id_color_warning'), 
      action: () => { 
        this.openAppInfo() 
      } 
    }, 
  }), 
  autoCancel: true, 
  customStyle: true, 
  alignment: DialogAlignment.Bottom 
})

进入设置-应用详情页。

openAppInfo(){ 
  let context = getContext(this) as common.UIAbilityContext; 
  context.startAbility({ 
    bundleName: 'com.huawei.hmos.settings', 
    abilityName: 'com.huawei.hmos.settings.MainAbility', 
    uri: 'application_info_entry', 
    parameters: { 
      pushParams: "com.example.startability" 
    } 
  }); 
}

场景三:

支持打开/关闭系统功能如Wi-Fi、NFC、移动网络、蓝牙等。

效果图

同设置应用内相应界面

方案

通过配置对应的uri进行跳转,蓝牙uri:"bluetooth_entry",NFC uri:"nfc_settings",移动网络uri:"mobile_network_entry"

核心代码

Button("to蓝牙").onClick(()=> { 
  let context = getContext(this) as common.UIAbilityContext; 
  context.startAbility({ 
    bundleName: 'com.huawei.hmos.settings', 
    abilityName: 'com.huawei.hmos.settings.MainAbility', 
    uri:"bluetooth_entry", 
  }); 
}).margin(10) 
 
Button("toNFC").onClick(()=> { 
  let context = getContext(this) as common.UIAbilityContext; 
  context.startAbility({ 
    bundleName: 'com.huawei.hmos.settings', 
    abilityName: 'com.huawei.hmos.settings.MainAbility', 
    uri:"nfc_settings", 
  }); 
}).margin(10) 
 
Button("to移动网络").onClick(()=> { 
  let context = getContext(this) as common.UIAbilityContext; 
  context.startAbility({ 
    bundleName: 'com.huawei.hmos.settings', 
    abilityName: 'com.huawei.hmos.settings.MainAbility', 
    uri:"mobile_network_entry", 
  }); 
}).margin(10)

想了解更多关于开源的内容,请访问:

51CTO 鸿蒙开发者社区

https://ost.51cto.com

相关文章

JavaScript2024新功能:Object.groupBy、正则表达式v标志
PHP trim 函数对多字节字符的使用和限制
新函数 json_validate() 、randomizer 类扩展…20 个PHP 8.3 新特性全面解析
使用HTMX为WordPress增效:如何在不使用复杂框架的情况下增强平台功能
为React 19做准备:WordPress 6.6用户指南
如何删除WordPress中的所有评论

发布评论