AppIntent: apa itu, model intent Siri dan Swift

Apa itu AppIntent dan untuk apa?

AppIntent — framework Apple untuk mendeskripsikan secara deklaratif perintah yang dapat dijalankan aplikasi Anda atas permintaan Siri, Shortcuts, Spotlight, Control Center, dan Action Button. Di dasarnya terdapat protokol AppIntent, di mana pengembang mendeskripsikan nama intent, parameternya, dan metode perform() — logika yang dijalankan. Framework secara otomatis menghasilkan antarmuka pengguna untuk mengonfigurasi parameter di aplikasi Shortcuts dan frasa suara untuk Siri.

Sebelum munculnya AppIntent, pengembang menggunakan Intents framework — sistem berbasis file Intent Definition File, yang menghasilkan kode Objective-C dan memerlukan konfigurasi Intents Extension terpisah. Proses ini rumit: bahkan intent sederhana memerlukan hingga 5 file konfigurasi. AppIntent menghilangkan kompleksitas ini — intent dideskripsikan dalam satu file Swift, dan sistem secara otomatis menghasilkan semua yang diperlukan untuk integrasi dengan Siri dan Shortcuts.

Menurut WWDC 2024 Session “Dive deeper into App Intents”, Apple melihat AppIntent sebagai mekanisme sentral untuk memperluas fungsionalitas aplikasi di luar UI tradisional. Pada saat rilis iOS 18, lebih dari 70% aplikasi di top 100 App Store telah menggunakan AppIntent untuk integrasi dengan Shortcuts dan Siri, dan pengguna rata-rata iOS 18 menjalankan 4–6 intent per hari melalui perintah suara atau widget.

Di mana AppIntent digunakan

• Siri — perintah suara: “Hey Siri, tambahkan tugas ke MyApp”
• Shortcuts — otomatisasi di aplikasi Pintasan dengan konfigurasi parameter
• Spotlight — pencarian dan eksekusi perintah langsung dari bilah pencarian
• Control Center — tombol aksi cepat di iOS 18+
• Action Button — konfigurasi aksi untuk tombol iPhone 15 Pro dan yang lebih baru

AppIntent vs Intents framework: perbedaan utama

Intents framework (iOS 10–15) memerlukan pembuatan file .intentdefinition, pembuatan kelas ObjC/Swift melalui Xcode, konfigurasi Intents Extension dan App Intent Configuration. AppIntent (iOS 16+) sepenuhnya menggantikan pipeline ini dengan kode Swift murni tanpa pembuatan, ekstensi, dan konfigurasi tambahan. Ini membuat proses pembuatan intent dapat diakses oleh pengembang iOS biasa tanpa mempelajari SiriKit.

Keunggulan utama AppIntent adalah deklaratifitas. Pengembang mendeskripsikan apa yang dilakukan intent, bukan bagaimana ia berintegrasi dengan sistem. Framework sendiri menangani skenario dialog Siri, menampilkan parameter di Shortcuts, dan mentransfer konteks antar intent. Di Intents framework lama, setiap aspek integrasi harus dikodekan secara manual, termasuk INUIHostedView untuk menampilkan UI intent.

Perbandingan pendekatan

Protokol utama: AppIntent, AppEntity, AppEnum

AppIntent — protokol sentral yang mendefinisikan intent. Ini berisi title (nama untuk Siri), description (deskripsi di Shortcuts), parameter (melalui @Parameter) dan metode perform() yang mengembalikan IntentResult. Hasilnya bisa berupa IntentDialog (dialog dengan Siri), nilai untuk dikembalikan ke Shortcuts, atau kesalahan. Setiap intent juga dapat menyediakan suggestedInvocationPhrase — frasa untuk panggilan suara.

AppEntity mendeskripsikan entitas yang digunakan intent. Misalnya, jika aplikasi mengelola proyek, AppEntity Project berisi id, displayRepresentation (bagaimana menampilkan entitas di UI) dan defaultQuery (bagaimana mencari entitas). AppEnum — enumerasi untuk parameter pilihan yang secara otomatis menghasilkan UI dengan elemen picker di Shortcuts. Alih-alih membuat daftar parameter secara manual, cukup mendeklarasikan enum yang sesuai dengan AppEnum.

Contoh AppEnum dan parameter

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")
    }
}

Parameter intent dan validasinya

Parameter AppIntent dideklarasikan melalui property wrapper @Parameter, yang secara otomatis berintegrasi dengan UI Shortcuts dan permintaan suara Siri. Setiap parameter memiliki title (ditampilkan di Shortcuts) dan dapat berisi deskripsi, nilai default, batasan. AppIntent mendukung tipe standar: String, Int, Double, Bool, serta tipe kustom melalui AppEntity dan AppEnum.

Validasi parameter dilakukan dalam metode perform() sebelum menjalankan logika. Jika parameter tidak valid, intent mengembalikan kesalahan melalui IntentError. Untuk validasi kompleks, dapat diimplementasikan metode validate(), yang dipanggil sebelum perform() dan dapat memberikan umpan balik kepada pengguna melalui IntentDialog bahkan sebelum perintah dijalankan. Ini sangat berguna dalam skenario suara Siri, di mana lebih mudah menanyai ulang pengguna daripada menjalankan perintah yang salah.

Parameter dengan validasi

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!")
    }
}

Membuat intent di Swift: contoh

Contoh lengkap intent untuk mencari catatan di aplikasi mendemonstrasikan kerja dengan AppEntity dan EntityQuery. Intent SearchNotesIntent menerima string pencarian dan mengembalikan daftar catatan yang ditemukan. AppEntity Note mendeskripsikan struktur catatan, dan EntityQuery mengimplementasikan pencarian di penyimpanan. Hasil dikembalikan melalui IntentResult dengan array entitas, yang ditampilkan Shortcuts kepada pengguna.

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)
    }
}

Integrasi dengan Shortcuts dan Siri

Setelah mendeklarasikan AppIntent, integrasi dengan Shortcuts dan Siri terjadi secara otomatis. Aplikasi Shortcuts memindai semua AppIntent dari aplikasi yang terinstal dan menampilkannya dalam daftar tindakan yang tersedia. Pengguna dapat menambahkan intent ke perintahnya, mengonfigurasi parameternya, dan menggabungkannya dengan tindakan lain. Untuk Siri, intent muncul sebagai perintah suara tanpa konfigurasi tambahan dari pengembang.

Pengembang dapat meningkatkan integrasi dengan menambahkan suggestedInvocationPhrase — frasa yang direkomendasikan untuk panggilan suara. Misalnya, untuk intent penambahan tugas: suggestedInvocationPhrase = "Add new task". Siri menganalisis frasa ini dan menawarkannya kepada pengguna saat mempelajari perintah suara. Juga dapat ditentukan categories — kategori intent (create, view, search, edit), yang membantu Shortcuts mengelompokkan tindakan berdasarkan makna.

Kategori intent untuk Shortcuts