Эти сигналы возвращают сведения о среде приложения, например, где находится пользователь и какой экран отображается.

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

Все сигналы возвращают запись со сведениями. Можно сохранить эту информацию в качестве записи или же извлечь отдельные свойства с помощью оператора . (см. здесь).

Ускорение

Сигнал ускорения (Acceleration) возвращает значение ускорения устройства в трех измерениях относительно экрана устройства. Ускорение измеряется в единицах g, значение которого составляет 9,81 м/с2 (речь идет об ускорении свободного падения, вызванного земным притяжением).

Свойство сигнала Описание
Acceleration.X Ось X направлена слева направо. Правая сторона представляет положительное значение.
Acceleration.Y Ось Y направлена вперед и назад. Спереди представлено положительное значение.
Acceleration.Z Ось Z направленна снизу вверх. Верхний отрезок представляет положительное число.

Приложение

Сигнал приложения (App) возвращает сведения о запущенном приложении.

Свойство сигнала Описание
App.ActiveScreen Отображаемый экран. Возвращает объект экрана, с помощью которого можно ссылаться на свойства экрана или сравнивать их со свойствами другого экрана, чтобы определить, какой экран отображается. Отображаемый экран можно изменить с помощью функции Back или Navigate.

Компас

Сигнал компаса (Compass) возвращает направление по компасу в верхней части экрана. Компас указывает в направлении магнитного севера.

Свойство сигнала Описание
Compass.Heading Каждый компас имеет градуировку, которая отображает азимут в градусах. Возвращается значение от 0 до 360 градусов, где 0 градусов обозначает север.

Подключение

Сигнал подключения (Connection) возвращает сведения о сетевом подключении. В случае лимитного подключения может потребоваться ограничить объем данных, отправляемых и получаемых по сети.

Свойство сигнала Описание
Connection.Connected Возвращает логическое значение true или false, указывающее, подключено ли устройство к сети.
Connection.Metered Возвращает логическое значение true или false, указывающее, является ли подключение лимитным.

Расположение

Сигнал расположения (Location) возвращает значение расположения устройства на основе глобальной навигационной спутниковой системы (GPS), а также другие сведения об устройстве, например расстояние до ближайшей сотовой вышки связи и IP-адрес устройства.

Когда пользователь впервые обращается за сведениями о местоположении, устройство запрашивает разрешение пользователя на обработку информации.

При изменении местоположения происходит постоянный перерасчет локаций, при котором расходуется заряд аккумулятора. Для экономии заряда аккумулятора можно использовать функции Enable и Disable, чтобы включить или отключить обновление информации о местоположении. Сведения о расположении автоматически исчезают, если отображаемый экран не зависит от местоположения.

Свойство сигнала Описание
Location.Altitude Возвращает число, указывающее высоту над уровнем моря, измеряемую в футах.
Location.Latitude Возвращает число от –90 до 90, указывающее географическую широту, выраженную в градусах. Положительное значение соответствует расположению к северу от экватора.
Location.Longitude Возвращает число от 0 до 180, указывающее географическую долготу, выраженную в градусах, измерение которой ведется с запада от Гринвича (Соединенное Королевство).

Примеры

Из точки подачи на стадионе Сэйфко-филд (Сиэтл, штат Вашингтон) подающий бросает телефон принимающему, который находится на основной базе. Телефон находится в горизонтальном положении относительно поверхности земли, а верхняя часть экрана направлена на принимающего. Подающий делает бросок без вращения. В этом состоянии телефон может использовать лимитированную сотовую связь, но не Wi-Fi. При этом отображается экран PlayBall.

Формула Описание Возвращаемый результат
Location.Latitude Возвращает значение широты текущего расположения. Стадион Сейфко-филд имеет координаты 47,591 с. ш. и 122,333 з. д. 47,591

Так как мяч движется от подающего к принимающему, значение широты будет постоянно изменяться.
Location.Longitude Возвращает значение долготы текущего расположения. 122,333

Так как мяч движется от подающего к принимающему, значение долготы будет постоянно изменяться.
Location Возвращает значение широты и долготы текущего расположения в виде записи. { Latitude: 47.591, Longitude: 122.333 }
Compass.Heading Возвращает направление по компасу в верхней части экрана. Основная база стадиона Сейфко-филд находится примерно на юго-западе от круга подачи. 230,25
Acceleration.X Возвращает ускорение устройства "бок — бок". Подающий бросает телефон прямо относительно верхней части экрана, поэтому устройство не вращается из стороны в сторону. 0
Acceleration.Y Возвращает ускорение устройства сверху вниз. Подающий изначально придает большое ускорение устройству при броске, ускоряя его до 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