DeviceCapability (Windows 10)

  • Artikel

Menyatakan kemampuan perangkat yang diperlukan oleh paket. Pada Windows 10.0.10240.0, dapat berisi hingga 100 elemen Perangkat. Pada Windows 10.0.10586.0, dapat berisi hingga 1000 (untuk sintaks dan contoh, lihat Contoh).

Hierarki elemen

<Paket>

    <Kemampuan>

         <DeviceCapability>

Sintaks

<DeviceCapability
    Name = 'A string with a value between 1 and 50 characters in length or a GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' >

  <!-- Child elements -->
  Device{0,1000}

</DeviceCapability>

Kunci

{} rentang kemunculan tertentu

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Nama Nama kemampuan perangkat, baik yang ditentukan sebagai nama yang mudah diingat atau GUID kelas antarmuka perangkat. String dengan nilai antara 1 dan 50 karakter atau GUID dalam bentuk xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx. Ya

Elemen anak

elemen anak Deskripsi
Perangkat Mendeklarasikan fungsi untuk perangkat yang terkait dengan DeviceCapability. Pada Windows 10.0.10240.0, DeviceCapability dapat berisi hingga 100 elemen Perangkat. Pada Windows 10.0.10586.0, dapat berisi hingga 1000 (untuk detail selengkapnya, lihat DeviceCapability).

Elemen induk

elemen induk Deskripsi
Kemampuan Menyatakan akses ke sumber daya pengguna yang dilindungi yang diperlukan paket. Anda dapat memiliki beberapa elemen DeviceCapability dan Capability dalam elemen Capabilities , tetapi semua elemen DeviceCapability harus muncul setelah elemen Capability .

Keterangan

Jika atribut Name ditentukan sebagai GUID, maka divalidasi sebagai GUID.

Aplikasi diberikan akses ke beberapa perangkat secara default. Untuk mengakses jenis perangkat lain, Anda harus menentukannya menggunakan elemen DeviceCapability . Beberapa kemampuan perangkat harus ditambahkan ke manifes paket secara manual. Untuk informasi selengkapnya, lihat Cara menentukan kemampuan perangkat dalam manifes paket.

Untuk informasi selengkapnya tentang deklarasi kemampuan, lihat Deklarasi kemampuan aplikasi.

Kemampuan perangkat berikut memerlukan elemen anak.

Kemampuan perangkat Deskripsi
Usb Menyediakan akses ke API di namespace Windows.Devices.Usb . Kemampuan ini membutuhkan elemen anak. Untuk informasi selengkapnya, lihat Memperbarui paket manifes aplikasi untuk perangkat USB.
humaninterfacedevice Menyediakan akses ke API di namespace Windows.Devices.HumanInterfaceDevice . Kemampuan ini membutuhkan elemen anak. Untuk informasi selengkapnya, lihat Cara menentukan kemampuan perangkat untuk HID.
bluetooth.genericAttributeProfile Menyediakan akses ke API di namespace Layanan Windows.Devices.Bluetooth.GenericAttributeProfile . Kemampuan ini membutuhkan elemen anak. Untuk informasi selengkapnya, lihat Cara menentukan kemampuan perangkat untuk Bluetooth.
bluetooth.rfcomm Menyediakan akses ke API di namespace Windows.Devices.Bluetooth.Rfcomm . Kemampuan ini membutuhkan elemen anak. Untuk informasi selengkapnya, lihat Cara menentukan kemampuan perangkat untuk Bluetooth.

Contoh

Berikut adalah contoh simpul Kemampuan yang akan berfungsi pada Windows 10.0.10240.0 dan 10.0.10586.0 (meskipun, Windows 10.0.10240.0 hanya akan mengurai <elemen Perangkat>). Windows 10.0.10586.0, di sisi lain, mendukung hingga 100 < Elemen perangkat> ditambah <elemen f2:Device> untuk total pelengkap 1000.

<Package
    xmlns:f2="http://schemas.microsoft.com/appx/manifest/foundation/windows10/2">
...
<Dependencies>
    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.10240.0" MaxVersionTested="10.0.10586.0"/>
</Dependencies>
...
<Capabilities>
    <DeviceCapability Name="microphone"/>
    <DeviceCapability Name="webcam"/>
    <DeviceCapability Name="<name>">
        <Device Id="id_000" ... />
        ...
        <Device Id="id_099" ... />
        <f2:Device Id="id_100" ... />
        ...
        <f2:Device Id="id_999" ... />
    </DeviceCapability>
</Capabilities>

Jika Anda hanya ingin mendukung Windows 10.0.10240.0, maka Anda hanya memerlukan <elemen Perangkat>. Jika Anda hanya ingin mendukung Windows 10.0.10586.0, maka Anda hanya memerlukan <elemen f2:Device>.

Untuk contoh selengkapnya, lihat Cara menentukan kemampuan perangkat dalam manifes paket.

Lihat juga

Deklarasi kemampuan aplikasi

Cara menentukan kemampuan perangkat dalam manifes paket

Persyaratan

Item Nilai
Ruang nama http://schemas.microsoft.com/appx/manifest/foundation/windows10