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 IDataSource;
29 struct IMediaHTTPService;
30 class IMediaPlayerService;
31 class IMediaMetadataRetriever;
32 
33 // Keep these in synch with the constants defined in MediaMetadataRetriever.java
34 // class.
35 enum {
36     METADATA_KEY_CD_TRACK_NUMBER = 0,
37     METADATA_KEY_ALBUM           = 1,
38     METADATA_KEY_ARTIST          = 2,
39     METADATA_KEY_AUTHOR          = 3,
40     METADATA_KEY_COMPOSER        = 4,
41     METADATA_KEY_DATE            = 5,
42     METADATA_KEY_GENRE           = 6,
43     METADATA_KEY_TITLE           = 7,
44     METADATA_KEY_YEAR            = 8,
45     METADATA_KEY_DURATION        = 9,
46     METADATA_KEY_NUM_TRACKS      = 10,
47     METADATA_KEY_WRITER          = 11,
48     METADATA_KEY_MIMETYPE        = 12,
49     METADATA_KEY_ALBUMARTIST     = 13,
50     METADATA_KEY_DISC_NUMBER     = 14,
51     METADATA_KEY_COMPILATION     = 15,
52     METADATA_KEY_HAS_AUDIO       = 16,
53     METADATA_KEY_HAS_VIDEO       = 17,
54     METADATA_KEY_VIDEO_WIDTH     = 18,
55     METADATA_KEY_VIDEO_HEIGHT    = 19,
56     METADATA_KEY_BITRATE         = 20,
57     METADATA_KEY_TIMED_TEXT_LANGUAGES      = 21,
58     METADATA_KEY_IS_DRM          = 22,
59     METADATA_KEY_LOCATION        = 23,
60     METADATA_KEY_VIDEO_ROTATION  = 24,
61     METADATA_KEY_CAPTURE_FRAMERATE = 25,
62     METADATA_KEY_HAS_IMAGE       = 26,
63     METADATA_KEY_IMAGE_COUNT     = 27,
64     METADATA_KEY_IMAGE_PRIMARY   = 28,
65     METADATA_KEY_IMAGE_WIDTH     = 29,
66     METADATA_KEY_IMAGE_HEIGHT    = 30,
67     METADATA_KEY_IMAGE_ROTATION  = 31,
68     METADATA_KEY_VIDEO_FRAME_COUNT  = 32,
69     METADATA_KEY_EXIF_OFFSET     = 33,
70     METADATA_KEY_EXIF_LENGTH     = 34,
71     METADATA_KEY_COLOR_STANDARD  = 35,
72     METADATA_KEY_COLOR_TRANSFER  = 36,
73     METADATA_KEY_COLOR_RANGE     = 37,
74     METADATA_KEY_SAMPLERATE      = 38,
75     METADATA_KEY_BITS_PER_SAMPLE = 39,
76 
77     // Add more here...
78 };
79 
80 class MediaMetadataRetriever: public RefBase
81 {
82 public:
83     MediaMetadataRetriever();
84     ~MediaMetadataRetriever();
85     void disconnect();
86 
87     status_t setDataSource(
88             const sp<IMediaHTTPService> &httpService,
89             const char *dataSourceUrl,
90             const KeyedVector<String8, String8> *headers = NULL);
91 
92     status_t setDataSource(int fd, int64_t offset, int64_t length);
93     status_t setDataSource(
94             const sp<IDataSource>& dataSource, const char *mime = NULL);
95     sp<IMemory> getFrameAtTime(int64_t timeUs, int option,
96             int colorFormat = HAL_PIXEL_FORMAT_RGB_565, bool metaOnly = false);
97     sp<IMemory> getImageAtIndex(int index,
98             int colorFormat = HAL_PIXEL_FORMAT_RGB_565, bool metaOnly = false, bool thumbnail = false);
99     sp<IMemory> getImageRectAtIndex(
100             int index, int colorFormat, int left, int top, int right, int bottom);
101     status_t getFrameAtIndex(
102             std::vector<sp<IMemory> > *frames, int frameIndex, int numFrames = 1,
103             int colorFormat = HAL_PIXEL_FORMAT_RGB_565, bool metaOnly = false);
104     sp<IMemory> extractAlbumArt();
105     const char* extractMetadata(int keyCode);
106 
107 private:
108     static const sp<IMediaPlayerService> getService();
109 
110     class DeathNotifier: public IBinder::DeathRecipient
111     {
112     public:
DeathNotifier()113         DeathNotifier() {}
114         virtual ~DeathNotifier();
115         virtual void binderDied(const wp<IBinder>& who);
116     };
117 
118     static sp<DeathNotifier>                  sDeathNotifier;
119     static Mutex                              sServiceLock;
120     static sp<IMediaPlayerService>            sService;
121 
122     Mutex                                     mLock;
123     sp<IMediaMetadataRetriever>               mRetriever;
124 
125 };
126 
127 }; // namespace android
128 
129 #endif // MEDIAMETADATARETRIEVER_H
130