Beschikbaarheid van een app-actie voor Windows in-/uitschakelen

Een Windows-app-actieprovider kan opgeven dat een of meer van de acties momenteel niet beschikbaar zijn. Deze functie maakt scenario's mogelijk, zoals het vereisen van een aanmelding of abonnement voordat een actie beschikbaar wordt gesteld aan de gebruiker.

Initiële beschikbaarheid instellen

U kunt de initiële beschikbaarheidsstatus van een app-actie opgeven door een waarde op te geven voor het veld isAvailable in het JSON-bestand van de actiedefinitie. De waarde is optioneel en is standaard ingesteld op true. In het volgende voorbeeld ziet u het gebruik van het veld isAvailable om een app-actie direct na de installatie niet beschikbaar te maken.

"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,
    ...

Zie het JSON-schema van de actiedefinitie voor app-acties in Windows voor meer informatie.

De beschikbaarheidsstatus tijdens runtime wijzigen

Registreer een wijziging in de beschikbaarheidsstatus van een of meer geregistreerde acties bij het systeem door ActionRuntime.SetActionAvailability aan te roepen.

void SetActionAvailability(bool actionIsAvailable)
{

    using (ActionRuntime runtime = new ActionRuntime())
    {
        runtime.SetActionAvailability("ExampleActionProvider.SendMessage", actionIsAvailable);
    }

}