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)]
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
継承
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 オブジェクトのコレクションを作成します。

適用対象

こちらもご覧ください