Condividi tramite

Panoramica delle azioni dell'app in Windows

Le azioni delle app in Windows sono singole unità di comportamento che un'app di Windows può implementare e registrare in modo da poter accedere da altre app ed esperienze, integrando facilmente nei flussi di lavoro degli utenti.

Che cos'è un'azione dell'app?

Un'azione dell'app è un'unità atomica di funzionalità. Le app compilano e registrano azioni e quindi Windows o altre app possono consigliare azioni registrate all'utente in orari e posizioni contestualmente rilevanti all'interno del flusso di lavoro dell'utente. 

Implementazione dell'azione dell'applicazione

Le azioni possono essere implementate gestendo l'attivazione dell'URI o tramite l'attivazione COM implementando l'interfaccia IActionProvider . Per una procedura dettagliata sull'implementazione di un semplice provider di azioni dell'app tramite l'attivazione URI, vedere Introduzione alle azioni dell'app in Windows.

Le app devono avere un'identità del pacchetto per registrare un'azione dell'app. Il manifesto del pacchetto MSIX fornisce metadati sulle azioni supportate dall'app del provider. Per ulteriori informazioni sulla sintassi del manifesto del pacchetto dell'app per la registrazione di azioni app, vedere actions-provider-manifest.md.

Le azioni vengono definite usando un formato JSON che fornisce metadati su una o più azioni, che includono informazioni come l'identificatore univoco e la descrizione per l'azione, nonché l'elenco di input e output su cui opera l'azione. Il file di definizione dell'azione JSON viene creato in un pacchetto con l'app del provider come contenuto. Il percorso del file all'interno del pacchetto viene specificato nel manifesto del pacchetto dell'app in modo che il sistema possa trovare e inserire le definizioni di azione. Per ulteriori informazioni sul formato JSON per la dichiarazione delle azioni, vedere lo schema JSON di definizione delle azioni per i provider di azioni di Windows.

Un'entità è un oggetto su cui opera un'azione dell'app. Le azioni accettano le entità come input e possono restituire entità come output. Le entità sono suddivise in sottotipi per rappresentare diversi tipi di contenuto su cui un'azione può operare, ad esempio Documento, Foto e Testo. Ogni tipo di entità ha un set di proprietà che forniscono informazioni correlate a ogni tipo di contenuto, ad esempio il percorso o l'estensione di un file. Le entità vengono espresse come JSON nel file JSON di definizione dell'azione per dichiarare gli input e gli output di un'azione dell'app. Sono disponibili anche un set di API WinRT che rappresentano le entità per l'uso delle entità nel codice. Per ulteriori informazioni, vedere il Namespace Windows.AI.Actions.

Note sull'IA responsabile

Quando si creano azioni supportate dall'intelligenza artificiale, è responsabilità dell'autore dell'azione eseguire il monitoraggio della moderazione e dell'abuso del contenuto quando si tratta di entità restituite all'utente. Per altre informazioni sui criteri di intelligenza artificiale responsabile Microsoft per altre informazioni, vedere Microsoft Responsible AI: Principles and approach (Intelligenza artificiale responsabile Microsoft: Principi e approccio)

Annotazioni

Valutare se i bambini dovrebbero avere accesso all'azione utilizzando la proprietà 'contentAgeRating' nel formato JSON della definizione dell'azione.

Le azioni dell'app sono destinate a fornire unità atomiche di funzionalità applicabili a scenari e flussi di lavoro all'esterno dell'app del provider. Ad esempio, un'azione potrebbe tradurre una parte di testo o elaborare un'immagine. Per gli scenari interamente specifici dell'app di Windows che implementa il comportamento, il percorso consigliato consiste nell'implementare un punto di estendibilità personalizzato con un'estensione dell'app. Per altre informazioni, vedere Creare e ospitare un'estensione dell'app.

L'elenco seguente descrive alcuni tipi di funzionalità che possono rendere validi candidati per l'implementazione come azione.

  • Funzionalità ampiamente applicabili e riutilizzabili. La funzionalità è destinata all'individuazione e al riutilizzo in più app o contesti (ad esempio, operazioni sui file, stampa).
  • Altre app possono comporre ed estendere le funzionalità.
  • La funzionalità dipende dal contesto e deve essere individuata dinamicamente in fase di esecuzione (ad esempio, la visualizzazione di comandi specifici del contesto in un'interfaccia utente).
  • La funzionalità si integra con gli strumenti di sistema esistenti o altri ecosistemi di app.
  • La funzionalità semplifica l'interazione dell'utente incapsulando attività complesse in un'unica azione di livello superiore , ad esempio l'automazione basata sull'utente.
  • La funzionalità può funzionare indipendentemente dal controllo interno dell'app e non deve seguire protocolli rigorosi specifici dell'app.
  • La funzionalità dovrebbe essere individuabile e richiamata in modo uniforme tra varie parti del sistema o altre app (ad esempio, un'API per modificare i file o condividere il contenuto).