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_IMEDIAMETADATARETRIEVER_H
19 #define ANDROID_IMEDIAMETADATARETRIEVER_H
20 
21 #include <binder/IInterface.h>
22 #include <binder/IMemory.h>
23 #include <utils/KeyedVector.h>
24 #include <utils/RefBase.h>
25 
26 namespace android {
27 class Parcel;
28 class IDataSource;
29 struct IMediaHTTPService;
30 
31 class IMediaMetadataRetriever: public IInterface
32 {
33 public:
34     DECLARE_META_INTERFACE(MediaMetadataRetriever);
35     virtual void            disconnect() = 0;
36 
37     virtual status_t        setDataSource(
38             const sp<IMediaHTTPService> &httpService,
39             const char *srcUrl,
40             const KeyedVector<String8, String8> *headers = NULL) = 0;
41 
42     virtual status_t        setDataSource(int fd, int64_t offset, int64_t length) = 0;
43     virtual status_t        setDataSource(
44             const sp<IDataSource>& dataSource, const char *mime) = 0;
45     virtual sp<IMemory>     getFrameAtTime(
46             int64_t timeUs, int option, int colorFormat, bool metaOnly) = 0;
47     virtual sp<IMemory>     getImageAtIndex(
48             int index, int colorFormat, bool metaOnly, bool thumbnail) = 0;
49     virtual sp<IMemory>     getImageRectAtIndex(
50             int index, int colorFormat, int left, int top, int right, int bottom) = 0;
51     virtual status_t        getFrameAtIndex(
52             std::vector<sp<IMemory> > *frames,
53             int frameIndex, int numFrames, int colorFormat, bool metaOnly) = 0;
54     virtual sp<IMemory>     extractAlbumArt() = 0;
55     virtual const char*     extractMetadata(int keyCode) = 0;
56 };
57 
58 // ----------------------------------------------------------------------------
59 
60 class BnMediaMetadataRetriever: public BnInterface<IMediaMetadataRetriever>
61 {
62 public:
63     virtual status_t    onTransact(uint32_t code,
64                                    const Parcel& data,
65                                    Parcel* reply,
66                                    uint32_t flags = 0);
67 };
68 
69 }; // namespace android
70 
71 #endif // ANDROID_IMEDIAMETADATARETRIEVER_H
72