UserActivity Classe

Definição

Namespace:

Windows.ApplicationModel.UserActivities

Uma UserActivity é criada por um aplicativo durante sua execução para notificar o sistema de um fluxo de trabalho do usuário que pode ser continuado em outro dispositivo ou em outro momento no mesmo dispositivo. Ele fornece informações sobre uma tarefa em que o usuário está envolvido.

Observação

A partir de julho de 2021, os usuários que têm o histórico de atividades sincronizado em seus dispositivos Windows por meio de sua MSA (Conta Microsoft) não terão mais a opção de carregar novas atividades na Linha do Tempo. Eles ainda poderão usar a Linha do Tempo e ver seu histórico de atividades (informações sobre aplicativos, sites e arquivos recentes) em seu computador local. As contas conectadas ao AAD não serão impactadas.

public ref class UserActivity sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.UserActivities.IUserActivityFactory, 393216, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UserActivity final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.ApplicationModel.UserActivities.IUserActivityFactory), 393216, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class UserActivity

function UserActivity(activityId)

Public NotInheritable Class UserActivity

Herança

Object Platform::Object IInspectable UserActivity

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ActivatableAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Comentários

Observação

A partir de julho de 2021, os usuários que têm o histórico de atividades sincronizado em seus dispositivos Windows por meio de sua MSA (Conta Microsoft) não terão mais a opção de carregar novas atividades na Linha do Tempo. Eles ainda poderão usar a Linha do Tempo e ver seu histórico de atividades (informações sobre aplicativos, sites e arquivos recentes) em seu computador local. As contas conectadas ao AAD não serão impactadas.

Uma UserActivity encapsula a tarefa de um usuário que pode ser continuada posteriormente e potencialmente em um dispositivo diferente. A criação de uma atividade do usuário faz com que essa atividade seja capaz de aparecer na Linha do Tempo do Windows e no recurso Retomar da Cortana de onde deixei de lado. A linha do tempo é uma exibição de tarefa rica que mostra uma visão cronológica do que você tem trabalhado, por meio de atividades que o Windows acredita ter tido um envolvimento significativo do usuário. Ele também pode incluir o que você estava trabalhando em todos os dispositivos. Por exemplo, um aplicativo de email pode criar uma UserActivity quando o usuário começar a criar uma nova mensagem de email. O usuário pode pausar o trabalho no email e, em seguida, trabalhar nele mais tarde no mesmo computador ou até mesmo em outro dispositivo.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1803	17134	UserActivity
1803	17134	ToJson
1803	17134	ToJsonArray
1803	17134	TryParseFromJson
1803	17134	TryParseFromJsonArray
1809	17763	IsRoamable

Construtores

UserActivity(String)

Criar uma UserActivity com uma ID de atividade especificada

Propriedades

ActivationUri	Obtém e define o URI (Uniform Resource Identifier) de ativação.
ActivityId	Obtém a ID de atividade que foi atribuída a essa UserActivity quando ela foi criada.
ContentInfo	Obtém ou define o objeto de informações de conteúdo para essa atividade de usuário.
ContentType	Obtém e define o tipo MIME (Multipurpose Internet Mail Extensions) do conteúdo armazenado em UserActivity.ContentUri. Por exemplo, "text/plain".
ContentUri	Obtém e define o URI (Uniform Resource Identifier) do conteúdo ou documento representado pela UserActivity.
FallbackUri	Obtém e define o URI (Uniform Resource Identifier) de fallback a ser usado se não houver nenhum manipulador para o URI de ativação.
IsRoamable	Obtém e define se os metadados da atividade específica devem ser carregados no Microsoft Cloud.
State	Obtém o estado (Publicado ou Novo) desta UserActivity.
VisualElements	Obtém informações que podem ser usadas para o bloco de detalhes dessa atividade.

Métodos

CreateSession()	Cria uma UserActivitySession à qual essa atividade de usuário será associada. Você deve chamar esse método no thread da interface do usuário.
SaveAsync()	Publique UserActivity.
ToJson()	Serializa a UserActivity em uma cadeia de caracteres JSON. Entre outras coisas, a cadeia de caracteres JSON conterá o nome de exibição do aplicativo, a URL de ativação, a URL de conteúdo, as informações de conteúdo e as informações do elemento visual, como descrição, cor da tela de fundo e assim por diante.
ToJsonArray(IIterable<UserActivity>)	Serializa uma coleção de objetos UserActivity em uma cadeia de caracteres JSON. Entre outras coisas, a cadeia de caracteres JSON conterá o nome de exibição do aplicativo, a URL de ativação, a URL de conteúdo, as informações de conteúdo e as informações do elemento visual, como descrição, cor da tela de fundo e assim por diante para cada UserActivity.
TryParseFromJson(String)	Constrói uma UserActivity a partir de uma cadeia de caracteres JSON.
TryParseFromJsonArray(String)	Cria uma coleção de objetos UserActivity de uma cadeia de caracteres JSON.

Confira também

• Atividades do usuário
• Exemplo de UserActivity