Change Exceptions and Properties and Add API level

Change-Id: Ic0d7f7d752525fd7673738a569cd59ef006043d3
Signed-off-by: sooyeon.kim <sooyeon.kim@samsung.com>

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/DefaultLanguageChangedEventArgs.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/DefaultLanguageChangedEventArgs.cs
index e5e5dfd..7031f5d 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/DefaultLanguageChangedEventArgs.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/DefaultLanguageChangedEventArgs.cs
@@ -21,6 +21,7 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// This class holds information about the DefaultLanguageChanged Event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class DefaultLanguageChangedEventArgs
     {
         internal DefaultLanguageChangedEventArgs(string previous, string current)
@@ -32,6 +33,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The previous language
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string PreviousLanguage
         {
             get;
@@ -41,10 +43,11 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The current language
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string CurrentLanguage
         {
             get;
             internal set;
         }
     }
-}
\ No newline at end of file
+}

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/EngineChangedEventArgs.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/EngineChangedEventArgs.cs
index 51d7a23..3694bbd 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/EngineChangedEventArgs.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/EngineChangedEventArgs.cs
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// This class holds information related to Engine Changed Event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class EngineChangedEventArgs
     {
         internal EngineChangedEventArgs(string engineId, string language, bool supportSilence, bool needCredential)
@@ -33,6 +34,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Engine Id
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string EngineId
         {
             get;
@@ -42,6 +44,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Default Lanaguage
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string Language
         {
             get;
@@ -51,6 +54,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The necessity of credential
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public bool NeedCredential
         {
             get;
@@ -60,10 +64,11 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Whether the silence detection is supported or not
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public bool SupportSilence
         {
             get;
             internal set;
         }
     }
-}
\ No newline at end of file
+}

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/ErrorOccuredEventArgs.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/ErrorOccuredEventArgs.cs
index 0ac7e15..c860cdd 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/ErrorOccuredEventArgs.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/ErrorOccuredEventArgs.cs
@@ -23,6 +23,7 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// This class holds information related to the STT ErrorOccured Event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class ErrorOccuredEventArgs
     {
         private IntPtr _handle;
@@ -158,6 +159,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The Error Value
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public Error ErrorValue
         {
             get;
@@ -167,10 +169,11 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Gets the current error message.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// string error message
         /// </returns>
-        public string GetErrorMessage
+        public string ErrorMessage
         {
             get
             {
@@ -187,4 +190,4 @@ namespace Tizen.Uix.Stt
 
         }
     }
-}
\ No newline at end of file
+}

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/ExceptionFactory.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/ExceptionFactory.cs
index b1d07fc..5b59574 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/ExceptionFactory.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/ExceptionFactory.cs
@@ -30,7 +30,7 @@ namespace Tizen.Uix.Stt
             {
                 case SttError.OutOfMemory:
                     {
-                        exp = new InvalidOperationException("Out Of Memory");
+                        exp = new OutOfMemoryException("Out Of Memory");
                         break;
                     }
 
@@ -48,7 +48,7 @@ namespace Tizen.Uix.Stt
 
                 case SttError.TimedOut:
                     {
-                        exp = new InvalidOperationException("No answer from the STT service");
+                        exp = new TimeoutException("No answer from the STT service");
                         break;
                     }
 
@@ -60,13 +60,13 @@ namespace Tizen.Uix.Stt
 
                 case SttError.PermissionDenied:
                     {
-                        exp = new InvalidOperationException("Permission Denied");
+                        exp = new UnauthorizedAccessException("Permission Denied");
                         break;
                     }
 
                 case SttError.NotSupported:
                     {
-                        exp = new InvalidOperationException("STT NOT supported");
+                        exp = new NotSupportedException("STT NOT supported");
                         break;
                     }
 

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/RecognitionResultEventArgs.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/RecognitionResultEventArgs.cs
index b30c70c..2618585 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/RecognitionResultEventArgs.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/RecognitionResultEventArgs.cs
@@ -26,6 +26,7 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// The recognition result from the engine.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class RecognitionResultEventArgs
     {
         private ResultEvent _result;
@@ -100,6 +101,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The result event
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public ResultEvent Result
         {
             get
@@ -111,6 +113,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Result texts.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public IEnumerable<string> Data
         {
             get
@@ -122,6 +125,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Returns the Result text count.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int DataCount
         {
             get
@@ -133,6 +137,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Engine message
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public ResultMessage Message
         {
             get

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/ResultTime.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/ResultTime.cs
index d58e9c5..ecf0b91 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/ResultTime.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/ResultTime.cs
@@ -22,6 +22,7 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// This Class represents the result of recognition result from the engine.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class ResultTime
     {
         internal ResultTime(int index, TimeEvent e, string text, long startTime, long endTime)
@@ -36,6 +37,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The result index
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int Index
         {
             get;
@@ -45,6 +47,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The token event
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public TimeEvent TokenEvent
         {
             get;
@@ -54,6 +57,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The result text
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string Text
         {
             get;
@@ -63,6 +67,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The start time of result text
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public long StartTime
         {
             get;
@@ -72,6 +77,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The end time of result text
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public long EndTime
         {
             get;

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/StateChangedEventArgs.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/StateChangedEventArgs.cs
index afe4d89..eb55c4c 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/StateChangedEventArgs.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/StateChangedEventArgs.cs
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// This class holds information related to the STT StateChanged event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class StateChangedEventArgs
     {
         internal StateChangedEventArgs(State previous, State current)
@@ -31,6 +32,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// A previous state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public State Previous
         {
             get;
@@ -39,6 +41,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// A current state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public State Current
         {
             get;

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/SttClient.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/SttClient.cs
index cff37e9..4e52840 100644 (file)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/SttClient.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/SttClient.cs
@@ -25,233 +25,286 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// The token event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum ResultEvent
     {
         /// <summary>
         /// Event when the recognition full or last result is ready
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         FinalResult = 0,
         /// <summary>
         /// Event when the recognition partial result is ready
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         PartialResult,
         /// <summary>
         /// Event when the recognition has failed
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Error
     };
 
     /// <summary>
     /// Enumeration representing the result message
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum ResultMessage
     {
         /// <summary>
         /// No Error
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         None,
         /// <summary>
         /// Recognition failed  because the speech started too soon.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         TooSoon,
         /// <summary>
         /// Recognition failed  because the speech is too short.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         TooShort,
         /// <summary>
         /// Recognition failed  because the speech is too long.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         TooLong,
         /// <summary>
         /// Recognition failed  because the speech is too quiet to listen.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         TooQuiet,
         /// <summary>
         /// Recognition failed  because the speech is too loud to listen.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         TooLoud,
         /// <summary>
         /// Recognition failed  because the speech is too fast to listen.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         TooFast
     };
 
     /// <summary>
     /// Enumeration for the Token type
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum TimeEvent
     {
         /// <summary>
         /// Event when the token is beginning type
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Beginning = 0,
         /// <summary>
         /// Event when the token is middle type
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Middle = 1,
         /// <summary>
         /// Event when the token is end type
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         End = 2
     };
 
     /// <summary>
     /// Enum for Error values that can occur
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum Error
     {
         /// <summary>
         /// Successful, No error
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         None,
         /// <summary>
         /// Out of Memory
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         OutOfMemory,
         /// <summary>
         /// I/O error
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         IoError,
         /// <summary>
         /// Invalid parameter
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         InvalidParameter,
         /// <summary>
         /// No answer from the STT service
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         TimedOut,
         /// <summary>
         /// Device or resource busy
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         RecorderBusy,
         /// <summary>
         /// Network is down
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         OutOfNetwork,
         /// <summary>
         /// Permission denied
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         PermissionDenied,
         /// <summary>
         /// STT NOT supported
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         NotSupported,
         /// <summary>
         /// Invalid state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         InvalidState,
         /// <summary>
         /// Invalid language
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         InvalidLanguage,
         /// <summary>
         /// No available engine
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         EngineNotFound,
         /// <summary>
         /// Operation failed
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         OperationFailed,
         /// <summary>
         /// Not supported feature of current engine
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         NotSupportedFeature,
         /// <summary>
         /// Recording timed out
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         RecordingTimedOut,
         /// <summary>
         /// No speech while recording
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         NoSpeech,
         /// <summary>
         /// Progress to ready is not finished
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         InProgressToReady,
         /// <summary>
         /// Progress to recording is not finished
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         InProgressToRecording,
         /// <summary>
         /// Progress to processing is not finished
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         InProgressToProcessing,
         /// <summary>
         /// Service reset
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         ServiceReset
     };
 
     /// <summary>
     /// Enumeration for Recognition Types
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum RecognitionType
     {
         /// <summary>
         /// Free form dictation
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Free,
         /// <summary>
         /// Continuous free dictation.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Partial,
         /// <summary>
         /// Search
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Search,
         /// <summary>
         /// Web Search
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         WebSearch,
         /// <summary>
         /// Map
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Map
     };
 
     /// <summary>
     /// Enumeration for the State types
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum State
     {
         /// <summary>
         /// Created state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Created = 0,
         /// <summary>
         /// Ready state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Ready = 1,
         /// <summary>
         /// Recording state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Recording = 2,
         /// <summary>
         /// Processing state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Processing = 3,
         /// <summary>
         /// Unavailable
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Unavailable
     };
 
     /// <summary>
     /// Enumeration for the Silence Detection types
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum SilenceDetection
     {
         /// <summary>
         /// Silence detection type - False
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         False = 0,
         /// <summary>
         /// Silence detection type - True
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         True = 1,
         /// <summary>
         /// Silence detection type - Auto
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Auto = 2
     };
 
@@ -263,6 +316,7 @@ namespace Tizen.Uix.Stt
     /// The STT service always works in the background as a server. If the service is not working, client library will invoke it and client will communicate with it.
     /// The service has engines and the recorder so client does not have the recorder itself. Only the client request commands to the STT service for using STT.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class SttClient : IDisposable
     {
         private IntPtr _handle;
@@ -284,6 +338,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Constructor to create a STT instance.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -291,13 +346,10 @@ namespace Tizen.Uix.Stt
         /// http://tizen.org/feature/speech.recognition
         /// http://tizen.org/feature/microphone
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reaons
-        /// 1. Out Of Memory
-        /// 2. Operation Failed
-        /// 3. STT Not Supported
-        /// 4. Permission Denied
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Operation Failed. </exception>
+        /// <exception cref="OutOfMemoryException"> This Exception can be due to Out of Memory. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         public SttClient()
         {
             IntPtr handle;
@@ -314,6 +366,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Event to be invoked when the recognition is done.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<RecognitionResultEventArgs> RecognitionResult
         {
             add
@@ -363,6 +416,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Event to be invoked when STT state changes.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<StateChangedEventArgs> StateChanged
         {
             add
@@ -407,6 +461,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Event to be invoked when an error occurs.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<ErrorOccuredEventArgs> ErrorOccured
         {
             add
@@ -450,6 +505,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Event to be invoked when default laungage change.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<DefaultLanguageChangedEventArgs> DefaultLanguageChanged
         {
             add
@@ -496,6 +552,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Event to be invoked to detect engine change.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<EngineChangedEventArgs> EngineChanged
         {
             add
@@ -541,6 +598,7 @@ namespace Tizen.Uix.Stt
         /// The language is specified as an ISO 3166 alpha-2 two letter country-code followed by ISO 639-1 for the two-letter language code.
         /// For example, "ko_KR" for Korean, "en_US" for American English.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Default language in STT.
         /// </value>
@@ -550,7 +608,7 @@ namespace Tizen.Uix.Stt
         /// <returns>
         /// Default Lanaguage string value.
         /// </returns>
-        public string GetDefaultLanguage
+        public string DefaultLanguage
         {
             get
             {
@@ -572,6 +630,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Gets the microphone volume during recording.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Recording volume in STT.
         /// </value>
@@ -581,7 +640,7 @@ namespace Tizen.Uix.Stt
         /// <pre>
         /// The State must be Recording.
         /// </pre>
-        public float GetRecordingVolume
+        public float RecordingVolume
         {
             get
             {
@@ -605,6 +664,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Gets the current STT state.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Current state of STT.
         /// </value>
@@ -614,7 +674,7 @@ namespace Tizen.Uix.Stt
         /// <returns>
         /// Current STT State value.
         /// </returns>
-        public State GetState
+        public State CurrentState
         {
             get
             {
@@ -637,6 +697,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// This property can be used to get and set the current engine id.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Current STT engine id.
         /// </value>
@@ -645,15 +706,13 @@ namespace Tizen.Uix.Stt
         /// </privilege>
         /// <exception cref="InvalidOperationException">
         /// This Exception can occur while setting due to the following reaons
-        /// 1. Out Of Memory
-        /// 2. Operation Failed
-        /// 3. STT Not Supported
-        /// 4. Permission Denied
-        /// 5. Invalid State
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// This can happen if Improper EngineId is provided while setting the value.
+        /// 1. Operation Failed
+        /// 2. Invalid State
         /// </exception>
+        /// <exception cref="OutOfMemoryException"> This Exception can be due to Out of Memory. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
+        /// <exception cref="ArgumentException"> This can happen if Improper EngineId is provided while setting the value. </exception>
         /// <pre>
         /// The State must be Created.
         /// </pre>
@@ -692,6 +751,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Retrieves the time stamp of the current recognition result
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// list of ResultTime
         /// </returns>
@@ -705,12 +765,9 @@ namespace Tizen.Uix.Stt
         /// <remarks>
         /// This function should only be called in RecognitionResult Event
         /// </remarks>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reaons
-        /// 1. Opearation Failed.
-        /// 2. STT Not Supported
-        /// 3. Permission Denied.
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Opearation Failed. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         public IEnumerable<ResultTime> GetDetailedResult()
         {
             List<ResultTime> list = new List<ResultTime>();
@@ -733,6 +790,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Gets the private data from stt engine.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <param name="key">
         /// The key string
         /// </param>
@@ -746,12 +804,9 @@ namespace Tizen.Uix.Stt
         /// http://tizen.org/feature/speech.recognition
         /// http://tizen.org/feature/microphone
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reaons
-        /// 1. No Answer from STT Service
-        /// 2. STT Not Supported
-        /// 3. Invalid State
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Invalid State. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="TimeoutException"> This Exception can be due to No Answer from STT Service. </exception>
         /// <pre>
         /// The State must be Ready.
         /// </pre>
@@ -774,6 +829,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Sets the private data to stt engine.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <param name="key">
         /// The key string
         /// </param>
@@ -787,15 +843,10 @@ namespace Tizen.Uix.Stt
         /// http://tizen.org/feature/speech.recognition
         /// http://tizen.org/feature/microphone
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reaons
-        /// 1. No Answer from STT Service
-        /// 2. STT Not Supported
-        /// 3. Invalid State
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// This can happen if Improper value is provided while setting the value.
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Invalid State. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="TimeoutException"> This Exception can be due to No Answer from STT Service. </exception>
+        /// <exception cref="ArgumentException"> This can happen if Improper value is provided while setting the value. </exception>
         /// <pre>
         /// The State must be Ready.
         /// </pre>
@@ -815,6 +866,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Gets the list of Supported Engine
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// IEnumerable<SupportedEngine> list of supported engines
         /// </returns>
@@ -825,13 +877,10 @@ namespace Tizen.Uix.Stt
         /// http://tizen.org/feature/speech.recognition
         /// http://tizen.org/feature/microphone
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reaons
-        /// 1. Out Of Memory
-        /// 2. Operation Failed
-        /// 3. STT Not Supported
-        /// 4. Permission Denied
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Operation Failed. </exception>
+        /// <exception cref="OutOfMemoryException"> This Exception can be due to Out of Memory. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         public IEnumerable<SupportedEngine> GetSupportedEngines()
         {
             List<SupportedEngine> engineList = new List<SupportedEngine>();
@@ -859,6 +908,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Sets the app credential
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <param name="credential">
         /// The credential string
         /// </param>
@@ -871,15 +921,13 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. Out Of Memory
-        /// 2. Operation Failed
-        /// 3. STT Not Supported
-        /// 4. Permission Denied
-        /// 5. Invalid State
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// This can happen if Improper value is provided while setting the value.
+        /// 1. Operation Failed
+        /// 2. Invalid State
         /// </exception>
+        /// <exception cref="OutOfMemoryException"> This Exception can be due to Out of Memory. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
+        /// <exception cref="ArgumentException"> This can happen if Improper value is provided while setting the value. </exception>
         /// <pre>
         /// The State must be Created.
         /// </pre>
@@ -899,6 +947,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Connects to the STT service asynchronously.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -906,12 +955,9 @@ namespace Tizen.Uix.Stt
         /// http://tizen.org/feature/speech.recognition
         /// http://tizen.org/feature/microphone
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported
-        /// 2. Permission Denied
-        /// 3. Invalid State
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Invalid State. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         /// <pre>
         /// The State must be Created.
         /// </pre>
@@ -935,6 +981,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Disconnects from the STT service.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -942,12 +989,9 @@ namespace Tizen.Uix.Stt
         /// http://tizen.org/feature/speech.recognition
         /// http://tizen.org/feature/microphone
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported
-        /// 2. Permission Denied
-        /// 3. Invalid State
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Invalid State. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         /// <pre>
         /// The State must be Ready.
         /// </pre>
@@ -972,6 +1016,7 @@ namespace Tizen.Uix.Stt
         /// The language is specified as an ISO 3166 alpha-2 two letter country-code followed by ISO 639-1 for the two-letter language code.
         /// For example, "ko_KR" for Korean, "en_US" for American English.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -984,11 +1029,11 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported
-        /// 2. Permission Denied
-        /// 3. Engine Not Found.
-        /// 4. Operation Failed.
+        /// 1. Engine Not Found.
+        /// 2. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         public IEnumerable<string> GetSupportedLangauages()
         {
             List<string> languageList = new List<string>();
@@ -1015,6 +1060,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Checks whether the recognition type is supported.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1030,11 +1076,11 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported
-        /// 2. Invalid State
-        /// 3. Engine Not Found.
-        /// 4. Operation Failed.
+        /// 1. Invalid State
+        /// 2. Engine Not Found.
+        /// 3. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
         /// <pre>
         /// The state should be Ready.
         /// </pre>
@@ -1093,6 +1139,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Sets the silence detection.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1105,11 +1152,11 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported
-        /// 2. Invalid State
-        /// 3. Not supported feature of current engine.
-        /// 4. Operation Failed.
+        /// 1. Invalid State
+        /// 2. Not supported feature of current engine.
+        /// 3. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
         /// <pre>
         /// The state should be Ready.
         /// </pre>
@@ -1130,6 +1177,7 @@ namespace Tizen.Uix.Stt
         /// Sets the sound to start recording.
         /// Sound file type should be wav type.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1142,14 +1190,12 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported.
-        /// 2. Permission Denied.
-        /// 3. Invalid State.
-        /// 4. Operation Failed.
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// If an Invalid Parameter is provided.
+        /// 1. Invalid State.
+        /// 2. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
+        /// <exception cref="ArgumentException"> If an Invalid Parameter is provided. </exception>
         /// <pre>
         /// The state should be Ready.
         /// </pre>
@@ -1169,6 +1215,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Unsets the sound to start recording.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1178,11 +1225,11 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported.
-        /// 2. Permission Denied.
-        /// 3. Invalid State.
-        /// 4. Operation Failed.
+        /// 1. Invalid State.
+        /// 2. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         /// <pre>
         /// The state should be Ready.
         /// </pre>
@@ -1203,6 +1250,7 @@ namespace Tizen.Uix.Stt
         /// Sets the sound to stop recording.
         /// Sound file type should be wav type.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1215,14 +1263,12 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported.
-        /// 2. Permission Denied.
-        /// 3. Invalid State.
-        /// 4. Operation Failed.
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// If an Invalid Parameter is provided.
+        /// 1. Invalid State.
+        /// 2. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
+        /// <exception cref="ArgumentException"> If an Invalid Parameter is provided. </exception>
         /// <pre>
         /// The state should be Ready.
         /// </pre>
@@ -1242,6 +1288,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Unsets the sound to stop recording.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1251,11 +1298,11 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported.
-        /// 2. Permission Denied.
-        /// 3. Invalid State.
-        /// 4. Operation Failed.
+        /// 1. Invalid State.
+        /// 2. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         /// <pre>
         /// The state should be Ready.
         /// </pre>
@@ -1277,6 +1324,7 @@ namespace Tizen.Uix.Stt
         /// This function starts recording in the STT service and sending recording data to engine.
         /// This work continues until Stop, Cancel or silence detected by engine
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1292,16 +1340,14 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported.
-        /// 2. Permission Denied.
-        /// 3. Invalid State.
-        /// 4. Operation Failed.
-        /// 5. Recorder Busy.
-        /// 6. Progress to recording is not finished
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// If an Invalid Language is provided
+        /// 1. Invalid State.
+        /// 2. Operation Failed.
+        /// 3. Recorder Busy.
+        /// 4. Progress to recording is not finished
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
+        /// <exception cref="ArgumentException"> If an Invalid Language is provided. </exception>
         /// <pre>
         /// The state should be Ready.
         /// </pre>
@@ -1361,6 +1407,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// Finishes the recording and starts recognition processing in engine asynchronously.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1370,14 +1417,14 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported.
-        /// 2. Permission Denied.
-        /// 3. Invalid State.
-        /// 4. Operation Failed.
-        /// 5. Progress to ready is not finished.
-        /// 6. Progress to recording is not finished.
-        /// 7. Progress to processing is not finished.
+        /// 1. Invalid State.
+        /// 2. Operation Failed.
+        /// 3. Progress to ready is not finished.
+        /// 4. Progress to recording is not finished.
+        /// 5. Progress to processing is not finished.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         /// <pre>
         /// The state should be Recording.
         /// </pre>
@@ -1405,6 +1452,7 @@ namespace Tizen.Uix.Stt
         /// This function cancels recording and engine cancels recognition processing.
         /// After successful cancel, StateChanged event is invoked otherwise if error is occurred, ErrorOccured event is invoked.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <privilege>
         /// http://tizen.org/privilege/recorder
         /// </privilege>
@@ -1414,14 +1462,14 @@ namespace Tizen.Uix.Stt
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. STT Not Supported.
-        /// 2. Permission Denied.
-        /// 3. Invalid State.
-        /// 4. Operation Failed.
-        /// 5. Progress to ready is not finished.
-        /// 6. Progress to recording is not finished.
-        /// 7. Progress to processing is not finished.
+        /// 1. Invalid State.
+        /// 2. Operation Failed.
+        /// 3. Progress to ready is not finished.
+        /// 4. Progress to recording is not finished.
+        /// 5. Progress to processing is not finished.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to STT Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         /// <pre>
         /// The state should be Recording or Processing.
         /// </pre>

diff --git a/Tizen.Uix.Stt/Tizen.Uix.Stt/SupportedEngine.cs b/Tizen.Uix.Stt/Tizen.Uix.Stt/SupportedEngine.cs
index 3d0050f..d2129e8 100755 (executable)
--- a/Tizen.Uix.Stt/Tizen.Uix.Stt/SupportedEngine.cs
+++ b/Tizen.Uix.Stt/Tizen.Uix.Stt/SupportedEngine.cs
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Stt
     /// <summary>
     /// This Class provideds the Information related to STT Engine.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class SupportedEngine
     {
         private string _engineId;
@@ -33,6 +34,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The Engine Id
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// The string Engine Id
         /// </returns>
@@ -47,6 +49,7 @@ namespace Tizen.Uix.Stt
         /// <summary>
         /// The Engine Name
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// The string Engine Name
         /// </returns>

diff --git a/packaging/csapi-uix-stt.spec b/packaging/csapi-uix-stt.spec
index 06c8faa..2e08c4c 100755 (executable)
--- a/packaging/csapi-uix-stt.spec
+++ b/packaging/csapi-uix-stt.spec
@@ -1,6 +1,6 @@
 Name:       csapi-uix-stt
 Summary:    Tizen STT Uix API for C#
-Version:    1.0.2
+Version:    1.0.3
 Release:    1
 Group:      Development/Libraries
 License:    Apache-2.0