DeviceCapability (Windows 10)

  • Статья

Объявляет возможность устройства, необходимую пакету. В Windows 10.0.10240.0 может содержать до 100 элементов устройства. В Windows 10.0.10586.0 может содержать до 1000 (синтаксис и примеры см. в примерах).

Иерархия элементов

<Пакет>

    <Возможности>

         <DeviceCapability>

Синтаксис

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

Клавиши

{} определенный диапазон вхождений

Элементы и атрибуты

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
имя; Имя возможности устройства, указанное в виде понятного имени или GUID класса интерфейса устройства. Строка со значением от 1 до 50 символов длиной или GUID в формате xxxxx-xxxx-xxxx-xxxx-xxxxx-xxxx. Да

Дочерние элементы

Дочерний элемент Описание
Устройство Объявляет функцию для устройства, связанного с DeviceCapability. В Windows 10.0.10240.0 deviceCapability может содержать до 100 элементов Device. На Windows 10.0.10586.0 он может содержать до 1000 (дополнительные сведения см. в разделе DeviceCapability).

Родительские элементы

Родительский элемент Описание
Capabilities Объявляет доступ к защищенным пользовательским ресурсам, необходимым пакету. В элементе Capabilities может быть несколько элементов DeviceCapability и Capability, но все элементы DeviceCapability должны поступать после элементов Capability.

Комментарии

Если атрибут Name указан как GUID, он проверяется как GUID.

Приложения по умолчанию получают доступ к некоторым устройствам. Чтобы получить доступ к другим типам устройств, необходимо указать их с помощью элемента DeviceCapability . Некоторые возможности устройства необходимо добавить в манифест пакета вручную. Дополнительные сведения см. в статье Определение возможностей устройств в манифесте пакета.

Дополнительные сведения об объявлениях возможностей см. в объявлениях возможностей приложений.

Для следующих возможностей устройства требуются дочерние элементы.

Возможность устройства Описание
Usb Предоставляет доступ к API в пространстве имен Windows.Devices.Usb . Для этой возможности необходимы дочерние элементы. Дополнительные сведения см. в разделе "Обновление пакета манифеста приложения" для USB-устройства.
humaninterfacedevice Предоставляет доступ к API в пространстве имен Windows.Devices.HumanInterfaceDevice . Для этой возможности необходимы дочерние элементы. Подробнее: Определение возможностей устройств для HID.
bluetooth.genericAttributeProfile Предоставляет доступ к API в пространстве имен Windows.Devices.Bluetooth.GenericAttributeProfile . Для этой возможности необходимы дочерние элементы. Подробнее: Определение возможностей устройств для Bluetooth.
bluetooth.rfcomm Предоставляет доступ к API в пространстве имен Windows.Devices.Bluetooth.Rfcomm . Для этой возможности необходимы дочерние элементы. Подробнее: Определение возможностей устройств для Bluetooth.

Примеры

Ниже приведен пример узла возможностей, который будет работать в Windows 10.0.10240.0 и 10.0.10586.0 (хотя Windows 10.0.10240.0 будет анализировать <только элементы устройства>). Windows 10.0.10586.0, с другой стороны, поддерживает до 100 < Элементы устройства> плюс <элементы f2:Device> для общего дополнения 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>

Если вы хотите поддерживать только Windows 10.0.10240.0, вам потребуется <только элемент Device>. Если вы хотите поддерживать только Windows 10.0.10586.0, вам потребуется <только элемент f2:Device>.

Дополнительные примеры см. в разделе "Указание возможностей устройств" в манифесте пакета.

См. также раздел

Объявления возможностей приложения

Указание возможностей устройства в манифесте пакета

Требования

Элемент Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/foundation/windows10