Рекомендации для пользователя

В этом руководстве описаны рекомендации по созданию и обновлению действий пользователей. Общие сведения о функции действий пользователей в Windows см. в разделе "Продолжить действия пользователей" даже на разных устройствах. Кроме того, ознакомьтесь с разделом "Действия пользователей" в Project Rome для реализации действий на других платформах разработки.

Примечание.

С июля 2021 г. пользователи, у которых журнал действий синхронизирован на всех устройствах с Windows с использованием учетной записи Майкрософт (MSA), больше не смогут отправлять новые действия в представлении временной шкалы. У таких пользователей по-прежнему будет возможность использовать временную шкалу и просматривать историю действий (сведения о последних приложениях, веб-сайтах и файлах) на своем локальном компьютере. Это не затронет учетные записи, подключенные к AAD.

Когда следует создавать или обновлять действия пользователей

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

Общие рекомендации

  • Запишите одно действие для группы связанных действий пользователей. Это особенно важно для музыкальных списков воспроизведения или телевизионных шоу: одно действие может обновляться через регулярные интервалы, чтобы отразить ход выполнения пользователя. В этом случае у вас будет одно действие пользователя с несколькими элементами журнала, представляющими периоды взаимодействия в течение нескольких дней или недель. Это же относится к действиям на основе документов, на которых пользователь выполняет постепенный прогресс в приложении.
  • Храните данные пользователей в облаке. Если вы хотите поддерживать действия между устройствами, необходимо убедиться, что содержимое, необходимое для повторного взаимодействия с этим действием, хранится в облачном расположении. Действия, относящиеся к устройству, будут отображаться на временной шкале на устройстве, где было создано действие, но не может отображаться на других устройствах.
  • Не создавайте действия для действий, которые пользователи не должны возобновлять. Если приложение используется для выполнения простых однократных операций, которые не сохраняют состояние, возможно, вам не нужно создавать действие пользователя.
  • Не создавайте действия для действий, выполненных другими пользователями. Если внешняя учетная запись отправляет пользователю сообщение или @-упоминания их в приложении, то для этого не следует создавать действие. Этот тип действия лучше обслуживается уведомлениями Центра уведомлений Центра уведомлений.
    • Сценарии совместной работы являются исключением: если несколько пользователей работают над одним действием вместе (например, документ Word), то в случаях, когда другой пользователь вносил изменения после пользователя. В этом случае может потребоваться обновить существующее действие, чтобы отразить изменения, внесенные в документ. Это приведет к обновлению существующих данных содержимого действия пользователя без создания нового элемента журнала.

Рекомендации по определенным типам приложений

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

  • Приложения на основе документов — создание одного действия на документ с одним или несколькими элементами журнала, отражающими периоды использования. Важно обновить действие по мере внесения изменений в документ.
  • Игры — создание одного действия для каждого сохранения игры или мира. Если ваша игра поддерживает только одну последовательность уровней, вы можете повторно опубликовать то же действие с течением времени, хотя вы можете обновить данные содержимого, чтобы показать последние ход выполнения или достижения.
  • Служебные приложения . Если в приложении нет ничего, пользователям потребуется оставить и возобновить работу, вам не нужно использовать действия пользователей. Хорошим примером является простое приложение, например Калькулятор.
  • Бизнес-приложения — многие приложения существуют для управления простыми задачами или рабочими процессами. Создайте одно действие для каждого отдельного рабочего процесса, доступного через приложение (например, отчеты о расходах будут отдельными действиями, чтобы пользователь мог щелкнуть действие, чтобы узнать, был ли утвержден определенный отчет).
  • Приложения воспроизведения мультимедиа — создание одного действия для каждой логической группировки содержимого (например, списка воспроизведения, программы или автономного содержимого). Основной вопрос для разработчиков приложений заключается в том, считается ли каждый фрагмент содержимого (телевизионный эпизод, песня) автономным контентом или частью коллекции. Как правило, если пользователь решит воспроизвести коллекцию или последовательное содержимое, коллекция в целом — это действие. Если они предпочитают играть один фрагмент содержимого, то один фрагмент содержимого является действием. Дополнительные рекомендации см. ниже.
    • Музыка: альбом/художник/жанр — если пользователь выбирает альбом, художник или жанр и хиты , эта коллекция является действием, не записывайте отдельное действие для каждой песни. Для коротких коллекций, таких как один альбом или коллекции, воспроизводимые в случайном порядке, может не потребоваться обновить действие, чтобы отразить текущую позицию пользователя. Для длительного последовательного воспроизведения, например альбома или списка воспроизведения, запись вашей позиции в альбоме может быть целесообразно.
    • Музыка: смарт-списки воспроизведения — приложения, которые играют музыку в случайном порядке, должны записывать одно действие для этого списка воспроизведения. Если пользователь воспроизводит список воспроизведения во второй раз, вы создадите дополнительные записи журнала для того же действия. Запись текущей позиции пользователя в списке воспроизведения не требуется, так как упорядочивание является случайным.
    • Телесериал — если ваше приложение настроено на воспроизведение следующего эпизода после завершения текущего, вы должны написать одно действие для сериала. При воспроизведении различных эпизодов в нескольких сеансах просмотра вы обновите действие, чтобы отразить текущую позицию в серии, и будут созданы несколько записей журнала.
    • Фильм — фильм является одним фрагментом содержимого и должен иметь свою собственную историю записи. Если пользователь перестает смотреть фильм частично, желательно записать свою позицию. Когда они хотят возобновить его в будущем, действие может возобновить фильм, где они покинули, или даже попросить пользователя, если они хотят возобновить или начать в начале.

Проектирование действий пользователей

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

  • URI активации — это универсальный код ресурса (URI), который можно передать приложению или интерфейсу, чтобы возобновить работу приложения с определенным контекстом. Как правило, эти ссылки принимают форму обработчика протокола для схемы (например, "my-app://page2?action=edit"). Разработчик должен определить, как будут обрабатываться параметрами URI приложения. Дополнительные сведения см. в разделе "Обработка активации URI".
  • Визуальные данные, состоящие из набора обязательных и необязательных свойств (например, заголовка, описания или элементов адаптивной карточки), позволяют пользователям визуально идентифицировать действие. Ниже приведены рекомендации по созданию визуальных элементов адаптивной карточки для действия.
  • Метаданные содержимого — это данные JSON, которые можно использовать для группировки и извлечения действий в определенном контексте. Как правило, это принимает форму http://schema.org данных. Ниже приведены рекомендации по заполнению этих данных.

Рекомендации по проектированию адаптивных карточек

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

Разработчикам приложений рекомендуется предоставлять пользовательские карточки с помощью простой схемы JSON адаптивной карточки. В документации по адаптивным карточкам приведены технические инструкции по созданию объектов адаптивной карточки. Ознакомьтесь с приведенными ниже рекомендациями по проектированию адаптивных карточек в действиях пользователей.

  • Использование изображений
    • При возможности используйте уникальное изображение для каждого действия. Имя приложения и значок автоматически отображаются рядом с карточкой действия; дополнительные изображения помогут пользователям найти нужные действия.
    • Изображения не должны содержать текст, который пользователь должен прочитать. Этот текст не будет доступен пользователям с потребностями специальных возможностей и не может быть выполнен поиск.
    • Если изображение не содержит текст и может быть обрезано около 2:1, его следует использовать в качестве фонового изображения. Это приводит к полужирной карточке действия, которая будет выделяться на временной шкале. Изображение будет немного темным, чтобы убедиться, что текст остается видимым на карточке, и в этом случае рекомендуется использовать только имя действия, так как меньший текст может стать трудно читать.
    • Если изображение не может быть обрезано до 2:1, его следует поместить в карточку действия.
      • Если пропорции квадратные или книжные, привязывайте изображение справа от карточки без полей.
      • Если пропорции — Альбомная, привязите изображение к правому верхнему углу карточки.
  • Каждое действие требуется для предоставления имени действия, которое всегда должно отображаться.
    • Это имя должно отображаться в левом верхнем углу карточки с помощью параметра большого полужирного текста. Важно, чтобы имя легко распознавалось, так как это единственная часть, которую пользователи увидят, когда действие отображается в сценариях Кортаны. Отображение того же имени на временной шкале упрощает просмотр большого количества действий пользователей.
  • Используйте один и тот же визуальный стиль для всех действий из приложения, чтобы пользователи могли легко находить действия приложения на временной шкале.
    • Например, действия должны использовать один и тот же цвет фона.
  • Используйте дополнительные текстовые сведения с разреженным образом.
    • Избегайте заполнения карточки текстом и используйте только дополнительные сведения, которые помогают пользователям находить правильное действие или отражают сведения о состоянии (например, текущий ход выполнения конкретной задачи).

Рекомендации по метаданным содержимого

Действия пользователей также могут содержать метаданные содержимого, которые Windows и Кортана используют для классификации действий и создания выводов. Затем действия можно сгруппировать по определенной теме, например расположение (если пользователь изучает отпуск), объект (если пользователь изучает что-то) или действие (если пользователь ищет определенный продукт в разных приложениях и веб-сайтах). Рекомендуется представлять как существительные, так и глаголы, участвующие в действии.

В следующем примере JSON метаданных содержимого , следуя стандартам Schema.org, представляет сценарий: "Джон играл Angry Birds с Стивом".

// John played angry birds with Steve.
{
  "@context": "http://schema.org",
  "@type": "PlayAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "MobileApplication",
    "name": "Angry Birds."
  },
  "participant": {
    "@type": "Person",
    "name": "Steve"
  }
}

Ключевые API