LaunchAction (di ContactLaunchActions)

  • Artikel

Menjelaskan tindakan konten ContactLaunchActions .

Hierarki elemen

<Ekstensi>
<Kontak>
<ContactLaunchActions>
<LaunchAction>

Sintaks

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

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

</LaunchAction>

Kunci

?rentang kemunculan tertentu opsional (nol atau satu) {}

Atribut dan Elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
DesiredView

Jumlah ruang layar yang diinginkan untuk digunakan saat kontak diluncurkan.

Windows Phone: DesiredView tidak didukung untuk Windows Phone.

Atribut ini dapat memiliki salah satu nilai berikut:

  • default
  • Berguna
  • useHalf
  • useMore
  • useMinimum
 Tidak
Kata kerja

Pengidentifikasi unik yang diteruskan ke aplikasi saat diluncurkan. Aplikasi ini dapat menggunakan string ini untuk menentukan handler ContactLaunchActions mana yang memicu peluncurannya. Ini unik per aplikasi dalam paket dan peka huruf besar/kecil.

Atribut ini dapat memiliki salah satu nilai berikut:

  • Panggilan
  • peta
  • pesan
  • Posting
  • videoCall
 Ya

 

Elemen Anak

Elemen Anak Deskripsi
ServiceId

Mengidentifikasi layanan untuk tindakan kontak.

 

Elemen Induk

Elemen Induk Deskripsi
ContactLaunchActions

Menyatakan tindakan yang harus diambil ketika kontak diluncurkan.

 

Elemen berikut memiliki nama yang sama dengan yang ini, tetapi konten atau atribut yang berbeda:

Keterangan

Untuk informasi selengkapnya tentang tindakan peluncuran yang dilakukan penyedia kontak, lihat ContactLaunchActionVerbs.

Manifes memberlakukan pemeriksaan semantik ini untuk atribut Kata Kerja untuk tindakan konten ContactLaunchActions .

  • Jika Kata Kerja diatur ke peta, kata kerja tidak boleh mendeklarasikan elemen ServiceId apa pun. Semua nilai lain untuk Kata Kerja harus mendeklarasikan ServiceId.
  • Hanya jika Kata Kerja diatur ke panggilan atau pesan, apakah kata kerja dapat menentukan ServiceId sebagai nilai 'telepon' terkenal.

Definisi LaunchAction (dalam ContactLaunchActions) memiliki pernyataan berikut:

            <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>

Pernyataan 'ref' sebelumnya menunjukkan bahwa LaunchAction (di ContactLaunchActions) mewarisi semua atribut dasar Ekstensi ini:

  <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>

Karena LaunchAction (dalam ContactLaunchActions) memungkinkan atribut dasar Ekstensi , ini memiliki validasi semantik yang tidak tercakup oleh skema manifes XSD:

  • Atribut dasar ekstensi harus mengikuti aturan ini:

    • Jika atribut StartPage ditentukan, gagal jika atribut EntryPoint, Executable, atau RuntimeType ditentukan.
    • Jika tidak, gagal jika atribut Executable atau RuntimeType ditentukan tanpa EntryPoint yang ditentukan.

  • Jika LaunchAction mendefinisikan atribut EntryPoint , baik LaunchAction ini atau elemen Ekstensi atau Aplikasi induk harus menentukan atribut Yang Dapat Dieksekusi .

Persyaratan

Nilai
Ruang nama http://schemas.microsoft.com/appx/2013/manifest