Siri无法识别AppIntentVocabulary.plist内词汇项示例与发音的技术求助

Let’s break down the most likely fixes for this common SiriKit issue—you’ve got the pieces in place, so we just need to make sure they’re hooked up correctly!

1. Double-Check AppIntentVocabulary.plist Target Membership #

This is the #1 mistake developers make: the vocabulary file must be included in your main app target, not just the Intents Extension. Siri pulls vocabulary data from the main app’s resources, not the extension.

• Right-click the AppIntentVocabulary.plist file in Xcode, select Show File Inspector.
• In the Target Membership section, ensure your main app’s checkbox is checked. You can leave the Intents Extension box unchecked—it doesn’t need this file.

2. Validate the Plist Structure #

Apple’s vocabulary plist has strict formatting rules. Even a tiny typo can break it. Here’s a correct template to compare against your file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Vocabulary</key>
    <dict>
        <key>IntentPhrases</key>
        <array>
            <dict>
                <key>IntentName</key>
                <string>InSendMessageIntent</string>
                <key>VocabularyItemExamples</key>
                <array>
                    <string>Send a message to Team Alpha</string>
                    <string>Text the design crew</string>
                </array>
                <key>VocabularyItemPronunciations</key>
                <dict>
                    <string>Team Alpha</string>
                    <string>Team Al-fah</string>
                </dict>
            </dict>
        </array>
    </dict>
</dict>
</plist>

• Critical notes:
  • The top-level key must be Vocabulary, containing an IntentPhrases array.
  • VocabularyItemPronunciations keys must exactly match strings in VocabularyItemExamples (case, spaces, and punctuation included). Siri won’t map pronunciations to mismatched text.

3. Verify Intents Extension Info.plist & Intent Implementation #

• Ensure your IntentsSupported array in the extension’s info.plist has the exact string InSendMessageIntent (no typos, extra spaces).
• Make sure your intent handling class (conforming to InSendMessageIntentHandling) properly processes parameters like recipient or groupName—Siri needs to know which parameters your intent accepts to associate your vocabulary entries with them.

4. Clear Siri’s Cache & Reconfigure Device Settings #

Siri caches vocabulary data aggressively, so a fresh start often fixes recognition issues:

• Delete your app from the test device, then rebuild and reinstall it.
• Restart the device entirely (hold power + volume down until the slider appears, then reboot).
• Go to Settings > Siri & Search > [Your App] and confirm:
  • Use with Siri & Search is toggled on.
  • Allow Siri Suggestions is enabled.

5. Test with Full Siri Commands #

Don’t test isolated vocabulary terms—Siri needs context from your intent. Use full phrases like:

"Hey Siri, ask [Your App Name] to send a message to Team Alpha"

Isolated words won’t trigger the intent association; you need to tie the vocabulary to your app’s specific action.

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