기본 타일 API

  • 아티클

참고 항목

Lives 타일은 이후 버전의 Windows에서 지원되지 않는 Windows 10 기능입니다. 새 앱의 경우 앱 아이콘에 대한 현재 지침을 따르는 것이 좋습니다.

기본 타일 API를 사용하여 현재 앱이 시작에 고정되었는지 확인하고 앱을 기본 타일에 고정하라고 요청할 수 있습니다.

Important

크리에이터스 업데이트 필요: 기본 타일 API를 사용하려면 SDK 15063을 대상으로 하고 Windows 10 빌드 15063 이상을 실행해야 합니다.

중요 API: StartScreenManager class, ContainsAppListEntryAsync, RequestAddAppListEntryAsync

기본 타일 API를 사용하는 시기

앱의 기본 타일에 적합한 환경을 디자인하는 데 많은 노력을 기울였고, 이제 시작에 고정하도록 사용자에게 요청할 수 있습니다. 하지만 코드를 살펴보기 전에 환경을 디자인할 때 유의해야 할 몇 가지 사항은 다음과 같습니다.

  • 작업에 대한 일반 "라이브 타일 고정" 호출로 앱에서 쉽게 해제할 수 있는 비파괴 UX를 만드세요.
  • 사용자에게 고정을 요청하기 전에 앱의 Live Tile 값을 명확하게 설명합니다.
  • 타일이 이미 고정되어 있거나 디바이스가 이를 지원하지 않는 경우 사용자에게 앱 타일을 고정하도록 요청하지 마세요(자세한 내용은 다음 참조).
  • 사용자에게 앱의 타일을 고정하도록 반복적으로 요청하지 마세요(아마도 짜증이 날 수 있습니다).
  • 명시적인 사용자 상호 작용이 없거나 앱이 최소화되어 있거나 열려 있지 않은 경우 고정 API를 호출하지 마세요.

API가 있는지 여부 확인

앱에서 이전 버전의 Windows 10을 지원하는 경우 해당 기본 타일 API를 사용할 수 있는지 확인해야 합니다. 그러려면 ApiInformation을 사용합니다. 기본 타일 API를 사용할 수 없는 경우 API 호출을 실행하지 마세요.

if (ApiInformation.IsTypePresent("Windows.UI.StartScreen.StartScreenManager"))
{
    // Primary tile API's supported!
}
else
{
    // Older version of Windows, no primary tile API's
}

시작에서 앱을 지원하는지 확인

현재 시작 메뉴와 앱 유형에 따라 현재 시작 화면에 앱을 고정하지 못할 수 있습니다. 예를 들어 IoT 또는 xbox 디바이스는 시작에 고정을 지원하지 않습니다. 따라서 고정 UI를 표시하거나 고정 코드를 실행하기 전에 현재 시작 화면에 대해 앱이 지원되는지 확인해야 합니다. 지원되지 않는 경우 사용자에게 타일을 고정할지 묻는 메시지를 표시하지 마세요.

// Get your own app list entry
// (which is always the first app list entry assuming you are not a multi-app package)
AppListEntry entry = (await Package.Current.GetAppListEntriesAsync())[0];

// Check if Start supports your app
bool isSupported = StartScreenManager.GetDefault().SupportsAppListEntry(entry);

현재 고정되어 있는지 확인

기본 타일이 시작에 현재 고정되어 있는지 확인하려면 ContainsAppListEntryAsync 메서드를 사용합니다.

// Get your own app list entry
AppListEntry entry = (await Package.Current.GetAppListEntriesAsync())[0];

// Check if your app is currently pinned
bool isPinned = await StartScreenManager.GetDefault().ContainsAppListEntryAsync(entry);

기본 타일 고정

기본 타일이 현재 고정되어 있지 않으며 시작에서 타일을 지원하는 경우 기본 타일을 고정할 수 있다는 설명을 사용자에게 표시할 수 있습니다.

참고 항목

앱이 포그라운드에 있는 동안 UI 스레드에서 이 API를 호출해야 합니다. 또한 사용자가 타일 고정에 대한 설명에 대해 예라고 답하는 경우와 같이 기본 타일 고정을 확실히 요청한 후에만 이 API를 호출해야 합니다.

사용자가 단추를 클릭하여 기본 타일을 고정하는 경우 RequestAddAppListEntryAsync 메서드를 호출하여 타일을 시작에 고정하도록 요청합니다. 타일을 시작에 고정할지 다시 묻는 대화 상자가 나타납니다.

타일이 시작에 고정되어 있는지 여부를 나타내는 부울이 반환됩니다. 타일이 이미 고정된 경우 사용자에게 대화 상자를 표시하지 않고 즉시 반환 true 됩니다. 사용자가 대화 상자에서 "아니요"를 클릭하거나 타일을 시작에 고정하는 것이 지원되지 않으면 반환 false됩니다. 그렇지 않으면 사용자가 "예"를 클릭하고 타일이 고정되고 API가 반환 true됩니다.

// Get your own app list entry
AppListEntry entry = (await Package.Current.GetAppListEntriesAsync())[0];

// And pin it to Start
bool isPinned = await StartScreenManager.GetDefault().RequestAddAppListEntryAsync(entry);

리소스