HarmonyOS API：已停止维护的接口

joytrian

发布于 2023-4-12 18:12

浏览

0收藏

版本：v3.1 Beta

@system.geolocation (地理位置)

更新时间: 2023-02-17 09:19

说明

从API Version 7 开始，该接口不再维护，推荐使用新接口@ohos.geolocation。
本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import geolocation from '@system.geolocation';

权限列表

ohos.permission.LOCATION

geolocation.getLocation

getLocation(Object): void

获取设备的地理位置。

系统能力： SystemCapability.Location.Location.Lite

参数:

参数名	类型	必填	说明
timeout	number	否	超时时间，单位为ms，默认值为30000。设置超时，是为了防止出现权限被系统拒绝、定位信号弱或者定位设置不当，导致请求阻塞的情况。超时后会使用fail回调函数。取值范围为32位正整数。如果设置值小于等于0，系统按默认值处理。
coordType	string	否	坐标系的类型，可通过getSupportedCoordTypes获取可选值，缺省值为wgs84。
success	Function	否	接口调用成功的回调函数。
fail	Function	否	接口调用失败的回调函数。
complete	Function	否	接口调用结束的回调函数。

success返回值：

参数名	类型	说明
longitude	number	设备位置信息：经度。
latitude	number	设备位置信息：纬度。
altitude	number	设备位置信息：海拔。
accuracy	number	设备位置信息：精确度。
time	number	设备位置信息：时间。

fail返回错误代码：

错误码	说明
601	获取定位权限失败，失败原因：用户拒绝。
602	权限未声明。
800	超时，失败原因：网络状况不佳或GPS不可用。
801	系统位置开关未打开。
802	该次调用结果未返回前接口又被重新调用，该次调用失败返回错误码。

示例：

export default {    
  getLocation() {        
    geolocation.getLocation({            
      success: function(data) {                
        console.log('success get location data. latitude:' + data.latitude);            
      },            
      fail: function(data, code) {                
        console.log('fail to get location. code:' + code + ', data:' + data);            
      },
    });    
  },
}

geolocation.getLocationType

getLocationType(Object): void

获取当前设备支持的定位类型。

系统能力： SystemCapability.Location.Location.Lite

参数：

参数名	类型	必填	说明
success	Function	否	接口调用成功的回调函数。
fail	Function	否	接口调用失败的回调函数。
complete	Function	否	接口调用结束的回调函数。

success返回值：

参数名	类型	说明
types	Array<string>	可选的定位类型['gps', 'network']。

示例：

export default {    
  getLocationType() {        
    geolocation.getLocationType({            
      success: function(data) {                
        console.log('success get location type:' + data.types[0]);            
      },            
      fail: function(data, code) {                
        console.log('fail to get location. code:' + code + ', data:' + data);            
       },        
     });    
  },
}

geolocation.subscribe

subscribe(Object): void

订阅设备的地理位置信息。多次调用的话，只有最后一次的调用生效。

系统能力： SystemCapability.Location.Location.Lite

参数：

参数名	类型	必填	说明
coordType	string	否	坐标系的类型，可通过getSupportedCoordTypes获取可选值，默认值为wgs84。
success	Function	是	位置信息发生变化的回调函数。
fail	Function	否	接口调用失败的回调函数。

success返回值：

参数名	类型	说明
longitude	number	设备位置信息：经度。
latitude	number	设备位置信息：纬度。
altitude	number	设备位置信息：海拔。
accuracy	number	设备位置信息：精确度。
time	number	设备位置信息：时间。

fail返回错误代码：

错误码	说明
601	获取定位权限失败，失败原因：用户拒绝。
602	权限未声明。
801	系统位置开关未打开。

示例：

export default {    
  subscribe() {        
    geolocation.subscribe({            
      success: function(data) {                
        console.log('get location. latitude:' + data.latitude);            
      },            
      fail: function(data, code) {                
        console.log('fail to get location. code:' + code + ', data:' + data);            
      },        
    });    
  },
}

geolocation.unsubscribe

unsubscribe(): void

取消订阅设备的地理位置信息。

系统能力： SystemCapability.Location.Location.Lite

示例：

export default {    
  unsubscribe() {        
    geolocation.unsubscribe();    
  },
}

geolocation.getSupportedCoordTypes

getSupportedCoordTypes(): Array<string>

获取设备支持的坐标系类型。

系统能力： SystemCapability.Location.Location.Lite

返回值：

类型	非空	说明
Array<string>	是	表示坐标系类型，如[wgs84, gcj02]。

示例：

export default {    
  getSupportedCoordTypes() {       
    var types = geolocation.getSupportedCoordTypes();    
  },
}

@system.mediaquery (媒体查询)

更新时间: 2023-02-17 09:19

提供根据不同媒体类型定义不同的样式。

说明

从API Version 7 开始，该接口不再维护，推荐使用新接口@ohos.mediaquery。
本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import mediaquery from '@system.mediaquery';

mediaquery.matchMedia

matchMedia(condition: string): MediaQueryList

根据媒体查询条件，创建MediaQueryList对象。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
condition	string	是	用于查询的条件。

返回值：

参数类型	说明
MediaQueryList	表示创建MediaQueryList对象的属性，详情见下表 MediaQueryList说明。

示例：

var mMediaQueryList = mediaquery.matchMedia('(max-width: 466)');

MediaQueryEvent

定义MediaQuery事件。

系统能力： SystemCapability.ArkUI.ArkUI.Full

名称	参数类型	必填	说明
matches	boolean	是	匹配结果。

MediaQueryList

定义MediaQuery列表信息。

属性

系统能力： 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full

名称	参数类型	必填	说明
media	string	否	序列化媒体查询条件，该参数为只读。
matches	boolean	是	匹配结果。

onchange

onchange?: (matches: boolean) => void

matches状态变化时的执行函数。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
matches	boolean	是	matches状态变化时值。

MediaQueryList.addListener

addListener(callback: (event: MediaQueryEvent) => void): void

给MediaQueryList添加回调函数，回调函数应在onShow生命周期之前添加，即需要在onInit或onReady生命周期里添加。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
callback	(event: MediaQueryEvent) => void	是	匹配条件发生变化的响应函数。

示例：

function maxWidthMatch(e){
  if(e.matches){
    // do something
  }
}
mMediaQueryList.addListener(maxWidthMatch);

MediaQueryList.removeListener

removeListener(callback: (event: MediaQueryEvent) => void): void

移除MediaQueryList中的回调函数。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
callback	(event: MediaQueryEvent) => void)	是	匹配条件发生变化的响应函数。

示例：

function maxWidthMatch(e){
  if(e.matches){
    // do something
  }
}
mMediaQueryList.removeListener(maxWidthMatch);

文章转载自：https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-system-mediaquery-0000001477981501-V3?catalogVersion=V3

分类

卡片开发

三方件

标签

HarmonyOS API

已于2023-4-12 18:12:34修改

51CTO

51CTO博客

51CTO学堂

HarmonyOS API：已停止维护的接口

@system.geolocation (地理位置)

导入模块

权限列表

geolocation.getLocation

geolocation.getLocationType

geolocation.subscribe

geolocation.unsubscribe

geolocation.getSupportedCoordTypes

@system.mediaquery (媒体查询)

导入模块

mediaquery.matchMedia

MediaQueryEvent

MediaQueryList

属性

onchange

MediaQueryList.addListener

MediaQueryList.removeListener

目录

订阅鸿蒙技术特刊，精选内容抢先看