|
1 /* |
|
2 * Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). |
|
3 * All rights reserved. |
|
4 * This component and the accompanying materials are made available |
|
5 * under the terms of the License "Eclipse Public License v1.0" |
|
6 * which accompanies this distribution, and is available |
|
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 * |
|
9 * Initial Contributors: |
|
10 * Nokia Corporation - initial contribution. |
|
11 * |
|
12 * Contributors: |
|
13 * |
|
14 * Description: Engine observer to get event notifications.* |
|
15 */ |
|
16 |
|
17 |
|
18 #ifndef MCRENGINEOBSERVER_H |
|
19 #define MCRENGINEOBSERVER_H |
|
20 |
|
21 // INCLUDES |
|
22 #include <e32def.h> |
|
23 |
|
24 // CONSTANTS |
|
25 // None |
|
26 |
|
27 // MACROS |
|
28 // None. |
|
29 |
|
30 // DATA TYPES |
|
31 /** |
|
32 * Different messages that DVR engine may send via client lib callback |
|
33 */ |
|
34 enum TCRObserverInfo |
|
35 { |
|
36 ECRAuthenticationNeeded, /**< CR needs new username and password for authentication */ |
|
37 ECRAttachCompleted, /**< Connection attach is completed and is ready to be used */ |
|
38 ECRConnectionError, /**< Unable to open connection in RTP engine & CR engine */ |
|
39 ECRNotEnoughBandwidth, /**< Stream bitrate higher than (estimated) available connection bandwidth */ |
|
40 ECRNormalEndOfStream, /**< Used to communicate end of streaming */ |
|
41 ECRSwitchingToTcp, /**< Switch to tcp, client needs to initiate possible player */ |
|
42 ECRStreamIsLiveStream, /**< We have a stream that cannot be paused */ |
|
43 ECRRealNetworksStream, /**< RealMedia stream format, cannot support */ |
|
44 ECRTestSinkData, /**< Placeholder for TestSink (NullSink) feedback information to test client */ |
|
45 ECRSdpAvailable, /**< Used to communicate availability of SDP */ |
|
46 ECRReadyToSeek, /**< Used to communicate seeking posibility */ |
|
47 ECRRecordingStarted, /**< Used to communicate recording state */ |
|
48 ECRRecordingPaused, /**< Used to communicate recording state */ |
|
49 ECRRecordingEnded /**< Used to communicate recording state */ |
|
50 }; |
|
51 |
|
52 /** |
|
53 * This structure is sent over message queue where |
|
54 * api sits listening |
|
55 */ |
|
56 struct SCRObserverMsg |
|
57 { |
|
58 TCRObserverInfo iMsg; /**< Identifies the message */ |
|
59 TInt iErr; /**< Can be used to pass error value related to message */ |
|
60 }; |
|
61 |
|
62 // FORWARD DECLARATIONS |
|
63 // None |
|
64 |
|
65 // CLASS DECLARATION |
|
66 |
|
67 /** |
|
68 * Engine observer to get event notifications. |
|
69 * |
|
70 * @lib CommonRecordingEngineClient.lib |
|
71 * @since Series 60 3.0 |
|
72 */ |
|
73 class MCREngineObserver |
|
74 { |
|
75 |
|
76 public: // New methods |
|
77 |
|
78 /** |
|
79 * Notify call back for statuses. |
|
80 * @since Series 60 3.0 |
|
81 * @param aInfo a notify info. |
|
82 * @return none. |
|
83 */ |
|
84 virtual void NotifyL( const SCRObserverMsg& aInfo ) = 0; |
|
85 |
|
86 }; |
|
87 |
|
88 #endif MCRENGINEOBSERVER_H |
|
89 |
|
90 // End of file. |