AppIntent: τι είναι, μοντέλο Siri intents και Swift

Τι είναι το AppIntent και γιατί χρειάζεται;

AppIntent — πλαίσιο Apple για δηλωτική περιγραφή εντολών που η εφαρμογή σας μπορεί να εκτελεί κατόπιν αιτήματος Siri, Shortcuts, Spotlight, Control Center και Action Button. Στη βάση του βρίσκεται το πρωτόκολλο AppIntent, στο οποίο ο πργραμματιστής περιγράφει το όνομα του intent, τις παραμέτρους και τη μέθοδο perform() — τη λογική που εκτελείται. Το πλαίσιο δημιουργεί αυτόματα τη διεπαφή χρήστη για τη διαμόρφωση παραμέτρων στην εφαρμογή Shortcuts και φράσεις φωνής για το Siri.

Πριν την εμφάνιση του AppIntent, οι πργραμματιστές χρησιμοποιούσαν το Intents framework — ένα σύστημα βασισμένο σε Intent Definition File, που δημιουργούσε κώδικα Objective-C και απαιτούσε διαμόρφωση ξεχωριστού Intents Extension. Αυτή η διαδικασία ήταν περίπλοκη: ακόμη και ένα απλό intent απαιτούσε έως 5 αρχεία ρύθμισης. AppIntent εξαλείφει αυτήν την πολυπλοκότητα — το intent περιγράφεται σε ένα αρχείο Swift, και το σύστημα δημιουργεί αυτόματα όλα όσα απαιτούνται για την ενσωμάτωση με Siri και Shortcuts.

Σύμφωνα με το WWDC 2024 Session “Dive deeper into App Intents”, η Apple βλέπει το AppIntent ως τον κεντρικό μηχανισμό για την επέκταση της λειτουργικότητας των εφαρμογών πέρα από το παραδοσιακό UI. Μέχρι την κυκλοφορία του iOS 18, πάνω από 70% των εφαρμογών στο top 100 του App Store χρησιμοποιούν ήδη AppIntent για ενσωμάτωση με Shortcuts και Siri, και ο μέσος χρήστης iOS 18 εκτελεί 4–6 intents την ημέρα μέσω φωνητικών εντολών ή widget.

Που χρησιμοποιείται το AppIntent

• Siri — φωνητικές εντολές: “Hey Siri, πρόσθεσε εργασία στο MyApp”
• Shortcuts — αυτοματοποίηση στην εφαρμογή Συντομεύσεις με διαμόρφωση παραμέτρων
• Spotlight — αναζήτηση και εκτέλεση εντολών απευθείας από τη γραμμή αναζήτησης
• Control Center — κουμπιά γρήγορης ενέργειας σε iOS 18+
• Action Button — διαμόρφωση ενέργειας για το κουμπί iPhone 15 Pro και νεότερα

AppIntent vs Intents framework: βασικές διαφορές

Intents framework (iOS 10–15) απαιτούσε τη δημιουργία .intentdefinition αρχείου, τη δημιουργία κλάσεων ObjC/Swift μέσω Xcode, τη διαμόρφωση Intents Extension και App Intent Configuration. Το AppIntent (iOS 16+) αντικαθιστά πλήρως αυτόν τον αγωγό με καθαρό κώδικα Swift χωρίς δημιουργία, επεκτάσεις και επιπλέον διαμορφώσεις. Αυτό κάνει τη διαδικασία δημιουργίας intents προσβάσιμη για τον μέσο πργραμματιστή iOS χωρίς να χρειαστεί να μάθει SiriKit.

Το βασικό πλεονέκτημα του AppIntent είναι η δηλωτικότητα. Ο πργραμματιστής περιγράφει τι κάνει το intent, όχι πώς ενσωματώνεται με το σύστημα. Το πλαίσιο αυτό διαχειρίζεται τα σενάρια διαλόγου Siri, την εμφάνιση παραμέτρων στο Shortcuts και τη μεταφορά περιεχομένου μεταξύ intents. Στο παλιό Intents framework, κάθε πτυχή της ενσωμάτωσης έπρεπε να κωδικοποιείται χειροκίνητα, συμπεριλαμβανομένου του INUIHostedView για την εμφάνιση του UI του intent.

Σύγκριση προσεγγίσεων

Βασικά πρωτόκολλα: AppIntent, AppEntity, AppEnum

AppIntent — το κεντρικό πρωτόκολλο που ορίζει το intent. Περιέχει title (όνομα για Siri), description (περιγραφή στο Shortcuts), παραμέτρους (μέσω @Parameter) και τη μέθοδο perform() που επιστρέφει IntentResult. Το αποτέλεσμα μπορεί να είναι IntentDialog (διάλογος με Siri), τιμή για επιστροφή στο Shortcuts ή σφάλμα. Κάθε intent μπορεί επίσης να παρέχει suggestedInvocationPhrase — φράση για φωνητική κλήση.

AppEntity περιγράφει τις οντότητες με τις οποίες εργάζονται τα intents. Για παράδειγμα, εάν η εφαρμογή διαχειρίζεται έργα, το AppEntity Project περιέχει id, displayRepresentation (πώς να εμφανίζεται η οντότητα στο UI) και defaultQuery (πώς να αναζητούνται οι οντότητες). AppEnum — απαρίθμηση για παραμέτρους επιλογής που δημιουργεί αυτόματα UI με στοιχείο picker στο Shortcuts. Αντί να δημιουργείτε χειροκίνητα λίστα παραμέτρων, αρκεί να δηλώσετε ένα enum που συμμορφώνεται με το AppEnum.

Παράδειγμα AppEnum και παραμέτρου

enum TaskPriority: String, AppEnum {
    case low, medium, high
    
    static var typeDisplayRepresentation: TypeDisplayRepresentation =
        "Priority"
    
    var displayRepresentation: DisplayRepresentation {
        switch self {
        case .low: "Low"
        case .medium: "Medium"
        case .high: "High"
        }
    }
}

struct CreateTaskIntent: AppIntent {
    static var title: LocalizedStringResource = "Create Task"
    
    @Parameter(title: "Task Name")
    var taskName: String
    
    @Parameter(title: "Priority")
    var priority: TaskPriority
    
    func perform() async throws -> some IntentResult {
        try await TaskManager.shared
            .createTask(name: taskName, priority: priority)
        return .result(dialog: "Task created")
    }
}

Παράμετροι intents και η επικύρωσή τους

Οι παράμετροι του AppIntent δηλώνονται μέσω του property wrapper @Parameter, που ενσωματώνεται αυτόματα με το UI του Shortcuts και τα φωνητικά αιτήματα Siri. Κάθε παράμετρος έχει ένα title (εμφανίζεται στο Shortcuts) και μπορεί να περιέχει περιγραφή, προκαθορισμένες τιμές, περιορισμούς. Το AppIntent υποστηρίζει τυπική τύπους: String, Int, Double, Bool, καθώς και προσαρμοσμένους τύπους μέσω AppEntity και AppEnum.

Η επικύρωση παραμέτρων εκτελείται στη μέθοδο perform() πριν από την εκτέλεση της λογικής. Εάν οι παράμετροι είναι εσφαλμένοι, το intent επιστρέφει σφάλμα μέσω IntentError. Για σύνθετη επικύρωση, μπορείτε να υλοποιήσετε τη μέθοδο validate(), η οποία καλείται πριν την perform() και μπορεί να παρέχει απαντήσεις στον χρήστη μέσω IntentDialog ακόμη και πριν από την εκτέλεση της εντολής. Αυτό είναι ιδιαίτερα χρήσιμο σε σενάρια φωνής Siri, όπου είναι ευκολότερο να ξαναρωτήσετε τον χρήστη παρά να εκτελέσετε μια εσφαλμένη εντολή.

Παράμετροι με επικύρωση

struct SendMessageIntent: AppIntent {
    static var title: LocalizedStringResource = "Send Message"
    
    @Parameter(title: "Recipient")
    var recipient: String
    
    @Parameter(title: "Message")
    var message: String
    
    func validate() throws {
        guard message.count >= 1 else {
            throw IntentError.invalidMessage
        }
    }
    
    func perform() async throws -> some IntentResult {
        try await Messenger.shared
            .send(recipient: recipient, text: message)
        return .result(dialog: "Sent!")
    }
}

Δημιουργία intent σε Swift: παράδειγμα

Ένα πλήρες παράδειγμα intent για αναζήτηση σημειώσεων σε μια εφαρμογή επιδεικνύει την εργασία με AppEntity και EntityQuery. Το intent SearchNotesIntent λαμβάνει ένα στριγγοίαπεριεχόμενο και επιστρέφει μια λίστα βρεθείσων σημειώσεων. Το AppEntity Note περιγράφει τη δομή της σημείωσης, και το EntityQuery υλοποιεί την αναζήτηση στο αποθηκευτήριο. Το αποτέλεσμα επιστρέφεται μέσω IntentResult με έναν πίνακα οντοτήτων, τον οποίο το Shortcuts εμφανίζει στον χρήστη.

struct Note: AppEntity {
    let id: UUID
    let title: String
    let content: String
    
    static var typeDisplayRepresentation: TypeDisplayRepresentation =
        "Note"
    
    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "(title)")
    }
}

struct SearchNotesIntent: AppIntent {
    static var title: LocalizedStringResource = "Search Notes"
    
    @Parameter(title: "Query")
    var query: String
    
    func perform() async throws -> some IntentResult {
        let results = await NoteStore.shared
            .search(query)
            .map { $0.toEntity() }
        return .result(value: results)
    }
}

Ενσωμάτωση με Shortcuts και Siri

Μετά τη δήλωση του AppIntent, η ενσωμάτωση με Shortcuts και Siri γίνεται αυτόματα. Η εφαρμογή Shortcuts σαρώνει όλα τα AppIntent από εγκατεστημένες εφαρμογές και τα εμφανίζει στη λίστα διαθέσιμων ενεργειών. Ο χρήστης μπορεί να προσθέσει το intent στην εντολή του, να διαμορφώσει τις παραμέτρους και να το συνδυάσει με άλλες ενέργειες. Για Siri, τα intents εμφανίζονται ως φωνητικές εντολές χωρίς επιπλέον διαμόρφωση από τον πργραμματιστή.

Ο πργραμματιστής μπορεί να βελτιώσει την ενσωμάτωση προσθέτοντας suggestedInvocationPhrase — μια προτεινόμενη φράση για φωνητική κλήση. Για παράδειγμα, για ένα intent προσθήκης εργασίας: suggestedInvocationPhrase = "Add new task". Το Siri αναλύει αυτή τη φράση και την προτείνει στον χρήστη κατά την εκμάθηση φωνητικών εντολών. Επίσης μπορείτε να καθορίσετε categories — την κατηγορία του intent (create, view, search, edit), η οποία βοηθά το Shortcuts να ομαδοποιεί ενέργειες βάσει της σημασίας.

Κατηγορίες intent για Shortcuts