UserActivity クラス

定義

名前空間:

Windows.ApplicationModel.UserActivities

UserActivity は、実行中にアプリによって作成され、別のデバイスまたは同じデバイス上の別の時点で続行できるユーザー作業ストリームをシステムに通知します。 ユーザーが関与しているタスクに関する情報が提供されます。

注意

2021 年 7 月から、Microsoft アカウント (MSA) を介して Windows デバイス間でアクティビティ履歴を同期しているユーザーには、タイムラインでの新しいアクティビティのアップロードのオプションがなくなりました。 引き続きタイムラインを使用して、ローカル PC でアクティビティ履歴 (最近使用したアプリ、Web サイト、ファイルに関する情報) を表示できます。 AAD 接続されたアカウントには影響はありません。

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

継承

Object Platform::Object IInspectable UserActivity

属性

ContractVersionAttribute MarshalingBehaviorAttribute ActivatableAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v5.0 で導入)

注釈

注意

2021 年 7 月から、Microsoft アカウント (MSA) を介して Windows デバイス間でアクティビティ履歴を同期しているユーザーには、タイムラインでの新しいアクティビティのアップロードのオプションがなくなりました。 引き続きタイムラインを使用して、ローカル PC でアクティビティ履歴 (最近使用したアプリ、Web サイト、ファイルに関する情報) を表示できます。 AAD 接続されたアカウントには影響はありません。

UserActivity は、後で続行できるユーザーのタスクをカプセル化し、場合によっては別のデバイスで続行できます。 ユーザー アクティビティを作成すると、そのアクティビティは Windows タイムラインと Cortana の [ピックアップ] 機能に表示されます。 タイムラインは、Windows が重要なユーザーエンゲージメントを持っていたと思われるアクティビティを通じて、あなたが取り組んだことの時系列ビューを示す豊富なタスクビューです。 また、さまざまなデバイス間で作業していた内容も含めることができます。 たとえば、メール アプリでは、ユーザーが新しいメール メッセージの作成を開始したときに UserActivity を作成できます。 ユーザーは、メールの操作を一時停止し、後で同じコンピューターまたは別のデバイスで作業できます。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1803	17134	UserActivity
1803	17134	ToJson
1803	17134	ToJsonArray
1803	17134	TryParseFromJson
1803	17134	TryParseFromJsonArray
1809	17763	IsRoamable

コンストラクター

UserActivity(String)

指定したアクティビティ ID を使用して UserActivity を作成する

プロパティ

ActivationUri	アクティブ化の Uniform Resource Identifier (URI) を取得および設定します。
ActivityId	作成時にこの UserActivity に割り当てられたアクティビティ ID を取得します。
ContentInfo	このユーザー アクティビティのコンテンツ情報オブジェクトを取得または設定します。
ContentType	UserActivity.ContentUri に格納されているコンテンツの MIME (多目的インターネット メール拡張機能) の種類を取得および設定します。 たとえば、"text/plain" などです。
ContentUri	UserActivity によって表されるコンテンツまたはドキュメントのコンテンツ Uri (Uniform Resource Identifier) を取得および設定します。
FallbackUri	アクティブ化 URI のハンドラーがない場合に使用するフォールバック Uniform Resource Identifier (URI) を取得および設定します。
IsRoamable	特定のアクティビティのメタデータを Microsoft Cloud にアップロードするかどうかを取得および設定します。
State	この UserActivity の状態 (発行済みまたは新規) を取得します。
VisualElements	このアクティビティの詳細タイルに使用できる情報を取得します。

メソッド

CreateSession()	このユーザー アクティビティが関連付けられる UserActivitySession を作成します。 UI スレッドでこのメソッドを呼び出す必要があります。
SaveAsync()	UserActivity を発行します。
ToJson()	UserActivity を JSON 文字列にシリアル化します。 特に、JSON 文字列には、アプリの表示名、アクティブ化 URL、コンテンツ URL、コンテンツ情報、説明、背景色などのビジュアル要素情報が含まれます。
ToJsonArray(IIterable<UserActivity>)	UserActivity オブジェクトのコレクションを JSON 文字列にシリアル化します。 特に、JSON 文字列には、アプリの表示名、アクティブ化 URL、コンテンツ URL、コンテンツ情報、説明、背景色などのビジュアル要素情報が各 UserActivity に含まれます。
TryParseFromJson(String)	JSON 文字列から UserActivity を構築します。
TryParseFromJsonArray(String)	JSON 文字列から UserActivity オブジェクトのコレクションを作成します。

こちらもご覧ください

• ユーザー アクティビティ
• UserActivity サンプル