ユーザーが地球上のどこにいて、どの画面が表示されているかなど、アプリの環境に関する情報を取得することができます。

説明と構文

すべてのシグナルは、情報のレコードを返します。 この情報は、レコードとして使用したり保存したりすることができるほか、. 演算子を使って個々のプロパティを抽出することもできます。

Acceleration

Acceleration シグナルは、デバイスの画面に対して相対的な 3 次元におけるデバイスの加速度を返します。 加速度は、9.81 m/秒2 単位または 32.2 ft/秒2 単位、つまり g (地球の重力によって地上の物体に与えられる加速度) で表されます。

シグナルのプロパティ 説明
Acceleration.X 左右。 正数は右を表します。
Acceleration.Y 前後。 正数は前を表します。
Acceleration.Z 上下。 正数は上を表します。

App

App シグナルは、実行中のアプリに関する情報を返します。

シグナルのプロパティ 説明
App.ActiveScreen 表示されている画面。 スクリーン オブジェクトを返します。このオブジェクトを使って画面のプロパティを参照したり、別の画面と比較してどちらの画面が表示されているかを調べたりすることができます。 Back 関数または Navigate 関数を使うことで、表示画面を変更することができます。

Compass

Compass シグナルは、画面上部のコンパスの方位を返します。 方位は磁北に基づきます。

シグナルのプロパティ 説明
Compass.Heading 方位 (度)。 0 を北として、0 ~ 360 の数値を返します。

接続

Connection シグナルは、ネットワーク接続に関する情報を返します。 従量制課金接続では、そのネットワーク上で送受信するデータ量を制限したい場合があります。

シグナルのプロパティ 説明
Connection.Connected デバイスがネットワークに接続されているかどうかを示すブール値 true または false を返します。
Connection.Metered 従量制課金接続であるかどうかを示すブール値 true または false を返します。

場所

Location 信号は、GPS (Global Positioning System) やその他のデバイス情報 (携帯電話の基地局通信、IP アドレスなど) に基づくデバイスの位置を返します。

ユーザーは、位置情報に初めてアクセスするとき、その情報へのアクセスを許可するようデバイスから求められる場合があります。

位置との従属関係は、位置が変化する過程で絶えず再計算され、デバイスのバッテリが消費されます。 バッテリの駆動時間を節約するために、Enable 関数と Disable 関数を使って位置情報の更新のオンとオフを切り替えることができます。 表示されている画面が位置情報に依存していない場合は、位置情報が自動的にオフになります。

シグナルのプロパティ 説明
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

ピッチャーからキャッチャーまでボールが移動する間、経度は絶えず変化します。
Location 現在位置の緯度と経度をレコードとして返します。 { Latitude: 47.591, Longitude: 122.333 }
Compass.Heading 画面上部のコンパスの方位を返します。 セーフコ・フィールド球場のホーム ベースは、ピッチャー マウンドのおよそ南西に位置しています。 230.25
Acceleration.X デバイスの左右の加速度を返します。 ピッチャーは、スマートフォンを画面の上部に対してまっすぐに投げるので、デバイスの左右方向の加速度はゼロです。 0
Acceleration.Y デバイスの前後の加速度を返します。 ピッチャーはデバイスを投げる際、最初に大きな加速度を与えます。時速 0 マイルの状態から 0.5 秒後には時速 90 マイル (毎秒 132 フィート) に達します。 デバイスが空中に放たれた後は、デバイスがそれ以上加速することはありません (空気摩擦は無視します)。 デバイスは減速し、キャッチャーが受けた時点で停止します。 ピッチャーがデバイスを投げている間は 8.2 となります。

デバイスが空中にある間は 0 になります。

キャッチャーがデバイスを受けたときは、-8.2 になります。
Acceleration.Z デバイスの上下の加速度を返します。 空中を飛んでいるデバイスは重力の影響を受けます。 ピッチャーがデバイスを投げる前は 0 です。

デバイスが空中にある間は 1 になります。

キャッチャーがデバイスを受けた後は 0 になります。
Acceleration 加速度をレコードとして返します。 ピッチャーがデバイスを投げるときは { X: 0, Y: 264, Z: 0 } になります。
Connection.Connected デバイスがネットワークに接続されているかどうかを示すブール値を返します。 true
Connection.Metered 従量制課金接続であるかどうかを示すブール値を返します。 true
App.ActiveScreen = PlayBall PlayBall が表示されているかどうかを示すブール値を返します。 true
App.ActiveScreen.Fill 表示画面の背景色を返します。 Color.Green