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 <private/media/VideoFrame.h> 24 25 namespace android { 26 27 // Abstract base class 28 class MediaMetadataRetrieverBase : public RefBase 29 { 30 public: MediaMetadataRetrieverBase()31 MediaMetadataRetrieverBase() {} ~MediaMetadataRetrieverBase()32 virtual ~MediaMetadataRetrieverBase() {} 33 virtual status_t setDataSource(const char *url) = 0; 34 virtual status_t setDataSource(int fd, int64_t offset, int64_t length) = 0; 35 virtual status_t setMode(int mode) = 0; 36 virtual status_t getMode(int* mode) const = 0; 37 virtual VideoFrame* captureFrame() = 0; 38 virtual MediaAlbumArt* extractAlbumArt() = 0; 39 virtual const char* extractMetadata(int keyCode) = 0; 40 }; 41 42 // MediaMetadataRetrieverInterface 43 class MediaMetadataRetrieverInterface : public MediaMetadataRetrieverBase 44 { 45 public: ~MediaMetadataRetrieverInterface()46 virtual ~MediaMetadataRetrieverInterface() {} 47 48 // @param mode The intended mode of operations: 49 // can be any of the following: 50 // METADATA_MODE_NOOP: Experimental - just add and remove data source. 51 // METADATA_MODE_FRAME_CAPTURE_ONLY: For capture frame/thumbnail only. 52 // METADATA_MODE_METADATA_RETRIEVAL_ONLY: For meta data retrieval only. 53 // METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL: For both frame 54 // capture and meta data retrieval. setMode(int mode)55 virtual status_t setMode(int mode) { 56 if (mode < METADATA_MODE_NOOP || 57 mode > METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL) { 58 return BAD_VALUE; 59 } 60 return NO_ERROR; 61 } 62 getMode(int * mode)63 virtual status_t getMode(int* mode) const { *mode = mMode; return NO_ERROR; } captureFrame()64 virtual VideoFrame* captureFrame() { return NULL; } extractAlbumArt()65 virtual MediaAlbumArt* extractAlbumArt() { return NULL; } extractMetadata(int keyCode)66 virtual const char* extractMetadata(int keyCode) { return NULL; } 67 68 uint32_t mMode; 69 }; 70 71 }; // namespace android 72 73 #endif // ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H 74 75