HarmonyOS鸿蒙Next中关于web类里申请权限的问题

HarmonyOS鸿蒙Next中关于web类里申请权限的问题 cke_130.png

如上图,在说明方法之前,文档里提到了需要权限,这个需要权限指代的是在使用下面方法的时候,遇到需要访问地理位置时候就要申请权限吗,还是如果使用了这个类就需要首先申请权限呢


更多关于HarmonyOS鸿蒙Next中关于web类里申请权限的问题的实战教程也可以访问 https://www.itying.com/category-93-b0.html

9 回复

GeolocationPermissions是个工具类。方法都是static的。方便你在Web组件使用地图位置时做权限管理。
调用这个类的方法不需要权限。调用需要权限的方法时才需要权限。
需要权限很多都是方法级别的。如果需要会有标识。
cke_1880.png

更多关于HarmonyOS鸿蒙Next中关于web类里申请权限的问题的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


我想请问一下,除了提到的工具类、方法类 还有什么其他的类别吗

如果全面了解下语言特性,可以看下《ArkTS语言介绍》。另外在线课程搜arkts也有系列课。

需要再你使用位置权限之前通过动态申请权限(用户授权),授权成功后通过web组件的onGeolocationShow方法去管理位置权限;
目前官网已有相关文档,

管理位置权限

可根据这个链接查看

如果不申请权限是使用不了定位的。你要想正常使用定位就一定绕不开申请权限。反过来,如果只是调用了定位的方法,而没有申请权限,是无法获取到定位信息的。

Web组件根据GeolocationPermissions类和onGeolocationShow方法的响应结果,决定是否赋予前端页面权限。用户可以获取位置信息,以便使用出行导航、天气预报等服务。

需要权限

使用获取位置功能,需在module.json5中配置位置权限。具体添加方法请参考在配置文件中声明权限

"requestPermissions":[
   {
     "name" : "ohos.permission.LOCATION" // 精准定位
   },
   {
     "name" : "ohos.permission.APPROXIMATELY_LOCATION" // 模糊定位
   },
   {
     "name" : "ohos.permission.LOCATION_IN_BACKGROUND" // 后台定位
   }
 ]

申请位置权限

在下面的示例中,用户点击前端页面"获取位置"按钮,Web组件通过弹窗通知应用侧位置权限请求消息。

  • 前端页面代码。
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>位置信息</title>
</head>
<body>
    <p id="locationInfo">位置信息</p>
    <button onclick="getLocation()">获取位置</button>
    <script>
        var locationInfo=document.getElementById("locationInfo");
        function getLocation(){
            if (navigator.geolocation) {
                // 访问设备地理位置
                navigator.geolocation.getCurrentPosition(showPosition);
            }
        }
        function showPosition(position){
            locationInfo.innerHTML="Latitude: " + position.coords.latitude + "<br />Longitude: " + position.coords.longitude;
        }
    </script>
</body>
</html>
  • 应用代码。
import { webview } from '@kit.ArkWeb';
import { BusinessError } from '@kit.BasicServicesKit';
import { abilityAccessCtrl, common } from '@kit.AbilityKit';
let atManager = abilityAccessCtrl.createAtManager();
@Entry
@Component
struct WebComponent {
  controller: webview.WebviewController = new webview.WebviewController();
  uiContext: UIContext = this.getUIContext();
  // 组件的生命周期函数,创建组件实例后触发
  aboutToAppear(): void {
    let context : Context | undefined = this.uiContext.getHostContext() as common.UIAbilityContext;
    if (!context) {
      console.error("context is undefined");
      return;
    }
    // 向用户请求位置权限,对整个应用生效
    atManager.requestPermissionsFromUser(context, ["ohos.permission.APPROXIMATELY_LOCATION"]).then((data) => {
      console.info('data:' + JSON.stringify(data));
      console.info('data permissions:' + data.permissions);
      console.info('data authResults:' + data.authResults);
    }).catch((error: BusinessError) => {
      console.error(`Failed to request permissions from user. Code is ${error.code}, message is ${error.message}`);
    })
  }
  build() {
    Column() {
      // Web组件的geolocationAccess属性默认为true,可以显式配置为false以禁止Web组件获取地理位置信息
      Web({ src: $rawfile('getLocation.html'), controller: this.controller })
        .geolocationAccess(true)
        .onGeolocationShow((event) => {
          // 位置权限申请通知仅对当前Web组件生效,应用内的其他Web组件不受影响
          this.uiContext.showAlertDialog({
            title: '位置权限请求',
            message: '是否允许获取位置信息',
            primaryButton: {
              value: 'cancel',
              action: () => {
                if (event) {
                  // 不允许此站点位置权限请求
                  // 注意invoke的第3个参数表示是否记住当前选择,如果传true,则下次不再弹框
                  event.geolocation.invoke(event.origin, false, false);
                }
              }
            },
            secondaryButton: {
              value: 'ok',
              action: () => {
                if (event) {
                  // 允许此站点位置权限请求
                  // 注意invoke的第3个参数表示是否记住当前选择,如果传true,则下次不再弹框
                  event.geolocation.invoke(event.origin, true, false);
                }
              }
            },
            cancel: () => {
              if (event) {
                // 不允许此站点位置权限请求
                // 注意invoke的第3个参数表示是否记住当前选择,如果传true,则下次不再弹框
                event.geolocation.invoke(event.origin, false, false);
              }
            }
          })
        })
    }
  }
}

找HarmonyOS工作还需要会Flutter的哦,有需要Flutter教程的可以学学大地老师的教程,很不错,B站免费学的哦:https://www.bilibili.com/video/BV1S4411E7LY/?p=17,

这里文档里的“需要权限”,指的是:

当 Web 页面真正访问地理位置能力时,需要应用先具备定位权限。

不是:

只要 import 或使用 GeolocationPermissions 类就必须先申请权限。

也就是说:

场景 是否必须提前申请定位权限
仅调用 allowGeolocation() 不一定
Web 页面触发 navigator.geolocation.xxx 必须
H5 请求定位 必须
Web 不访问定位 不需要

你可以理解为:

GeolocationPermissions

本质上只是:

“是否允许某个网页(origin)使用定位”

但:

真正的定位能力

还是系统权限控制的。


例如:

H5 页面:

navigator.geolocation.getCurrentPosition(...)

这时:

  1. Web 会请求定位
  2. ArkWeb 会检查:
    • 当前 origin 是否 allow
    • App 是否有 LOCATION 权限
  3. 缺任何一个都会失败

所以实际完整流程应该是:

正确流程

1. 申请系统定位权限

例如:

ohos.permission.LOCATION

必要时:

ohos.permission.APPROXIMATELY_LOCATION

后台定位再加:

ohos.permission.LOCATION_IN_BACKGROUND

2. 用户授权成功后

再:

webview.GeolocationPermissions.allowGeolocation(origin)

3. H5 才能正常获取定位


很多人容易误解成:

allowGeolocation = 已经拥有定位权限

其实不是。

它只是:

允许某个网页使用定位

真正权限仍然是:

系统 Runtime Permission

举个例子:

你即使:

allowGeolocation('https://xxx.com')

但用户没授权:

ohos.permission.LOCATION

H5 仍然会:

定位失败

所以建议实际开发里:

推荐做法

在:

Web 即将加载定位页面

之前:

先主动申请定位权限。

而不是等 H5 调定位时再处理。

这样兼容性最好。


总结一句:

GeolocationPermissions 类本身不要求必须先申请权限,
但只要 Web 页面真正访问定位能力,就必须提前拥有系统定位权限。

在 HarmonyOS Next 中,Web 组件权限通过 onPermissionRequest 事件处理。在 Web 组件上设置该事件监听,事件回调中获取 PermissionRequest 对象,调用其 grant()deny() 方法授予或拒绝权限(如地理位置、摄像头)。权限需先在 module.json5 中声明。

在 HarmonyOS Next 的文档中,“需要权限” 指的是当你调用某个具体方法、触发某种功能时,该操作所必需的权限,而非整个 Web 类使用时就必须预先申请。

例如,如果某个 Web 接口说明中标注了 ohos.permission.LOCATION,这表示:只有当 Web 页面中的 JavaScript 尝试通过该接口获取地理位置时,你的应用才需要确保已申请并授予该权限。如果页面不请求位置信息,即使使用了 Web 组件,也无需申请该权限。

简而言之,权限与具体行为绑定,按需申请,不必为使用该 Class 而提前全部请求。

回到顶部