Windows용 앱 작업의 가용성 설정/해제

Windows 앱 작업 공급자는 하나 이상의 작업을 현재 사용할 수 없게 지정할 수 있습니다. 이 기능을 사용하면 사용자가 작업을 사용할 수 있게 되기 전에 로그인 또는 구독을 요구하는 등의 시나리오를 사용할 수 있습니다.

초기 가용성 설정

작업 정의 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를 호출하여 등록된 하나 이상의 작업의 가용성 상태 변경을 시스템에 등록합니다.

void SetActionAvailability(bool actionIsAvailable)
{

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

}