os/mm/mmdevicefw/speechrecogsupport/ASR/inc/mmf/common/SpeechRecognitionCustomCommands.h
changeset 0 bde4ae8d615e
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/mm/mmdevicefw/speechrecogsupport/ASR/inc/mmf/common/SpeechRecognitionCustomCommands.h	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,667 @@
     1.4 +// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +//
    1.18 +
    1.19 +#ifndef __SPEECHRECOGNITIONCUSTOMCOMMANDS_H__
    1.20 +#define __SPEECHRECOGNITIONCUSTOMCOMMANDS_H__
    1.21 +
    1.22 +//  INCLUDES
    1.23 +#include	<mmf/common/mmfcontroller.h>
    1.24 +#include 	<mmf/common/speechrecognitiondataclient.h>
    1.25 +
    1.26 +/**
    1.27 +@publishedAll
    1.28 +@released
    1.29 +
    1.30 +This is the main class of Speech Recognition Custom Commands.
    1.31 +
    1.32 +@since  8.0
    1.33 +*/
    1.34 +class RSpeechRecognitionCustomCommands : public RMMFCustomCommandsBase
    1.35 +	{
    1.36 +public:
    1.37 +	/**
    1.38 +	Public C++ constructor for RSpeechRecognitionCustomCommands class.
    1.39 +
    1.40 +	@param  aController			
    1.41 +	        A reference to a RMMFController object.
    1.42 +
    1.43 +	@since  8.0
    1.44 +	*/
    1.45 +	IMPORT_C RSpeechRecognitionCustomCommands(RMMFController& aController);
    1.46 +	
    1.47 +	/** 
    1.48 +	Adds a new pronunciation for the given model into the specified lexicon.
    1.49 +
    1.50 +	@param  aLexiconID
    1.51 +	        The lexicon ID to where the new pronunciation is added.
    1.52 +	@param  aModelBankID
    1.53 +	        The model bank ID.
    1.54 +	@param  aModelID
    1.55 +	        The model ID.
    1.56 +	@param  aPronunciationID
    1.57 +	        A reference to where a new pronunciation ID is assigned.
    1.58 +
    1.59 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
    1.60 +	        another of the system-wide error codes.
    1.61 +
    1.62 +	@since  8.0
    1.63 +	*/
    1.64 +	IMPORT_C TInt AddPronunciation(TLexiconID aLexiconID,
    1.65 +					TModelBankID aModelBankID, TModelID aModelID,
    1.66 +					TPronunciationID& aPronunciationID);
    1.67 +
    1.68 +	/**
    1.69 +	Adds a new rule for the given pronunciation into the specified grammar.
    1.70 +
    1.71 +	@param  aGrammarID			
    1.72 +	        The grammar ID to where the new rule is added.
    1.73 +	@param  aLexiconID			
    1.74 +	        The lexicon ID.
    1.75 +	@param  aPronunciationID	
    1.76 +	        The pronunciation ID.
    1.77 +	@param  aRuleID				
    1.78 +	        A reference to where a new rule ID is assigned.
    1.79 +
    1.80 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
    1.81 +	        another of the system-wide error codes.
    1.82 +
    1.83 +	@since  8.0
    1.84 +	*/
    1.85 +	IMPORT_C TInt AddRule(TGrammarID aGrammarID, TLexiconID aLexiconID,
    1.86 +					TPronunciationID aPronunciationID, TRuleID& aRuleID);
    1.87 +
    1.88 +	/**
    1.89 +	Cancels the current operation.
    1.90 +
    1.91 +	@since  8.0
    1.92 +	*/
    1.93 +	IMPORT_C void Cancel();
    1.94 +
    1.95 +	/**
    1.96 +	Commits the current train operation to the database.
    1.97 +
    1.98 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
    1.99 +	        another of the system-wide error codes.
   1.100 +
   1.101 +	@since  8.0
   1.102 +	*/
   1.103 +	IMPORT_C TInt CommitChanges();
   1.104 +
   1.105 +	/**
   1.106 +	Creates a new grammar.
   1.107 +
   1.108 +	@param  aGrammarID
   1.109 +	        A reference to where the grammar ID is stored.
   1.110 +
   1.111 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.112 +	        another of the system-wide error codes.
   1.113 +
   1.114 +	@since  8.0
   1.115 +    */
   1.116 +	IMPORT_C TInt CreateGrammar(TGrammarID& aGrammarID);
   1.117 +
   1.118 +	/**
   1.119 +	Creates a new lexicon.
   1.120 +
   1.121 +	@param  aLexiconID			
   1.122 +	        A reference where lexicon ID is stored.
   1.123 +
   1.124 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.125 +	        another of the system-wide error codes.
   1.126 +
   1.127 +	@since  8.0
   1.128 +    */
   1.129 +	IMPORT_C TInt CreateLexicon(TLexiconID& aLexiconID);
   1.130 +
   1.131 +    /**
   1.132 +	Creates a new model bank.
   1.133 +
   1.134 +	@param  aModelBankID		
   1.135 +	        A reference to where a new model bank ID is assigned.
   1.136 +
   1.137 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.138 +	        another of the system-wide error codes.
   1.139 +
   1.140 +	@since  8.0
   1.141 +    */
   1.142 +	IMPORT_C TInt CreateModelBank(TModelBankID& aModelBankID);
   1.143 +
   1.144 +	/**
   1.145 +	Ends the current recognition session.
   1.146 +	
   1.147 +	The resources allocated for recognition are freed.
   1.148 +
   1.149 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.150 +	        another of the system-wide error codes.
   1.151 +
   1.152 +	@since  8.0
   1.153 +    */
   1.154 +	IMPORT_C TInt EndRecSession();
   1.155 +
   1.156 +	/**
   1.157 +	Returns all grammar IDs owned by the client.
   1.158 +
   1.159 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.160 +	        another of the system-wide error codes.
   1.161 +
   1.162 +	@since  8.0
   1.163 +    */
   1.164 +	IMPORT_C TInt GetAllClientGrammarIDs();
   1.165 +
   1.166 +	/**
   1.167 +	Returns all lexicon IDs owned by the client.
   1.168 +
   1.169 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.170 +	        another of the system-wide error codes.
   1.171 +	
   1.172 +	@since  8.0
   1.173 +    */
   1.174 +	IMPORT_C TInt GetAllClientLexiconIDs();
   1.175 +
   1.176 +	/**
   1.177 +	Returns all modelBank IDs owned by the client.
   1.178 +
   1.179 +    @return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.180 +	           another of the system-wide error codes.
   1.181 +
   1.182 +	@since  8.0
   1.183 +    */
   1.184 +	IMPORT_C TInt GetAllClientModelBankIDs();
   1.185 +
   1.186 +	/**
   1.187 +	Returns all grammar IDs owned by the client.
   1.188 +
   1.189 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.190 +	        another of the system-wide error codes.
   1.191 +
   1.192 +	@since  8.0
   1.193 +    */
   1.194 +	IMPORT_C TInt GetAllGrammarIDs();
   1.195 +
   1.196 +	/**
   1.197 +	Returns all lexicon IDs owned by the client.
   1.198 +
   1.199 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.200 +	        another of the system-wide error codes.
   1.201 +
   1.202 +	@since  8.0
   1.203 +    */
   1.204 +	IMPORT_C TInt GetAllLexiconIDs();
   1.205 +
   1.206 +
   1.207 +	/**
   1.208 +	Returns all modelBank IDs owned by the client.
   1.209 +
   1.210 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.211 +	        another of the system-wide error codes.
   1.212 +
   1.213 +	@since  8.0
   1.214 +    */
   1.215 +	IMPORT_C TInt GetAllModelBankIDs();
   1.216 +
   1.217 +	/**
   1.218 +	Returns all model IDs that exist in the specified model bank.
   1.219 +
   1.220 +	@param  aModelBankID		
   1.221 +	        The model bank ID.
   1.222 +
   1.223 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.224 +	        another of the system-wide error codes.
   1.225 +
   1.226 +	@since  8.0
   1.227 +    */
   1.228 +	IMPORT_C TInt GetAllModelIDs(TModelBankID aModelBankID);
   1.229 +
   1.230 +	/**
   1.231 +	Returns all pronunciation IDs that exist in the specified lexicon.
   1.232 +
   1.233 +	@param  aLexiconID			
   1.234 +	        The lexicon ID.
   1.235 +
   1.236 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.237 +	        another of the system-wide error codes.
   1.238 +
   1.239 +	@since  8.0
   1.240 +    */
   1.241 +	IMPORT_C TInt GetAllPronunciationIDs(TLexiconID aLexiconID);
   1.242 +
   1.243 +	/**
   1.244 +	Returns all rule IDs that exist in the specified grammar.
   1.245 +
   1.246 +    @param  aGrammarID			
   1.247 +	        The grammar ID.
   1.248 +
   1.249 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.250 +	        another of the system-wide error codes.
   1.251 +
   1.252 +	@since  8.0
   1.253 +    */
   1.254 +	IMPORT_C TInt GetAllRuleIDs(TGrammarID aGrammarID);
   1.255 +
   1.256 +	/**
   1.257 +	Returns the number of models available for training system wide,
   1.258 +	based on available disk space.
   1.259 +
   1.260 +	@param  aAvailableStorage	
   1.261 +	        The number of models that can be held in available storage space.
   1.262 +
   1.263 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.264 +	        another of the system-wide error codes.
   1.265 +
   1.266 +	@since  8.0
   1.267 +    */
   1.268 +	IMPORT_C TInt GetAvailableStorage(TInt& aAvailableStorage);
   1.269 +
   1.270 +	/**
   1.271 +	Returns the engine properties specified by the engine property
   1.272 +	ID array. On return aPropertyValue contains an array of engine
   1.273 +	properties.
   1.274 +
   1.275 +	@param  aPropertyId		
   1.276 +	        A constant reference to an array of engine property IDs.
   1.277 +	@param  aPropertyValue	
   1.278 +	        A reference to an array of engine property values.
   1.279 +
   1.280 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.281 +	        another of the system-wide error codes.
   1.282 +
   1.283 +	@since  8.0
   1.284 +    */
   1.285 +	IMPORT_C TInt GetEngineProperties(const RArray<TInt>& aPropertyId,
   1.286 +					RArray<TInt>& aPropertyValue);
   1.287 +
   1.288 +	/**
   1.289 +	Returns the number of models in the specified model bank.
   1.290 +
   1.291 +	@param  aModelBankID		
   1.292 +	        The model bank ID.
   1.293 +	@param  aModelCount			
   1.294 +	        The reference where the number of models is set.
   1.295 +
   1.296 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.297 +	        another of the system-wide error codes.
   1.298 +
   1.299 +	@since  8.0
   1.300 +    */
   1.301 +	IMPORT_C TInt GetModelCount(TModelBankID aModelBankID,
   1.302 +					TInt& aModelCount);
   1.303 +
   1.304 +
   1.305 +	/**
   1.306 +	Checks if the rule is valid or not.
   1.307 +
   1.308 +	@param  aGrammarID			
   1.309 +            The grammar ID.
   1.310 +	@param  aRuleID				
   1.311 +	        The rule ID.
   1.312 +	@param  aValid				
   1.313 +	        A reference where the validity of the rule is set.
   1.314 +
   1.315 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.316 +	        another of the system-wide error codes.
   1.317 +
   1.318 +	@since  8.0
   1.319 +    */
   1.320 +	IMPORT_C TInt GetRuleValidity(TGrammarID aGrammarID, TRuleID aRuleID, 
   1.321 +					TBool& aValid);
   1.322 +
   1.323 +	/**
   1.324 +    *
   1.325 +    *	Returns the duration of the utterance for the specified model.
   1.326 +    * @since 8.0
   1.327 +    * @param	aModelBankID		model bank Id
   1.328 +	* @param	aModelID			model Id
   1.329 +	* @param	aDuration			reference where the duration of 
   1.330 +	*								utterance is set
   1.331 +    * @return	System-wide errors
   1.332 +    */
   1.333 +	IMPORT_C TInt GetUtteranceDuration(TModelBankID aModelBankID, 
   1.334 +				TModelID aModelID, TTimeIntervalMicroSeconds32& aDuration);
   1.335 +
   1.336 +	/**
   1.337 +    Loads the specified grammar into the recognizer; done prior to recognition.
   1.338 +
   1.339 +    @param  aGrammarID			
   1.340 +	        The grammar ID.
   1.341 +
   1.342 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.343 +	        another of the system-wide error codes.
   1.344 +
   1.345 +    @since  8.0
   1.346 +    */
   1.347 +	IMPORT_C TInt LoadGrammar(TGrammarID aGrammarID);
   1.348 +
   1.349 +	/**
   1.350 +	Loads the specified lexicon into the recognizer; done prior to recognition.
   1.351 +
   1.352 +	@param  aLexiconID			
   1.353 +	        The lexicon ID.
   1.354 +
   1.355 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.356 +	        another of the system-wide error codes.
   1.357 +
   1.358 +	@since  8.0
   1.359 +    */
   1.360 +	IMPORT_C TInt LoadLexicon(TLexiconID aLexiconID);
   1.361 +
   1.362 +	/**
   1.363 +	Loads the specified model bank into the recognizer; done prior to recognition.
   1.364 +
   1.365 +	@param  aModelBankID		
   1.366 +	        The model bank ID.
   1.367 +
   1.368 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.369 +	        another of the system-wide error codes.
   1.370 +
   1.371 +	@since  8.0
   1.372 +    */
   1.373 +	IMPORT_C TInt LoadModels(TModelBankID aModelBankID);
   1.374 +
   1.375 +	/**
   1.376 +	Plays the previously trained utterance.
   1.377 +
   1.378 +	@param  aModelBankID		
   1.379 +	        The model bank ID.
   1.380 +	@param  aModelID			
   1.381 +	        The model ID, whose utterance is played.
   1.382 +
   1.383 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.384 +	        another of the system-wide error codes.
   1.385 +
   1.386 +	@since  8.0
   1.387 +    */
   1.388 +	IMPORT_C TInt PlayUtterance(TModelBankID aModelBankID,
   1.389 +					TModelID aModelID);
   1.390 +
   1.391 +	/**
   1.392 +	Initiates recognition; performed following loading of model bank, lexicon, and grammar.
   1.393 +
   1.394 +	@param  aResultSet			
   1.395 +	        A reference where the recognition result is set.
   1.396 +
   1.397 +    @return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.398 +            another of the system-wide error codes.
   1.399 +
   1.400 +	@since  8.0
   1.401 +    */
   1.402 +	IMPORT_C TInt Recognize(CSDClientResultSet& aResultSet);
   1.403 +
   1.404 +	/**
   1.405 +	Records the user utterance for training and recognition.
   1.406 +
   1.407 +	@param  aRecordTime			
   1.408 +	        The recording time in microseconds.
   1.409 +
   1.410 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.411 +	         another of the system-wide error codes.
   1.412 +
   1.413 +	@since  8.0
   1.414 +    */
   1.415 +	IMPORT_C TInt Record(TTimeIntervalMicroSeconds32 aRecordTime);
   1.416 +
   1.417 +	/**
   1.418 +	Removes the specified grammar from the permanent storage.
   1.419 +
   1.420 +	Removing a grammar will remove all rules within the grammar.
   1.421 +
   1.422 +	@param  aGrammarID			
   1.423 +	        The grammar ID.
   1.424 +
   1.425 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.426 +	        another of the system-wide error codes.
   1.427 +	
   1.428 +	@since  8.0
   1.429 +    */
   1.430 +	IMPORT_C TInt RemoveGrammar(TGrammarID aGrammarID);
   1.431 +
   1.432 +	/**
   1.433 +	Removes the specified lexicon from the permanent storage.
   1.434 +
   1.435 +	Removing a lexicon will remove all pronunciations within the lexicon.
   1.436 +
   1.437 +	@param  aLexiconID			
   1.438 +	        The lexicon ID.
   1.439 +
   1.440 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.441 +	        another of the system-wide error codes.
   1.442 +	@since  8.0
   1.443 +    */
   1.444 +	IMPORT_C TInt RemoveLexicon(TLexiconID aLexiconID);
   1.445 +
   1.446 +	/**
   1.447 +	Removes the specified model bank from the permanent storage.
   1.448 +
   1.449 +	Removing a model bank will remove all models within the model bank.
   1.450 +
   1.451 +	@param  aModelBankID		
   1.452 +	        The model bank ID.
   1.453 +
   1.454 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.455 +	        another of the system-wide error codes.
   1.456 +
   1.457 +	@since  8.0
   1.458 +    */
   1.459 +	IMPORT_C TInt RemoveModelBank(TModelBankID aModelBankID);
   1.460 +
   1.461 +	/**
   1.462 +	Removes the specified model from the specified model bank permanently.
   1.463 +
   1.464 +	@param  aModelBankID		
   1.465 +	        The model bank ID.
   1.466 +	@param  aModelID			
   1.467 +	        The model ID.
   1.468 +
   1.469 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.470 +	        another of the system-wide error codes.
   1.471 +
   1.472 +	@since  8.0
   1.473 +    */
   1.474 +	IMPORT_C TInt RemoveModel(TModelBankID aModelBankID,
   1.475 +								TModelID aModelID);
   1.476 +
   1.477 +	/**
   1.478 +	Removes the specified pronunciation from the specified lexicon permanently.
   1.479 +
   1.480 +	@param  aLexiconID
   1.481 +	        The lexicon ID.
   1.482 +	@param  aPronunciationID
   1.483 +	        The pronunciation ID.
   1.484 +
   1.485 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.486 +	        another of the system-wide error codes.
   1.487 +
   1.488 +	@since	8.0
   1.489 +    */
   1.490 +	IMPORT_C TInt RemovePronunciation(TLexiconID aLexiconID,
   1.491 +								TPronunciationID aPronunciationID);
   1.492 +
   1.493 +	/**
   1.494 +	Removes the specified rule from the specified grammar permanently.
   1.495 +
   1.496 +	@param  aGrammarID			
   1.497 +	        The grammar ID.
   1.498 +	@param  aRuleID				
   1.499 +	        The rule ID.
   1.500 +
   1.501 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.502 +	        another of the system-wide error codes.
   1.503 +
   1.504 +	@since  8.0
   1.505 +    */
   1.506 +	IMPORT_C TInt RemoveRule(TGrammarID aGrammarID, TRuleID aRuleID);
   1.507 +
   1.508 +	/**
   1.509 +	Sets the client UID for client.
   1.510 +
   1.511 +	@param  aClientUid			
   1.512 +	        The client UID.
   1.513 +
   1.514 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.515 +	        another of the system-wide error codes.
   1.516 +
   1.517 +	@since  8.0
   1.518 +	*/
   1.519 +	IMPORT_C TInt SetClientUid(TUid aClientUid);
   1.520 +
   1.521 +	/**
   1.522 +	Starts a new recognition session.
   1.523 +
   1.524 +	@param  aMode				
   1.525 +	        The recognition mode.
   1.526 +
   1.527 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.528 +	        another of the system-wide error codes.
   1.529 +
   1.530 +	@since  8.0
   1.531 +    */
   1.532 +	IMPORT_C TInt StartRecSession(TRecognitionMode aMode);
   1.533 +
   1.534 +    /**
   1.535 +	Trains a new model into the specified model bank.
   1.536 +
   1.537 +	@param  aModelBankID		
   1.538 +	        The model bank ID.
   1.539 +	@param  aModelID			
   1.540 +	        The reference to where a new model ID is assigned.
   1.541 +
   1.542 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.543 +	        another of the system-wide error codes.
   1.544 +
   1.545 +	@since  8.0
   1.546 +    */
   1.547 +	IMPORT_C TInt Train(TModelBankID aModelBankID, TModelID& aModelID);
   1.548 +
   1.549 +	/**
   1.550 +	Unloads the specified rule from the specified grammar in temporary
   1.551 +	memory, previously loaded with LoadGrammarL(). The rule in the
   1.552 +	permanent storage remains intact.
   1.553 +
   1.554 +	@param  aGrammarID
   1.555 +	        The grammar ID.
   1.556 +	@param  aRuleID
   1.557 +	        The rule ID.
   1.558 +
   1.559 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.560 +	        another of the system-wide error codes.
   1.561 +
   1.562 +	@since  8.0
   1.563 +    */
   1.564 +	IMPORT_C TInt UnloadRule(TGrammarID aGrammarID, TRuleID aRuleID);
   1.565 +
   1.566 +	/**
   1.567 +	Uploads the specified parameters into the engine.
   1.568 +
   1.569 +	@param  aParameterId		
   1.570 +	        An array of parameter IDs.
   1.571 +	@param  aParameterValue
   1.572 +	        An array of parameter values.
   1.573 +
   1.574 +	@return An error code indicating if the function call was successful. KErrNone on success, otherwise
   1.575 +	        another of the system-wide error codes.
   1.576 +
   1.577 +	@since  8.0
   1.578 +    */
   1.579 +	IMPORT_C TInt LoadEngineParameters(const RArray<TInt>& aParameterId,
   1.580 +								const RArray<TInt>& aParameterValue);
   1.581 +
   1.582 +	/**
   1.583 +	Gets an array of pronunciation IDs previously requested by GetAllPronunciationIDs.
   1.584 +
   1.585 +	@param  aPronunciationIDs
   1.586 +	        An array to store pronunciation IDs.
   1.587 +
   1.588 +    @since  8.0
   1.589 +    */
   1.590 +	IMPORT_C void GetPronunciationIDArrayL(RArray<TPronunciationID>& aPronunciationIDs);
   1.591 +
   1.592 +	/**
   1.593 +	Gets an array of rule IDs previously requested by GetAllRuleIDs.
   1.594 +
   1.595 +	@param  aRuleIDs
   1.596 +	        An array to store rule IDs.
   1.597 +
   1.598 +    @since  8.0
   1.599 +    */
   1.600 +	IMPORT_C void GetRuleIDArrayL(RArray<TRuleID>& aRuleIDs);
   1.601 +
   1.602 +	/**
   1.603 +	Gets an array of model IDs previously requested by GetAllModelIDs.
   1.604 +
   1.605 +	@param  aModelIDs
   1.606 +	        An array to store model IDs.
   1.607 +
   1.608 +    @since  8.0
   1.609 +    */
   1.610 +	IMPORT_C void GetModelIDArrayL(RArray<TModelID>& aModelIDs);
   1.611 +
   1.612 +	/**
   1.613 +	Gets an array of grammar IDs previously requested by GetAllGrammarIDs.
   1.614 +
   1.615 +	@param  aGrammarIDs
   1.616 +	        An array to store grammar IDs.
   1.617 +
   1.618 +    @since  8.0
   1.619 +    */
   1.620 +	IMPORT_C void GetGrammarIDArrayL(RArray<TGrammarID>& aGrammarIDs);
   1.621 +
   1.622 +	/**
   1.623 +	Gets an array of lexicon IDs previously requested by GetAllLexiconIDs.
   1.624 +
   1.625 +	@param  aLexiconIDs
   1.626 +	        An array to store lexicon IDs.
   1.627 +
   1.628 +	@since  8.0
   1.629 +    */
   1.630 +	IMPORT_C void GetLexiconIDArrayL(RArray<TLexiconID>& aLexiconIDs);
   1.631 +
   1.632 +
   1.633 +	/**
   1.634 +	Gets an array of modelBank IDs previously requested by GetAllModelBankIDs.
   1.635 +
   1.636 +	@param  aModelBankIDs
   1.637 +	        An array to store modelBank IDs.
   1.638 +
   1.639 +    @since  8.0
   1.640 +    */
   1.641 +	IMPORT_C void GetModelBankIDArrayL(RArray<TModelBankID>& aModelBankIDs);
   1.642 +
   1.643 +
   1.644 +	/**
   1.645 +	Gets a client result set previously created by a call to Recognise().
   1.646 +
   1.647 +	@param  aResultSet
   1.648 +	        The ResultSet used to contain the recognition results
   1.649 +
   1.650 +    @since  8.0
   1.651 +    */
   1.652 +	IMPORT_C void GetResultSetL(CSDClientResultSet& aResultSet);
   1.653 +	
   1.654 +private:
   1.655 +	void DoGetEnginePropertiesL(const RArray<TInt>& aPropertyId, 
   1.656 +					RArray<TInt>& aPropertyValue);
   1.657 +	void DoLoadEngineParametersL(const RArray<TInt>& aParameterId, 
   1.658 +								const RArray<TInt>& aParameterValue);
   1.659 +
   1.660 +					
   1.661 +	CBufFlat* ExternalizeIntArrayL(const RArray<TInt>& aArray);
   1.662 +	void InternalizeIntArrayL(TDes8& aDes, TInt aNumberElements, RArray<TInt>& aArray);
   1.663 +	
   1.664 +	void DoRecognizeL(CSDClientResultSet& aResultSet);
   1.665 +private:
   1.666 +	TAny* iReservedPtr_1;	// reserved for future expansion
   1.667 +	TAny* iReservedPtr_2;	// reserved for future expansion
   1.668 +};
   1.669 +
   1.670 +#endif  // __SPEECHRECOGNITIONCUSTOMCOMMANDS_H__