Swift AppIntent参数捕获出错：如何排查错误并引导用户重试？

一、查看错误信息的两种有效方式 #

• Xcode实时日志：将真机连接到Xcode，启动App后触发Siri Intent，Xcode控制台会输出参数解析阶段的详细错误（比如Siri无法匹配枚举值、语音识别结果不匹配等），这是最直接的排查方式。
• 系统Console日志：打开Mac上的Console.app，筛选进程包含Siri或Intents的日志，能捕获到Xcode未输出的底层错误，适合排查一些隐蔽的识别失败问题。

二、解决参数混淆并引导用户重试的具体方案 #

1. 优化枚举的语音识别匹配度 #

给MyValues的每个枚举值添加语音同义词，覆盖Siri可能识别出的不同表述，避免因语音歧义导致匹配失败：

extension MyValues: AppEnum {
    static var typeDisplayRepresentation: TypeDisplayRepresentation = "Choose values"
    static var caseDisplayRepresentations: [MyValues: DisplayRepresentation] = [
        .no: DisplayRepresentation(
            title: "No",
            subtitle: "Response for none",
            speechRecognitionSynonyms: ["None", "Zero"]
        ),
        .alittle: DisplayRepresentation(
            title: "A little",
            subtitle: "Response for small amount",
            speechRecognitionSynonyms: ["Small", "Bit", "Not much"]
        ),
        .alot: DisplayRepresentation(
            title: "A lot",
            subtitle: "Response for large amount",
            speechRecognitionSynonyms: ["Lots", "Much", "Large"]
        )
    ]
    
    static var scoreFromValue: [MyValues: Int] = [
        .no: 1,
        .alittle: 3,
        .alot: 5
    ]
}

2. 自定义参数解析错误处理 #

为每个@Parameter实现resolve方法，当参数解析失败时，主动抛出带提示的错误，引导用户重新输入，替代系统默认的静默崩溃：

struct MyIntent: AppIntent {
    static private func score(values: [Int]) -> String {
        let result = values.reduce(1, *)
        return String(result)
    }
    
    static let title: LocalizedStringResource = "Values Questionnaire"
    
    @Parameter(title: "value1", requestValueDialog: "Question 1? Please say No, A little, or A lot")
    var valueOne: MyValues
    
    @Parameter(title: "value2", requestValueDialog: "Question 2? Please say No, A little, or A lot")
    var valueTwo: MyValues
    
    @Parameter(title: "value3", requestValueDialog: "Question 3? Please say No, A little, or A lot")
    var valueThree: MyValues
    
    @Parameter(title: "value4", requestValueDialog: "Question 4? Please say No, A little, or A lot")
    var valueFour: MyValues
    
    // 为第一个参数添加解析失败处理
    func resolveValueOne() async throws -> MyValues {
        guard let validValue = try? await $valueOne.resolve() else {
            throw IntentError(
                title: "Invalid response",
                description: "Please try again with No, A little, or A lot",
                retrySuggestion: "Say one of the three options"
            )
        }
        return validValue
    }
    
    // 同理为其他参数添加resolve方法
    func resolveValueTwo() async throws -> MyValues {
        guard let validValue = try? await $valueTwo.resolve() else {
            throw IntentError(
                title: "Invalid response",
                description: "Please try again with No, A little, or A lot",
                retrySuggestion: "Say one of the three options"
            )
        }
        return validValue
    }
    
    func resolveValueThree() async throws -> MyValues {
        guard let validValue = try? await $valueThree.resolve() else {
            throw IntentError(
                title: "Invalid response",
                description: "Please try again with No, A little, or A lot",
                retrySuggestion: "Say one of the three options"
            )
        }
        return validValue
    }
    
    func resolveValueFour() async throws -> MyValues {
        guard let validValue = try? await $valueFour.resolve() else {
            throw IntentError(
                title: "Invalid response",
                description: "Please try again with No, A little, or A lot",
                retrySuggestion: "Say one of the three options"
            )
        }
        return validValue
    }
    
    @MainActor
    func perform() async throws -> some IntentResult{
        let score = MyIntent.score(values: [
            MyValues.scoreFromValue[valueOne] ?? 0,
            MyValues.scoreFromValue[valueTwo] ?? 0,
            MyValues.scoreFromValue[valueThree] ?? 0,
            MyValues.scoreFromValue[valueFour] ?? 0
        ])
        return .result(dialog: """
            I got \(valueOne.rawValue), \(valueTwo.rawValue), \(valueThree.rawValue) and \(valueFour.rawValue) which is a score of \(score)
            """)
    }
}

3. 增强提示语明确性 #

修改requestValueDialog，在提问时明确告知用户可选的回答选项，减少用户说出歧义内容的概率，比如把原来的"Question 1?"改成"Question 1? Please say No, A little, or A lot"。

三、额外注意事项 #

• 真机上测试前，确保App已通过Xcode安装且签名有效，Siri权限已开启（设置→Siri与搜索→确保你的App权限开启）。
• 避免使用过于相似的枚举值表述，比如"A little"和"A lot"可以通过添加同义词进一步区分。

内容的提问来源于stack exchange，提问作者Kittovski