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
26namespace android {
27class Parcel;
28class IDataSource;
29struct IMediaHTTPService;
30
31class IMediaMetadataRetriever: public IInterface
32{
33public:
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
60class BnMediaMetadataRetriever: public BnInterface<IMediaMetadataRetriever>
61{
62public:
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