Windows アプリ アクション プロバイダーは、1 つ以上のアクションが現在使用できないことを指定できます。 この機能を使用すると、ユーザーがアクションを使用できるようになる前にログインまたはサブスクリプションを要求するなどのシナリオが可能になります。
初期可用性を設定する
アクション定義 JSON ファイルで isAvailable フィールドの値を指定することで、アプリ アクションの初期可用性状態を指定できます。 値は省略可能で、既定値は true です。 次の例は、 isAvailable フィールドを使用して、インストール直後にアプリアクションを使用できないようにする方法を示しています。
"version": 2,
"actions": [
{
"id": "ToDoList.ToDoActionHandler.AddToList",
"description": "Add item to your to-do list",
"icon": "ms-resource://Files/Assets/LockScreenLogo.png",
"usesGenerativeAI": false,
"isAvailable": false,
...
詳細については、「 Windows 上のアプリ アクションのアクション定義 JSON スキーマ」を参照してください。
実行時に可用性の状態を変更する
ActionRuntime.SetActionAvailability を呼び出して、1 つ以上の登録済みアクションの可用性状態の変更をシステムに登録します。
void SetActionAvailability(bool actionIsAvailable)
{
using (ActionRuntime runtime = new ActionRuntime())
{
runtime.SetActionAvailability("ExampleActionProvider.SendMessage", actionIsAvailable);
}
}