UserActivity 클래스

정의

네임스페이스:

Windows.ApplicationModel.UserActivities

UserActivity는 실행 중에 앱이 다른 디바이스에서 또는 동일한 디바이스에서 다른 시간에 계속할 수 있는 사용자 작업 스트림을 시스템에 알리기 위해 만들어집니다. 사용자가 참여하는 작업에 대한 정보를 제공합니다.

참고

2021년 7월부터 MSA(Microsoft 계정)를 통해 Windows 디바이스에서 동기화된 활동 기록이 있는 사용자는 더 이상 타임라인에 새 활동을 업로드할 수 없습니다. 타임라인은 계속 사용할 수 있으며 로컬 PC의 활동 기록(최근 앱, 웹 사이트 및 파일에 대한 정보)을 볼 수 있습니다. 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월부터 MSA(Microsoft 계정)를 통해 Windows 디바이스에서 동기화된 활동 기록이 있는 사용자는 더 이상 타임라인에 새 활동을 업로드할 수 없습니다. 타임라인은 계속 사용할 수 있으며 로컬 PC의 활동 기록(최근 앱, 웹 사이트 및 파일에 대한 정보)을 볼 수 있습니다. 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	활성화 URI(Uniform Resource Identifier)를 가져오고 설정합니다.
ActivityId	이 UserActivity 를 만들 때 할당된 활동 ID를 가져옵니다.
ContentInfo	이 사용자 활동에 대한 콘텐츠 정보 개체를 가져오거나 설정합니다.
ContentType	UserActivity.ContentUri에 저장된 콘텐츠의 MIME(다목적 인터넷 메일 확장) 형식을 가져오고 설정합니다. 예를 들어 "text/plain"입니다.
ContentUri	UserActivity가 나타내는 콘텐츠 또는 문서의 콘텐츠 URI(Uniform Resource Identifier)를 가져오고 설정합니다.
FallbackUri	활성화 URI에 대한 처리기가 없는 경우 사용할 대체 URI(Uniform Resource Identifier)를 가져오고 설정합니다.
IsRoamable	특정 활동의 메타데이터를 Microsoft 클라우드에 업로드해야 하는지 여부를 가져오고 설정합니다.
State	이 UserActivity의 상태(게시됨 또는 새로 만들기)를 가져옵니다.
VisualElements	이 작업의 세부 정보 타일에 사용할 수 있는 정보를 가져옵니다.

메서드

CreateSession()	이 사용자 활동이 연결될 UserActivitySession 을 만듭니다. UI 스레드에서 이 메서드를 호출해야 합니다.
SaveAsync()	UserActivity를 게시합니다.
ToJson()	UserActivity를 JSON 문자열로 직렬화합니다. 무엇보다도 JSON 문자열에는 앱 표시 이름, 활성화 URL, 콘텐츠 URL, 콘텐츠 정보 및 설명, 배경색 등의 시각적 요소 정보가 포함됩니다.
ToJsonArray(IIterable<UserActivity>)	UserActivity 개체의 컬렉션을 JSON 문자열로 직렬화합니다. 무엇보다도 JSON 문자열에는 각 UserActivity에 대한 앱 표시 이름, 활성화 URL, 콘텐츠 URL, 콘텐츠 정보 및 시각적 요소 정보(예: 설명, 배경색 등)가 포함됩니다.
TryParseFromJson(String)	JSON 문자열에서 UserActivity 를 생성합니다.
TryParseFromJsonArray(String)	JSON 문자열에서 UserActivity 개체의 컬렉션을 만듭니다.

추가 정보

• 사용자 활동
• UserActivity 샘플