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

  • 아티클

참고

Windows 10 Windows 10 다른 내용을 참조하세요.

 

Windows 런타임 앱에 필요한 각 디바이스 기능을 선언하려면 DeviceCapability 요소 및 해당 자식 요소를 패키지 매니페스트에 추가합니다.

중요

일부 디바이스 기능은 수동으로 지정해야 합니다. 예를 들어 XML(텍스트) 편집기를 사용하여 USB, HID(휴먼 인터페이스 디바이스), POS(서비스 지점), Bluetooth GATT 및 Bluetooth RFCOMM API에 대한 디바이스 기능을 지정해야 합니다.

 

1단계:

Package.appxmanifest 파일을 엽니다. Microsoft Visual Studio XML(텍스트) 편집기를 사용하여 파일을 엽니다. 이렇게 하려면 솔루션 탐색기 파일을 마우스 오른쪽 단추로 클릭하고 [열기]를 클릭합니다. 그런 다음 XML(텍스트) 편집기를 선택하고 확인을 클릭합니다.

2단계:

디바이스 기능당 하나의 DeviceCapability 요소를 추가합니다. Capabilities 요소에는 여러 DeviceCapability 및 Capability 요소가 있을 수 있지만 모든 DeviceCapability 요소는 Capability 요소 뒤를 따라야 합니다. 일부 디바이스 기능에는 여러 자식 요소가 필요합니다. 자세한 내용은 DeviceCapability를 참조하세요.

참고

UWP 앱과 Windows 8.x 전화 앱 모두에서 모든 API를 사용할 수 있는 것은 아닙니다. 각 API에서 지원되는 디바이스에 대한 자세한 내용은 API 참조 설명서를 참조하세요.

 

웹캠 예제

다음은 웹캠 디바이스 기능의 예입니다. 이 디바이스 기능에는 자식 요소가 필요하지 않습니다. 웹캠을 사용하는 방법의 예는 오디오 또는 비디오를 녹음하는 방법을 참조하세요.

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

USB 예제

usb 디바이스 기능을 사용하면 Windows API에 액세스할 수 있습니다. Devices.Usb 네임스페이스. 자세한 내용은 USB 디바이스에 대한 앱 매니페스트 패키지 업데이트를 참조하세요.

<DeviceCapability Name="usb">
    <Device Id="vidpid:xxxx xxxx">
      <Function Type="classId:xx xx xx"/>
      <Function Type="name:xxxxx"/>
      <Function Type="winUsbId:xxxxx"/>
    </Device>
</DeviceCapability>

HID(휴먼 인터페이스 디바이스) 예제

humaninterfacedevice 디바이스 기능을 사용하면 Windows API에 액세스할 수 있습니다. Devices.HumanInterfaceDevice 네임스페이스. 이 예제에서는 이 기능을 통해 특정 함수의 모든 디바이스에 액세스할 수 있습니다. 자세한 내용은 HID 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.

<DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:xxxx xxxx"/>
    </Device>
</DeviceCapability>

POS(서비스 지점) 예제

pointOfService 장치 접근 권한 값은 Windows.Devices.PointOfService 네임스페이스에서 API 액세스를 가능하게 합니다. 이 디바이스 기능에는 자식 요소가 필요하지 않습니다.

<Capabilities>
  <DeviceCapability Name="pointOfService"/>
</Capabilities>

Bluetooth GATT 예제

bluetooth.genericAttributeProfile 디바이스 기능을 사용하면 Windows API에 액세스할 수 있습니다. 장치. Bluetooth. GenericAttributeProfile 네임스페이스입니다. 이 예제에서는 이 기능을 통해 특정 함수의 모든 디바이스에 액세스할 수 있습니다. 자세한 내용은 Bluetooth 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.

  <Capabilities>
    <m2:DeviceCapability Name="bluetooth.genericAttributeProfile">
      <m2:Device Id="any">
        <m2:Function Type="name:xxxxxx"/>
      </m2:Device>
    </m2:DeviceCapability>
  </Capabilities>

Bluetooth RFCOMM 예제

bluetooth.rfcomm 디바이스 기능을 사용하면 Windows API에 액세스할 수 있습니다. 장치. Bluetooth. Rfcomm 네임스페이스. 이 예제에서는 이 기능을 통해 특정 함수의 모든 디바이스에 액세스할 수 있습니다. 자세한 내용은 Bluetooth 관련 장치 접근 권한 값을 지정하는 방법을 참조하세요.

  <Capabilities>
    <m2:DeviceCapability Name="bluetooth.rfcomm">
      <m2:Device Id="any">
        <m2:Function Type="serviceId:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"/>
      </m2:Device>
    </m2:DeviceCapability>
  </Capabilities>

디바이스, 센서 및 전원

DeviceCapability 요소 참조

앱 기능 선언