@capgo/capacitor-compass

概述

Capacitor 设备罗盘接口

核心功能

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

Public API

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

真实数据来源

此参考是从 src/definitions.ts 在 capacitor-compass.

继续从@capgo/capacitor-compass

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