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
26namespace android {
27
28class DataSource;
29struct IMediaHTTPService;
30
31// Abstract base class
32class MediaMetadataRetrieverBase : public RefBase
33{
34public:
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) = 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
51class MediaMetadataRetrieverInterface : public MediaMetadataRetrieverBase
52{
53public:
54    MediaMetadataRetrieverInterface() {}
55
56    virtual             ~MediaMetadataRetrieverInterface() {}
57    virtual VideoFrame* getFrameAtTime(int64_t /*timeUs*/, int /*option*/) { return NULL; }
58    virtual MediaAlbumArt* extractAlbumArt() { return NULL; }
59    virtual const char* extractMetadata(int /*keyCode*/) { return NULL; }
60};
61
62}; // namespace android
63
64#endif // ANDROID_MEDIAMETADATARETRIEVERINTERFACE_H
65