1 /*
2 **
3 ** Copyright (C) 2008 The Android Open Source Project
4 **
5 ** Licensed under the Apache License, Version 2.0 (the "License");
6 ** you may not use this file except in compliance with the License.
7 ** You may obtain a copy of the License at
8 **
9 **     http://www.apache.org/licenses/LICENSE-2.0
10 **
11 ** Unless required by applicable law or agreed to in writing, software
12 ** distributed under the License is distributed on an "AS IS" BASIS,
13 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 ** See the License for the specific language governing permissions and
15 ** limitations under the License.
16 */
17 
18 #ifndef ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H
19 #define ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H
20 
21 #include <utils/RefBase.h>
22 #include <media/mediametadataretriever.h>
23 #include <media/mediascanner.h>
24 #include <private/media/VideoFrame.h>
25 
26 namespace android {
27 
28 class DataSource;
29 struct IMediaHTTPService;
30 
31 // Abstract base class
32 class MediaMetadataRetrieverBase : public RefBase
33 {
34 public:
MediaMetadataRetrieverBase()35                         MediaMetadataRetrieverBase() {}
~MediaMetadataRetrieverBase()36     virtual             ~MediaMetadataRetrieverBase() {}
37 
38     virtual status_t    setDataSource(
39             const sp<IMediaHTTPService> &httpService,
40             const char *url,
41             const KeyedVector<String8, String8> *headers = NULL) = 0;
42 
43     virtual status_t    setDataSource(int fd, int64_t offset, int64_t length) = 0;
44     virtual status_t setDataSource(const sp<DataSource>& source) = 0;
45     virtual VideoFrame* getFrameAtTime(int64_t timeUs, int option) = 0;
46     virtual MediaAlbumArt* extractAlbumArt() = 0;
47     virtual const char* extractMetadata(int keyCode) = 0;
48 };
49 
50 // MediaMetadataRetrieverInterface
51 class MediaMetadataRetrieverInterface : public MediaMetadataRetrieverBase
52 {
53 public:
MediaMetadataRetrieverInterface()54     MediaMetadataRetrieverInterface() {}
55 
~MediaMetadataRetrieverInterface()56     virtual             ~MediaMetadataRetrieverInterface() {}
getFrameAtTime(int64_t timeUs,int option)57     virtual VideoFrame* getFrameAtTime(int64_t timeUs, int option) { return NULL; }
extractAlbumArt()58     virtual MediaAlbumArt* extractAlbumArt() { return NULL; }
extractMetadata(int keyCode)59     virtual const char* extractMetadata(int keyCode) { return NULL; }
60 };
61 
62 }; // namespace android
63 
64 #endif // ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H
65