DeviceCapability(Windows 10)

아티클
02/01/2024

패키지에 필요한 디바이스 기능을 선언합니다. 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>

키

{} 특정 발생 범위

특성 및 요소

특성

attribute	Description	데이터 형식	필수	기본값
이름	친숙한 이름 또는 디바이스 인터페이스 클래스 GUID로 지정된 디바이스 기능의 이름입니다.	길이가 1~50자인 문자열이거나 xxxxxxxx-xxxx-xxxx-xxxx-xxxx 형식의 GUID입니다.	예

자식 요소

자식 요소	Description
디바이스	DeviceCapability와 연결된 디바이스에 대한 함수를 선언합니다. Windows 10.0.10240.0에서 DeviceCapability는 최대 100개의 디바이스 요소를 포함할 수 있습니다. Windows 10.0.10586.0에서는 최대 1000을 포함할 수 있습니다(자세한 내용은 DeviceCapability 참조).

부모 요소

부모 요소	Description
Capabilities	패키지에 필요한 보호된 사용자 리소스에 대한 액세스를 선언합니다. Capabilities 요소에는 여러 DeviceCapability 및 Capability 요소가 있을 수 있지만 모든 DeviceCapability 요소는 기능 요소 뒤를 따라야 합니다.

설명

Name 특성이 GUID로 지정되면 GUID로 유효성이 검사됩니다.

앱에는 기본적으로 일부 디바이스에 대한 액세스 권한이 부여됩니다. 다른 유형의 디바이스에 액세스하려면 DeviceCapability 요소를 사용하여 디바이스를 지정해야 합니다. 일부 디바이스 기능은 패키지 매니페스트에 수동으로 추가해야 합니다. 자세한 내용은 패키지 매니페스트에 장치 접근 권한 값을 지정하는 방법을 참조하세요.

기능 선언에 대한 자세한 내용은 앱 기능 선언을 참조하세요.

다음 디바이스 기능에는 자식 요소가 필요합니다.

디바이스 기능	Description
Usb	Windows.Devices.Usb 네임스페이스의 API에 대한 액세스를 제공합니다. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 USB 디바이스에 대한 앱 매니페스트 패키지 업데이트를 참조하세요.
humaninterfacedevice	Windows.Devices.HumanInterfaceDevice 네임스페이스의 API에 대한 액세스를 제공합니다. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 HID 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.
bluetooth.genericAttributeProfile	Windows.Devices.Bluetooth.GenericAttributeProfile 네임스페이스의 API에 대한 액세스를 제공합니다. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 Bluetooth 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.
bluetooth.rfcomm	Windows.Devices.Bluetooth.Rfcomm 네임스페이스의 API에 대한 액세스를 제공합니다. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 Bluetooth 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.

예제

다음은 Windows 10.0.10240.0 및 10.0.10586.0 모두에서 작동하는 기능 노드의 예입니다(Windows 10.0.10240.0은 디바이스> 요소만 구문 분석<하지만). 반면 Windows 10.0.10586.0은 최대 100 < 을 지원합니다. 총 1,000개의 보완을 위한 디바이스> 요소와 <f2:Device> 요소

<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> 요소만 필요합니다<.

자세한 예제는 패키지 매니페스트에서 디바이스 기능을 지정하는 방법을 참조하세요.

참고 항목

앱 기능 선언

패키지 매니페스트에서 디바이스 접근 권한 값을 지정하는 방법

요구 사항

항목	값
Namespace	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`