傳回應用程式環境的相關資訊,例如使用者位於世界上哪個位置和所顯示的畫面。

描述和語法

所有訊號都會傳回資訊的記錄。 您可以使用此資訊並將其儲存為記錄,或者,您可以使用 . 運算子 來擷取個別屬性。 operator.

加速度

加速度訊號會傳回裝置相對於裝置畫面的三維加速度。 加速度的測量單位是 g,也就是 9.81 公尺/秒2 或 32.2 英呎/秒2 (地球因為重力而施加在物體表面的加速度)。

訊號屬性 說明
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

當球在投手和捕手之間移動時,經度會持續變更。
位置 傳回目前位置的經緯度作為記錄。 { Latitude: 47.591, Longitude: 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