|
1 /* |
|
2 * Copyright (c) 2004 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 "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: Audio Configuration internal Central Repository keys for |
|
15 * specifying buffering mode during progressive download. |
|
16 * |
|
17 */ |
|
18 |
|
19 |
|
20 #ifndef AUDIOCONFIGURATIONINTERNALCRKEYS_H |
|
21 #define AUDIOCONFIGURATIONINTERNALCRKEYS_H |
|
22 |
|
23 // INCLUDES |
|
24 #include <e32def.h> |
|
25 |
|
26 // CONSTANTS |
|
27 |
|
28 /** |
|
29 * Audio Configuration CR UID. |
|
30 */ |
|
31 const TUid KCRUidAudioConfiguration = {0x10207B74}; |
|
32 |
|
33 /** |
|
34 * This key is required for the Enhanced Media Client to determine the "buffering mode" |
|
35 * when the source runs out of data. When it happens, the source will start sending |
|
36 * buffer to underlying framework when buffering condition is met. |
|
37 * |
|
38 * Possible integer values: |
|
39 * 0 = "None". No buffering is done, as and when data is downloaded, it will be given |
|
40 * to underlying framework. |
|
41 * 1 = "Fixed Size". Fixed size buffering. The source waits until the data accumulated |
|
42 * reaches the limit (in bytes) specified by KPDLPrimaryBufferingAmount. |
|
43 * 2 = "Fixed duration". Fixed duration buffering. The source waits until the data |
|
44 * accumulated reaches the limit (calculated dynamically). When playback begins, |
|
45 * it is guarenteed to continue playback for KPDLPrimaryBufferingAmount duration |
|
46 * before it may underflow again. (Note: The playback may stop due to other reasons |
|
47 * but insufficient data). |
|
48 * 3 = "Dynamic duration". Dynamic duration buffering. The source waits until the data |
|
49 * accumulated reaches the limit (in bytes) specified by KPDLPrimaryBufferingAmount |
|
50 * plus a constant. The limit determined is the best possible approximation. |
|
51 * When the playback begins it is may never underflow until the clip is played |
|
52 * back completely. This assuming that data transfer rate and the bit rate of the |
|
53 * clip remains constant until the download is complete. |
|
54 (Note: The playback may stop due to other reasons but insufficient data). |
|
55 */ |
|
56 const TUint32 KPDLPrimaryBufferingType = 0x00000001; |
|
57 |
|
58 /** |
|
59 * Size/Duration value associated with primary buffering type. |
|
60 */ |
|
61 const TUint32 KPDLPrimaryBufferingAmount = 0x00000002; |
|
62 |
|
63 /** |
|
64 * This key is used if primary configuration cannot be used. |
|
65 * This may happen when the component does not know all the variables needed to |
|
66 * to determine the buffering limit. |
|
67 * |
|
68 * If the buffering type specified is still invalid at runtime(for e.g. the customer may have |
|
69 * configured both primary and secondary to fixed duration and the bit rate may |
|
70 * not be known in the begining of playback). The component will default to no |
|
71 * buffering and will send data to framework as and when it is received. The playback |
|
72 * may include breaks in this case. To avoid this, this should be configured to fixed |
|
73 * size. |
|
74 */ |
|
75 const TUint32 KPDLSecondaryBufferingType = 0x00000003; |
|
76 |
|
77 /** |
|
78 * Size/Duration value associated with secondary buffering type. |
|
79 */ |
|
80 const TUint32 KPDLSecondaryBufferingAmount = 0x00000004; |
|
81 |
|
82 /** |
|
83 * Initial Percentage of File download before starting playback. |
|
84 */ |
|
85 const TUint32 KPDLInitialBufferingPercentage = 0x00000005; |
|
86 |
|
87 |
|
88 #endif // AUDIOCONFIGURATIONINTERNALCRKEYS_H |
|
89 |
|
90 // End of file |