🗣️ Siri 음성 제어 앱 만들기

⭐ Difficulty: ⭐⭐⭐ ⏱️ Est. Time: 2-3h 📂 App Frameworks

Build an app that works when you say "Add a todo" using App Intents.

✨ App Intents?

App Intents exposes your app's features to Siri, Shortcuts, and Spotlight. Available on iOS 16+ and much simpler than the previous SiriKit.

📝 첫 번째 Intent 만들기

AddTodoIntent.swift

import AppIntents

struct AddTodoIntent: AppIntent {
    static var title: LocalizedStringResource = "할 일 추가"
    
    @Parameter(title: "제목")
    var todoTitle: String
    
    func perform() async throws -> some IntentResult {
        TodoStore.shared.add(title: todoTitle)
        return .result(dialog: "\(todoTitle) 추가 완료!")
    }
}

🎤 Siri 음성 명령 등록

Shortcuts.swift

struct TodoShortcuts: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: AddTodoIntent(),
            phrases: [
                "할 일 추가해줘 \(.applicationName)",
                "\(.applicationName)에 할 일 추가"
            ],
            shortTitle: "할 일 추가",
            systemImageName: "plus.circle"
        )
    }
}

💡 HIG 팁

Write phrases as natural sentences — use expressions people would actually say, like "Add a todo" or "Create a new task."

🔄 파라미터 대화 흐름

파라미터가 없으면 Siri가 자동으로 물어봅니다:

Dialog.swift

guard let title = todoTitle else {
    throw $todoTitle.needsValueError("어떤 할 일을 추가할까요?")
}

📋 Entity 정의

Define todo items as Entities so Siri can suggest and search tasks:

TodoEntity.swift

struct TodoEntity: AppEntity {
    static var typeDisplayRepresentation: TypeDisplayRepresentation {
        "할 일"
    }

    var id: UUID
    var title: String
    var isCompleted: Bool

    var displayRepresentation: DisplayRepresentation {
        DisplayRepresentation(title: "\(title)")
    }

    // Spotlight 검색 지원
    static var defaultQuery = TodoEntityQuery()
}

🔍 EntityQuery 구현

TodoEntityQuery.swift

struct TodoEntityQuery: EntityQuery {
    func entities(for identifiers: [UUID]) async throws -> [TodoEntity] {
        TodoStore.shared.todos.filter { identifiers.contains($0.id) }
    }

    func suggestedEntities() async throws -> [TodoEntity] {
        // 미완료 항목 3개 제안
        TodoStore.shared.todos
            .filter { !$0.isCompleted }
            .prefix(3)
            .map(TodoEntity.init)
    }
}

📱 SwiftUI Integration

Use AppIntentsUI to customize Siri responses with SwiftUI:

AddTodoIntent+UI.swift

import AppIntentsUI

extension AddTodoIntent {
    @MainActor
    func perform() async throws -> some IntentResult & ProvidesDialog & ShowsSnippetView {
        let todo = TodoStore.shared.add(title: todoTitle)

        return .result(
            dialog: "\(todoTitle) 추가했어요!",
            view: TodoSnippetView(todo: todo)
        )
    }
}

struct TodoSnippetView: View {
    let todo: TodoEntity

    var body: some View {
        HStack {
            Image(systemName: "checkmark.circle")
            Text(todo.title)
        }
        .padding()
    }
}

💡 Testing 방법

Run in Xcode and ask Siri "Add a todo [app name]." In the simulator, test via Hardware → Siri.

📦 Learning Resources

📎 Apple Official Resources

📘 Documentation 💻 Sample Code 🎬 WWDC Sessions