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 и сейчас.

Возвращаемое значение

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
        }
    }
}