In the Android project, we should distinguish between three levels:
shortcut IDs defined in XML
their short and long labels
flows that are clearly wired in code
In shortcuts.xml, these Android shortcut IDs are currently defined:
start_discover_tour
stop_discover_tour
play_audio
pause_audio
stop_audio
next_spot
previous_spot
show_nearby
show_events
For German, the code contains these exact shortcut labels:
start_discover_tour: Tour starten / Eine Entdeckungstour starten
stop_discover_tour: Tour beenden / Die Entdeckungstour beenden
play_audio: Audio abspielen / Spot-Audioguide abspielen
pause_audio: Audio pausieren / Den Audioguide pausieren
stop_audio: Audio stoppen / Den Audioguide stoppen
next_spot: Nächster Spot / Zum nächsten Spot gehen
previous_spot: Vorheriger Spot / Zum vorherigen Spot gehen
show_nearby: In der Nähe / Spots in der Nähe anzeigen
show_events: Veranstaltungen / Kommende Veranstaltungen anzeigen
Important for users:
For Google Assistant, we should phrase the public help more carefully than for Siri.
The code clearly contains shortcut names and intent targets, but not the same explicit list of natural spoken phrases that we have for Siri.
Because of that, public help should talk about Google Assistant shortcuts, App Shortcuts or Assistant actions instead of promising exact spoken sentences.
Audio commands are most useful when a matching playback session is already active.
Important technical review note:
start_discover_tour also has an explicit Assistant binding: actions.intent.OPEN_APP_FEATURE with feature = discover tour.
In MainActivity, PLAY_AUDIO, PAUSE_AUDIO and STOP_AUDIO are handled directly.
In the Explore screen, the pending queue is clearly replayed for START_DISCOVER_TOUR, SHOW_NEARBY and SHOW_EVENTS.
STOP_DISCOVER_TOUR, NEXT_SPOT and PREVIOUS_SPOT are defined as shortcuts and actions, but they are not backed by the same clearly visible Explore flow. In the help center, we should therefore describe them as existing shortcuts, but not as equally well-confirmed end-user voice flows compared with Start Discover Tour, Nearby and Events.
This makes myTuur usable not only by touch, but also through voice and quick actions.
