返回关于应用环境的信息,例如用户的全球所在位置,以及所显示的是哪个屏幕。

说明和语法

所有信号都将返回信息的记录。 可以使用此信息并将其存储为记录,也可提取单个属性,其方式是使用“.” 运算符

加速度

加速度信号以相对于设备屏幕的三维方式返回设备的加速度。 加速度的测量单位为 g(9.81 m/s2 或 32.2 ft/s2)(地球由于重力而在其表面对物体产生的加速度)。

信号属性 说明
Acceleration.X 右侧和左侧。 右侧为正数。
Acceleration.Y 前方和后方。 前方为正数。
Acceleration.Z 上方和下方。 上方为正数。

应用

应用信号返回正在运行的应用的相关信息。

信号属性 说明
App.ActiveScreen 所显示的屏幕。 返回一个屏幕对象,可用于引用屏幕属性,或与其他屏幕进行比较,以判断显示的是哪个屏幕。 使用 BackNavigate 函数可以更改显示的屏幕。

指南针

指南针信号返回屏幕顶部的指南针标题。 该标题以磁北方为基础。

信号属性 说明
Compass.Heading 标题以度为单位。 返回一个介于 0 到 360 之间的数值,0 表示北方。

连接

连接信号返回网络连接的相关信息。 如果连接按流量计费,建议限制通过网络发送或接受数据的量。

信号属性 说明
Connection.Connected 返回一个布尔值 truefalse,指示设备是否已连接到网络。
Connection.Metered 返回一个布尔值 truefalse,指示连接是否按流量计费。

位置

位置信号基于全球定位系统 (GPS) 和其他设备信息(如手机基站通信和 IP 地址)返回设备的位置。

用户首次访问位置信息时,设备可能会提示该用户,以允许访问此信息。

随着位置在不断改变,位置上的依赖项将不断被重新计算,这将消耗设备电池的电量。 要维护电池寿命,可使用 EnableDisable 函数打开或关闭位置更新。 如果显示的屏幕不依赖于位置信息,位置将自动关闭。

信号属性 说明
Location.Altitude 返回一个指示海拔高度的数值(用英尺表示)。
Location.Latitude 返回一个介于 - 90 至 90 之间的数值,该值指示从赤道起以度数表示的纬度。 正数表示赤道以北的位置。
Location.Longitude 返回一个介于 0 至 180 之间的数值,该值指示从英国格林威治以西起用度数表示的经度。

示例

在华盛顿的西雅图塞菲科球场中,一位棒球投手从投球区向本垒的捕手投掷了一部手机。 该手机相对于地面是平行移动的,手机的屏幕顶端指向捕手,且投手在投掷过程中未使手机发生旋转。 在该位置,这部手机连接的是按流量计费的移动网络服务,没有 WiFi。 将显示 PlayBall 屏幕。

公式 说明 结果
Location.Latitude 返回当前位置的纬度。 塞菲科球场在地图上的坐标定位是 47.591 N,122.333 W。 47.591

纬度将随球在投手和捕手之间的移动而不断更改。
Location.Longitude 返回当前位置的经度。 122.333

经度将随球在投手和捕手之间的移动而不断更改。
位置 返回当前位置的经度和纬度作为记录。 { 纬度: 47.591,经度: 122.333 }
Compass.Heading 返回屏幕顶部的指南针标题。 在塞菲科球场,本垒大致位于投手区的西南侧。 230.25
Acceleration.X 返回并排设备的加速度。 由于投手直接向前相对屏幕的顶端投掷手机,因此设备不会并排加速。 0
Acceleration.Y 返回设备从前到后的加速度。 在投掷设备之初,投手为设备提供了一个较大的加速度,在半秒中内达到从 0 增至 90 英里/小时(132 英尺/秒)。 设备在空中运动时,忽略空气阻力,设备不会进一步加速。 捕手接住设备时,设备将减速至停止。 8.2,投手投掷设备时。

0,设备在空中时。

-8.2,捕手接住设备时。
Acceleration.Z 返回设备从上到下的加速度。 设备在空中运动时会受重力影响。 0,投手投掷设备前。

1,设备在空中运动时。

0,捕手接住设备后。
加速度 将加速度作为记录返回。 { X: 0, Y: 264, Z: 0 },投手投掷设备时。
Connection.Connected 返回一个布尔值,它指示设备是否已连接到网络 true
Connection.Metered 返回一个布尔值,它指示连接是否按流量计费 true
App.ActiveScreen = PlayBall 返回一个布尔值,它指示是否显示了 PlayBall true
App.ActiveScreen.Fill 返回所显示的屏幕的背景色。 Color.Green