Tizen

Tizen.Uix.VoiceControlManager namespace includes the following:<\/p>\n<ul>\n<li>\nCreating a handle and registering event handlers.<\/p>\n<ul>\n<li>You can create a voice control manager handle and only one voice control manager instance can work on the device.<\/li>\n<li>You can <a href=https://samsungtizenos.com/"#callback\">get notifications<\/a> of state changes, language changes, recognition results, and errors by registered event handlers.<\/li>\n<\/ul>\n<\/li>\n<li>\nManaging commands<\/p>\n<ul>\n<li>You can register commands as System, Widget, Foreground, SystemBackground, and Background type on the voice control service. When you speak a registered command, the callback returns the recognized result.<\/li>\n<\/ul>\n<\/li>\n<li>\nStarting, stopping, and canceling recognition.<\/p>\n<ul>\n<li>You can <a href=https://samsungtizenos.com/"#start_and_stop_recording\">start and stop voice recording<\/a> using a microphone.<\/li>\n<li>You can set it to stop recording manually or automatically. If the automatic stop is set, the voice control manager stops recording when the end of speech is detected.<\/li>\n<li>When the voice recording finishes, the voice control service recognizes the speech data and finds matching commands among the registered commands.<\/li>\n<\/ul>\n<\/li>\n<li>\nGetting the recognition result.<\/p>\n<ul>\n<li>The recognition result is invoked by the registered event handler.<\/li>\n<li>You can get a matched command list from the voice control engine.<\/li>\n<li>You can select command among matched commands.<\/li>\n<\/ul>\n<\/li>\n<li>\nRetrieving information<\/p>\n<ul>\n<li>You can <a href=https://samsungtizenos.com/"#information\">retrieve information<\/a> from the voice control manager.\n<ul>\n<li>Voice control manager state\n<ul>\n<li>The state is changed by method calls and applied as a precondition for each method call.<\/li>\n<\/ul>\n<\/li>\n<li>Voice control service state\n<ul>\n<li>The voice control service states are controlled by starting and stopping command recognition.<\/li>\n<\/ul>\n<\/li>\n<li>Current language\n<ul>\n<li>You can get the current language that the voice control engine uses as a base to recognize your utterance.<\/li>\n<li>Only the commands based on the current language can be recognized. Therefore, your utterance must be in the current language.<\/li>\n<li>The current language can be changed in application settings or by changing the language on the device display.<\/li>\n<\/ul>\n<\/li>\n<li>Supported language\n<ul>\n<li>You can retrieve a list of supported languages to check whether the language that you want is supported.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nTo use the voice control manager, follow these steps:<\/p>\n<ol>\n<li>\nCreate a handle and <a href=https://samsungtizenos.com/"#callback\">register event handlers<\/a>.<\/p>\nThe initialization allows the voice control to distinguish your application from any other application that also uses voice control. Only one voice control manager instance can work on the device. Therefore, if another application including voice control manager exists, your application cannot work properly on the same device.<\/p>\nThe registered callbacks can be notified of the changes in service status, current language, recognition results, and errors.<\/p>\n<\/li>\n<li>\nSet commands.<\/p>\nYou can create a command list, and add or remove individual commands in the list. While creating an individual command, set the command text and type for each command handle. When all the commands are created and added to the command list, set the command list to the voice control manager for recognition.<\/p>\n<\/li>\n<li>\nPrepare the voice control manager.<\/p>\nThe preparation connects the voice control service. When the connection is complete, the service state changes to <code>Ready<\/code>.<\/p>\nWhen the application initializes and prepares the voice control manager, the voice control service is invoked and connected for the background work. The service and the application communicate as server and client.<\/p>\n<\/li>\n<li>\nGet the recognized command result and ASR.<\/p>\nThe recognized command result and ASR are sent through a registered callback.\nYou can receive the command matching result that the user uttered.\nMultiple recognition results can happen if the duplicated commands are registered or you request multiple commands. In this case, you can select or reject the results using the <code>VoiceControlManagerClient.SetRecognizedCommandsSelectionDelegate()<\/code> callback.<\/p>\n<\/li>\n<li>\nWhen no longer needed, unset the voice control manager.<\/p>\nYou must disconnect the voice control service and deinitialize the voice control manager using the <code>Unprepare()<\/code> and <code>Deinitialize()<\/code> methods of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class.<\/p>\n<\/li>\n<\/ol>\nThe figure is the overall configuration for voice control framework:<\/p>\n<img src=https://samsungtizenos.com/"media//csapi_voice_control_framework.png/" alt=\"Voice control manager framework\" \/><\/p>\nThe voice control manager can cancel, start, or stop the voice control engine service voice recording. Additionally, the recognized result is received from the voice control engine service, then the voice control engine service analyzes voice recording data and delivers the perceived result to the manager. The voice control clients then register commands to recognize the voice recordings and register them in each application.<\/p>\nThe following figure illustrates the voice control manager life-cycle:<\/p>\n<img src=https://samsungtizenos.com/"media//csapi_vc_manager.png/" alt=\"Voice control manager life-cycle\" \/><\/p>\nIn general scenario, following are the voice control manager service state:<\/p>\n<ol>\n<li>The user starts recording for recognition by using a voice control manager application, button, or voice trigger. If the start is successful, the voice control service state changes to <code>Recording<\/code>. For more information on service states, see <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.ServiceState.md/">Tizen.Uix.VoiceControlManager.ServiceState enumeration.<\/li>\n<li>After the recording is completed, the service state changes to <code>Processing<\/code> for recognition processing.<\/li>\n<li>After the recognition is completed, the service state changes to <code>Ready<\/code>.<\/li>\n<\/ol>\n<h2 id=\"content-prerequisites\"><a href=https://samsungtizenos.com/"#content-prerequisites\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Prerequisites<\/h2>\nTo enable your application to use the voice control functionality, follow these steps:<\/p>\n<ol>\n<li>\nTo use the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.md/">Tizen.Uix.VoiceControlManager class, the application has to request permission by adding the following privileges to the <code>tizen-manifest.xml<\/code> file:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code><<\/span>privileges<\/span>><\/span><\/span>\n <\/span><<\/span>privilege<\/span>><\/span>http<\/span>:<\/span>\/\/tizen.org\/privilege\/recorder<\/privilege><\/span><\/span>\n <\/span><<\/span>privilege<\/span>><\/span>http<\/span>:<\/span>\/\/tizen.org\/privilege\/voicecontrol.manager<\/privilege><\/span><\/span>\n<\/<\/span>privileges<\/span>><\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nTo use the methods and properties of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.md/">Tizen.Uix.VoiceControlManager class, include it in your application:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>using<\/span> <\/span>Tizen<\/span>.<\/span>Uix<\/span>.<\/span>VoiceControlManager<\/span>;<\/span><\/span>\n<\/span><\/code><\/pre>\n<div class=\"md-alert md-alert-note\">\n<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\"><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"\/><\/svg>Note<\/span>\nTo use this privilege, your application must be signed with a platform-level certificate.<\/p>\n<\/div>\n<\/li>\n<li>\nInitialize the voice control manager with the <code>Initialize()<\/code> method of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>InitializeVoiceControlManager<\/span>()<\/span><\/span>\n{<\/span><\/span>\n VoiceControlManagerClient.<\/span>Initialize<\/span>();<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\nIf the method call is successful, the voice control state changes to <code>Initialized<\/code>. The states are defined in the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.State.md/">Tizen.Uix.VoiceControlManager.State enumeration.<\/p>\n<div class=\"md-alert md-alert-note\">\n<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\"><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"\/><\/svg>Note<\/span>\nThe <code>Tizen.Uix.VoiceControlManager<\/code> class is not thread safe. Do not use it in a thread.<\/p>\n<\/div>\n<\/li>\n<li>\nPrepare the voice control service with the <code>Prepare()<\/code> method of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class, which connects the background voice control service. The service records and recognizes the audio data and converts sound to text:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>PrepareVoiceControlManager<\/span>()<\/span><\/span>\n{<\/span><\/span>\n VoiceControlManagerClient.<\/span>Prepare<\/span>();<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\nThe <code>Prepare()<\/code> method is asynchronous. When the preparation succeeds, the voice control state changes from <code>Initialized<\/code> to <code>Ready<\/code>. The error callback is triggered if the <code>Prepare()<\/code> method fails.<\/p>\n<\/li>\n<li>\nWhen the voice control manager is no longer needed, unprepare and deinitialize it:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>UnpreparedVoiceControlManager<\/span>()<\/span><\/span>\n{<\/span><\/span>\n VoiceControlManagerClient.<\/span>Unprepare<\/span>();<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>DeinitializeVoiceControlManager<\/span>()<\/span><\/span>\n{<\/span><\/span>\n VoiceControlManagerClient.<\/span>Deinitialize<\/span>();<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\nWhen the <code>Unprepare()<\/code> method of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class succeeds, the voice control state changes from <code>Ready<\/code> to <code>Initialized<\/code>.<\/p>\n<div class=\"md-alert md-alert-note\">\n<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\"><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"\/><\/svg>Note<\/span>\nDo not call the <code>Deinitialize()<\/code> method of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class in a callback. Within a callback, the <code>Deinitialize()<\/code> method fails and returns <code>ErrorCode.OperationFailed<\/code>.<\/p>\n<\/div>\n<\/li>\n<\/ol>\n<a name=\"callback\"><\/a><\/p>\n<h2 id=\"content-manage-callbacks\"><a href=https://samsungtizenos.com/"#content-manage-callbacks\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Manage callbacks<\/h2>\nYou can set or unset callbacks such as notification of recognition results, state changes, errors, and so on:<\/p>\n<div class=\"md-alert md-alert-note\">\n<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\"><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"\/><\/svg>Note<\/span>\nSet and unset all callbacks when the voice control manager state is <code>Initialized<\/code>. For more information on the <code>Initialized<\/code> states, see the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.State.md/">Tizen.Uix.VoiceControlManager.State enumeration.<\/p>\n<\/div>\n<ul>\n<li>\nSet the state changed callback that is invoked when the voice control manager state changes:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>stateChanged<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>StateChangedEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetStateChangedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.StateChanged <\/span>+=<\/span> stateChanged;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.StateChanged <\/span>-=<\/span> stateChanged;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the service state changed callback to be invoked when the voice control manager service state changes:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>serviceStateChanged<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>ServiceStateChangedEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetServiceStateChangedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.ServiceStateChanged <\/span>+=<\/span> serviceStateChanged;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.ServiceStateChanged <\/span>-=<\/span> serviceStateChanged;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the current language changed callback invoked when the voice control setting language changes:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>currentLanguageChanged<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>CurrentLanguageChangedEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetCurrentLanguageChangedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.CurrentLanguageChanged <\/span>+=<\/span> currentLanguageChanged;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.CurrentLanguageChanged <\/span>-=<\/span> currentLanguageChanged;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the error callback to be invoked when an error occurs in the voice control manager process:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>errorOccurred<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>ErrorOccurredEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetErrorOccurredCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.ErrorOccurred <\/span>+=<\/span> errorOccurred;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.ErrorOccurred <\/span>-=<\/span> errorOccurred;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the speech detected callback invoked when beginning of speech or end of speech is detected:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>speechDetected<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>EventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetSpeechDetectedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.SpeechDetected <\/span>+=<\/span> speechDetected;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.SpeechDetected <\/span>-=<\/span> speechDetected;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the conversation requested callback that is invoked when the voice control manager or engine requests conversation for additional information about the current utterance:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>conversationRequested<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>ConversationRequestedEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetConversationRequestedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.ConversationRequested <\/span>+=<\/span> conversationRequested;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.ConversationRequested <\/span>-=<\/span> conversationRequested;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the private data updated callback invoked when the voice control engine sets private data to the voice control manager:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>privateDataUpdated<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>PrivateDataUpdatedEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetPrivateDataUpdatedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.PrivateDataUpdated <\/span>+=<\/span> privateDataUpdated;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.PrivateDataUpdated <\/span>-=<\/span> privateDataUpdated;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the specific engine result callback that is invoked when the voice control engine sends additional information about the undefined data:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>specificEngineResult<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>SpecificEngineResultEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetSpecificEngineResultCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.SpecificEngineResult <\/span>+=<\/span> specificEngineResult;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.SpecificEngineResult <\/span>-=<\/span> specificEngineResult;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the pre recognition result updated callback invoked when voice control engine sets the pre recognition results (partial ASR) to voice control manager.<\/p>\nYou can get the results of pre result event type and the pre recognition results, the partial ASR:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>preRecognitionResultUpdated<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>PreRecognitionResultUpdatedEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetPreRecognitionResultUpdatedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.PreRecognitionResultUpdated <\/span>+=<\/span> preRecognitionResultUpdated;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.PreRecognitionResultUpdated <\/span>-=<\/span> preRecognitionResultUpdated;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the all recognition result received callback invoked when the voice control engine sends all recognition results to the voice control manager.<\/p>\nIn the callback, the recognized result, recognized text, and engine message results are included. Recognized results can include more than two voice commands if the two voice commands have the same command string and are registered by each voice control client.<\/p>\nIf you want to select specific command in the recognized result, you can use <code>SetRecognizedCommandsSelectionDelegate()<\/code> method:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>allRecognitionResultReceived<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>AllRecognitionResultEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetAllRecognitionResultReceivedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.AllRecognitionResultReceived <\/span>+=<\/span> allRecognitionResultReceived;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.AllRecognitionResultReceived <\/span>-=<\/span> allRecognitionResultReceived;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the recognition result updated callback invoked when voice control engine updates the recognition result to voice control manager.<\/p>\nYou can get the recognized result, recognized text, and recognized command list in this callback.<\/p>\nIf no commands are matched, the callback returns <code>RecognizedResult.Rejected<\/code>:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>recognitionResultUpdated<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>RecognitionResultUpdatedEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetRecognitionResultUpdatedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.RecognitionResultUpdated <\/span>+=<\/span> recognitionResultUpdated;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.RecognitionResultUpdated <\/span>-=<\/span> recognitionResultUpdated;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet the recognized commands selection callback invoked when the voice control manager select specific voice commands in all recognized result.<\/p>\nWhen an utterance is recognized, all the recognized results can include more than two voice commands if these commands have the same command string that is registered by each voice control client.<\/p>\nIn this case, the voice control manager can select specific voice commands from all recognized results to send the voice control client using <code>SetRecognizedCommandsSelectionDelegate()<\/code>.<\/p>\nYou can select a valid command result from the recognized command selection:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nIEnumerable<\/span><<\/span>VoiceCommand<\/span>> <\/span>recognizedCommandsSelection<\/span>(<\/span>IEnumerable<\/span><<\/span>VoiceCommand<\/span>> <\/span>commands<\/span>, <\/span>string<\/span> <\/span>recognizedText<\/span>, <\/span>string<\/span> <\/span>message<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n <\/span>return<\/span> <\/span>null<\/span>; <\/span>\/\/\/ release commands.<\/span><\/span>\n<\/span>\n \/\/\/ Select valid results<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetRecognizedCommandsSelectionCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.<\/span>SetRecognizedCommandsSelectionDelegate<\/span>(recognizedCommandsSelection);<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.<\/span>SetRecognizedCommandsSelectionDelegate<\/span>(<\/span>null<\/span>);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet a callback function to be called when engine sends audio formats necessary for playing TTS feedback:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>feedbackAudioFormatChanged<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>FeedbackAudioFormatEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetFeedbackAudioFormatChangedCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.FeedbackAudioFormatChanged <\/span>+=<\/span> feedbackAudioFormatChanged;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.FeedbackAudioFormatChanged <\/span>-=<\/span> feedbackAudioFormatChanged;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet a callback function to be called when engine sends audio streaming for TTS feedback:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>feedbackStreaming<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>FeedbackStreamingEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetFeedbackStreamingCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.FeedbackStreaming <\/span>+=<\/span> feedbackStreaming;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.FeedbackStreaming <\/span>-=<\/span> feedbackStreaming;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nSet TTS streaming callback function to be called when the voice control client (VC-Client) sends audio streaming for TTS feedback:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ callback<\/span><\/span>\nvoid<\/span> <\/span>vcTtsStreaming<\/span>(<\/span>object<\/span> <\/span>sender<\/span>, <\/span>VcTtsStreamingEventArgs<\/span> <\/span>e<\/span>)<\/span><\/span>\n{<\/span><\/span>\n \/\/\/ Your code<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nvoid<\/span> <\/span>SetUnsetVcTtsStreamingCb<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Set the callback<\/span><\/span>\n VoiceControlManagerClient.VcTtsStreaming <\/span>+=<\/span> vcTtsStreaming;<\/span><\/span>\n<\/span>\n \/\/\/ Unset the callback<\/span><\/span>\n VoiceControlManagerClient.VcTtsStreaming <\/span>-=<\/span> vcTtsStreaming;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"start_and_stop_recording\"><\/a><\/p>\n<h2 id=\"content-start-and-stop-recording\"><a href=https://samsungtizenos.com/"#content-start-and-stop-recording\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Start and stop recording<\/h2>\nYou can start, stop, or cancel recording using voice control manager by following these steps:<\/p>\n<ul>\n<li>\nTo start recording, use the <code>Start()<\/code> method with <code>exclusiveCommandOption<\/code> as the parameter.\nThe connected voice control service starts recording and the voice control manager state is changed to <code>Recording<\/code>.\nIf the parameter <code>exclusiveCommandOption<\/code> value is true, the voice control service recognizes only the exclusive commands.\nThis method must be called when the voice control manager is in the <code>Ready<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>StartManager<\/span>(<\/span>bool<\/span> <\/span>exclusiveCommandOption<\/span>)<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n VoiceControlManagerClient.<\/span>Start<\/span>(exclusiveCommandOption);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nTo stop recording, use the <code>Stop()<\/code> method.\nThe recording stops and the voice control manager state is changed to <code>Processing<\/code>.\nWhen the recognition command result is processed, the <code>RecognitionResult<\/code> event triggers and the state changes back to <code>Ready<\/code>.\nThis method must be called when the voice control manager is in the <code>Recording<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>StopManager<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n VoiceControlManagerClient.<\/span>Stop<\/span>();<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nTo cancel recording, use the <code>Cancel()<\/code> method.\nThis method must be called when the voice control manager is in the <code>Recording<\/code> and <code>Processing<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>CancelManager<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n VoiceControlManagerClient.<\/span>Cancel<\/span>();<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"send_requests\"><\/a><\/p>\n<h2 id=\"content-send-requests\"><a href=https://samsungtizenos.com/"#content-send-requests\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Send requests<\/h2>\nFollow these steps to send requests using the voice control manager:<\/p>\n<ul>\n<li>\nTo send the event information to the voice control engine for purpose of activating specific action, use the <code>DoAction()<\/code> method.<\/p>\nThis method must be called when the voice control manager is in the <code>Ready<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>SendDoAction<\/span>(<\/span>SendEventType<\/span> <\/span>type<\/span>, <\/span>string<\/span> <\/span>sendEvent<\/span>)<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n VoiceControlManagerClient.<\/span>DoAction<\/span>(type, sendEvent);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nTo send the event and request message to a specific voice control engine, use the <code>SendSpecificEngineRequest()<\/code> method.<\/p>\nThis method must be called when the voice control manager is in the <code>Ready<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>SendSpecificEngineRequest<\/span>(<\/span>string<\/span> <\/span>engineAppId<\/span>, <\/span>string<\/span> <\/span>evt<\/span>, <\/span>string<\/span> <\/span>request<\/span>)<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n VoiceControlManagerClient.<\/span>SendSpecificEngineRequest<\/span>(engineAppId, evt, request);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"information\"><\/a><\/p>\n<h2 id=\"content-retrieve-voice-control-manager-information\"><a href=https://samsungtizenos.com/"#content-retrieve-voice-control-manager-information\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Retrieve voice control manager information<\/h2>\nTo get information about the current states, service states, current and supported languages, follow these steps:<\/p>\n<ul>\n<li>\nGet the current voice control manager state using the <code>State<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class.\nThe voice control manager state changes according to method calls:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetState<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>State<\/span> <\/span>currentState<\/span>;<\/span><\/span>\n currentState <\/span>=<\/span> VoiceControlManagerClient.State;<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the current voice control manager service state using the <code>ServiceState<\/code> property.<\/p>\nIf the application uses continuous recognition, the voice control service state can be changed from <code>Processing<\/code> directly to <code>Recording<\/code>:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetServiceState<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>ServiceState<\/span> <\/span>currentServiceState<\/span>;<\/span><\/span>\n currentServiceState <\/span>=<\/span> VoiceControlManagerClient.ServiceState;<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the supported languages.<\/p>\nYou can use the <code>GetSupportedLanguages()<\/code> method of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class.\nThis function is used when the voice control manager is in the <code>Ready<\/code> or <code>Initialized<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetSupportedLanguages<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>List<\/span><<\/span>string<\/span>> <\/span>list<\/span> <\/span>=<\/span> (<\/span>List<\/span><<\/span>string<\/span>>)VoiceControlManagerClient.<\/span>GetSupportedLanguages<\/span>();<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the current language.<\/p>\nYou can use the <code>CurrentLanguage<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class.<\/p>\nUse the language change callback to get notifications for any language change.<\/p>\nThis function is not used when the voice control manager is in the <code>None<\/code> service status:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetCurrentLanguage<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>string<\/span> <\/span>currentLanguage<\/span> <\/span>=<\/span> VoiceControlManagerClient.CurrentLanguage;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet the microphone volume during recording.<\/p>\nYou can use the <code>RecordingVolume<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class.<\/p>\nThe recording volume value is retrieved periodically with the short-term recorded sound data as decibels (dB).<\/p>\nThe recording volume normally has a negative value, and 0 is the maximum value.<\/p>\nThis function is used when the voice control manager is in the <code>Recording<\/code> service state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetRecordingVolume<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>float<\/span> <\/span>recordingVolume<\/span> <\/span>=<\/span> VoiceControlManagerClient.RecordingVolume;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet or set the audio in type.<\/p>\nYou can use the <code>AudioType<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class.<\/p>\nThe audio type values can be <code>VC_AUDIO_ID_BLUETOOTH<\/code> or <code>VC_AUDIO_ID_MSF<\/code> in string.<\/p>\nThis function is used when the voice control manager is in the <code>Ready<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetSetAudioType<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Get<\/span><\/span>\n <\/span>string<\/span> <\/span>audioType<\/span> <\/span>=<\/span> VoiceControlManagerClient.AudioType;<\/span><\/span>\n<\/span>\n \/\/\/ Set <\/span><\/span>\n VoiceControlManagerClient.AudioType <\/span>=<\/span> audioType;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet or set the recognition mode.<\/p>\nYou can use the <code>RecognitionModeType<\/code> enumeration of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.RecognitionModeType.md/">Tizen.Uix.VoiceControlManager.RecognitionModeType enumeration as a parameter.<\/p>\nThe default value of <code>RecognitionModeType<\/code> is <code>RecognitionModeType.StopBySilence<\/code>. If you want to set the manual mode, you can use <code>RecognitionModeType.Manual<\/code>.<\/p>\nThis function is used when the voice control manager is in the <code>Ready<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetSetRecognitionMode<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Get<\/span><\/span>\n <\/span>RecognitionModeType<\/span> <\/span>recognitionModeType<\/span> <\/span>=<\/span> VoiceControlManagerClient.RecognitionMode;<\/span><\/span>\n<\/span>\n \/\/\/ Set<\/span><\/span>\n VoiceControlManagerClient.RecognitionMode <\/span>=<\/span> recognitionModeType;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nGet or set private data between the voice control manager and the voice control engine.<\/p>\nYou can use the <code>GetPrivateData()<\/code> and <code>SetPrivateData()<\/code> methods of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class.<\/p>\n<code>GetPrivateData()<\/code> is used when the parameters move from the voice control engine to the voice control manager, while <code>SetPrivateData()<\/code> is used when the parameters move from the voice control manager to the voice control engine.<\/p>\nThis option must be set when the voice control manager is in the <code>Ready<\/code> state:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetSetPrivateData<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Get<\/span><\/span>\n <\/span>string<\/span> <\/span>privateData<\/span> <\/span>=<\/span> VoiceControlManagerClient.<\/span>GetPrivateData<\/span>(<\/span>"privateKey"<\/span>);<\/span><\/span>\n<\/span>\n \/\/\/ Set<\/span><\/span>\n VoiceControlManagerClient.<\/span>SetPrivateData<\/span>(<\/span>"privateKey"<\/span>, <\/span>"privateData"<\/span>);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<a name=\"commands\"><\/a><\/p>\n<h2 id=\"content-manage-commands\"><a href=https://samsungtizenos.com/"#content-manage-commands\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Manage commands<\/h2>\nYou can use command group to manage the commands. You can add or remove the commands to the command group and retrieve the command information using the command group.<\/p>\nTo create a command group and commands, follow these steps:<\/p>\n<ol>\n<li>\nCreate a command group with a command group handle.<\/p>\nThe command group can have multiple commands. Each command has a text and a type.<\/p>\nThe group can have <code>Background<\/code>, <code>Exclusive<\/code>, <code>Foreground<\/code>, <code>System<\/code>, <code>SystemBackground<\/code>, and <code>Widget<\/code> type commands.<\/p>\nFor more information on the command types, see <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.CommandType.md/">Tizen.Uix.VoiceControlManager.CommandType enumeration.<\/p>\n<div class=\"md-alert md-alert-note\">\n<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\"><path d=\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13ZM6.5 7.75A.75.75 0 0 1 7.25 7h1a.75.75 0 0 1 .75.75v2.75h.25a.75.75 0 0 1 0 1.5h-2a.75.75 0 0 1 0-1.5h.25v-2h-.25a.75.75 0 0 1-.75-.75ZM8 6a1 1 0 1 1 0-2 1 1 0 0 1 0 2Z\"\/><\/svg>Note<\/span>\nThe order of command group priority is <code>System<\/code>, <code>Widget<\/code>, <code>Foreground<\/code>, <code>SystemBackground<\/code>, and <code>Background<\/code>. The <code>Exclusive<\/code> is used on special situation.\nNormally, the <code>System<\/code> and <code>SystemBackground<\/code> commands are only registered in the voice control manager.\nThe <code>Foreground<\/code> and <code>Background<\/code> commands are used in the voice control client application.\nThe <code>widget<\/code> command is automatically registered in the elementary on the screen.\nThe <code>Exclusive<\/code> commands have special priority, so these are used when recording starts with <code>VoiceControlManagerClient.Start(true)<\/code>.\nWhen recording starts with <code>VoiceControlManagerClient.Start(true)<\/code>, commands having other priorities are not recognized, only <code>Exclusive<\/code> commands are recognized.<\/p>\n<\/div>\nCreate the command group:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>CreateCommandGroup<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>VoiceCommandsGroup<\/span> <\/span>group<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommandsGroup<\/span>();<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nCreate a command.<\/p>\nFirst create a command handle, and then define the command and type:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>CreateCommand<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>VoiceCommand<\/span> <\/span>command<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommand<\/span>();<\/span><\/span>\n<\/span>\n command.Command <\/span>=<\/span> <\/span>"open"<\/span>;<\/span><\/span>\n command.Type <\/span>=<\/span> CommandType.Foreground;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nAdd the command to the command group:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>AddCommand<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>VoiceCommandsGroup<\/span> <\/span>group<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommandsGroup<\/span>();<\/span><\/span>\n <\/span>VoiceCommand<\/span> <\/span>command<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommand<\/span>();<\/span><\/span>\n command.Command <\/span>=<\/span> <\/span>"open"<\/span>;<\/span><\/span>\n command.Type <\/span>=<\/span> CommandType.Foreground;<\/span><\/span>\n group.Commands.<\/span>Add<\/span>(command);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\nIf necessary, you can also remove commands from the command group:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>RemoveCommand<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>VoiceCommand<\/span> <\/span>command<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommand<\/span>();<\/span><\/span>\n command.Command <\/span>=<\/span> <\/span>"open"<\/span>;<\/span><\/span>\n command.Type <\/span>=<\/span> CommandType.Foreground;<\/span><\/span>\n \/\/\/ Other actions<\/span><\/span>\n group.Commands.<\/span>Remove<\/span>(command);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\nTo retrieve the commands, you have to add the command list:<\/p>\n<ul>\n<li>\nYou can use the <code>GetCurrentCommands()<\/code> method of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceControlManagerClient.md/">Tizen.Uix.VoiceControlManager.VoiceControlManagerClient class to get all commands from the command list:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>ForeachCommand<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>IEnumerable<\/span><<\/span>VoiceCommand<\/span>> <\/span>command<\/span> <\/span>=<\/span> VoiceControlManagerClient.<\/span>GetCurrentCommands<\/span>();<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nYou can use the <code>Commands<\/code> property of the <a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.VoiceCommandsGroup.md/">Tizen.Uix.VoiceControlManager.VoiceCommandsGroup class to get the current commands in an output parameter.<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetCommands<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>VoiceCommand<\/span> <\/span>current_command<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommand<\/span>();<\/span><\/span>\n <\/span>VoiceCommandsGroup<\/span> <\/span>group<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommandsGroup<\/span>();<\/span><\/span>\n<\/span>\n \/\/\/ Other actions<\/span><\/span>\n<\/span>\n current_commands <\/span>=<\/span> group.Commands;<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<\/li>\n<li>\nRegister the commands for recognition by setting the command group to the voice control service.<\/p>\nIf you want to update the registered commands, set the command group again with the updated commands:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>SetCommand<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>VoiceCommandsGroup<\/span> <\/span>group<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommandsGroup<\/span>();<\/span><\/span>\n <\/span>VoiceCommand<\/span> <\/span>command<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommand<\/span>();<\/span><\/span>\n command.Command <\/span>=<\/span> <\/span>"test"<\/span>;<\/span><\/span>\n command.Type <\/span>=<\/span> CommandType.Foreground;<\/span><\/span>\n<\/span>\n group.Commands.<\/span>Add<\/span>(command);<\/span><\/span>\n<\/span>\n VoiceControlManagerClient.<\/span>SetCommands<\/span>(group);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nWhen no longer needed, unset the command group:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>\/\/\/ Unset the command group<\/span><\/span>\nvoid<\/span> <\/span>UnsetCommand<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>VoiceCommandsGroup<\/span> <\/span>group<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommandsGroup<\/span>();<\/span><\/span>\n <\/span>VoiceCommand<\/span> <\/span>command<\/span> <\/span>=<\/span> <\/span>new<\/span> <\/span>VoiceCommand<\/span>();<\/span><\/span>\n command.Command <\/span>=<\/span> <\/span>"test"<\/span>;<\/span><\/span>\n command.Type <\/span>=<\/span> CommandType.Foreground;<\/span><\/span>\n<\/span>\n group.Commands.<\/span>Remove<\/span>(command);<\/span><\/span>\n<\/span>\n VoiceControlManagerClient.<\/span>SetCommands<\/span>(group);<\/span><\/span>\n \/\/\/or<\/span><\/span>\n VoiceControlManagerClient.<\/span>ClearCommands<\/span>();<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ol>\n<a name=\"register_command\"><\/a><\/p>\n<h2 id=\"content-register-command\"><a href=https://samsungtizenos.com/"#content-register-command\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Register command<\/h2>\n<ul>\n<li>\nYou can register the commands for recognition by setting the command group to the voice control service from a file that includes the commands. The parameter <code>commandFilePath<\/code> is used to get the path of the file.\nIf you want to update the registered commands, set the command group again with the updated commands:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>SetCommandsFromFile<\/span>(<\/span>string<\/span> <\/span>commandFilePath<\/span>)<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ file path contents.<\/span><\/span>\n <\/span>\/*<\/span><\/span>\n {<\/span><\/span>\n "foreground": [<\/span><\/span>\n {<\/span><\/span>\n "format": "0",<\/span><\/span>\n "domain": "0",<\/span><\/span>\n "cmd": "open"<\/span><\/span>\n },<\/span><\/span>\n {<\/span><\/span>\n "format": "0",<\/span><\/span>\n "domain": "0",<\/span><\/span>\n "cmd": "test"<\/span><\/span>\n }<\/span><\/span>\n ]<\/span><\/span>\n }<\/span><\/span>\n *\/<\/span><\/span>\n<\/span>\n VoiceControlManagerClient.<\/span>SetCommandsFromFile<\/span>(commandFilePath, CommandType.Foreground);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nChecks whether the command format is supported:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>GetSupportedCommandFormat<\/span>()<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n <\/span>bool<\/span> <\/span>isSupported<\/span> <\/span>=<\/span> VoiceControlManagerClient.<\/span>IsSupportedCommandFormat<\/span>(CommandFormat.Action);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<li>\nEnable or disable command type as candidate command:<\/p>\n<pre class=\"shiki shiki-themes github-light github-dark\" style=\"background-color:#fff;--shiki-dark-bg:#24292e;color:#24292e;--shiki-dark:#e1e4e8;\"><code>void<\/span> <\/span>EnableDisableCommandType<\/span>(<\/span>CommandType<\/span> <\/span>cmdType<\/span>)<\/span><\/span>\n{<\/span><\/span>\n <\/span>try<\/span><\/span>\n {<\/span><\/span>\n VoiceControlManagerClient.<\/span>EnableCommandType<\/span>(cmdType);<\/span><\/span>\n VoiceControlManagerClient.<\/span>DisableCommandType<\/span>(cmdType);<\/span><\/span>\n }<\/span><\/span>\n <\/span>catch<\/span> (<\/span>Exception<\/span> <\/span>e<\/span>)<\/span><\/span>\n {<\/span><\/span>\n \/\/\/ Error handling<\/span><\/span>\n }<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre>\n<\/li>\n<\/ul>\n<h2 id=\"content-related-information\"><a href=https://samsungtizenos.com/"#content-related-information\" class=\"heading-permalink\" aria-hidden=\"true\" title=\"Permalink\">\u00b6<\/a>Related information<\/h2>\n<ul>\n<li>\nDependencies<\/p>\n<ul>\n<li>Tizen 5.5 and Higher<\/li>\n<\/ul>\n<\/li>\n<li>\nAPI References<\/p>\n<ul>\n<li><a href=https://samsungtizenos.com/"//application//dotnet//api//TizenFX//latest//api//Tizen.Uix.VoiceControlManager.md/">Tizen.Uix.VoiceControlManager/n

Customize your cookie preferences

Necessary

Analytics