次の方法で共有

Power Apps での Acceleration、App、Compass、Connection、および Location 信号

  • [アーティクル]

適用対象: キャンバス アプリ モデル駆動型アプリ

ユーザーが世界のどこにいて、どのスクリーンが表示されているかなど、アプリの環境に関する情報を返します。

説明および構文

信号は、ユーザーがアプリをどのように操作しているかとは無関係の、いつでも変更できる値です。 信号に基づく数式は、これらの値が変化するときに自動的に再計算します。

通常、信号は情報のレコード を返します。 この情報を、レコードとして使用および保存したり、または .演算子 を使用して個々のプロパティを抽出することができます。

Note

Acceleration と Compass 関数は、iOS や Android などのネイティブ プレーヤーで正確な値を返しますが、ブラウザーでアプリを作成または変更するとき、これらの関数はゼロ値を返します。

Acceleration

Acceleration 信号は、デバイスのスクリーンに基づいて 3 次元でデバイスの加速度を返します。 加速度は g 単位で 9.81 m/秒2 または 32.2 ft/秒2 (地球が重力によって地表でオブジェクトに与える加速度) で測られます。

プロパティ 内容
加速.X 左右。 右は正数です。
加速.Y 前後。 前は正数です。
加速.Z 上下。 上は正数です。

App

他のプロパティの中で、App オブジェクトには、どのスクリーンが表示されているかを示す信号が含まれています。

プロパティ 内容
アプリ.アクティブスクリーン 表示されているスクリーン。 スクリーンのプロパティを参照したり、または別のスクリーンと比較してどのスクリーンが表示しているかを確認するのに使用できるスクリーン オブジェクトを返します。 Back または Navigate 関数を使用して、表示しているスクリーンを変更することができます。

詳細: App オブジェクト ドキュメント。

Compass

Compass 信号はスクリーンの上部のコンパス方位を返します。 方位は磁北に基づきます。

プロパティ 内容
コンパスの方向 度数で示す方位。 0 を北として、0 から 360 の数値を返します。

Connection

Connection 信号は、ネットワークの接続に関する情報を返します。 従量制課金接続では、ネットワークを介して送受信するデータ量を制限したい場合があります。 または、アプリがオフラインで有効になっている場合は、現在の同期状態に応じて異なる情報を表示することができます。

Property Description
接続。接続済み デバイスがネットワークに接続されているかどうかを示すブール値の true または false の値を返します。
接続。従量制 接続が従量制課金であるかどうかを示すブール値の true または false の値を返します。
接続.同期 オフラインが有効なアプリの現在の同期状態を保持する ConnectionSync という名前の列挙型を返します。

以下は、Connection.Sync で使用できる列挙値です。

列挙値 Description
接続 デバイスはネットワークに接続されており、アプリはオフラインで動作する準備ができています
警告付き接続 デバイスは警告とともに接続されています。
接続済み同期待ち デバイス上の一部のデータはサービスと同期する必要があります。
接続エラー 最後の同期試行でエラーが発生しました。
接続リフレッシュ アプリは現在サービスとデータを同期しています。
接続されていません デバイスがサービスに接続されていません。
警告なしで接続されていません 最後の同期警告です。
接続されていません。同期待ちです。 デバイス上には同期を待機しているアップデートがあります。
接続されていない同期エラー 最後の同期エラーです。

場所

Location 信号は、グローバル ポジショニング システム (GPS) および携帯電話基地局通信および IP アドレスなどの他のデバイス情報に基づいて、デバイスの場所を返します。

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

場所が変更すると、場所への依存関係は継続的に再計算され、デバイスのバッテリから電力が消費されます。 バッテリの寿命を節約するため、Enable および Disable 関数を使用して場所の更新をオンおよびオフすることができます。 表示されているスクリーンが場所情報に依存していない場合は、場所が自動的にオフになります。

プロパティ 内容
場所.高度 海抜で測った高度 (メートル) を示す数値を返します。
場所.緯度 赤道からの度数で測定される緯度を示す –90 から 90 の数値を返します。 正数は、赤道の北にある場所を示します。
場所.経度 イギリスのグリニッジからの度数で測定される経度を示す –180 から 180 の数値を返します。 正数は、グリニッジより東の位置を示します。

使用例

野球場で、ピッチャーがピッチャー マウンドからホーム ベースのキャッチャーに電話を投げます。 電話は地面に対して平らに置かれており、スクリーンの上部はキャッチャーに向いていて、ピッチャーは回転を加えません。 この場所で、電話は従量制課金の携帯ネットワーク サービスを利用できますが、WiFi は利用できません。 PlayBall スクリーンは表示されています。 アプリはオフラインで有効になっており、サービスに接続されています。

式 Description Result
場所.緯度 現在の場所の緯度を返します。 フィールドは、マップ座標 47.591 N, 122.333 W にあります。 47.591

ボールがピッチャーからキャッチャーまでを移動する間、緯度は継続的に変更されます。
場所.経度 現在の場所の経度を返します。 122.333

ボールがピッチャーからキャッチャーまでを移動する間、経度は継続的に変更されます。
位置 現在の場所の緯度および経度をレコードとして返します。 { 経度: 47.591, 緯度: 122.333 }
コンパスの方向 スクリーン上部のコンパスの方位を返します。 このフィールドで、ホーム ベースは、ピッチャー マウンドからおおよそ南西にあります。 230.25
加速.X デバイスの左右の加速度を返します。 ピッチャーは、電話をスクリーンの上部に対してまっすぐに投げるので、デバイスは左右の加速していません。 0
加速.Y デバイスの前後の加速度を返します。 ピッチャーはデバイスを投げるとき、最初に大きな加速度を与え、0.5 秒で1 時間当たり 0 から 90 マイル (1 秒あたり 132 フィート) に達します。 デバイスが空中にあると、空気の摩擦を無視し、デバイスがそれ以降加速することはありません。 デバイスはキャッチャーがキャッチすると減速し、停止します。 ピッチャーがデバイスを投げている間は 8.2 です。

デバイスが空中にある間は 0 です。

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

デバイスが空中にある間は 1 です。

キャッチャーがデバイスをキャッチした後は 0 です。
加速度 レコードとして加速度を返します。 ピッチャーがデバイスを投げるときは {X: 0, Y: 264, Z: 0} です。
接続。接続済み デバイスがネットワークに接続されているかどうかを示すブール値を返します 真実
接続。従量制 接続が従量制課金であるかどうかを示すブール値を返します 真実
接続.同期 現在の同期状態を示す列挙値を返します。 接続同期.接続済み
App.ActiveScreen = プレイボール PlayBall が表示されているかどうかを示すブール値を返します。 真実
アプリ.ActiveScreen.Fill 表示されているスクリーンのバックグラウンド色を返します。 色:緑