Uso degli indicatori di stato tvOS in Xamarin
Questo articolo illustra la progettazione e l'uso degli indicatori di stato all'interno di un'app Xamarin.tvOS.
In alcuni casi l'app Xamarin.tvOS deve caricare nuovo contenuto o eseguire un'operazione di elaborazione prolungata. Durante questi tempi, devi presentare un indicatore di attività o un indicatore di stato per informare l'utente che l'app è ancora in esecuzione e di fornire un'indicazione sulla lunghezza dell'esecuzione dell'attività.
Informazioni sugli indicatori di attività
Un indicatore di attività presenta come ingranaggio rotante e viene utilizzato per rappresentare un'attività di lunghezza non determinita. L'indicatore viene visualizzato all'avvio dell'attività e scompare al termine dell'attività.
Apple offre i suggerimenti seguenti per l'uso degli indicatori di attività:
- Quando possibile, usare le barre di stato. Poiché un indicatore di attività non fornisce all'utente alcun feedback sul tempo necessario per l'esecuzione del processo, usare sempre un indicatore di stato se la lunghezza è nota (ad esempio, il numero di byte da scaricare in un file).
- Mantieni l'indicatore animato : gli utenti correlano un indicatore di attività stazionaria a un'app bloccata, quindi dovresti sempre animare l'indicatore mentre viene visualizzato.
- Descrivere l'attività in fase di elaborazione : solo la visualizzazione dell'indicatore di attività da sola non è sufficiente. L'utente deve essere informato del processo in cui sono in attesa. Includere un'etichetta significativa (in genere una singola frase completa) che definisce chiaramente l'attività.
Informazioni sulle barre di stato
Un indicatore di stato presenta come una linea che riempie di colore per indicare lo stato e la durata di un'attività dispendiosa in termini di tempo. Le barre di stato devono essere sempre usate quando la lunghezza delle attività è nota o può essere calcolata.
Apple offre i suggerimenti seguenti per l'uso delle barre di stato:
- Segnala in modo accurato lo stato di avanzamento : le barre di stato devono sempre presentare una rappresentazione accurata del tempo necessario per completare un'attività. Non rappresentare mai male il tempo necessario per rendere l'app occupata.
- Usare per durate ben definite: le barre di stato non devono solo indicare che si sta verificando un'attività lunga, ma fornire all'utente e all'utente un'indicazione della quantità di attività completata e una stima del tempo rimanente.
Indicatori di stato e storyboard
Il modo più semplice per usare un indicatore di stato in un'app Xamarin.tvOS consiste nell'aggiungerlo all'interfaccia utente dell'app usando iOS Designer.
Nel riquadro della soluzione fare doppio clic sul file Main.storyboard e aprirlo per la modifica.
Trascinare un indicatore di attività dalla casella degli strumenti e rilasciarlo nella visualizzazione:
Nella scheda Widget del riquadro proprietà è possibile modificare diverse proprietà dell'indicatore di attività, ad esempio stile, comportamento e nome:
Il nome determina il nome della proprietà che rappresenta l'indicatore di attività nel codice C#.
Trascinare una visualizzazione stato dalla casella degli strumenti e rilasciarla nella visualizzazione:
Nella scheda Widget di Esplora proprietà è possibile modificare diverse proprietà della visualizzazione dello stato, ad esempio stile, stato (percentuale di completamento) e Nome:
Il nome determina il nome della proprietà che rappresenta la visualizzazione dello stato di avanzamento nel codice C#.
Salva le modifiche.
Per altre informazioni sull'uso degli storyboard, vedere la Guida introduttiva hello, tvOS.
Uso degli indicatori di attività
Come indicato in precedenza, gli indicatori di attività devono essere visualizzati quando l'app esegue un lungo processo di lunghezza indeterminato.
In qualsiasi momento, è possibile verificare se un indicatore di attività sta animando controllando la relativa IsAnimating proprietà. Se la HidesWhenStopped proprietà è true, l'indicatore dell'attività verrà nascosto automaticamente quando viene arrestata l'animazione.
È possibile usare il codice seguente per avviare l'animazione:
ActivityIndicator.StartAnimating();
E il codice seguente interromperà l'animazione:
ActivityIndicator.StopAnimating();
Nota
Questi frammenti di codice presuppongono che il nome dell'indicatore di attività sia stato impostato su ActivityIndicator nella scheda Widget della finestra di progettazione iOS.
Utilizzo delle barre di stato
Anche in questo caso, un indicatore di stato deve essere usato ogni volta che l'app esegue un'attività a esecuzione prolungata di una durata nota.
La Progress proprietà viene utilizzata per impostare la quantità dell'attività completata dal 0% al 100% (da 0,0 a 1,0). Utilizzare la ProgressTintColor proprietà per impostare il colore della barra completata dell'importo e la TrackTintColor proprietà per impostare il colore di sfondo (importo non completato).
Riepilogo
Questo articolo ha illustrato la progettazione e l'uso degli indicatori di stato all'interno di un'app Xamarin.tvOS.