On compatible Apple devices, myTuur supports Siri and app shortcuts. For the public help center, we should only name the phrases that are actually configured in the iOS code as AppShortcut phrases.
In the current iOS code, these Siri actions are backed by fixed app shortcut phrases:
StartDiscoveryTourIntent
StopDiscoveryTourIntent
PlayAudioIntent
PauseAudioIntent
NextStopIntent
PreviousStopIntent
ShowNearbyIntent
ShowFoodNearbyIntent
WhatCanIDoIntent
EventTicketsIntent
The app shortcut phrases in the code always include the app name and are built from the localized siri_shortcut_* strings. For English, these exact phrases are currently registered:
myTuur City Guide App - Start Discover
myTuur City Guide App - Stop Discover
myTuur City Guide App - Play Audio
myTuur City Guide App - Pause Audio
myTuur City Guide App - Next Spot
myTuur City Guide App - Previous Spot
myTuur City Guide App - Nearby Spots
myTuur City Guide App - Food Nearby
myTuur City Guide App - What Can I Do
myTuur City Guide App - Ticket Check
Important for users:
In practice, users normally say Hey Siri first. That is Siri system behavior and not part of the phrase configured in the app.
All of these intents open the app.
The Siri intents switch the app into the Explore context.
For public help, we should document the commands with the full app name rather than with free paraphrases.
For every supported language, the help center should only name the phrases that are actually registered by the iOS code for that locale.
Not every command is equally useful in every state:
Generally suitable: start the Discover Tour, show nearby spots, What Can I Do, Ticket Check
Only useful with an active context: play audio, pause audio, next spot, previous spot
In practice, this means:
If there is no active tour or running navigation, Siri can still open the app, but some commands will not always trigger a visible action.
For audio and spot commands, the user should ideally already be in an active tour or a fitting navigation session.
Important technical note:
Additional app intents such as PauseTourIntent, ResumeTourIntent and StopAudioIntent do exist in the code, but they are not part of the visible app shortcut phrase list. We should therefore not document them yet as fixed Siri voice commands.
After a language change, the app must re-register shortcut parameters so Siri knows the phrases for the new app language.
