@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 来规划原生能力的 Using @capgo/capacitor-compass, Capgo 原生插件目录 来规划产品工作流程的 Capgo 原生插件目录, Capacitor 由 Capgo 开发的插件 来规划实现细节的 Capacitor 由 Capgo 开发的插件, 添加或更新插件 来规划实现细节的添加或更新插件,和 Ionic 企业版插件替代品 为 Ionic 企业版插件替代品中的产品工作流程。