概述
概述Capacitor Compass 插件用于读取设备compass方向。
核心功能
核心功能getCurrentHeading- 获取当前compass方向(度数)。在 iOS 上,方向会在后台更新,返回最新值。 在 Android 上,方向会在方法被调用时使用加速计和磁力计传感器计算。 未在 Web 上实现。startListening- 开始监听compass方向变化事件。该功能启动compass传感器并发送‘headingChange’事件。stopListening- 停止监听compass方向变化事件。该功能停止compass传感器并停止发送事件。checkPermissions- 检查当前访问compass数据的权限状态。 在iOS中,检查位置权限状态。 在Android中,该方法始终返回‘granted’,因为没有权限要求。
- 公共API
公共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_KEEP_0__/__CAPGO_KEEP_1__-compass 进行连接 使用 @capgo/capacitor-compass 为在使用 @capgo/capacitor-compass 中的原生能力 @Capgo 插件目录 为在 @Capgo 插件目录 中的产品工作流 @Capacitor 由 @Capgo 提供的插件 为在 @Capacitor 由 @Capgo 提供的插件 中的实现细节 添加或更新插件 了解在添加或更新插件时的实现细节, Ionic企业级插件替代方案 了解Ionic企业级插件替代方案的产品工作流程。