이 가이드에서는 사용자 활동을 만들고 업데이트하기 위한 권장 사례를 간략하게 설명합니다. Windows의 사용자 활동 기능에 대한 개요는 여러 디바이스에서도 사용자 활동 계속을참조하세요. 또는 Project Rome의 사용자 활동 섹션 참조하여 다른 개발 플랫폼에서의 활동 구현을 참조하세요.
비고
2021년 7월부터 MSA(Microsoft 계정)를 통해 Windows 장치에서 활동 기록이 동기화된 사용자는 더 이상 타임라인에서 새 활동을 업로드할 수 있는 옵션이 없습니다. 여전히 타임라인을 사용하고 로컬 PC에서 활동 기록(최근 앱, 웹 사이트 및 파일에 대한 정보)을 볼 수 있습니다. AAD 연결 계정은 영향을 받지 않습니다.
사용자 활동을 만들거나 업데이트하는 경우
모든 앱이 다르기 때문에 앱 내의 작업을 사용자 활동에 매핑하는 가장 좋은 방법은 각 개발자가 결정해야 합니다. 사용자 활동은 Cortana 및 타임라인에서 선보일 예정이며, 이는 사용자가 과거에 방문한 콘텐츠로 돌아갈 수 있도록 하여 사용자의 생산성과 효율성을 높이는 데 초점을 맞췄습니다.
일반 지침
- 관련된 사용자 작업 그룹에 대한 단일 활동을 기록합니다. 이는 특히 음악 재생 목록 또는 TV 쇼와 관련이 있습니다. 사용자의 진행 상황을 반영하기 위해 정기적으로 단일 활동을 업데이트할 수 있습니다. 이 경우 여러 일 또는 주에 걸친 참여 기간을 나타내는 여러 기록 항목이 있는 단일 사용자 활동이 있습니다. 사용자가 앱 내에서 점진적으로 진행하는 문서 기반 활동에도 마찬가지입니다.
- 클라우드에 사용자 데이터를 저장합니다. 디바이스 간 활동을 지원하려면 이 활동을 다시 참여하는 데 필요한 콘텐츠가 클라우드 위치에 저장되어 있는지 확인해야 합니다. 디바이스별 활동은 활동이 만들어진 디바이스의 타임라인에 표시되지만 다른 디바이스에는 표시되지 않을 수 있습니다.
- 사용자가 다시 시작할 필요가 없는 작업에 대한 활동을 만들지 마세요. 애플리케이션을 사용하여 상태를 유지하지 않는 간단한 일회성 작업을 완료하는 경우 사용자 작업을 만들 필요가 없습니다.
- 다른 사용자가 완료한 작업에 대한 활동을 만들지 마세요. 외부 계정이 사용자에게 메시지를 보내거나 앱 내에서 메시지를 @멘션하는 경우 이에 대한 활동을 만들면 안 됩니다. 이러한 유형의 작업은 알림 센터의 알림에서 더 효과적입니다.
- 공동 작업 시나리오는 예외입니다. 여러 사용자가 동일한 작업(예: Word 문서)에서 함께 작업하는 경우 사용자 후에 다른 사용자가 변경한 경우가 있습니다. 이 경우 문서에 적용된 변경 내용을 반영하도록 기존 활동을 업데이트할 수 있습니다. 여기에는 새 기록 항목을 만들지 않고 기존 사용자 활동 콘텐츠 데이터를 업데이트하는 작업이 포함됩니다.
특정 유형의 앱에 대한 지침
모든 앱은 다르지만 대부분의 앱은 다음 상호 작용 패턴 중 하나에 속합니다.
- 문서 기반 앱
- 사용 기간을 반영하는 하나 이상의 기록 항목을 사용하여 문서당 하나의 활동을 만듭니다. 문서에 변경 사항이 생길 때마다 활동을 업데이트하는 것이 중요합니다. - 게임 - 각 게임 저장 또는 각 월드에 대해 하나의 활동을 만듭니다. 게임에서 단일 레벨 시퀀스만 지원하는 경우 콘텐츠 데이터를 업데이트하여 최신 진행률 또는 도전 과제를 표시할 수 있지만 시간이 지남에 따라 동일한 활동을 다시 게시할 수 있습니다.
- 유틸리티 앱 - 사용자가 나가서 다시 시작해야 하는 앱 내에 아무 것도 없는 경우 사용자 활동을 사용할 필요가 없습니다. 좋은 예는 계산기와 같은 간단한 앱입니다.
- 업무용 애플리케이션 - 단순 작업 및 워크플로우를 관리하기 위한 많은 앱이 있습니다. 앱을 통해 액세스하는 각 개별 워크플로에 대해 하나의 활동을 만듭니다(예: 경비 보고서는 각각 별도의 활동이므로 사용자가 활동을 클릭하여 특정 보고서가 승인되었는지 확인할 수 있음).
-
미디어 재생 앱 - 콘텐츠의 논리적 그룹화당 하나의 활동(예: 재생 목록, 프로그램 또는 독립 실행형 콘텐츠)을 만듭니다. 앱 개발자의 기본 질문은 각 콘텐츠(TV 에피소드, 노래)가 독립 실행형 콘텐츠 또는 컬렉션의 일부로 계산되는지 여부입니다. 일반적으로 사용자가 컬렉션 또는 순차 콘텐츠를 재생하도록 선택하는 경우 컬렉션 전체가 활동입니다. 단일 콘텐츠를 재생하도록 선택하는 경우 해당 콘텐츠의 한 부분이 활동입니다. 아래의 구체적인 지침을 참조하세요.
- 음악: 앨범/아티스트/장르 — 사용자가 앨범, 아티스트, 또는 장르를 선택하고 재생을 누르면 해당 컬렉션이 활동입니다. 각 노래에 대해 별도의 활동을 작성하지 마십시오. 단일 앨범 또는 컬렉션과 같은 짧은 컬렉션이 임의 순서로 재생되는 경우 사용자의 현재 위치를 반영하도록 활동을 업데이트할 필요가 없습니다. 앨범 또는 재생 목록과 같은 긴 순차 재생의 경우 앨범 내에서 위치를 녹음하는 것이 합리적일 수 있습니다.
- 음악: 스마트 재생 목록 - 임의 순서로 음악을 재생하는 애플리케이션은 해당 재생 목록에 대한 단일 활동을 기록해야 합니다. 사용자가 재생 목록을 두 번째로 재생하는 경우 동일한 활동에 대한 추가 기록 레코드를 만듭니다. 순서가 임의이므로 재생 목록에서 사용자의 현재 위치를 기록할 필요가 없습니다.
- TV 시리즈 — 앱이 현재 에피소드가 완료된 후 다음 에피소드를 재생하도록 구성된 경우 TV 시리즈에 대한 단일 활동을 작성해야 합니다. 여러 보기 세션에서 다양한 에피소드를 재생하면 시리즈의 현재 위치를 반영하도록 활동을 업데이트하고 여러 기록 레코드가 만들어집니다.
- 영화 - 영화는 하나의 콘텐츠이며 자체의 역사가 있어야 합니다. 사용자가 영화를 부분적으로 시청하는 것을 중지하는 경우 자신의 위치를 기록하는 것이 좋습니다. 나중에 다시 시작하려는 경우 활동은 중단된 영화를 다시 시작하거나 사용자에게 처음부터 다시 시작하거나 시작할지 물어볼 수 있습니다.
사용자 활동 디자인
사용자 활동은 활성화 URI, 시각적 데이터 및 콘텐츠 메타데이터의 세 가지 구성 요소로 구성됩니다.
- 활성화 URI는 특정 컨텍스트에서 애플리케이션을 다시 시작하기 위해 애플리케이션 또는 환경에 전달할 수 있는 URI입니다. 일반적으로 이러한 링크는 스키마에 대한 프로토콜 처리기 형식을 사용합니다(예: "my-app://page2?action=edit"). 앱에서 URI 매개 변수를 처리하는 방법을 결정하는 것은 개발자의 맡입니다. 자세한 내용은 URI 처리 활성화을 참조하세요.
- 필수 및 선택적 속성 집합(예: 제목, 설명 또는 적응형 카드 요소)으로 구성된 시각적 데이터를 사용하면 사용자가 활동을 시각적으로 식별할 수 있습니다. 활동에 대한 어댑티브 카드 비주얼을 만드는 방법에 대한 지침은 아래를 참조하세요.
- 콘텐츠 메타데이터는 특정 컨텍스트에서 활동을 그룹화하고 검색하는 데 사용할 수 있는 JSON 데이터입니다. 일반적으로 http://schema.org 데이터의 형태를 사용합니다. 이 데이터 작성에 대한 지침은 아래를 참조하세요.
적응형 카드 디자인 지침
타임라인에 활동이 나타날 때, 이는 적응형 카드 프레임워크 을 사용하여 표시됩니다. 개발자가 각 활동에 적응형 카드를 제공하지 않으면 타임라인은 앱 이름/아이콘, 필수 제목 필드 및 선택적 설명 필드를 기반으로 간단한 카드를 자동으로 만듭니다.
앱 개발자는 간단한 적응형 카드 JSON 스키마를 사용하여 사용자 지정 카드를 제공하는 것이 좋습니다. 적응형 카드 개체를 생성하는 방법에 대한 기술 지침은 적응형 카드 설명서 참조하세요. 사용자 활동에서 적응형 카드를 디자인하려면 아래 지침을 참조하세요.
- 이미지 사용
- 가능한 경우 각 작업에 고유한 이미지를 사용합니다. 애플리케이션 이름 및 아이콘이 자동으로 활동 카드 옆에 표시됩니다. 추가 이미지는 사용자가 찾고 있는 활동을 찾는 데 도움이 됩니다.
- 이미지에는 사용자가 읽을 것으로 예상되는 텍스트가 포함되어서는 안 됩니다. 접근성이 필요한 사용자는 이 텍스트를 사용할 수 없으며 검색할 수 없습니다.
- 이미지에 텍스트가 없고 약 2:1 비율로 잘라낼 수 있는 경우 배경 이미지로 사용해야 합니다. 타임라인에서 눈에 띄게 강조된 활동 카드가 생성됩니다. 이미지가 약간 어둡게 표시되어 텍스트가 카드에 계속 표시되도록 하며, 작은 텍스트가 읽기 어려울 수 있으므로 이 경우 활동 이름만 사용하는 것이 좋습니다.
- 이미지를 2:1로 잘라낼 수 없는 경우 활동 카드 내에 배치해야 합니다.
- 가로 세로 비율이 정사각형 또는 세로인 경우, 이미지를 카드의 오른쪽에 여백 없이 고정합니다.
- 가로 세로 비율이 가로로 설정된 경우 이미지를 카드의 오른쪽 위 모서리에 배치하세요.
- 각 활동은 항상 표시되어야 하는 활동 이름을 제공해야 합니다.
- 이 이름은 큰 굵게 표시된 텍스트 옵션을 사용하여 카드의 왼쪽 위 모서리에 표시되어야 합니다. Cortana 시나리오에서 활동이 표시될 때 사용자에게 표시되는 유일한 부분이므로 이름을 쉽게 인식할 수 있는 것이 중요합니다. 타임라인에 동일한 이름을 표시하면 사용자가 많은 수의 활동을 더 쉽게 찾아볼 수 있습니다.
- 사용자가 타임라인에서 앱의 활동을 쉽게 찾을 수 있도록 앱의 모든 활동에 동일한 비주얼 스타일을 사용합니다.
- 예를 들어 활동은 모두 동일한 배경색을 사용해야 합니다.
- 추가 텍스트 정보를 아예 사용하지 마세요.
- 카드를 텍스트로 채우지 말고 사용자가 올바른 활동을 찾거나 상태 정보(예: 특정 작업의 현재 진행률)를 반영하는 추가 정보만 사용합니다.
콘텐츠 메타데이터 지침
사용자 활동에는 Windows 및 Cortana가 활동을 분류하고 유추를 생성하는 데 사용하는 콘텐츠 메타데이터도 포함될 수 있습니다. 그런 다음 활동은 위치(사용자가 휴가를 조사하는 경우), 개체(사용자가 무언가를 연구하는 경우) 또는 작업(사용자가 다른 앱 및 웹 사이트에서 특정 제품을 쇼핑하는 경우)과 같은 특정 토픽을 기준으로 그룹화할 수 있습니다. 활동에 관련된 명사와 동사를 모두 나타내는 것이 좋습니다.
다음 예제에서 콘텐츠 메타데이터 JSON은 Schema.org표준에 따라 "John이 Steve와 함께 Angry Birds를 연주했습니다."라는 시나리오를 나타냅니다.
// John played angry birds with Steve.
{
"@context": "http://schema.org",
"@type": "PlayAction",
"agent": {
"@type": "Person",
"name": "John"
},
"object": {
"@type": "MobileApplication",
"name": "Angry Birds."
},
"participant": {
"@type": "Person",
"name": "Steve"
}
}
주요 API
관련 항목
- 사용자 활동(프로젝트 로마 문서)
- 적응형 카드
- 적응형 카드 시각화 도우미를 샘플
- URI 활성화 처리하기
- Microsoft Graph