Partilhar via


UserActivity Classe

Definição

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)]
class UserActivity final
/// [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")]
class UserActivity final
/// [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)]
public sealed class UserActivity
[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")]
public sealed class UserActivity
[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

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.

Aplica-se a

Confira também