GetSensor

返回用于 iOS 或 iPadOS 设备指定传感器的值。

格式 

GetSensor (传感器名称{;选项1;选项2})

参数 

传感器名称 - 支持的传感器的名称（如下所示）。

选项1 - 指定传感器的可选参数。

选项2 - 指定传感器的可选参数。

括号 { } 中的参数是可选的。

返回的数据类型 

文本、数字

原始版本 

17.0

说明 

使用此函数可捕获传感器为运行 FileMaker Go 的 iOS 或 iPadOS 设备提供的信息。例如，可以找出用户行走的距离或步数；或设备的加速度、速度、航向和姿势。

传感器

传感器名称

返回

返回的数据类型

选项1

选项2

电池

 

batteryLevel

电池充电量（0.0 到 1.0）。

数字

 

 

batteryStatus

表示电池充电状态的数字：
1 - 未插电
2 - 正在充电
3 - 已插电并充满

数字

 

 

 

 

 

 

 

地点

 

location

设备当前所在地点，格式为：

纬度（以度为单位）
经度（以度为单位）
水平精度（ +/- 以米为单位的精度）

文本1

精度 (以米为单位)

超时 (以秒为单位)

locationValues

设备当前所在地点，格式为：

纬度（以度为单位）
经度（以度为单位）
海拔（以米为单位）
水平精度（ +/- 以米为单位的精度）
垂直精度（ +/- 以米为单位的精度）
时长（以分钟为单位）

文本1

精度 (以米为单位)

超时 (以秒为单位)

 

 

 

 

 

姿势、速度和加速度

 

altitude

设备的姿势（以弧度为单位），格式为：

滚动
倾斜
偏航

文本1

 

 

rotationRate

设备的旋转速度（以弧度/秒为单位），格式为：

x
y
z

文本1

 

 

accelerationByUser

用户给予设备的加速度（以每平方秒的米数为单位，m/s2），格式为：

x
y
z

文本1

 

 

accelerationByGravity

重力加速度（以每平方秒的米数为单位，m/s2），格式为：

x
y
z

文本1

 

 

speed

设备速度（以米/秒为单位）。

数字

精度 (以米为单位)

超时 (以秒为单位)

heading

当前运动方向（以度为单位）。返回从 0.0 到 359.9 度的值。

数字

精度 (以米为单位)

超时 (以秒为单位)

 

 

 

 

 

磁性

 

magneticField

设备当前姿势的磁场矢量（以微特斯拉为单位），格式为：

x
y
z

文本1

 

 

compassMagneticHeading

用户设备相对于磁北的方向（以度为单位）。返回从 0.0 到 359.9 度的值。

数字

精度 (以米为单位)

超时 (以秒为单位)

compassTrueHeading

用户设备相对于真北的方向（以度为单位）。返回从 0.0 到 359.9 度的值。

数字

精度 (以米为单位)

超时 (以秒为单位)

 

 

 

 

 

步数

 

stepCount

设备在指定持续时间内检测到的步数。

数字

过去秒数

 

stepDistance

用户在指定持续时间内行走的估计距离（以米为单位）。

数字

过去秒数

 

stepFloorsUp

用户在指定持续时间内上的楼层数。

数字

过去秒数

 

stepFloorsDown

用户在指定持续时间内下的楼层数。

数字

过去秒数

 

 

 

 

 

 

空气压力

 

airPressure

记录的空气压力（以千帕为单位）。

数字

 

 

 

 

 

 

 

传感器列表

 

available

设备可用传感器值的列表。这些值之间以回车符分隔。

文本

 

 
  1. 数据以回车符分隔的数值列表形式返回。

注释 

  • 精度是表示距离（以米为单位）的数值。默认精度值为 100 米。
  • 超时是表示获取数据所需的最长时间（以秒为单位）的数值。默认超时值为 10；最大值为 600。
  • 默认过去秒数是自午夜开始计算的秒数。
  • 如果传感器不可用于设备，FileMaker Go 将返回空字符串。
  • 地点值与 Location函数相同。
  • 地点值的值与 LocationValues 函数相同。

示例 1 

如果用户在过去一个小时内步行了 8000 步，GetSensor ( "stepCount"; 3600 ) 将返回 8000。

相关主题