Home | History | Annotate | Download | only in media 
      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:
     35                         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:
     55     MediaMetadataRetrieverInterface() {}
     56 
     57     virtual             ~MediaMetadataRetrieverInterface() {}
     58     virtual VideoFrame* getFrameAtTime(
     59             int64_t /*timeUs*/, int /*option*/, int /*colorFormat*/, bool /*metaOnly*/)
     60     { return NULL; }
     61     virtual MediaAlbumArt* extractAlbumArt() { return NULL; }
     62     virtual const char* extractMetadata(int /*keyCode*/) { return NULL; }
     63 };
     64 
     65 }; // namespace android
     66 
     67 #endif // ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H
     68