跳过内容

@capgo/capacitor-compass

Capacitor

概述

概述

Capacitor Compass 插件用于读取设备指南针方向。

核心功能

核心功能
  • getCurrentHeading - iOS 中获取当前compass方向,iOS在后台更新heading值,返回最新值。Android使用加速计和磁力计传感器计算heading值。Web未实现。
  • startListening - 开始监听compass方向变化事件。该方法启动compass传感器并触发‘headingChange’事件。
  • stopListening - 停止监听compass方向变化事件。该方法停止compass传感器并停止事件传递。
  • checkPermissions - 检查当前compass数据访问权限状态。iOS检查位置权限状态。Android始终返回‘granted’,因为无需权限。
方法描述
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企业级插件替代方案的产品工作流程