Trabajar con indicadores de progreso de tvOS en Xamarin
En este artículo se describe el diseño y el trabajo con indicadores de progreso dentro de una aplicación Xamarin.tvOS.
Es posible que haya ocasiones en las que la aplicación Xamarin.tvOS necesite cargar contenido nuevo o realizar una operación de procesamiento larga. Durante estos tiempos, debes presentar un indicador de actividad o una barra de progreso para que el usuario sepa que la aplicación todavía se está ejecutando y darles alguna indicación de la longitud de la tarea que se está ejecutando.
Acerca de los indicadores de actividad
Un indicador de actividad se presenta como un engranaje giratorio y se usa para representar una tarea de una longitud indeterminada. El indicador se presenta cuando se inicia la tarea y desaparece cuando se completa la tarea.
Apple tiene las siguientes sugerencias para trabajar con indicadores de actividad:
- Siempre que sea posible, use barras de progreso en su lugar : dado que un indicador de actividad no proporciona ningún comentario al usuario durante cuánto tiempo tardará la ejecución del proceso, use siempre una barra de progreso si se conoce la longitud (por ejemplo, cuántos bytes se van a descargar en un archivo).
- Mantener el indicador animado: los usuarios relacionan un indicador de actividad estacionario con una aplicación detenida, por lo que siempre debe animar el indicador mientras se muestra.
- Describir la tarea que se está procesando: simplemente mostrar el indicador de actividad por sí mismo no es suficiente; el usuario debe informarse sobre el proceso en el que está esperando. Incluya una etiqueta significativa (normalmente una sola frase completa) que defina claramente la tarea.
Acerca de las barras de progreso
Una barra de progreso se presenta como una línea que se rellena con color para indicar el estado y la duración de una tarea que consume mucho tiempo. Las barras de progreso siempre deben usarse cuando se conoce la longitud de las tareas o se pueden calcular.
Apple tiene las siguientes sugerencias para trabajar con barras de progreso:
- Notificar con precisión el progreso: las barras de progreso siempre deben presentar una representación precisa del tiempo necesario para completar una tarea. Nunca desfigure la hora para que la aplicación parezca ocupada.
- Uso de duraciones bien definidas: las barras de progreso no solo deben mostrar que se está llevando a cabo una tarea larga, sino que proporcione al usuario la cantidad de la tarea completada y una estimación del tiempo restante.
Indicadores de progreso y guiones gráficos
La manera más fácil de trabajar con un indicador de progreso en una aplicación de Xamarin.tvOS es agregarlo a la interfaz de usuario de la aplicación mediante Diseñador de iOS.
En el Panel de solución , haga doble clic en el archivo Main.storyboard y ábralo para editarlo.
Arrastre un indicador de actividad desde el cuadro de Herramientas y colóquelo en la vista:
En la pestaña Widget de Panel de propiedades, puede ajustar varias propiedades del indicador de actividad, como su Estilo, Comportamientoy Nombre:
El Nombre determina el nombre de la propiedad que representa el indicador de actividad en el código de C#.
Arrastre un vista progreso desde el cuadro de Herramientas y colóquelo en la vista:
En la pestaña Widget del explorador de propiedades , puede ajustar varias propiedades de la vista de progreso, como su Estilo, Progreso (porcentaje completado) y Nombre:
El Nombre determina el nombre de la propiedad que representa la vista de progreso en el código de C#.
Guarde los cambios.
Para obtener más información sobre cómo trabajar con guiones gráficos, consulte nuestra Hola, guía de inicio rápido de tvOS.
Trabajar con indicadores de actividad
Como se indicó anteriormente, los indicadores de actividad deben mostrarse cuando la aplicación ejecuta un largo proceso de longitud indeterminada.
En cualquier momento, puede ver si un indicador de actividad está animando comprobando su propiedad IsAnimating. Si la propiedad HidesWhenStopped es true, el indicador de actividad se ocultará automáticamente cuando se detenga su animación.
Puede usar el código siguiente para iniciar la animación:
ActivityIndicator.StartAnimating();
Y lo siguiente detendrá la animación:
ActivityIndicator.StopAnimating();
Nota:
En estos fragmentos de código se supone que el Nombre del indicador de actividad se estableció en ActivityIndicator en la pestaña Widget del diseñador de iOS.
Trabajar con barras de progreso
De nuevo, se debe usar una barra de progreso cada vez que la aplicación ejecute una tarea de larga duración.
La propiedad Progress se usa para establecer la cantidad de la tarea que se ha completado del 0 % al 100 % (de 0,0 a 1,0). Use la propiedad ProgressTintColor para establecer el color de la barra de cantidad completada y la propiedad TrackTintColor para establecer el color de fondo (cantidad no completada).
Resumen
En este artículo se ha tratado el diseño y el trabajo con indicadores de progreso dentro de una aplicación Xamarin.tvOS.