sensors_sensors_cangjie_wrapper:基于OpenHarmony的泛Sensor服务仓颉接口项目

泛sensor子系统仓颉封装层

Branch7Tags0

sensors_cangjie_wrapper

Introduction

The sensors_cangjie_wrapper is a Cangjie API encapsulated on OpenHarmony based on the capabilities of the pan-sensor service subsystem. Sensor refers to a device used to detect events or changes that occur in the environment and send this message to other electronic devices (such as central processing units). The pan-sensor service subsystem provides the ability to obtain Sensor data, including functions such as obtaining Sensor attribute lists, subscribing to Sensor data, and setting data reporting mode of a sensor. The currently developed pan-sensor service Cangjie interface only supports standard devices.

System Architecture

The following figure shows the architecture of the pan-sensor service framework.

the architecture of the pan-sensor service framework

As shown in the architecture:

  • The pan-sensor Service Cangjie interface currently provides the following capabilities:

    • subscribing to or unsubscribing from sensor data.
    • obtaining Sensor data.
  • Interface encapsulation: Implement Sensor service capabilities using Cangjie.

  • Sensor Cangjie FFI interface definition: responsible for defining the C interoperability Cangjie interface, used to implement Cangjie Sensor capabilities.

  • Sensor Service: Responsible for providing basic Sensor functions and encapsulating C interfaces for interoperability with Cangjie.

Directory Structure

base/sensors/sensors_cangjie_wrapper
├── figures               # architecture pictures
├── kit                   # Cangjie kit code
│   └── SensorServiceKit  # Cangjie SensorServiceKit
├── ohos                  # Cangjie pan-sensor code
│   └── sensor            # Cangjie sensor code
└── test                  # Test cases

Constraints

  • To use sensor functions, ensure that the device where your application runs has the required sensor components.
  • To obtain data of some sensors, you need to request the required permissions.

Usage

As shown in the diagram, Sensor Service Cangjie provides the following capabilities, and developers can use one or more types of interfaces according to their usage needs:

  • querying the sensor list.
  • subscribing to or unsubscribing from sensor data.

Please refer to the Sensor related API for detailsohos.sensor(Sensors). For relevant guidance, please refer toIntroduction to Sensor Service Kit Development.

Compared to ArkTS, the following features are currently not supported:

  • Obtain the geomagnetic field information of a specific location on Earth at a certain moment.
  • Obtain altitude based on air pressure values.
  • Calculate the geomagnetic tilt angle based on the tilt matrix.
  • Calculate rotation matrices, etc.

Code Contribution

Developers are welcome to contribute code, documentation, etc. For specific contribution processes and methods, please refer to Code Contribution.

Repositories Involved

sensors_sensor

Introduction

泛sensor子系统仓颉封装层

Customize your domain