Restituiscono informazioni sull'ambiente dell'app, ad esempio la posizione geografica dell'utente e la schermata visualizzata.

Descrizione e sintassi

Tutti i segnali restituiscono un record di informazioni. È possibile usare e archiviare le informazioni come record o estrarre le singole proprietà usando l'operatore . operatore.

Accelerazione

Il segnale Acceleration (Accelerazione) restituisce l'accelerazione del dispositivo in tre dimensioni relative alla schermata del dispositivo. L'accelerazione è misurata in unità g di 9,81 m/secondo2 o 32,2 piedi/secondo2, ovvero l'accelerazione che la Terra esercita sugli oggetti sulla superficie terrestre a causa della gravità.

Proprietà del segnale Descrizione
Acceleration.X Destra e sinistra. L'accelerazione a destra è un numero positivo.
Acceleration.Y In avanti e indietro. L'accelerazione in avanti è un numero positivo.
Acceleration.Z In alto e in basso. L'accelerazione in alto è un numero positivo.

App

Il segnale App restituisce informazioni sull'app in esecuzione.

Proprietà del segnale Descrizione
App.ActiveScreen La schermata visualizzata. Restituisce un oggetto schermata che è possibile usare per fare riferimento alle proprietà della schermata o eseguire un confronto con un'altra schermata per individuare la schermata visualizzata. È possibile modificare la schermata visualizzata usando la funzione Back o Navigate.

Bussola

Il segnale Compass (Bussola) restituisce l'intestazione della bussola nella parte superiore della schermata. L'intestazione è basata sul Nord magnetico.

Proprietà del segnale Descrizione
Compass.Heading L'intestazione in gradi. Restituisce un numero compreso tra 0 e 360. Il numero 0 rappresenta il Nord.

Connessione

Il segnale Connection (Connessione) restituisce informazioni sulla connessione di rete. In una connessione a consumo è possibile che si voglia limitare la quantità di dati inviati o ricevuti in rete.

Proprietà del segnale Descrizione
Connection.Connected Restituisce un valore booleano true o false che indica se il dispositivo è connesso a una rete.
Connection.Metered Restituisce un valore booleano true o false che indica se la connessione è a consumo.

Percorso

Il segnale Location (Posizione) restituisce la posizione GPS (Global Positioning System) del dispositivo e altre informazioni sul dispositivo, ad esempio le comunicazioni dell'antenna cellulare e l'indirizzo IP.

Quando un utente accede alle informazioni sulla posizione per la prima volta, il dispositivo potrebbe richiedere all'utente di consentire l'accesso a queste informazioni.

Al cambio di posizione, le dipendenze della posizione vengono ricalcolate continuamente consumando l'energia della batteria del dispositivo. Per prolungare la durata della batteria, è possibile usare le funzioni Enable e Disable per attivare e disattivare gli aggiornamenti della posizione. La posizione viene disattivata automaticamente se la schermata visualizzata non dipende dalle informazioni di posizione.

Proprietà del segnale Descrizione
Location.Altitude Restituisce un numero che indica l'altitudine, in piedi, sul livello del mare.
Location.Latitude Restituisce un numero compreso tra -90 e 90 che indica la latitudine, misurata in gradi dall'equatore. Un numero positivo indica una posizione a Nord dell'equatore.
Location.Longitude Restituisce un numero compreso tra 0 e 180 che indica la longitudine, misurata in gradi a Ovest di Greenwich, Inghilterra.

Esempi

Dal monte di lancio di Safeco Field a Seattle, Washington, un lanciatore di baseball lancia un telefono a un ricevitore che si trova sul piatto di casa base. Il telefono è appoggiato di piatto rispetto al terreno, la parte superiore dello schermo è rivolta verso il ricevitore e il battitore non aggiunge alcun effetto. In questa posizione, nel telefono è disponibile un servizio di rete cellulare calcolato a consumo ma senza connessione Wi-Fi. Viene visualizzata la schermata PlayBall.

Formula Descrizione Risultato
Location.Latitude Restituisce la latitudine della posizione corrente. Safeco Field si trova in corrispondenza delle coordinate geografiche 47.591 N, 122.333 O. 47.591

La latitudine cambia continuamente mentre la palla si sposta tra lanciatore e ricevitore.
Location.Longitude Restituisce la longitudine della posizione corrente. 122.333

La longitudine cambia continuamente mentre la palla si sposta tra lanciatore e ricevitore.
Location Restituisce la latitudine e la longitudine della posizione corrente, sotto forma di record. { Latitudine: 47.591, Longitudine: 122.333 }
Compass.Heading Restituisce l'intestazione della bussola della parte superiore della schermata. Presso Safeco Field il piatto di casa base si trova approssimativamente a Sud-Ovest del monte di lancio. 230.25
Acceleration.X Restituisce l'accelerazione del dispositivo da un lato all'altro. Poiché il lanciatore lancia il telefono dritto rispetto alla parte superiore dello schermo, il dispositivo non subisce accelerazione da un lato all'altro. 0
Acceleration.Y Restituisce l'accelerazione del dispositivo da fronte a retro. Il lanciatore trasmette inizialmente al dispositivo un'accelerazione elevata durante il lancio, che passa da 0 a 90 miglia all'ora (132 piedi al secondo) in mezzo secondo. Quando il dispositivo è in aria, ignorando l'attrito dell'aria, il dispositivo non accelera ulteriormente. Il dispositivo rallenta quando il ricevitore lo afferra bloccandolo. 8.2, quando il lanciatore lancia il dispositivo.

0, mentre il dispositivo è in aria.

-8.2, quando il ricevitore afferra il dispositivo.
Acceleration.Z Restituisce l'accelerazione del dispositivo dall'alto al basso. Mentre è in aria, il dispositivo subisce gli effetti della gravità. 0, prima che il lanciatore lanci il dispositivo.

1, mentre il dispositivo è in aria.

0, dopo che il ricevitore ha afferrato il dispositivo.
Acceleration Restituisce l'accelerazione sotto forma di record. { X: 0, Y: 264, Z: 0 } quando il lanciatore lancia il dispositivo.
Connection.Connected Restituisce un valore booleano che indica se il dispositivo è connesso a una rete true
Connection.Metered Restituisce un valore booleano che indica se la connessione è a consumo true
App.ActiveScreen = PlayBall Restituisce un valore booleano che indica se la schermata PlayBall è visualizzata. true
App.ActiveScreen.Fill Restituisce il colore di sfondo per la schermata visualizzata. Color.Green