DeviceCapability (Windows 10)
パッケージに必要なデバイス機能を宣言します。 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>
Key
{} 特定の出現範囲
属性と要素
属性
| 属性 | 説明 | データ型 | 必須 | 既定値 |
|---|---|---|---|---|
| 名前 | フレンドリ名またはデバイス インターフェイス クラス GUID として指定されたデバイス機能の名前。 | 長さが 1 ~ 50 文字の文字列、または xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx という形式の GUID。 | はい |
子要素
| 子要素 | 説明 |
|---|---|
| [デバイス] | DeviceCapability に関連付けられているデバイスの関数を宣言します。 Windows 10.0.10240.0 では、DeviceCapability には最大 100 個のデバイス要素を含めることができます。 Windows 10.0.10586.0 では、最大 1000 個を含めることができます (詳細については、DeviceCapability を参照してください)。 |
親要素
| 親要素 | 説明 |
|---|---|
| Capabilities | パッケージに必要な保護されたユーザー リソースへのアクセスを宣言します。 Capabilities 要素には複数の DeviceCapability 要素と Capability 要素を含めることができますが、すべての DeviceCapability 要素は Capability 要素の後に含まれている必要があります。 |
注釈
Name 属性が GUID として指定されている場合は、GUID として検証されます。
アプリには、既定で一部のデバイスへのアクセスが許可されます。 他の種類のデバイスにアクセスするには、 DeviceCapability 要素を使用してデバイスを指定する必要があります。 一部のデバイス機能は、パッケージ マニフェストに手動で追加する必要があります。 詳しくは、「パッケージ マニフェストでデバイス機能を指定する方法」をご覧ください。
機能宣言の詳細については、「 アプリの機能宣言」を参照してください。
次のデバイス機能には、子要素が必要です。
| デバイス機能 | [説明] |
|---|---|
| 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 の両方で動作する Capabilities ノードの例を次に示します (ただし、Windows 10.0.10240.0 ではデバイス>要素のみが解析<されます)。 一方、Windows 10.0.10586.0 は最大 100 < をサポートします。合計補数 1000 のデバイス>要素と <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 |