Windows ビルド 22621 以降では、Microsoft Copilot ハードウェア キーまたは Windows キー + C キーが押されたときに起動されるアプリをユーザーが選択できるようにするピッカー UI にアプリを登録できます。
注
Microsoft Copilot ハードウェア キー プロバイダーとして登録するアプリは、シングルウィンドウ アプリとして実装することをお勧めします。
Microsoft Copilot ハードウェア キー アプリ拡張機能
Microsoft Copilot ハードウェア キー プロバイダーとして登録するには、アプリをパッケージ化する必要があります。 アプリのパッケージ化の詳細については、「 Windows アプリでのパッケージ ID の概要」を参照してください。 アプリ パッケージ マニフェスト ファイル Package.appxmanifestは、Windows アプリのさまざまな拡張機能と機能をサポートしています。 アプリ パッケージ マニフェストの形式は、 パッケージ マニフェスト スキーマ リファレンスに記載されているスキーマのセットによって定義されます。 Microsoft Copilot ハードウェア キー プロバイダーは、 uap3:AppExtension 内で登録情報を宣言します。 拡張機能の Name 属性は、"com.microsoft.windows.copilotkeyprovider" に設定する必要があります。
<Package
...
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
...>
<Applications>
<Application...>
...
<Extensions>
<uap3:Extension Category="windows.appExtension">
<uap3:AppExtension Name="com.microsoft.windows.copilotkeyprovider"
Id="MyAppId"
DisplayName="App display name"
Description="App description"
PublicFolder="Public" />
</uap3:Extension>
</Extensions>
...
</Application>
</Applications>
...
</Package>
次の表 uap3:AppExtension では、 uap3:AppExtension 要素の属性について説明します。
| 特性 | 説明 | 必須 |
|---|---|---|
| ID (アイディー) | アプリのアプリ定義識別子。 | イエス |
| 表示名 | Windows Copilot ハードウェア ボタン ピッカー UI に表示されるアプリ名。 | イエス |
| 説明 | Windows Copilot ハードウェア ボタン ピッカー UI に表示されるアプリの説明。 | イエス |
| パブリックフォルダー | ホストがブローカーを介してファイルへの読み取りアクセス権を持つ場所としてインスタンスが宣言するフォルダー。 | イエス |
Windows Copilot ハードウェア キー プロバイダーに署名する
Microsoft Copilot ハードウェア キーのターゲットとして有効にするには、プロバイダー アプリにサインインする必要があります。 アプリのパッケージ化と署名の詳細については、「 Visual Studio でのデスクトップまたは UWP アプリのパッケージ化」を参照してください。
現在の Copilot ハードウェア キー プロバイダーのクエリ
次のレジストリ キーの値を照会して、アプリが Copilot ハードウェア キーと Windows キー + C キーボード ショートカットのユーザーのターゲットであるかどうかを確認します。 詳細については、「 レジストリからのデータの取得」を参照してください。
| レジストリ キー | 説明 | 価値 |
|---|---|---|
| HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\BrandedKeyChoiceType | ユーザーが Copilot キーのターゲットとして検索またはアプリを選択したかどうかを識別します。 値 "AppEnforcedByPolicy" は、Copilot キーのアプリ ターゲットが IT 管理者ポリシーによって設定されていることを示します。 詳細については、「 ポリシー CSP - WindowsAI」を参照してください。 | "Search"、"App"、ポリシーによって強制されたアプリ (AppEnforcedByPolicy) |
| HKEY_CURRENT_USER\Software\Microsoft\Windows\Shell\BrandedKey\AppAumid | キーが現在検索用に構成されている場合でも、最後に構成された Copilot ハードウェア キー プロバイダーのアプリケーション ユーザー モデル ID (AUMID、AppId とも呼ばれます) を識別します。 | AUMIDの一つ。 |
優れたユーザー エクスペリエンスを提供するために、アプリは Copilot ハードウェア キー プロバイダー アプリに対するユーザーの選択を尊重し、ユーザーが選択を変更するための永続的またはノイズの多い要求を表示しないようにする必要があります。
Windows developer