鸿蒙语言基础类库：【@system.sensor (传感器)】

news2024/11/16 2:40:32

传感器

说明：

  • 从API Version 8开始，该接口不再维护，推荐使用新接口[@ohos.sensor]。
  • 本模块首批接口从API version 4开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
  • 该功能使用需要对应硬件支持，仅支持真机调试。

导入模块

import sensor from '@system.sensor';

传感器错误码列表

错误码说明
900当前设备不支持相应的传感器。

sensor.subscribeAccelerometer

subscribeAccelerometer(Object): void

观察加速度数据变化。针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.ACCELEROMETER，该权限为系统权限

参数：

参数名类型必填说明
intervalstring是频率参数，加速度的回调函数执行频率。 默认为normal，可选值有： - game：极高的回调频率，20ms/次，适用于游戏。 - ui：较高的回调频率，60ms/次，适用于UI更新。 - normal：普通的回调频率，200ms/次，低功耗。
successFunction是感应到加速度数据变化后的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
xnumberx轴的加速度。
ynumbery轴的加速度。
znumberz轴的加速度。

示例：

sensor.subscribeAccelerometer({
  interval: 'normal',
  success: function(ret) {
    console.log('X-axis data: ' + ret.x);
    console.log('Y-axis data: ' + ret.y);
    console.log('Z-axis data: ' + ret.z);
  },
  fail: function(data, code) {
    console.error('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeAccelerometer

unsubscribeAccelerometer(): void

取消订阅加速度数据。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.ACCELEROMETER，该权限为系统权限

示例：

sensor.unsubscribeAccelerometer();

sensor.subscribeCompass

subscribeCompass(Object): void

订阅罗盘数据变化。针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

参数：

参数名类型必填说明
successFunction是罗盘数据改变后触发的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
directionnumber设备面对的方向度数。

示例：

sensor.subscribeCompass({
  success: function(ret) {
    console.log('get data direction:' + ret.direction);
  },
  fail: function(data, code) {
    console.error('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeCompass

unsubscribeCompass(): void

取消订阅罗盘。

系统能力：SystemCapability.Sensors.Sensor

示例：

sensor.unsubscribeCompass();

sensor.subscribeProximity

subscribeProximity(Object): void

订阅距离感应数据变化。针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

参数：

参数名类型必填说明
successFunction是距离感应数据改变后调用的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
distancenumber可见物体相对于设备显示屏的接近或远离状态。

示例：

sensor.subscribeProximity({
  success: function(ret) {
    console.log('get data distance:' + ret.distance);
  },
  fail: function(data, code) {
    console.error('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeProximity

unsubscribeProximity(): void

取消订阅距离感应。

系统能力：SystemCapability.Sensors.Sensor

示例：

sensor.unsubscribeProximity();

sensor.subscribeLight

sensor.subscribeLight(Object): void

订阅环境光线感应数据变化。再次调用时，会覆盖前一次调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

参数：

参数名类型必填说明
successFunction是光线感应数据改变后的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
intensitynumber光线强度，单位为lux。

示例：

sensor.subscribeLight({
  success: function(ret) {
    console.log('get data intensity:' + ret.intensity);
  },
  fail: function(data, code) {
    console.error('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeLight

unsubscribeLight(): void

取消订阅环境光线感应。

系统能力：SystemCapability.Sensors.Sensor

示例：

sensor.unsubscribeLight();

sensor.subscribeStepCounter

subscribeStepCounter(Object): void

订阅计步传感器数据变化。针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.ACTIVITY_MOTION

参数：

参数名类型必填说明
successFunction是计步传感器数据改变后的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
stepsnumber计步传感器重启后累计记录的步数。

示例：

sensor.subscribeStepCounter({
  success: function(ret) {
    console.log('get step value:' + ret.steps);
  },
  fail: function(data, code) {
    console.log('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeStepCounter

unsubscribeStepCounter(): void

取消订阅计步传感器。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.ACTIVITY_MOTION

示例：

sensor.unsubscribeStepCounter();

sensor.subscribeBarometer

subcribeBarometer(Object): void

订阅气压传感器数据变化。针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

参数：

参数名类型必填说明
successFunction是气压传感器数据改变后的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
pressurenumber气压值，单位：帕斯卡。

示例：

sensor.subscribeBarometer({
  success: function(ret) {
    console.log('get data value:' + ret.pressure);
  },
  fail: function(data, code) {
    console.log('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeBarometer

unsubscribeBarometer(): void

取消订阅气压传感器。

系统能力：SystemCapability.Sensors.Sensor

示例：

sensor.unsubscribeBarometer();

sensor.subscribeHeartRate

subscribeHeartRate(Object): void

订阅心率传感器数据变化。针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.READ_HEALTH_DATA

参数：

参数名类型必填说明
successFunction是心率传感器数据改变后的回调函数，默认频率5s/次。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
heartRatenumber心率值。

示例：

sensor.subscribeHeartRate({
  success: function(ret) {
    console.log('get heartrate value:' + ret.heartRate);
  },
  fail: function(data, code) {
    console.log('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeHeartRate

unsubscribeHeartRate(): void

取消订阅心率。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.READ_HEALTH_DATA

示例：

sensor.unsubscribeHeartRate();

sensor.subscribeOnBodyState

subscribeOnBodyState(Object): void

订阅设备佩戴状态。针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效。

系统能力：SystemCapability.Sensors.Sensor

参数：

参数名类型必填说明
successFunction是穿戴状态改变后的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
valueboolean是否已佩戴。

示例：

sensor.subscribeOnBodyState({
  success: function(ret) {
    console.log('get on-body state value:' + ret.value);
  },
  fail: function(data, code) {
    console.log('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeOnBodyState

unsubscribeOnBodyState(): void

取消订阅设备佩戴状态。

系统能力：SystemCapability.Sensors.Sensor

示例：

sensor.unsubscribeOnBodyState();

sensor.getOnBodyState

getOnBodyState(Object): void

获取设备佩戴状态。

系统能力：SystemCapability.Sensors.Sensor

参数：

参数名类型必填说明
successFunction否接口调用成功的回调函数。
failFunction否接口调用失败的回调函数。
completeFunction否接口调用结束的回调函数。

success返回值：

参数名类型说明
valueboolean是否已佩戴。

示例：

sensor.getOnBodyState({
  success: function(ret) {
    console.log('on body state: ' + ret.value);
  },
  fail: function(data, code) {
    console.log('Subscription failed. Code: ' + code + '; Data: ' + data);
  },
});

sensor.subscribeDeviceOrientation6+

subscribeDeviceOrientation(interval: string, success: (data: DeviceOrientationResponse), fail?: (data: string, code: number)): void

观察设备方向传感器数据变化。

针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效；针对同一个方法内，不支持多次调用。

系统能力：SystemCapability.Sensors.Sensor

参数：

参数名类型必填说明
intervalstring是频率参数，设备方向传感器的回调函数执行频率。 默认为normal，可选值有： - game：极高的回调频率，20ms/次，适用于游戏。 - ui：较高的回调频率，60ms/次，适用于UI更新。 - normal：普通的回调频率，200ms/次，低功耗。
successFunction是感应到设备方向传感器数据变化后的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
alphanumber当设备坐标 X/Y 和地球 X/Y 重合时，绕着 Z 轴转动的夹角为 alpha。
betanumber当设备坐标 Y/Z 和地球 Y/Z 重合时，绕着 X 轴转动的夹角为 beta。
gammanumber当设备 X/Z 和地球 X/Z 重合时，绕着 Y 轴转动的夹角为 gamma。

示例：

sensor.subscribeDeviceOrientation({
  interval: 'normal',
  success: function(ret) {
    console.log('Alpha data: ' + ret.alpha);
    console.log('Beta data: ' + ret.beta);
    console.log('Gamma data: ' + ret.gamma);
  },
  fail: function(data, code) {
    console.error('Subscription failed. Code: ' + code + '; Data: ' + data);
  }
});

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeDeviceOrientation6+

unsubscribeDeviceOrientation(): void

取消订阅设备方向传感器数据。

系统能力：SystemCapability.Sensors.Sensor

示例：

sensor.unsubscribeDeviceOrientation();

sensor.subscribeGyroscope6+

subscribeGyroscope(interval: string, success: (data: GyroscopeResponse), fail?: (data: string, code: number)): void

观察陀螺仪数据变化。

针对同一个应用，多次点击调用时，会覆盖前面的调用效果，即仅最后一次调用生效；针对同一个方法内，不支持多次调用。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.GYROSCOPE，该权限为系统权限

参数：

参数名类型必填说明
intervalstring是频率参数，陀螺仪的回调函数执行频率。 默认为normal，可选值有： - game：极高的回调频率，20ms/次，适用于游戏。 - ui：较高的回调频率，60ms/次，适用于UI更新。 - normal：普通的回调频率，200ms/次，低功耗。
successFunction是感应到陀螺仪数据变化后的回调函数。
failFunction否接口调用失败的回调函数。

success返回值：

参数名类型说明
xnumberx轴的旋转角速度。
ynumbery轴的旋转角速度。
znumberz轴的旋转角速度。

示例：

sensor.subscribeGyroscope({
  interval: 'normal',
  success: function(ret) {
    console.log('X-axis data: ' + ret.x);
    console.log('Y-axis data: ' + ret.y);
    console.log('Z-axis data: ' + ret.z);
  },
  fail: function(data, code) {
    console.error('Subscription failed. Code: ' + code + '; data: ' + data);
  }
});

在这里插入图片描述

说明： 建议在页面销毁时，即onDestory回调中，取消数据订阅，避免不必要的性能开销。

sensor.unsubscribeGyroscope6+

unsubscribeGyroscope(): void

取消订阅陀螺仪数据。

系统能力：SystemCapability.Sensors.Sensor

需要权限：ohos.permission.GYROSCOPE，该权限为系统权限

示例：

sensor.unsubscribeGyroscope();

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1935345.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

什么是信息指纹和信息加密——《数学之美》第16、17章以及其他各种资料的读书笔记

什么是信息指纹和信息加密——《数学之美》第16、17章以及其他各种资料的读书笔记

目录 1. 信息指纹 1.1 概念 1.2 相关算法的演进历程 1.3 哈希碰撞 1.4 雪崩效应 1.5 应用场景 2. 信息加密 2.1 密码学的简要历史 2.1.1 古代密码学：智慧的萌芽 2.1.2 中世纪至文艺复兴：密码术的兴起 2.1.3 近代密码学：机械密码机的…
阅读更多...
【python函数】string和json的互转函数封装

【python函数】string和json的互转函数封装

我是一名测试开发工程师（全栈），作品有全终端自动化测试框架wyTest，未羽研发测试管理平台，欢迎同行交流。 一、主要涉及2个方法： json.loads：将字符串转换成JSONjson.dumps：将JSON转…
阅读更多...
Apache BookKeeper 一致性协议解析

Apache BookKeeper 一致性协议解析

导语 Apache Pulsar 是一个多租户、高性能的服务间消息传输解决方案，支持多租户、低延时、读写分离、跨地域复制（GEO replication）、快速扩容、灵活容错等特性。Pulsar 存储层依托于 BookKeeper 组件，所以本文简单探讨一下 BookK…
阅读更多...
接口开发：Orcal数据库的批量修改sql

接口开发：Orcal数据库的批量修改sql

场景：在日常的CURD中一定会用到批量修改。在我们的项目中，使用的数据库是Orcal，由于之前基本都是使用Mysql的，使用的sql语句也基本都是用mysql的。但是在这次的接口编写时用mysql的批量修改出了问题，刚开始我还以为是写…
阅读更多...
高频面试题-CSS

高频面试题-CSS

BFC 介绍下BFC (块级格式化上下文) 1>什么是BFC BFC即块级格式化上下文，是CSS可视化渲染的一部分, 它是一块独立的渲染区域，只有属于同一个BFC的元素才会互相影响，且不会影响其它外部元素。 2>如何创建BFC 根元素，即HTM…
阅读更多...
浅谈端到端（自动驾驶）

浅谈端到端（自动驾驶）

一、 引言 端到端是近期非常火的话题，尤其在自动驾驶、具身智能等领域。去年UniAD的发布，给大家普及了端到端的网络设计，带动了行业的发展。产业界，特斯拉FSD Beta V12效果惊艳，近期理想也推出了双系统的E2E自动驾驶系…
阅读更多...
qml 实现一个listview

qml 实现一个listview

主要通过qml实现listvie功能&#xff0c;主要包括右键菜单&#xff0c;滚动条&#xff0c;拖动改变内容等&#xff0c;c 与 qml之间的变量和函数的调用。 main.cpp #include <QQuickItem> #include <QQmlContext> #include "testlistmodel.h" int main…
阅读更多...
（自用）高性能网络编程

（自用）高性能网络编程

Epoll - Reactor 设计模式 以餐厅大点餐为例 Reactor优点 Epoll - IO多路复用 1.创建EPOLL 句柄 相关函数 epoll_create #include <sys/epoll.h>int epoll_create(int size); 作用&#xff1a; 创建一个 epoll 实例 参数: size 参数用于指定 epoll 实例中管理的…
阅读更多...
MongoDB教程（十二）：MongoDB数据库索引

MongoDB教程（十二）：MongoDB数据库索引

&#x1f49d;&#x1f49d;&#x1f49d;首先&#xff0c;欢迎各位来到我的博客&#xff0c;很高兴能够在这里和您见面&#xff01;希望您在这里不仅可以有所收获&#xff0c;同时也能感受到一份轻松欢乐的氛围&#xff0c;祝你生活愉快&#xff01; 文章目录 引言一、MongoD…
阅读更多...
vue3前端开发-小兔鲜项目-图片懒加载的自定义标签

vue3前端开发-小兔鲜项目-图片懒加载的自定义标签

vue3前端开发-小兔鲜项目-图片懒加载的自定义标签&#xff01;很多大型网站&#xff0c;因为首页面渲染的内容太多了&#xff0c;然而有些用户&#xff0c;可能在顶部就发现了自己感兴趣的内容&#xff0c;直接就点击跳转去了其他页面&#xff0c;因此&#xff0c;完全没有必要…
阅读更多...
Spring纯注解开发

Spring纯注解开发

前言 Spring3.0引入了纯注解开发的模式&#xff0c;框架的诞生是为了简化开发&#xff0c;那注解开发就是简化再简化。Spring的特性在整合MyBatis方面体现的淋漓尽致哦 一.注解开发 以前跟老韩学习SE时他就说&#xff1a;注解本质是一个继承了Annotation 的特殊接口,其具体实…
阅读更多...
Apache SeaTunnel——OLAP 引擎的数据动脉

Apache SeaTunnel——OLAP 引擎的数据动脉

导读本文将分享如何利用 Apache SeaTunnel 将各个业务系统的数据同步到 OLAP 引擎。 主要内容包括以下六大部分&#xff1a; 1. Apache SeaTunnel 项目介绍 2. Apache SeaTunnel 核心功能 3.SeaTunnel 在 OLAP 场景下的应用 4. 社区近期计划 5. WhaleTunnel 产品特性 6. …
阅读更多...
【框架】PHP框架详解-symfony框架

【框架】PHP框架详解-symfony框架

目录 一、框架概述 二、核心组件 三、特点与优势 四、开发流程 新机制 层次 网络应用框架 包涵观念 兼容的数据库 结构 开发环境捆绑 应用开源项目 公共特性 Symfony是一个用PHP语言编写的开放源代码的Web应用框架，旨在加速Web应用程序的开发过程，提高代码的可维…
阅读更多...
VS2019+CMake+Vtk9.3.0+Qt5.14.2 配置

VS2019+CMake+Vtk9.3.0+Qt5.14.2 配置

VS2019CMakeVtk9.3.0Qt5.14.2 配置环境 第一步 下载 基本配置 系统环境&#xff1a;windows11 x64 Qt&#xff1a;5.14.2 这是最后最新的LTS qt离线版本&#xff0c;后续版本都需要在线安装&#xff0c;同时使用qt5.14也避免版权问题。 Qt 5.14&#xff1a;大部分模块基于LG…
阅读更多...
去中心化技术的变革力量：探索Web3的潜力

去中心化技术的变革力量：探索Web3的潜力

随着区块链技术的发展和应用&#xff0c;去中心化技术正成为数字世界中的一股强大变革力量。Web3作为去中心化应用的新兴范式&#xff0c;正在重新定义人们对于数据、互联网和价值交换的认知。本文将探索去中心化技术的基本概念、Web3的核心特征及其潜力应用&#xff0c;展示其…
阅读更多...
Zabbix × openGauss完成兼容 | 信创路上，得其法则事半功倍

Zabbix × openGauss完成兼容 | 信创路上，得其法则事半功倍

在当今快速发展的信息技术领域&#xff0c;数据库作为核心组件之一&#xff0c;其性能、可靠性和兼容性一直是企业和开发者关注的焦点。 近期&#xff0c;Zabbix与openGauss完成了兼容性认证&#xff0c;经过严格联合测试&#xff0c;双方产品实现完全兼容&#xff0c;整体运行…
阅读更多...
手写简易版Spring IOC容器【学习】

手写简易版Spring IOC容器【学习】

这里写自定义目录标题 BeanDefinitionbeanDefinition类 单例对象单例对象注册(SingletonBeanRegistry)DefaultSingletonBeanRegistry 模板方法 BeanFactoryBeanFactory接口AbstractBeanFactory 抽象工厂模板 (getBean)AbstractAutowireCapableBeanFactory (createBean 创建bean…
阅读更多...
离散数学，汉密尔顿图判定的实际问题，平面图，平面图的判定，欧拉公式，对偶图，五色定理的证明

离散数学，汉密尔顿图判定的实际问题，平面图，平面图的判定，欧拉公式，对偶图，五色定理的证明

目录 1.汉密尔顿图判定的实际问题 判断是否是汉密尔顿图 思考&#xff1a;下图中哪些是汉密尔顿图 例子 2.平面图 平面图的基本概念 并非所有的图都能嵌入平面 平面图的面与次数 欧拉公式 欧拉公式的证明 3.平面图的判定 同胚 kuratowski定理 ​4.对偶图 四…
阅读更多...
docker 安装并测试（Ubuntu下）

docker 安装并测试（Ubuntu下）

1. 确认安装环境&#xff08;操作系统版本和 CPU 架构&#xff09; 2. 如果有旧版本的 docker 需要进行卸载 使用 docker 命令检查是否已经安装了 docker 如果 docker 已经安装&#xff0c;使用以下命令卸载&#xff1a; apt-get purge docker-ce docker-ce-cli containerd…
阅读更多...
​1：1公有云能力整体输出，腾讯云“七剑”下云端

​1：1公有云能力整体输出，腾讯云“七剑”下云端

【全球云观察 &#xff5c; 科技热点关注】 曾几何时&#xff0c;云计算技术的兴起&#xff0c;为千行万业的数字化创新带来了诸多新机遇&#xff0c;同时也催生了新产业新业态新模式&#xff0c;激发出高质量发展的科技新动能。很显然&#xff0c;如今的云创新已成为高质量发…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023