Сигнали прискорення, програми, компаса, підключення та розташування в Power Apps

Застосовується до: програм Canvas Програм на основі моделі

Повертає відомості про середовище програми, наприклад, де у світі знаходиться користувач і який екран відображено.

Опис і синтаксис

Сигнали – це значення, які можуть змінитися в будь-який час, незалежно від того, як користувач взаємодіє з програмою. Формули, які базуються на сигналах, автоматично переобчислюються зі зміною значень.

Зазвичай сигнали повертають запис інформації. Можна зберегти цю інформацію як запис або видобути окремі властивості за допомогою .оператора.

Нотатка

Функції «Прискорення » та «Компас» повертають точні значення у власному програвачі, наприклад on iOS or Android, але ці функції повертають нульові значення, коли ви створюєте або змінюєте програму в браузері.

Прискорення

Сигнал Acceleration повертає прискорення пристрою у трьох вимірах відносно екрану пристрою. Прискорення вимірюються в одиницях g, що становить 9,81 м/с² або 32,2 фути/с² (прискорення, що Земля надає об'єктам на її поверхні через гравітацію).

Властивість	Опис
Acceleration.X	Вправо і вліво. Вправо – додатне число.
Acceleration.Y	Вперед і назад. Вперед – додатне число.
Acceleration.Z	Угору і вниз. Угору – додатне число.

Програма

Крім інших властивостей, об'єкт App містить сигнал, який вказує, який екран відображається.

Властивість	Опис
App.ActiveScreen	Екран, що відображається. Повертає об'єкт на екрані, який можна використовувати для посилання на властивості екрана або порівняти його з іншим екраном, щоб визначити, який екран відображається. Скористайтеся функціями Back або Navigate, щоб змінити екран, який відображається.

Додаткові відомості: Документація об'єктів App.

Compass

Сигнал Compass повертає напрямок компаса верхньої частини екрана. Напрямок залежить від магнітної півночі.

Властивість	Опис
Compass.Heading	Напрямок у градусах. Повертає число від 0 до 360, де 0 — це північ.

Зв’язок

Сигнал Connection повертає відомості про підключення до мережі. У разі використання лімітного з'єднання, бажано обмежити кількість даних, які надсилаються або надходять через мережу. Або, якщо програму ввімкнено в автономному режимі, ви можете відображати різну інформацію залежно від поточного стану синхронізації.

Властивість	Опис
Connection.Connected	Повертає логічне значення True або False, що вказує, чи пристрій підключено до мережі.
Connection.Metered	Повертає логічне значення True або False, що вказує, чи підключення лімітоване.
Connection.Sync	Повертає перелік із назвою ConnectionSync , який містить поточний стан синхронізації для програми, увімкненої в автономному режимі.

Нижче наведено значення переліків, доступні для Connection.Sync.

Значення переліку	Опис
Підключений	Ваш пристрій підключено до мережі, і додаток готовий до роботи в автономному режимі
ConnectedWithWarning	Ваш пристрій підключено з попередженням.
ConnectedPendingUpsync	Деякі дані на вашому пристрої повинні бути синхронізовані з сервісом.
Помилка ConnectedError	Під час останньої спроби синхронізації сталася помилка.
ПідключеноRefresh	Ваш додаток синхронізує дані зі службою.
Не підключено	Ваш пристрій не підключено до сервісу.
NotConnectedWithWarning	Останнє попередження про синхронізацію.
NotConnectedPendingUpsync	На вашому пристрої є оновлення, які очікують на синхронізацію.
NotConnectedSyncError	Остання помилка синхронізації.

Розташування

Сигнал Location повертає розташування пристрою на основі даних GPS та інших відомостей пристрою, наприклад стільникового зв'язку й ІР-адреси.

Коли користувач хоче вперше отримати відомості про місцезнаходження, пристрій може надати запит, щоб користувач дозволив доступ до цих відомостей.

Якщо розташування змінюється, залежності від розташування буде постійно переобчислено, що споживатиме заряд акумулятора пристрою. Щоб зберегти заряд акумулятора, можна використовувати функції Enable і Disable, щоб ввімкнути або вимкнути оновлення розташування. Розташування автоматично вимикається, якщо відображуваний екран не залежить від відомостей про розташування.

Властивість	Опис
Location.Altitude	Повертає число, яке вказує висоту над рівнем моря, виражену в метрах.
Location.Latitude	Повертає число від –90 до 90, що вказує на широту, що вимірюється у градусах від екватора. Додатне число означає розташування на північ від екватора.
Location.Longitude	Повертає число від –180 до 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 до 90 миль на годину (132 футів на секунду) за півсекунди. Після того, як пристрій опинився в повітрі, не враховуючи тертя повітря, він далі не прискорюється. Пристрій сповільнюється і зупиняється, коли кетчер ловить його.	8,2, коли пітчер кидає пристрій. 0, коли пристрій знаходиться в повітрі. –8,2, коли кетчер ловить пристрій.
Acceleration.Z	Повертає прискорення пристрою зверху вниз. Перебуваючи в повітрі, пристрій зазнає впливу гравітації.	0, перед тим, як пітчер кидає пристрій. 1, коли пристрій знаходиться в повітрі. 0, після того, як кетчер спіймає пристрій.
Прискорення	Повертає прискорення як запис.	{ X: 0, Y: 264, Z: 0 }, коли пітчер кидає пристрій.
Connection.Connected	Повертає логічне значення, що вказує, чи пристрій підключено до мережі.	True
Connection.Metered	Повертає логічне значення, що вказує, чи підключення лімітоване.	True
Connection.Sync	Повертає значення переліку, яке вказує на поточний стан синхронізації.	ConnectionSync.Connected
App.ActiveScreen = PlayBall	Повертає логічне значення, що вказує, чи відображено PlayBall.	True
App.ActiveScreen.Fill	Повертає колір фону для відображуваного екрану.	Color.Green