Share via


알림 메시지를 옵트인(opt in)하는 방법(Windows 런타임 앱)

[ 이 문서는 Windows 런타임 앱을 작성하는 Windows에서 8.x 및 Windows Phone 8.x 개발자를 대상으로 합니다. Windows 10용으로 개발하는 경우에는 최신 설명서를 참조하세요.]

참고  JavaScript를 사용하지 않는 경우 알림 메시지를 옵트인(opt in)하는 방법(XAML)을 참조하세요.

 

이 항목에서는 앱이 알림 메시지를 발생시킬 수 있도록 지정하는 방법에 대해 설명합니다.

알아야 할 사항

기술

  • Windows Runtime

사전 요구 사항

이 항목을 이해하기 위해 필요한 항목은 다음과 같습니다.

  • 알림 메시지 용어와 개념에 대한 기본 지식 자세한 내용은 알림 메시지 개요를 참조하세요.
  • 알림 XML 스키마를 사용한 경험 및 XML과 DOM(문서 개체 모델) API를 통한 XML 조작을 사용한 일반적인 경험. 자세한 내용은 알림 스키마를 참조하세요.

지침

단계 1: 알림 메시지 접근 권한 값 선언

알림 메시지를 사용하는 접근 권한 값은 앱의 package.appxmanifest 파일에 선언되어 있습니다. Microsoft Visual Studio 매니페스트 편집기를 사용하는 경우 응용 프로그램 탭의 알림 섹션에서 알림 가능 옵션을 "예"로 설정하기만 하면 됩니다.

다음 예제에서는 이 옵션 선택의 결과로 package.appxmanifest 파일에 삽입된 XML을 보여 줍니다. ToastCapable 특성이 매니페스트의 VisualElements 요소에 추가됩니다.

또한 이 예제에서는 Visual Studio 외부에서 package.appxmanifest 파일을 직접 만드는 경우 추가하는 내용을 보여 줍니다. 자세한 내용은 수동으로 패키지 매니페스트를 만드는 방법을 참조하세요. Visual Studio 옵션이 "예"이면 package.appxmanifest 파일에는 "true"로 작성됩니다.


<VisualElements 
    ...
    ToastCapable="true">
</VisualElements>

단계 2: 알림 메시지의 배경색 및 텍스트 색 선언(Windows만 해당)

알림 메시지의 배경색 및 연하거나 진한 텍스트 색을 선언할 수 있습니다. 이 설정은 타일에도 적용됩니다.—알림 메시지와 타일 알림의 배경색 및 텍스트 색은 항상 연결되어 있습니다.

Visual Studio 매니페스트 편집기를 사용할 경우 시각적 자산 탭에서 전경 텍스트 옵션을 선택합니다. 배경색 옵션을 W3DC 색 문자열(예: "#FFFFFF")로 설정하세요.

참고  Windows Phone 스토어 앱에서는 텍스트 색이나 배경색을 설정할 수 없습니다. 알림 배경색은 사용자가 설정에서 선택할 수 있는 시스템 테마 컬러이며 텍스트는 항상 밝은색입니다.

다음 예제에서는 이 옵션 선택의 결과로 package.appxmanifest 파일에 삽입된 XML을 보여 줍니다. ForegroundText 및 BackgroundColor 특성이 매니페스트의 VisualElements 요소에 추가됩니다.


<VisualElements 
    ...
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF">
</VisualElements>

단계 3: 로고 이미지 지정

알림 메시지가 발생한 앱을 사용자에게 알리기 위해 앱의 작은 로고 이미지가 각 알림 메시지의 오른쪽 아래에 표시됩니다.

참고  Windows Phone 8.1에서는 이 로고 이미지를 사용하지 않습니다. 타일에는 매니페스트에 지정된 앱의 표시 이름만 표시되거나 아무 것도 표시되지 않습니다.

Visual Studio 매니페스트 편집기를 사용할 경우 시각적 자산 탭에서 정사각형 30x30 로고(Windows) 또는 정사각형 44x44 로고(Windows Phone) 이미지 경로를 설정합니다. 지정한 이미지가 앱 패키지에 포함되어 있어야 합니다.

다음 예제에서는 이 옵션 선택의 결과로 package.appxmanifest 파일에 삽입된 XML을 보여 줍니다. SmallLogo 특성이 매니페스트의 VisualElements 요소에 추가됩니다.


<VisualElements 
    ...
    SmallLogo="images\smallTile-sdk.png">
</VisualElements>

설명

위의 단계를 완료하면 앱이 알림 메시지를 사용자에게 보낼 수 있습니다.

전체 예제

다음 예에서는 이 항목에 설명된 특성을 포함하여 package.appxmanifest 파일에 있는 샘플 Windows 앱의 VisualElements 요소에 대한 전체 XML을 보여 줍니다.


<VisualElements 
    DisplayName="ToastsSample" 
    Logo="images\squareTile-sdk.png" 
    SmallLogo="images\smallTile-sdk.png" 
    Description="SDK Sample" 
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF" 
    ToastCapable="true">
    <DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
    <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>

관련 항목

알림 메시지 개요

알림 메시지에 대한 지침 및 검사 목록

알림 메시지 샘플