• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2008 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 
18 #ifndef MEDIAMETADATARETRIEVER_H
19 #define MEDIAMETADATARETRIEVER_H
20 
21 #include <utils/Errors.h>  // for status_t
22 #include <utils/threads.h>
23 #include <binder/IMemory.h>
24 #include <media/IMediaMetadataRetriever.h>
25 
26 namespace android {
27 
28 class IMediaPlayerService;
29 class IMediaMetadataRetriever;
30 
31 // Keep these in synch with the constants defined in MediaMetadataRetriever.java
32 // class.
33 enum {
34     METADATA_KEY_CD_TRACK_NUMBER = 0,
35     METADATA_KEY_ALBUM           = 1,
36     METADATA_KEY_ARTIST          = 2,
37     METADATA_KEY_AUTHOR          = 3,
38     METADATA_KEY_COMPOSER        = 4,
39     METADATA_KEY_DATE            = 5,
40     METADATA_KEY_GENRE           = 6,
41     METADATA_KEY_TITLE           = 7,
42     METADATA_KEY_YEAR            = 8,
43     METADATA_KEY_DURATION        = 9,
44     METADATA_KEY_NUM_TRACKS      = 10,
45     METADATA_KEY_IS_DRM_CRIPPLED = 11,
46     METADATA_KEY_CODEC           = 12,
47     METADATA_KEY_RATING          = 13,
48     METADATA_KEY_COMMENT         = 14,
49     METADATA_KEY_COPYRIGHT       = 15,
50     METADATA_KEY_BIT_RATE        = 16,
51     METADATA_KEY_FRAME_RATE      = 17,
52     METADATA_KEY_VIDEO_FORMAT    = 18,
53     METADATA_KEY_VIDEO_HEIGHT    = 19,
54     METADATA_KEY_VIDEO_WIDTH     = 20,
55     METADATA_KEY_WRITER          = 21,
56     // Add more here...
57 };
58 
59 // The intended mode of operations:$
60 // METADATA_MODE_NOOP: Experimental - just add and remove data source.$
61 // METADATA_MODE_FRAME_CAPTURE_ONLY: For capture frame/thumbnail only.$
62 // METADATA_MODE_METADATA_RETRIEVAL_ONLY: For meta data retrieval only.$
63 // METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL: For both frame capture
64 //   and meta data retrieval.$
65 enum {
66     METADATA_MODE_NOOP                                 = 0x00,
67     METADATA_MODE_FRAME_CAPTURE_ONLY                   = 0x01,
68     METADATA_MODE_METADATA_RETRIEVAL_ONLY              = 0x02,
69     METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL = 0x03
70 };
71 
72 class MediaMetadataRetriever: public RefBase
73 {
74 public:
75     MediaMetadataRetriever();
76     ~MediaMetadataRetriever();
77     void disconnect();
78     status_t setDataSource(const char* dataSourceUrl);
79     status_t setDataSource(int fd, int64_t offset, int64_t length);
80     status_t setMode(int mode);
81     status_t getMode(int* mode);
82     sp<IMemory> captureFrame();
83     sp<IMemory> extractAlbumArt();
84     const char* extractMetadata(int keyCode);
85 
86 private:
87     static const sp<IMediaPlayerService>& getService();
88 
89     class DeathNotifier: public IBinder::DeathRecipient
90     {
91     public:
DeathNotifier()92         DeathNotifier() {}
93         virtual ~DeathNotifier();
94         virtual void binderDied(const wp<IBinder>& who);
95     };
96 
97     static sp<DeathNotifier>                  sDeathNotifier;
98     static Mutex                              sServiceLock;
99     static sp<IMediaPlayerService>            sService;
100 
101     Mutex                                     mLock;
102     sp<IMediaMetadataRetriever>               mRetriever;
103 
104 };
105 
106 }; // namespace android
107 
108 #endif // MEDIAMETADATARETRIEVER_H
109