/*
* Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies). 
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  MTag is an abstraction for a voice tag. MTag memebrs consist of 
*               a context, speech item, and RRD. 
*
*/


#ifndef NSSVASMTAG_H
#define NSSVASMTAG_H

// include 

#include <nssvasmcontext.h>
#include <nssvasmrrd.h>
#include <nssvasmspeechitem.h>

/**
* MTag is the interface class for tag processing.
* A voice tag consists of a context, a RRD, and a speech item. A context can have
* multiple voice tags. Context represents the category (application) to which the tag
* belongs. RRD represents the result data for a tag. Speech item represents the speech
* speech data and speech activities for a tag. A client will not create a tag diectly, 
* but use the methods in tag manager to get a tag. After getting a tag, the client can
* get the RRD and speech item objects using the following methods in MTag. A context needs
* to be created before creating a tag. After a tag is used, it needs to be deleted. Deleting
* a tag deletes its RRD and speech item, and thus they donot have to be deleted expicitly,
* @lib NssVASApi.lib
* @since 2.0
*/
class MNssTag
    {
    public:
    
        /**
        * Get the context 
    	* @since 2.0
        * @return context object to which this tag belongs
        */	
        virtual MNssContext* Context() = 0;

        /**
        * Get the RRD
    	* @since 2.0
        * @return RRD object for this tag
        */
    	virtual MNssRRD* RRD() = 0;

        /**
        * Get the speech item
    	* @since 2.0
        * @return speech item for this tag
        */
    	virtual MNssSpeechItem* SpeechItem() = 0;

        /**
        * virtual destructor for proper clean up
        */
    	virtual ~MNssTag(){}
    	
    };

#endif // NSSVASMTAG_H
            
// End of File