DeviceCapability(Windows 8.1 대한 확장 스키마)

아티클
07/20/2023

패키지에 필요한 디바이스 기능을 선언합니다.

요소 계층 구조

<DeviceCapability>

구문

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

특성 및 요소

특성

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

자식 요소

없음

부모 요소

이 가장 바깥쪽(문서) 요소는 다른 요소에 포함되지 않을 수 있습니다.

설명

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

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

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

일부 디바이스 기능에는 자식 요소가 필요합니다. 이 표에서는 이름 또는 GUID별로 디바이스 기능을 나열하고 자식 요소가 필요한지 여부를 지정합니다.

디바이스 기능	Description
location	사용자의 현재 위치에 대한 액세스 권한을 제공합니다.
마이크	마이크의 오디오 피드에 대한 액세스 권한을 제공합니다.
proximity	서로 가까이 있는 디바이스 간의 NFC(근거리 통신)에 필요합니다. 근거리 근접성을 사용하여 파일을 보내거나 근접 디바이스에서 앱에 연결할 수 있습니다.
웹캠	카메라의 비디오 피드에 대한 액세스를 제공합니다.
Usb	Windows API에 대한 액세스를 제공합니다. Devices.Usb 네임스페이스. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 USB 디바이스에 대한 앱 매니페스트 패키지 업데이트를 참조하세요.
humaninterfacedevice	Windows API에 대한 액세스를 제공합니다. Devices.HumanInterfaceDevice 네임스페이스. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 HID 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.
bluetooth.genericAttributeProfile	Windows API에 대한 액세스를 제공합니다. 장치. Bluetooth. GenericAttributeProfile 네임스페이스입니다. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 Bluetooth 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.
bluetooth.rfcomm	Windows API에 대한 액세스를 제공합니다. 장치. Bluetooth. Rfcomm 네임스페이스. 이 접근 권한 값에는 자식 요소가 필요합니다. 자세한 내용은 Bluetooth 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.
pointOfService	Windows 통해 POS(Point of Service) 바코드 스캐너 및 자기 줄무늬 판독기 액세스 권한을 제공합니다. Devices.PointOfService 네임스페이스. 이러한 API는 Windows Phone 지원되지 않습니다.
기타 디바이스(GUID로 표시됨)	특수 디바이스 및 Windows 휴대용 디바이스가 포함됩니다.

예

기능 노드의 예는 다음과 같습니다. 자세한 예제는 패키지 매니페스트에서 디바이스 기능을 지정하는 방법을 참조하세요.

<Capabilities>
  <Capability Name="internetClient"/>
  <Capability Name="musicLibrary"/>
  <Capability Name="videosLibrary"/>
  <DeviceCapability Name="microphone"/>
  <DeviceCapability Name="webcam"/>
</Capabilities>

참고 항목

앱 기능 선언

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

요구 사항

	값
Namespace	`http://schemas.microsoft.com/appx/2010/manifest`