Работа с индикаторами хода выполнения tvOS в Xamarin

В этой статье рассматривается проектирование и работа с индикаторами хода выполнения в приложении Xamarin.tvOS.

Может возникнуть время, когда приложению Xamarin.tvOS необходимо загрузить новое содержимое или выполнить длинную операцию обработки. В эти времена необходимо представить индикатор действия или индикатор хода выполнения, чтобы сообщить пользователю, что приложение по-прежнему запущено, и дать им некоторое указание на длину выполняемой задачи.

Пример индикаторов хода выполнения

Сведения о индикаторах активности

Индикатор действия представляет собой вращающийся косик и используется для представления задачи неопределенной длины. Индикатор отображается при запуске и исчезновении задачи при завершении задачи.

Apple предлагает следующие предложения по работе с индикаторами активности:

  • По возможности используйте индикатор хода выполнения. Так как индикатор действия не дает пользователю отзыв о том, сколько времени будет выполняться процесс, всегда используйте индикатор хода выполнения, если длина известна (например, сколько байтов для скачивания в файле).
  • Сохраняйте анимацию индикатора. Пользователи связывают индикатор активности с застопорированным приложением, поэтому при отображении индикатора всегда следует анимировать.
  • Описание обрабатываемой задачи — просто отображение индикатора активности недостаточно. Пользователь должен быть проинформирован о процессе ожидания. Включите значимую метку (обычно одно, полное предложение), которая четко определяет задачу.

Сведения о индикаторах хода выполнения

Индикатор выполнения представляет собой строку, которая заполняется цветом, чтобы указать состояние и длину задачи, которая занимает много времени. Индикаторы хода выполнения всегда следует использовать, если длина задач известна или может быть вычислена.

Apple предлагает следующие предложения по работе с индикаторами хода выполнения:

  • Точный отчет о ходе выполнения. Индикаторы хода выполнения всегда должны представлять точное представление времени, необходимого для выполнения задачи. Никогда не искажайте время, чтобы приложение было занято.
  • Используйте для четко определенных длительности. Индикаторы хода выполнения не только показывают, что выполняется длинная задача, но и дает пользователю указание на то, сколько задач завершено, и оценка оставшегося времени.

Индикаторы хода выполнения и раскадровки

Самый простой способ работы с индикатором хода выполнения в приложении Xamarin.tvOS — добавить его в пользовательский интерфейс приложения с помощью конструктора iOS.

  1. На панели решений дважды щелкните файл Main.storyboard и откройте его для редактирования.

  2. Перетащите индикатор действия из панели элементов и удалите его в представлении:

    Индикатор действия

  3. На вкладке "Мини-приложение" панели свойств можно настроить несколько свойств индикатора действия, например "Стиль", "Поведение" и "Имя".

    Вкладка

    Имя определяет имя свойства, представляющего индикатор действия в коде C#.

  4. Перетащите представление хода выполнения из панели элементов и удалите его в представлении:

    Представление хода выполнения

  5. На вкладке "Мини-приложение" Обозреватель свойства можно настроить несколько свойств представления хода выполнения, таких как стиль, ход выполнения (процент завершения) и имя:

    Вкладка

    Имя определяет имя свойства, представляющего представление хода выполнения в коде C#.

  6. Сохранение изменений.

Дополнительные сведения о работе с раскадровками см. в руководстве по началу работы с раскадровки Hello, tvOS.

Работа с индикаторами действий

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

В любой момент можно увидеть, является ли индикатор действия анимацией, проверка его IsAnimating свойство. HidesWhenStopped Если свойство имеет значениеtrue, индикатор действия автоматически будет скрыт при остановке анимации.

Для запуска анимации можно использовать следующий код:

ActivityIndicator.StartAnimating();

И следующее остановит анимацию:

ActivityIndicator.StopAnimating();

Примечание.

В этих фрагментах кода предполагается, что для имени индикатора действия задано значение ActivityIndicator на вкладке "Мини-приложение" конструктора iOS.

Работа с индикаторами выполнения

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

Свойство Progress используется для задания объема задачи, которая была завершена с 0% до 100% (0,0 до 1,0). ProgressTintColor Используйте свойство, чтобы задать цвет завершенной панели объема и TrackTintColor свойства, чтобы задать цвет фона (незавершенный объем).

Итоги

В этой статье рассматривается проектирование и работа с индикаторами хода выполнения в приложении Xamarin.tvOS.