@capgo/capacitor-compass

概述

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

核心功能

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

- 公开 API

方法	描述
getCurrentHeading	获取当前指南针方向（度数）。在 iOS 上，方向会在后台更新，返回最新值。在 Android 上，方法调用时使用加速计和磁力计传感器计算方向。Web 未实现。
getPluginVersion	获取本机 Capacitor 插件版本。
startListening	开始监听指南针方向变化的事件。这会启动指南针传感器并发送 ‘headingChange’ 事件。
stopListening	停止监听指南针方向变化的事件。这会停止指南针传感器并停止发送事件。
addListener	添加一个监听指南针方向变化事件的监听器。
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-compass.

继续从 @capgo/capacitor-compass

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