@capgo/capacitor-compass

概述

Capacitor Compass Plugin用于读取设备罗盘方向。

核心功能

• getCurrentHeading - 获取当前罗盘方向（度数）。在iOS中，罗盘方向在后台更新，返回最新值。在Android中，罗盘方向在方法被调用时使用加速计和磁力计传感器计算。未在Web中实现。
• startListening - 开始监听compass方向变化事件。该功能启动compass传感器并发送‘headingChange’事件。
• stopListening - 停止监听compass方向变化事件。该功能停止compass传感器并停止发送事件。
• checkPermissions - 检查当前访问compass数据的权限状态。 在iOS中，这检查位置权限状态。 在Android中，这始终返回‘granted’，因为没有权限要求。

Public API

方法	描述
getCurrentHeading	获取当前compass方向（以度为单位）。 在iOS中，方向在后台更新，返回最新值。 在Android中，方向在调用方法时使用加速计和磁力计传感器计算。 未在Web中实现。
getPluginVersion	获取本机Capacitor插件版本。
startListening	开始监听compass方向变化事件。该功能启动compass传感器并发送‘headingChange’事件。
stopListening	停止监听compass方向变化事件。该功能停止compass传感器并停止发送事件。
addListener	添加compass方向变化事件的监听器。
addListener	添加一个监听指南针精度变化事件的监听器。仅在 Android 上支持。 在 iOS 和 Web 上，这将永远不会发出事件。
removeAllListeners	移除此插件的所有监听器。
checkPermissions	检查当前访问指南针数据的权限状态。 在 iOS 上，这检查位置权限状态。 在 Android 上，这始终返回“已授权”因为没有权限要求。
requestPermissions	请求访问指南针数据的权限。 在 iOS 上，这请求位置权限（用于获取方向数据）。 在 Android 上，这立即解决因为没有权限要求。
watchAccuracy	开始监控指南针精度。 在 Android 上，这监控磁力计精度并发出精度变化事件。 开发者可以监听这些事件并实现自己的UI来提示用户进行校准。 在 iOS 和 Web 上，这个方法什么也不做，因为指南针精度监控不可用。
unwatchAccuracy	停止监控指南针精度。 这停止了精度监控。
getAccuracy	获取当前指南针精度级别。 在 Android 上，返回当前磁力计传感器精度。 在 iOS 和 Web 上，始终返回 CompassAccuracy.UNKNOWN 因为精度监控不可用。

真实来源

此参考是从 src/definitions.ts 在 capacitor-指南针.

继续从 @capgo/capacitor-compass 中

如果您正在使用 @capgo/capacitor-compass 来规划原生插件工作，连接它与 使用 @capgo/capacitor-compass 来规划原生能力在使用 @capgo/capacitor-compass 中 Capgo 插件目录 来规划产品工作流程在 Capgo 插件目录 中 Capacitor 由 Capgo 提供的插件 来规划 Capacitor 由 Capgo 提供的插件 的实现细节 添加或更新插件 关于在添加或更新插件中实现详细信息， Ionic 企业插件替代品 关于Ionic 企业插件替代品的产品工作流程。