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 #include <media/stagefright/MediaErrors.h>
26 
27 namespace android {
28 
29 class DataSource;
30 struct IMediaHTTPService;
31 
32 // Abstract base class
33 class MediaMetadataRetrieverBase : public RefBase
34 {
35 public:
MediaMetadataRetrieverBase()36                         MediaMetadataRetrieverBase() {}
~MediaMetadataRetrieverBase()37     virtual             ~MediaMetadataRetrieverBase() {}
38 
39     virtual status_t    setDataSource(
40             const sp<IMediaHTTPService> &httpService,
41             const char *url,
42             const KeyedVector<String8, String8> *headers = NULL) = 0;
43 
44     virtual status_t    setDataSource(int fd, int64_t offset, int64_t length) = 0;
45     virtual status_t    setDataSource(const sp<DataSource>& source, const char *mime) = 0;
46     virtual sp<IMemory> getFrameAtTime(
47             int64_t timeUs, int option, int colorFormat, bool metaOnly) = 0;
48     virtual sp<IMemory> getImageAtIndex(
49             int index, int colorFormat, bool metaOnly, bool thumbnail) = 0;
50     virtual sp<IMemory> getImageRectAtIndex(
51             int index, int colorFormat, int left, int top, int right, int bottom) = 0;
52     virtual sp<IMemory> getFrameAtIndex(
53             int frameIndex, int colorFormat, bool metaOnly) = 0;
54     virtual MediaAlbumArt* extractAlbumArt() = 0;
55     virtual const char* extractMetadata(int keyCode) = 0;
56 };
57 
58 }; // namespace android
59 
60 #endif // ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H
61