Partilhar via


Ativar ou desativar a disponibilidade de uma ação de app para Windows

Um provedor de Ação de Aplicativos Windows pode especificar que uma ou mais de suas ações estão indisponíveis no momento. Esse recurso permite cenários como exigir um login ou assinatura antes que uma ação seja disponibilizada para o usuário.

Definir disponibilidade inicial

Você pode especificar o status de disponibilidade inicial de uma ação do aplicativo fornecendo um valor para o campo isAvailable no arquivo JSON de definição de ação. O valor é opcional e assume como padrão true. O exemplo a seguir ilustra o uso do campo isAvailable para tornar uma ação do aplicativo indisponível imediatamente após a instalação.

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

Para obter mais informações, consulte Esquema JSON de definição de ação para ações de aplicativo no Windows.

Alterar o estado de disponibilidade em tempo de execução

Registre uma alteração no estado de disponibilidade de uma ou mais ações registradas no sistema chamando ActionRuntime.SetActionAvailability.

void SetActionAvailability(bool actionIsAvailable)
{

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

}