UserActivityChannel.GetSessionHistoryItemsForUserActivityAsync メソッド

定義

名前空間:

Windows.ApplicationModel.UserActivities

ユーザー アクティビティのセッション履歴を取得します。

public:
 virtual IAsyncOperation<IVector<UserActivitySessionHistoryItem ^> ^> ^ GetSessionHistoryItemsForUserActivityAsync(Platform::String ^ activityId, DateTime startTime) = GetSessionHistoryItemsForUserActivityAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVector<UserActivitySessionHistoryItem>> GetSessionHistoryItemsForUserActivityAsync(winrt::hstring const& activityId, DateTime const& startTime);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IList<UserActivitySessionHistoryItem>> GetSessionHistoryItemsForUserActivityAsync(string activityId, System.DateTimeOffset startTime);

function getSessionHistoryItemsForUserActivityAsync(activityId, startTime)

Public Function GetSessionHistoryItemsForUserActivityAsync (activityId As String, startTime As DateTimeOffset) As IAsyncOperation(Of IList(Of UserActivitySessionHistoryItem))

パラメーター

activityId

String

Platform::String

winrt::hstring

セッション履歴を取得するユーザー アクティビティを識別します。

startTime

DateTime DateTimeOffset

startTime と now の間にアクティブだったユーザー アクティビティ セッションを取得します。

戻り値

IAsyncOperation<IVector<UserActivitySessionHistoryItem>>

IAsyncOperation<IList<UserActivitySessionHistoryItem>>

指定したユーザー アクティビティの指定された期間中にアクティブだったユーザー アクティビティ セッション オブジェクトの一覧。

属性

RemoteAsyncAttribute

Windows の要件

デバイス ファミリ	Windows 10, version 1803 (10.0.17134.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v6.0 で導入)

例

private async void GetMostRecentActivity()
{
    UserActivityChannel channel = UserActivityChannel.GetDefault();

    // Gets the 10 most recently engaged UserActivity objects, sorted by engagement EndTime (null EndTimes sort first)
    IList<UserActivitySessionHistoryItem> recentActivity = await channel. GetRecentUserActivitiesAsync(maxUniqueActivities: 10);

    foreach (var activity in recentActivity)
    {
        var engagements = await channel.GetSessionHistoryItemsForUserActivityAsync(activity.UserActivity.ActivityId, new DateTimeOffset(DateTime.Now, TimeSpan.FromDays(1)));

        long totalEngagementTime = 0;
        foreach(var e in engagements)
        {
            if (e.EndTime != null) // EndTime may be null for active UserActivities
            {
                totalEngagementTime += e.EndTime.Value.Ticks - e.StartTime.Ticks);
            }
            // App specific code to display the activity engagement time
        }
    }
}