The Glass Explorer Edition SDK is deprecated. This documentation remains as a historical reference.
Voice Command Checklist
Stay organized with collections
Save and categorize content based on your preferences.
Glass voice commands are carefully tuned and designed for the best accuracy
and recognition. This means they take quite a bit of time for us to model and
develop.
We've come up with the following guidelines to help us more quickly evaluate
and build your voice commands. You should follow the guidelines or
have a good reason to break them.
Guideline |
Good Example |
Bad Example |
Is general enough to apply to multiple Glassware, but still has a clear purpose
| "ok glass, learn a song" |
"ok glass, learn something", "ok glass, learn a song on guitar" |
Is colloquial and can explain Glass features in a conversation |
"ok glass, take a picture" ("You can use Glass to take a picture") |
"ok glass, take picture" ("You can use Glass to take picture") |
Is comfortable to say in public |
"ok glass, find a doctor" |
"ok glass, find a gynecologist" |
Brings the user from intent to action as quickly as possible |
"ok glass, find a recipe for" (this allows users to speak "chicken kiev" and immediately see the recipe) |
"ok glass, show me a cookbook" (this forces users to look through a list for what they want) |
Avoids brand words |
"ok glass, make a video call" |
"ok glass, start a hangout" |
Is long enough to ensure high recognition quality (at least three syllables) |
"ok glass, make a video call" |
"ok glass, hangout" |
Fits on a single line (less than 600px wide at 40px Roboto Thin) |
"ok glass, add a calendar event" |
"ok glass, create a new calendar event" |
Does not sound similar to existing commands |
|
"ok glass, find a race" (too similar to "ok glass, find a place") |
Does not require immediate interactivity in Mirror API Glassware. Immediate
interactivity is only supported with GDK Glassware. |
"ok glass, take a note" (This allows users to speak a note and move on to their
next task without worrying about a response from the Glassware.) |
"ok glass, find a recipe" (This requires a response from the Glassware so
users can view the results. This is an acceptable GDK voice command but not
acceptable for the Mirror API.) |
Has an imperative verb with an object |
"ok glass, make a video call" |
"ok glass, video call" |
Uses articles when possible |
"ok glass, record a video" |
"ok glass, record video" |
Uses definite articles only when the object is definite |
"ok glass, show me the weather" |
"ok glass, take the picture" |
Uses "this" when there is only one relevant instance of the object |
"ok glass, recognize this song" |
"ok glass, recognize songs" |
Uses me and my when appropriate |
"ok glass, show me the news" |
"ok glass, show the news" |
Refers to Glass as the subject carrying out the action |
"ok glass, start a run" (Glass starts Glassware that tracks a run) |
"ok glass, go running" (The user is the one that actually goes running) |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[[["\u003cp\u003eGlass voice commands should be general, colloquial, and comfortable to say in public, while quickly leading users to their desired action.\u003c/p\u003e\n"],["\u003cp\u003eCommands must be easily distinguishable from existing ones, have a clear purpose, and be optimized for voice recognition accuracy (at least three syllables long).\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should avoid brand words and ensure commands fit on a single line, adhering to specific grammatical guidelines for clarity and consistency.\u003c/p\u003e\n"],["\u003cp\u003eVoice commands for Mirror API Glassware should not require immediate interaction, unlike those for GDK Glassware.\u003c/p\u003e\n"],["\u003cp\u003eCommands should be structured with an imperative verb and an object, using articles and pronouns appropriately for context and clarity.\u003c/p\u003e\n"]]],[],null,["# Voice Command Checklist\n\nGlass voice commands are carefully tuned and designed for the best accuracy\nand recognition. This means they take quite a bit of time for us to model and\ndevelop.\n\nWe've come up with the following guidelines to help us more quickly evaluate\nand build your voice commands. You should follow the guidelines or\nhave a good reason to break them.\n\n| Guideline | Good Example | Bad Example |\n|---------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Is general enough to apply to multiple Glassware, but still has a clear purpose | \"ok glass, learn a song\" | \"ok glass, learn something\", \"ok glass, learn a song on guitar\" |\n| Is colloquial and can explain Glass features in a conversation | \"ok glass, take a picture\" (\"You can use Glass to take a picture\") | \"ok glass, take picture\" (\"You can use Glass to take picture\") |\n| Is comfortable to say in public | \"ok glass, find a doctor\" | \"ok glass, find a gynecologist\" |\n| Brings the user from intent to action as quickly as possible | \"ok glass, find a recipe for\" (this allows users to speak \"chicken kiev\" and immediately see the recipe) | \"ok glass, show me a cookbook\" (this forces users to look through a list for what they want) |\n| Avoids brand words | \"ok glass, make a video call\" | \"ok glass, start a hangout\" |\n| Is long enough to ensure high recognition quality (at least three syllables) | \"ok glass, make a video call\" | \"ok glass, hangout\" |\n| Fits on a single line (less than 600px wide at 40px Roboto Thin) | \"ok glass, add a calendar event\" | \"ok glass, create a new calendar event\" |\n| Does not sound similar to existing commands | | \"ok glass, find a race\" (too similar to \"ok glass, find a place\") |\n| Does not require immediate interactivity in Mirror API Glassware. Immediate interactivity is only supported with GDK Glassware. | \"ok glass, take a note\" (This allows users to speak a note and move on to their next task without worrying about a response from the Glassware.) | \"ok glass, find a recipe\" (This requires a response from the Glassware so users can view the results. This is an acceptable GDK voice command but not acceptable for the Mirror API.) |\n| Has an imperative verb with an object | \"ok glass, make a video call\" | \"ok glass, video call\" |\n| Uses articles when possible | \"ok glass, record a video\" | \"ok glass, record video\" |\n| Uses definite articles only when the object is definite | \"ok glass, show me the weather\" | \"ok glass, take the picture\" |\n| Uses \"this\" when there is only one relevant instance of the object | \"ok glass, recognize this song\" | \"ok glass, recognize songs\" |\n| Uses me and my when appropriate | \"ok glass, show me the news\" | \"ok glass, show the news\" |\n| Refers to Glass as the subject carrying out the action | \"ok glass, start a run\" (Glass starts Glassware that tracks a run) | \"ok glass, go running\" (The user is the one that actually goes running) |"]]