概述
概述Capacitor Compass 插件用于读取设备指南针方向。
核心功能
核心功能getCurrentHeading- iOS 中获取当前compass方向,iOS在后台更新heading值,返回最新值。Android使用加速计和磁力计传感器计算heading值。Web未实现。startListening- 开始监听compass方向变化事件。该方法启动compass传感器并触发‘headingChange’事件。stopListening- 停止监听compass方向变化事件。该方法停止compass传感器并停止事件传递。checkPermissions- 检查当前compass数据访问权限状态。iOS检查位置权限状态。Android始终返回‘granted’,因为无需权限。
- 公开API
Section titled “Public API”| 方法 | 描述 |
|---|---|
getCurrentHeading | 获取当前compass方向(度数)。iOS在后台更新heading值,返回最新值。Android使用加速计和磁力计传感器计算heading值。Web未实现。 |
getPluginVersion | 获取本地Capacitor插件版本。 |
startListening | 开始监听compass方向变化事件。该方法启动compass传感器并触发‘headingChange’事件。 |
stopListening | 停止监听compass方向变化事件。该方法停止compass传感器并停止事件传递。 |
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_KEEP_0__/__CAPGO_KEEP_1__-compass 使用@capgo/capacitor-compass for the native capability in Using @capgo/capacitor-compass, Capgo插件目录 Capgo由__CAPGO_KEEP_1__ Capacitor由Capgo for the implementation detail in Capacitor Plugins by Capgo, 添加或更新插件 查看添加或更新插件的实现细节 Ionic企业级插件替代方案 查看Ionic企业级插件替代方案的产品工作流程