Change Exceptions and Properties and Add API level
authorsooyeon.kim <sooyeon.kim@samsung.com>
Wed, 31 May 2017 07:13:15 +0000 (16:13 +0900)
committersooyeon.kim <sooyeon.kim@samsung.com>
Tue, 4 Jul 2017 10:36:59 +0000 (19:36 +0900)
Change-Id: I2c8cc3ee3e78b0774b78bac9b0dcc739d77ee430
Signed-off-by: sooyeon.kim <sooyeon.kim@samsung.com>
packaging/csapi-uix-tts.spec
src/Tizen.Uix.Tts/Tizen.Uix.Tts/DefaultVoiceChangedEventArgs.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/EngineChangedEventArgs.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/ErrorOccuredEventArgs.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/ExceptionFactory.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/SpeedRange.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/StateChangedEventArgs.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/SupportedVoice.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/TtsClient.cs
src/Tizen.Uix.Tts/Tizen.Uix.Tts/UtteranceEventArgs.cs

index fa35438..f7493f2 100755 (executable)
@@ -1,6 +1,6 @@
 Name:       csapi-uix-tts
 Summary:    Tizen TTS Uix API for C#
-Version:    1.0.2
+Version:    1.0.3
 Release:    1
 Group:      Development/Libraries
 License:    Apache-2.0
index 2461733..6ece3cc 100755 (executable)
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Tts
     /// <summary>
     /// This Class holds information related to DefaultVoiceChanged Event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class DefaultVoiceChangedEventArgs
     {
         internal DefaultVoiceChangedEventArgs(string previousLanguage, int previousVoiceType, string currentLanguage, int currentVoiceType)
@@ -31,6 +32,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The Previous SupportedVoice
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public SupportedVoice Previous
         {
             get;
@@ -40,6 +42,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The current SupportedVoice
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public SupportedVoice Current
         {
             get;
index 78da32e..6419660 100755 (executable)
@@ -22,6 +22,7 @@ namespace Tizen.Uix.Tts
     /// <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, int voiceType, bool needCredential)
@@ -34,6 +35,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Engine Id
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public string EngineId
         {
             get;
@@ -43,6 +45,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The necessity of credential
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public bool NeedCredential
         {
             get;
@@ -52,6 +55,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The supported voice
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public SupportedVoice VoiceType
         {
             get;
index 7916391..dd173dc 100755 (executable)
@@ -23,6 +23,7 @@ namespace Tizen.Uix.Tts
     /// <summary>
     /// This class holds information related to the TTS ErrorOccured Event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class ErrorOccuredEventArgs
     {
         private IntPtr _handle;
@@ -116,6 +117,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The Utterance Id
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int UtteranceId
         {
             get;
@@ -125,6 +127,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The Error Value
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public Error ErrorValue
         {
             get;
@@ -134,10 +137,11 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Gets the current error message.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// string error message
         /// </returns>
-        public string GetErrorMessage
+        public string ErrorMessage
         {
             get
             {
index dd05ab7..a29d9dd 100755 (executable)
@@ -30,7 +30,7 @@ namespace Tizen.Uix.Tts
             {
                 case TtsError.OutOfMemory:
                     {
-                        exp = new InvalidOperationException("Out Of Memory");
+                        exp = new OutOfMemoryException("Out Of Memory");
                         break;
                     }
 
@@ -48,7 +48,7 @@ namespace Tizen.Uix.Tts
 
                 case TtsError.TimedOut:
                     {
-                        exp = new InvalidOperationException("No answer from the STT service");
+                        exp = new TimeoutException("No answer from the TTS service");
                         break;
                     }
 
@@ -60,13 +60,13 @@ namespace Tizen.Uix.Tts
 
                 case TtsError.PermissionDenied:
                     {
-                        exp = new InvalidOperationException("Permission Denied");
+                        exp = new UnauthorizedAccessException("Permission Denied");
                         break;
                     }
 
                 case TtsError.NotSupported:
                     {
-                        exp = new InvalidOperationException("STT NOT supported");
+                        exp = new NotSupportedException("TTS NOT supported");
                         break;
                     }
 
index 9911355..dbe1f68 100755 (executable)
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Tts
     /// <summary>
     /// This class holds the Speed Range Values
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class SpeedRange
     {
         internal SpeedRange(int min, int normal, int max)
@@ -32,6 +33,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The Max Speed Range Value
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int Max
         {
             get;
@@ -41,6 +43,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The Min Speed Range Value
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int Min
         {
             get;
@@ -50,6 +53,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The Normal Speed Range Value
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int Normal
         {
             get;
index 7c6bffa..ba1db04 100755 (executable)
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Tts
     /// <summary>
     /// This class holds information related to the TTS state change event
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class StateChangedEventArgs
     {
         internal StateChangedEventArgs(State previous, State current)
@@ -31,6 +32,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// A previous state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public State Previous
         {
             get;
@@ -40,6 +42,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// A current state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public State Current
         {
             get;
index a79a1fd..eb6f75b 100755 (executable)
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Tts
     /// <summary>
     /// This Class holds information about the Supported Voices.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class SupportedVoice
     {
         internal SupportedVoice(string lang, int voiceType)
@@ -55,6 +56,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Language 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>
         public string Language
         {
             get;
index d91e54b..a8dedcc 100755 (executable)
@@ -25,137 +25,166 @@ namespace Tizen.Uix.Tts
     /// <summary>
     /// Enumeration for States
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum State
     {
         /// <summary>
         /// Created atate
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Created = 0,
 
         /// <summary>
         /// Ready state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Ready = 1,
 
         /// <summary>
         /// Playing state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Playing = 2,
 
         /// <summary>
         /// Paused state
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Paused = 3,
 
         /// <summary>
         /// state Unavailable
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Unavailable
     };
 
     /// <summary>
     /// Enumeration for TTS mode.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum Mode
     {
         /// <summary>
         /// Default mode for normal application
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Default = 0,
 
         /// <summary>
         /// Notification mode
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Notification = 1,
 
         /// <summary>
         /// Accessibiliity mode
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         ScreenReader = 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>
         /// 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 Voice
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         InvalidVoice,
         /// <summary>
         /// No available engine
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         EngineNotFound,
         /// <summary>
         /// Operation failed
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         OperationFailed,
         /// <summary>
         /// Audio policy blocked
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         AudioPolicyBlocked
     };
 
     /// <summary>
     /// Enumeration for Voice Types
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public enum Voice
     {
         /// <summary>
         /// Automatic Voice Type
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Auto,
 
         /// <summary>
         /// Male Voice
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Male,
 
         /// <summary>
         /// Female Voice
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Female,
 
         /// <summary>
         /// Child Voice Type
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         Child
     };
 
@@ -163,6 +192,7 @@ namespace Tizen.Uix.Tts
     /// You can use Text-To-Speech (TTS) API's to read sound data transformed by the engine from input texts.
     /// Applications can add input-text to queue for reading continuously and control the player that can play, pause, and stop sound data synthesized from text.
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class TtsClient : IDisposable
     {
         private IntPtr _handle;
@@ -185,16 +215,17 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Constructor to create a TTS instance.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <feature>
         /// http://tizen.org/feature/speech.synthesis
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. Out Of Memory
-        /// 2. Operation Failed
-        /// 3. TTS Not Supported
-        /// 4. Engine Not Found
+        /// 1. Operation Failed
+        /// 2. Engine Not Found
         /// </exception>
+        /// <exception cref="OutOfMemoryException"> This Exception can be due to Out Of Memory. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         public TtsClient()
         {
             IntPtr handle;
@@ -211,6 +242,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Event to be invoked when TTS state changes.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<StateChangedEventArgs> StateChanged
         {
             add
@@ -254,6 +286,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Event to be invoked when the utterance starts.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<UtteranceEventArgs> UtteranceStarted
         {
             add
@@ -295,6 +328,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Event to be invoked when the utterance completes.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<UtteranceEventArgs> UtteranceCompleted
         {
             add
@@ -336,6 +370,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Event to be invoked when an error occurs.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<ErrorOccuredEventArgs> ErrorOccured
         {
             add
@@ -378,6 +413,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Event to be invoked when an error occurs.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<DefaultVoiceChangedEventArgs> DefaultVoiceChanged
         {
             add
@@ -423,6 +459,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Event to be invoked to detect engine change.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public event EventHandler<EngineChangedEventArgs> EngineChanged
         {
             add
@@ -466,6 +503,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Gets the default voice set by the user.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Default voice in TTS
         /// </value>
@@ -495,6 +533,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Gets the maximum byte size for text.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Maximum byte size for text
         /// </value>
@@ -504,7 +543,7 @@ namespace Tizen.Uix.Tts
         /// <pre>
         /// The State should be Ready
         /// </pre>
-        public uint GetMaxTextSize
+        public uint MaxTextSize
         {
             get
             {
@@ -528,13 +567,14 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Gets the current TTS state.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Current state of TTS
         /// </value>
         /// <returns>
         /// Current TTS State value.
         /// </returns>
-        public State GetState
+        public State CurrentState
         {
             get
             {
@@ -558,6 +598,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The TTS Mode can be set using this property
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <value>
         /// Current mode of TTS (default, screen-reader, notification)
         /// </value>
@@ -566,11 +607,11 @@ namespace Tizen.Uix.Tts
         /// </returns>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons while setting the value
-        /// 1. Out Of Memory
-        /// 2. Operation Failed
-        /// 3. TTS Not Supported
-        /// 4. Engine Not Found
+        /// 1. Operation Failed
+        /// 2. Engine Not Found
         /// </exception>
+        /// <exception cref="OutOfMemoryException"> This Exception can be due to Out Of Memory. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         /// <pre>
         /// State should be Created
         /// </pre>
@@ -610,20 +651,16 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Sets the app credential
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <param name="credential">
         /// The credential string
         /// </param>
         /// <feature>
         /// http://tizen.org/feature/speech.synthesis
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. 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 TTS Not Supported. </exception>
+        /// <exception cref="ArgumentException"> This can happen if Improper value is provided while setting the value. </exception>
         /// <pre>
         /// The State must be Created or Ready.
         /// </pre>
@@ -643,14 +680,12 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Connects to the TTS service asynchronously.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <feature>
         /// http://tizen.org/feature/speech.synthesis
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reasons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Invalid State. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         /// <pre>
         /// The State must be Created.
         /// </pre>
@@ -674,14 +709,12 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Disconnects from the STT service.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <feature>
         /// http://tizen.org/feature/speech.synthesis
         /// </feature>
-        /// <exception cref="InvalidOperationException">
-        /// This Exception can be due to the following reasons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// </exception>
+        /// <exception cref="InvalidOperationException"> This Exception can be due to Invalid State. </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         /// <pre>
         /// The State must be Ready.
         /// </pre>
@@ -704,6 +737,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Retrieves all supported voices of the current engine.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// list of SupportedVoice.
         /// </returns>
@@ -712,10 +746,10 @@ namespace Tizen.Uix.Tts
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reasons
-        /// 1. TTS Not Supported
-        /// 2. Engine Not Found.
-        /// 3. Operation Failed.
+        /// 1. Engine Not Found.
+        /// 2. Operation Failed.
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         public IEnumerable<SupportedVoice> GetSupportedVoices()
         {
             List<SupportedVoice> voicesList = new List<SupportedVoice>();
@@ -743,6 +777,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Gets the private data from tts engine.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <param name="key">
         /// The key string
         /// </param>
@@ -754,11 +789,11 @@ namespace Tizen.Uix.Tts
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// 3. Engine Not found
-        /// 4. Operation Failure
+        /// 1. Invalid State
+        /// 2. Engine Not found
+        /// 3. Operation Failure
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         /// <pre>
         /// The State must be Ready.
         /// </pre>
@@ -782,6 +817,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Sets the private data to tts engine.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <param name="key">
         /// The key string
         /// </param>
@@ -793,14 +829,12 @@ namespace Tizen.Uix.Tts
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// 3. Engine Not found
-        /// 4. Operation Failure
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// This can happen if Improper value is provided while setting the value.
+        /// 1. Invalid State
+        /// 2. Engine Not found
+        /// 3. Operation Failure
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
+        /// <exception cref="ArgumentException"> This can happen if Improper value is provided while setting the value. </exception>
         /// <pre>
         /// The State must be Ready.
         /// </pre>
@@ -820,6 +854,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Gets the speed range.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <returns>
         /// The SpeedRange value
         /// </returns>
@@ -828,10 +863,10 @@ namespace Tizen.Uix.Tts
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// 3. Operation Failure
+        /// 1. Invalid State
+        /// 2. Operation Failure
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         /// <pre>
         /// The State must be Created.
         /// </pre>
@@ -855,6 +890,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Adds a text to the queue.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <remarks>
         /// Locale MUST be set for utf8 text validation check.
         /// </remarks>
@@ -878,15 +914,13 @@ namespace Tizen.Uix.Tts
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// 3. Operation Failure
-        /// 4. Invalid Voice
-        /// 5. Permission Denied
-        /// </exception>
-        /// <exception cref="ArgumentException">
-        /// This can happen if Improper value is provided.
+        /// 1. Invalid State
+        /// 2. Operation Failure
+        /// 3. Invalid Voice
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS 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. </exception>
         /// <pre>
         /// The State must be Ready or Playing or Paused.
         /// </pre>
@@ -910,17 +944,18 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Starts synthesizing voice from the text and plays the synthesized audio data.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <feature>
         /// http://tizen.org/feature/speech.synthesis
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// 3. Operation Failure
-        /// 4. Out of Network
-        /// 5. Permission Denied
+        /// 1. Invalid State
+        /// 2. Operation Failure
+        /// 3. Out of Network
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
+        /// <exception cref="UnauthorizedAccessException"> This Exception can be due to Permission Denied. </exception>
         /// <pre>
         /// The State must be Ready or Paused.
         /// </pre>
@@ -943,15 +978,16 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Stops playing the utterance and clears the queue.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <feature>
         /// http://tizen.org/feature/speech.synthesis
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// 3. Operation Failure
+        /// 1. Invalid State
+        /// 2. Operation Failure
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         /// <pre>
         /// The State must be Ready or Playing or Paused.
         /// </pre>
@@ -975,15 +1011,16 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Pauses the currently playing utterance.
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         /// <feature>
         /// http://tizen.org/feature/speech.synthesis
         /// </feature>
         /// <exception cref="InvalidOperationException">
         /// This Exception can be due to the following reaons
-        /// 1. TTS Not Supported
-        /// 2. Invalid State
-        /// 3. Operation Failure
+        /// 1. Invalid State
+        /// 2. Operation Failure
         /// </exception>
+        /// <exception cref="NotSupportedException"> This Exception can be due to TTS Not Supported. </exception>
         /// <pre>
         /// The State must be Playing.
         /// </pre>
@@ -1006,6 +1043,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// Method to release resources
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public void Dispose()
         {
             Dispose(true);
index afe841a..ba06b1d 100755 (executable)
@@ -20,6 +20,7 @@ namespace Tizen.Uix.Tts
     /// <summary>
     /// This Class hold information related to UtteranceStared and UtteranceCompleted Events
     /// </summary>
+    /// <since_tizen> 3 </since_tizen>
     public class UtteranceEventArgs
     {
         internal UtteranceEventArgs(int uttId)
@@ -30,6 +31,7 @@ namespace Tizen.Uix.Tts
         /// <summary>
         /// The utterance ID
         /// </summary>
+        /// <since_tizen> 3 </since_tizen>
         public int UtteranceId
         {
             get;