パッケージ マニフェストでデバイス機能を指定する方法

  • [アーティクル]

Note

Windows 10 については、「 Windows 10 の相違点」を参照してください。

 

Windows ランタイムアプリで必要な各デバイス機能を宣言するには、パッケージマニフェストにDeviceCapability要素と適用可能な子要素を追加します。

重要

デバイスの機能によっては、手動で指定する必要があります。 たとえば、 XML (テキスト) エディターを使用して、USB、ヒューマンインターフェイスデバイス (HID)、Point of Service (POS)、Bluetooth GATT、Bluetooth RFCOMM api のデバイス機能を指定する必要があります。

 

手順 1:

Package.appxmanifest ファイルを開きます。 Microsoft Visual Studio で、 XML (テキスト) エディターを使用してファイルを開きます。 これを行うには、ソリューションエクスプローラーでファイルを右クリックし、[ファイルを開くアプリケーションの起動] をクリックします。 次に、[ XML (テキスト) エディター ] を選択し、[ OK] をクリックします。

手順 2:

デバイス機能ごとに1つの DeviceCapability 要素を追加します。 Capabilities要素には複数のDeviceCapability要素と機能要素を含めることができますが、すべてのDeviceCapability要素は機能要素の後に指定する必要があります。 一部のデバイス機能には複数の子要素が必要であることに注意してください。 詳細については、「 DeviceCapability」を参照してください。

Note

UWP アプリと Windows 8 電話アプリの両方ですべての api を使用できるわけではありません。 各 API でサポートされているデバイスの詳細については、API リファレンスのドキュメントを参照してください。

 

Webcam の例

Webcamデバイス機能の例を次に示します。 このデバイスの機能には、子要素は必要ありません。 Webcam の使用方法の例については、「 オーディオまたはビデオを記録する方法」を参照してください。

<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 にアクセスできます。HumanInterfaceDevice名前空間。 この例では、機能によって特定の関数の任意のデバイスにアクセスできます。 詳しくは、「HID のデバイス機能を指定する方法」をご覧ください。

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

Point of Service (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 の例

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 要素のリファレンス

アプリ機能の宣言