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, const char *mime) = 0; 45 virtual VideoFrame* getFrameAtTime( 46 int64_t timeUs, int option, int colorFormat, bool metaOnly) = 0; 47 virtual MediaAlbumArt* extractAlbumArt() = 0; 48 virtual const char* extractMetadata(int keyCode) = 0; 49 }; 50 51 // MediaMetadataRetrieverInterface 52 class MediaMetadataRetrieverInterface : public MediaMetadataRetrieverBase 53 { 54 public: MediaMetadataRetrieverInterface()55 MediaMetadataRetrieverInterface() {} 56 ~MediaMetadataRetrieverInterface()57 virtual ~MediaMetadataRetrieverInterface() {} getFrameAtTime(int64_t,int,int,bool)58 virtual VideoFrame* getFrameAtTime( 59 int64_t /*timeUs*/, int /*option*/, int /*colorFormat*/, bool /*metaOnly*/) 60 { return NULL; } extractAlbumArt()61 virtual MediaAlbumArt* extractAlbumArt() { return NULL; } extractMetadata(int)62 virtual const char* extractMetadata(int /*keyCode*/) { return NULL; } 63 }; 64 65 }; // namespace android 66 67 #endif // ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H 68