다음을 통해 공유

LaunchAction(ContactLaunchActions에서)

  • 아티클

ContactLaunchActions 콘텐츠 작업을 설명합니다.

요소 계층 구조

<내선 번호>
<연락처>
<ContactLaunchActions>
<LaunchAction>

Syntax

<LaunchAction Verb         = "call" | "map" | "message" | "post" | "videoCall"
              DesiredView? = "default" | "useLess" | "useHalf" | "useMore" | "useMinimum" >

  <!-- Child elements -->
  ServiceId{0,100}

</LaunchAction>

키

? 선택적(0개 또는 1개) {} 특정 발생 범위

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
DesiredView

연락처가 시작될 때 사용할 원하는 화면 공간 크기입니다.

Windows Phone: DesiredView는 Windows Phone 지원되지 않습니다.

이 특성 값은 다음 중 하나일 수 있습니다.

  • default
  • 쓸모 없는
  • useHalf
  • useMore
  • useMinimum
 아니요
동사

앱이 시작될 때 앱에 전달되는 고유 식별자입니다. 앱은 이 문자열을 사용하여 시작을 트리거한 ContactLaunchActions 처리기를 확인할 수 있습니다. 패키지의 애플리케이션별로 고유하며 대/소문자를 구분합니다.

이 특성 값은 다음 중 하나일 수 있습니다.

  • call
  • map
  • message
  • post
  • videoCall
 예

 

자식 요소

자식 요소 Description
ServiceId

연락처 작업에 대한 서비스를 식별합니다.

 

부모 요소

부모 요소 Description
ContactLaunchActions

연락처가 시작될 때 수행할 작업을 선언합니다.

 

다음 요소는 이 요소와 이름이 같지만 콘텐츠나 특성은 다릅니다.

설명

연락처 공급자가 수행하는 시작 작업에 대한 자세한 내용은 ContactLaunchActionVerbs를 참조하세요.

매니페스트는 ContactLaunchActions 콘텐츠 작업에 대해 동사 특성에 대해 이러한 의미 체계 검사를 적용합니다.

  • 동사가매핑되도록 설정된 경우 ServiceId 요소를 선언해서는 안 됩니다. 동사의 다른 모든 값은 ServiceId를 선언해야 합니다.
  • 동사가호출 또는 메시지로 설정된 경우에만 ServiceId를 잘 알려진 값 '전화'로 지정할 수 있습니다.

LaunchAction(ContactLaunchActions의 경우) 정의에는 다음 문이 있습니다.

            <xs:element name="LaunchAction" maxOccurs="50">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="ServiceId" type="CT_ServiceId" minOccurs="0" maxOccurs="100"/>
                </xs:sequence>
                <xs:attribute name="Verb" type="ST_ContactLaunchActionVerbs" use="required"/>
                <xs:attribute name="DesiredView" type="ST_DesiredView" use="optional"/>
                <xs:attributeGroup ref="m:ExtensionBaseAttributes"/>
              </xs:complexType>
              <xs:unique name="Service_Id">
                <xs:selector xpath="m2:ServiceId"/>
                <xs:field xpath="."/>
              </xs:unique>
            </xs:element>

앞의 'ref' 문은 LaunchAction(ContactLaunchActions) 이 다음 확장 기본 특성을 모두 상속한다는 것을 나타냅니다.

  <xs:attributeGroup name="ExtensionBaseAttributes">
    <xs:attribute name="Executable" type="ST_Executable" use="optional"/>
    <xs:attribute name="EntryPoint" type="ST_EntryPoint" use="optional"/>
    <xs:attribute name="RuntimeType" type="ST_ActivatableClassId" use="optional"/>
    <xs:attribute name="StartPage" type="ST_FileName" use="optional"/>
  </xs:attributeGroup>

LaunchAction(ContactLaunchActions에서)은 확장 기본 특성을 허용하므로 XSD 매니페스트 스키마에서 다루지 않는 이러한 의미 체계 유효성 검사가 있습니다.

  • 확장 기본 특성은 다음 규칙을 따라야 합니다.

    • StartPage 특성을 지정한 경우 EntryPoint, Executable 또는 RuntimeType 특성이 지정된 경우 실패합니다.
    • 그렇지 않으면 EntryPoint를 지정하지 않고 Executable 또는 RuntimeType 특성을 지정하면 실패합니다.

  • LaunchAction이 EntryPoint 특성을 정의하는 경우 이 LaunchAction 또는 부모 확장 또는 애플리케이션 요소는 실행 파일 특성을 지정해야 합니다.

요구 사항

값
Namespace http://schemas.microsoft.com/appx/2013/manifest