Swift Academy · Lezione

App Intents e Shortcuts

Renda disponibili le azioni per Siri e Shortcuts.

Lezione 4 di 413 passaggi

App Intents e Shortcuts è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 4 lezioni in totale.

Cosa sono gli App Intents

Il framework App Intents espone le azioni dell'app al sistema: Siri, Shortcuts, Spotlight, widget e il pulsante Azione. Descriva un'azione una sola volta come tipo Swift e sarà disponibile ovunque, attivabile con la voce e automatizzabile.

import AppIntents
// Define an action as a type; the system can run it
// from Siri, Shortcuts, Spotlight, widgets, etc.

Definizione di un AppIntent

Un intent è conforme a AppIntent, dichiara un title rivolto all'utente e implementa perform(), che esegue il lavoro e restituisce un risultato. Il framework lo rileva automaticamente: non è necessaria alcuna registrazione.

import AppIntents
struct AddTaskIntent: AppIntent {
    static var title: LocalizedStringResource = "Add Task"
    func perform() async throws -> some IntentResult {
        // create the task here
        return .result()
    }
}

Parametri

Utilizzi il property wrapper @Parameter per chiedere all'utente (o a Siri) un input. Il sistema richiede i valori mancanti e li convalida. Ogni parametro ha un title mostrato nell'editor di Shortcuts.

import AppIntents
struct AddTaskIntent: AppIntent {
    static var title: LocalizedStringResource = "Add Task"
    @Parameter(title: "Title")
    var taskTitle: String
    func perform() async throws -> some IntentResult {
        return .result()
    }
}

Restituire valori e dialoghi

Un intent può restituire dati e pronunciare una conferma. Le varianti di IntentResult, come .result(value:dialog:), consentono di restituire un valore tipizzato insieme a un dialogo parlato o visibile che Siri riproduce all'utente.

import AppIntents
struct CountTasksIntent: AppIntent {
    static var title: LocalizedStringResource = "Count Tasks"
    func perform() async throws
        -> some IntentResult & ProvidesDialog {
        let count = 5
        return .result(
            dialog: "You have \(count) tasks")
    }
}

Riepilogo dei parametri

parameterSummary descrive la frase visualizzata nell'editor di Shortcuts, inserendo i parametri in un linguaggio naturale, come Add \(taskTitle) to my list. In questo modo l'azione risulta chiara quando viene combinata in una scorciatoia.

import AppIntents
struct AddTaskIntent: AppIntent {
    static var title: LocalizedStringResource = "Add Task"
    @Parameter(title: "Title") var taskTitle: String
    static var parameterSummary: some ParameterSummary {
        Summary("Add \(\.$taskTitle) to my list")
    }
    func perform() async throws -> some IntentResult {
        .result()
    }
}

Entità

Un AppEntity rappresenta un oggetto del modello su cui il sistema può ragionare: un'attività, una nota o una playlist. Con un'entità e una query, Siri e Shortcuts possono consentire agli utenti di scegliere un elemento dei Suoi dati come valore di un parametro.

import AppIntents
struct TaskEntity: AppEntity {
    static var typeDisplayRepresentation:
        TypeDisplayRepresentation = "Task"
    var id: String
    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "\(id)")
    }
    static var defaultQuery = TaskQuery()
}

Query delle entità

Un EntityQuery indica al sistema come trovare le entità tramite ID e come elencare i suggerimenti. È alla base del selettore visualizzato quando l'utente sceglie un valore in Shortcuts o risponde a Siri.

import AppIntents
struct TaskQuery: EntityQuery {
    func entities(for ids: [String]) async throws
        -> [TaskEntity] {
        ids.map { TaskEntity(id: $0) }
    }
    func suggestedEntities() async throws -> [TaskEntity] {
        [TaskEntity(id: "Groceries")]
    }
}

App Shortcuts

Un AppShortcut rende un intent eseguibile a voce senza alcuna configurazione: l'utente non deve prima creare una scorciatoia. È necessario fornire frasi di attivazione che includano il token del nome dell'app, così Siri conosce il contesto.

import AppIntents
struct AddTaskShortcut: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: AddTaskIntent(),
            phrases: ["Add a task in \(.applicationName)"],
            shortTitle: "Add Task",
            systemImageName: "plus")
    }
}

Frasi di attivazione

Le frasi devono contenere \(.applicationName), così Siri può distinguere il contesto. Fornisca diverse varianti naturali che gli utenti potrebbero pronunciare. Il sistema gestisce la corrispondenza, quindi non deve analizzare personalmente la lingua.

import AppIntents
// Provide variants; applicationName is required:
// phrases: [
//   "Add a task in \(.applicationName)",
//   "Create a task with \(.applicationName)",
//   "New \(.applicationName) task"
// ]
let phrases = "include applicationName token"
_ = phrases

Disponibili oltre Siri

Poiché gli intent sono dichiarativi, lo stesso AddTaskIntent può alimentare un widget interattivo Button(intent:), un controllo di Control Center o un'azione di Shortcuts: tutti eseguono il Suo perform() senza codice di collegamento aggiuntivo.

import AppIntents
import SwiftUI
// In an interactive widget:
// Button(intent: AddTaskIntent()) {
//     Label("Add", systemImage: "plus")
// }
let reuse = "one intent, many surfaces"
_ = reuse

Localizzare gli intent

I titoli e i dialoghi usano LocalizedStringResource, quindi vengono tradotti tramite il Suo String Catalog. Anche le frasi di attivazione vengono localizzate per ogni lingua, consentendo a Siri di rispondere agli utenti nella loro lingua.

import AppIntents
struct GreetIntent: AppIntent {
    static var title: LocalizedStringResource = "Greet"
    func perform() async throws
        -> some IntentResult & ProvidesDialog {
        .result(dialog: "Welcome back")
    }
}

Verifica rapida

Ricorda che cosa rende valide le frasi di un AppShortcut.

Rispondi nella lezione interattiva

Riepilogo

Ha imparato a usare App Intents:

Conformarsi a AppIntent con un title e perform(); raccogliere i dati di input tramite @Parameter e descriverli con parameterSummary.
Modellare i dati come AppEntity con un EntityQuery per i selettori e i suggerimenti.
Esporre azioni vocali tramite frasi di AppShortcut che includono \(.applicationName).
Lo stesso intent alimenta Siri, Shortcuts, i widget interattivi e i controlli, e viene localizzato tramite LocalizedStringResource.

Gratis per iniziare

Impara Swift con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 122
Lezioni: 409

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «App Intents e Shortcuts» è gratuita?

Sì — il testo completo di «App Intents e Shortcuts» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 4 lezioni in totale.

Cosa imparerò in «App Intents e Shortcuts»?

Renda disponibili le azioni per Siri e Shortcuts. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Swift Academy?

Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «App Intents e Shortcuts»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Swift Academy?

Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Swift Academy