如何在套件資訊清單中指定裝置功能

注意

如 Windows 10,請參閱Windows 10 的不同之處。

 

若要宣告 Windows 執行階段應用程式所需的每個裝置功能,請將DeviceCapability元素和適用的子項目新增至封裝資訊清單。

重要

某些裝置功能必須以手動方式指定。 例如,您必須使用XML (Text) Editor來指定 USB、人體介面裝置 (HID) 、服務點 (POS) 、藍牙 GATT 和藍牙 RFCOMM api 的裝置功能。

 

步驟 1:

開啟 Package.appxmanifest 檔案。 在 Microsoft Visual Studio 中,使用XML (文字) 編輯器開啟檔案。 若要這樣做,請在方案總管中,以滑鼠右鍵按一下檔案,然後按一下 [開啟檔案]。 然後,選取 [ XML (Text) 編輯器 ],然後按一下 [確定]

步驟 2:

為每一裝置功能新增一個 DeviceCapability 元素。 您可以在 [功能] 元素中擁有多個DeviceCapability功能元素,但所有DeviceCapability元素都必須在功能元素之後。 請注意,某些裝置功能需要多個子項目。 如需詳細資訊,請參閱 DeviceCapability

注意

並非所有 api 都適用于 UWP 應用程式和 Windows 8. x 電話應用程式。 如需每個 API 支援哪些裝置的詳細資訊,請參閱 API 參考檔。

 

網路攝影機範例

以下是 網路 攝影機裝置功能的範例。 此裝置功能不需要子項目。 如需如何使用網路攝影機的範例,請參閱 如何錄製音訊或影片

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

USB 範例

Usb裝置功能可讓您存取 Windows 中的 api 。裝置. 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 。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>

藍牙 GATT 範例

GenericAttributeProfile裝置功能可讓您存取 Windows 中的 api 。設備。藍牙。GenericAttributeProfile命名空間。 在此範例中,此功能可讓您存取特定功能的任何裝置。 如需詳細資訊,請參閱如何指定藍牙的裝置功能

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

藍牙 RFCOMM 範例

Rfcomm裝置功能可讓您存取 Windows 中的 api 。設備。藍牙。Rfcomm命名空間。 在此範例中,此功能可讓您存取特定功能的任何裝置。 如需詳細資訊,請參閱如何指定藍牙的裝置功能

  <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 元素參考

應用程式功能宣告