Edit

Share via


Recall overview

Recall utilizes Windows Copilot Runtime to help you find anything you've seen on your PC. Search using any clues you remember or use the timeline to scroll through your past activity, including apps, documents, and websites. Once you've found what you're looking for, you can quickly jump back to the content seen in the snapshot by selecting the relaunch button below the screenshot. The UserActivity API is what allows apps to provide deep links, so you can pick up where you left off.

Click to Do is an AI-supported feature that utilizes the local Phi Silica model in Copilot+ PCs to connect actions to the content (text or images) found by Recall. For example, a video that you watched featured a person wearing a shirt that you like. You can find that video and where the shirt shows up using Recall. Click to Do will then offer the option to search using Bing for where you might buy that shirt online. Developers will be able to launch Click to Do from their app using a URI scheme.

Learn more about Click to Do or find how to Launch Click to Do from your app using a URI.

Learn more about Recall, including:

  • System Requirements
  • How to use Recall
  • How to search with Recall
  • How content interaction (with "Screenray") works
  • How to pause or resume snapshots
  • How to filter certain websites or apps from being saved by Recall
  • How to manage Recall snapshots and disk space
  • Keyboard shortcuts

Learn more about Privacy and control over your Recall experience, including:

  • Controls on how to manage your Recall and snapshots preferences
  • How to filter apps and websites from your snapshots
  • How snapshot storage works (content stays local)
  • Built-in security included with the secured-core PC, Microsoft Pluton security processor, and Windows Hello Enhanced Sign-in Security (ESS)

For IT Administrators, learn how to Manage Recall using Windows Client Management, including:

  • System requirements
  • Supported browsers
  • How to configure policies for Recall
  • Limitations
  • User controlled settings for Recall
  • Storage allocation
  • Policy setting for control over whether Windows saves snapshots of the screen and analyzes user activity on the device: DisableAIDataAnalysis

Recall updates:

Prerequisites

To utilize Recall and Click to Do, the following requirements must be met:

To utilize Recall and Click to Do in you Windows app:

  • This is not yet available. This support will ship in an upcoming experimental channel release of the Windows App SDK.
  • User Activity is supported in Windows SDK version 10.0.17134.0 (Windows 10, version 1803, Build 17134) or later.

Launch Click to Do

To launch the Click to Do feature on a Copilot+ PC from your app, you can utilize the following URI scheme: ms-recall://default/?screenray.

Currently, for Click to Do to function, the Recall feature must be enabled on the Copilot+ PC. See the "User choice from the start" section of Privacy and control over your Recall experience for guidance on enabling or disabling Recall in the Privacy & security section of Windows Settings.

The ms-recall://default/?screenray URI enables your app to programmatically launch Click to Do, placing an interactive overlay on top of the PC screen. This overlay suggests quick actions to appear for images or text. The analysis of the screen is always performed locally on the device. Content is only shared if the user chooses to complete an action. Content is not saved, nor is it automatically passed back to the app used to open the overlay. This URI does not accept any additional parameters.

The following code samples open Click to Do from the user’s app:

winrt::Windows::Foundation::Uri clickToDoUri(L"ms-recall://default/?screenray"); 

winrt::Windows::System::Launcher::LaunchUriAsync(clickToDoUri); 
var clickToDoUri = new Windows.Foundation.Uri(L"ms-recall://default/?screenray"); 

Windows.System.Launcher.LaunchUriAsync(clickToDoUri) 

Use Recall in your Windows app

For those who opt-in by enabling "Recall & snapshots" in Settings > Privacy & security, Windows will regularly save snapshots of the customer's screen and stores them locally. Using screen segmentation and image recognition, Windows provides the power to gain insight into what is visible on the screen. As a Windows application developer, you will now be able to offer your app users the ability to semantically search these saved snapshots and find content related to your app. Each snapshot has a UserActivity associated that enables the user to relaunch the content.

Screenshot of the Recall interface showing a Redbarn Sale Analysis app sample.

User Activities

A UserActivity refers to something specific the user was working on within your app. For example, when a user is writing a document, a UserActivity could refer to the specific place in the document where the user left off writing. When listening to a music app, the UserActivity could be the playlist that the user last listened to. When drawing on a canvas, the UserActivity could be where the user last made a mark. In summary, a UserActivity represents a destination within your Windows app that a user can return to so that they can resume what they were doing.

To engage with a UserActivity your Windows app would call: UserActivity.CreateSession. The Windows operating system responds by creating a history record indicating the start and end time for that UserActivity. Re-engaging with that same UserActivity over time will result in multiple history records being stored for it.

More information about how to engage with User Activities using Recall is coming soon.