SiriKit & Voice Integration Rehberi

1import AppIntents
2 
3// Basit bir App Intent tanimlama
4struct OpenArticleIntent: AppIntent {
5    static var title: LocalizedStringResource = "Makale Ac"
6    static var description: IntentDescription = "Belirtilen makaleyi uygulamada acar"
7 
8    // Parametre tanimlama
9    @Parameter(title: "Makale")
10    var article: ArticleEntity
11 
12    // Siri'nin gosterecegi ozet
13    static var parameterSummary: some ParameterSummary {
14        Summary("\(\.article) makalesini ac")
15    }
16 
17    // Intent calistirildiginda
18    func perform() async throws -> some IntentResult & ProvidesDialog {
19        // Makaleyi ac
20        await NavigationManager.shared.openArticle(article.id)
21 
22        return .result(dialog: "\(article.title) makalesi acildi")
23    }
24}
25 
26// Entity tanimlama - Siri'nin anlayacagi veri tipi
27struct ArticleEntity: AppEntity {
28    static var typeDisplayRepresentation: TypeDisplayRepresentation = "Makale"
29    static var defaultQuery = ArticleQuery()
30 
31    var id: String
32    var title: String
33    var category: String
34 
35    var displayRepresentation: DisplayRepresentation {
36        DisplayRepresentation(title: "\(title)", subtitle: "\(category)")
37    }
38}
39 
40// Entity query - Siri'nin entity'leri bulmasi icin
41struct ArticleQuery: EntityQuery {
42    func entities(for identifiers: [String]) async throws -> [ArticleEntity] {
43        return identifiers.compactMap { id in
44            ArticleStore.shared.find(by: id).map { article in
45                ArticleEntity(id: article.id, title: article.title, category: article.category)
46            }
47        }
48    }
49 
50    func suggestedEntities() async throws -> [ArticleEntity] {
51        return ArticleStore.shared.recentArticles().map { article in
52            ArticleEntity(id: article.id, title: article.title, category: article.category)
53        }
54    }
55}

1import AppIntents
2 
3struct CheckOrderStatusIntent: AppIntent {
4    static var title: LocalizedStringResource = "Siparis Durumu"
5    static var description: IntentDescription = "Son siparisin durumunu kontrol eder"
6 
7    static var openAppWhenRun: Bool = false
8 
9    func perform() async throws -> some IntentResult & ProvidesDialog & ShowsSnippetView {
10        guard let order = try await OrderService.shared.getLatestOrder() else {
11            return .result(
12                dialog: "Aktif siparisinis bulunamadi"
13            ) {
14                OrderStatusView(order: nil)
15            }
16        }
17 
18        let statusText: String
19        switch order.status {
20        case .preparing:
21            statusText = "hazirlaniyor"
22        case .shipped:
23            statusText = "kargoya verildi"
24        case .delivered:
25            statusText = "teslim edildi"
26        case .cancelled:
27            statusText = "iptal edildi"
28        }
29 
30        return .result(
31            dialog: "Siparisiniz \(statusText)"
32        ) {
33            OrderStatusView(order: order)
34        }
35    }
36}

1import AppIntents
2 
3struct SendMessageIntent: AppIntent {
4    static var title: LocalizedStringResource = "Mesaj Gonder"
5 
6    @Parameter(title: "Alici", requestValueDialog: "Kime mesaj gondermek istiyorsunuz?")
7    var recipient: ContactEntity
8 
9    @Parameter(title: "Mesaj", requestValueDialog: "Ne yazmak istiyorsunuz?")
10    var message: String
11 
12    static var parameterSummary: some ParameterSummary {
13        Summary("\(\.recipient) kisisine \(\.message) mesajini gonder")
14    }
15 
16    func perform() async throws -> some IntentResult & ProvidesDialog {
17        try await MessageService.shared.send(
18            to: recipient.id,
19            message: message
20        )
21 
22        return .result(dialog: "Mesaj gonderildi")
23    }
24}

1import AppIntents
2 
3struct MyAppShortcuts: AppShortcutsProvider {
4    static var appShortcuts: [AppShortcut] {
5        AppShortcut(
6            intent: CheckOrderStatusIntent(),
7            phrases: [
8                "Siparis durumumu \(.applicationName) ile kontrol et",
9                "\(.applicationName) siparisim nerede",
10                "Son siparisimi \(.applicationName) ile goster"
11            ],
12            shortTitle: "Siparis Durumu",
13            systemImageName: "shippingbox"
14        )
15 
16        AppShortcut(
17            intent: OpenArticleIntent(),
18            phrases: [
19                "\(.applicationName) ile makale oku",
20                "\(.applicationName) son makaleleri goster"
21            ],
22            shortTitle: "Makale Oku",
23            systemImageName: "doc.text"
24        )
25    }
26}