javauis/mmapi_qt/baseline/inc/mmmaplayerfactory.h
branchRCL_3
changeset 65 ae942d28ec0e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/mmapi_qt/baseline/inc/mmmaplayerfactory.h	Tue Aug 31 15:09:22 2010 +0300
@@ -0,0 +1,102 @@
+/*
+* Copyright (c) 2002 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:  Interface for all player factories.
+*
+*/
+
+
+#ifndef MMMAPLAYERFACTORY_H
+#define MMMAPLAYERFACTORY_H
+
+//  INCLUDES
+#include <badesca.h> // CDesC16Array
+
+//  CONSTANTS
+_LIT(KMMAHttpProtocol, "http");
+_LIT(KMMAHttpsProtocol, "https");
+_LIT(KMMAFileProtocol, "file");
+_LIT(KMMACaptureProtocol, "capture");
+_LIT(KMMADeviceProtocol, "device");
+
+//  CLASS DEFINITION
+class CMMAPlayer;
+
+/*
+-----------------------------------------------------------------------------
+
+    DESCRIPTION
+    Interface for all player factories.
+
+-----------------------------------------------------------------------------
+*/
+NONSHARABLE_CLASS(MMMAPlayerFactory)
+{
+public:
+
+    /**
+     * Allow delete through this interface.
+     */
+    virtual ~MMMAPlayerFactory() {};
+
+    /**
+     * Creates new player according to a content type.
+     *
+     * @param aContentType Player's content type.
+     * @return New instance of CMMAPlayer or null if factory cannot
+     *         create it
+     */
+    virtual CMMAPlayer* CreatePlayerL(const TDesC& aContentType) = 0;
+
+    /**
+     * Creates new player according to a locator
+     *
+     * @param aProtocol protocol part from the locator.
+     * @param aMiddlePart middle part from the locator.
+     * @param aParameters parameters part from the locator.
+     * @return New instance of CMMAPlayer or null if factory cannot
+     *         create it
+     */
+    virtual CMMAPlayer* CreatePlayerL(const TDesC& aProtocol,
+                                      const TDesC& aMiddlePart,
+                                      const TDesC& aParameters) = 0;
+
+    /**
+     * Creates new player according to a header data
+     *
+     * @param aHeaderData Header data from the content
+     * @return New instance of CMMAPlayer or null if factory cannot
+     *         create it
+     */
+    virtual CMMAPlayer* CreatePlayerL(const TDesC8& aHeaderData) = 0;
+
+    /**
+     * Gets player's supported content types.
+     *
+     * @param aProtocol The input protocol for the supported content types.
+     * @param aMimeTypeArray Will contain supported mime types for protocol.
+     */
+    virtual void GetSupportedContentTypesL(const TDesC& aProtocol,
+                                           CDesC16Array& aMimeTypeArray) = 0;
+
+    /**
+     * Gets player's supported protocols for the content type.
+     *
+     * @param aContentType The content type for the supported protocols.
+     * @param aProtocolArray Will contain supported protocols for content type.
+     */
+    virtual void GetSupportedProtocolsL(const TDesC& aContentType,
+                                        CDesC16Array& aProtocolArray) = 0;
+};
+
+#endif // MMMAPLAYERFACTORY_H