1/*
2 * Copyright (C) 2008 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17
18#ifndef MEDIAMETADATARETRIEVER_H
19#define MEDIAMETADATARETRIEVER_H
20
21#include <utils/Errors.h>  // for status_t
22#include <utils/threads.h>
23#include <binder/IMemory.h>
24#include <media/IMediaMetadataRetriever.h>
25
26namespace android {
27
28class IDataSource;
29struct IMediaHTTPService;
30class IMediaPlayerService;
31class IMediaMetadataRetriever;
32
33// Keep these in synch with the constants defined in MediaMetadataRetriever.java
34// class.
35enum {
36    METADATA_KEY_CD_TRACK_NUMBER = 0,
37    METADATA_KEY_ALBUM           = 1,
38    METADATA_KEY_ARTIST          = 2,
39    METADATA_KEY_AUTHOR          = 3,
40    METADATA_KEY_COMPOSER        = 4,
41    METADATA_KEY_DATE            = 5,
42    METADATA_KEY_GENRE           = 6,
43    METADATA_KEY_TITLE           = 7,
44    METADATA_KEY_YEAR            = 8,
45    METADATA_KEY_DURATION        = 9,
46    METADATA_KEY_NUM_TRACKS      = 10,
47    METADATA_KEY_WRITER          = 11,
48    METADATA_KEY_MIMETYPE        = 12,
49    METADATA_KEY_ALBUMARTIST     = 13,
50    METADATA_KEY_DISC_NUMBER     = 14,
51    METADATA_KEY_COMPILATION     = 15,
52    METADATA_KEY_HAS_AUDIO       = 16,
53    METADATA_KEY_HAS_VIDEO       = 17,
54    METADATA_KEY_VIDEO_WIDTH     = 18,
55    METADATA_KEY_VIDEO_HEIGHT    = 19,
56    METADATA_KEY_BITRATE         = 20,
57    METADATA_KEY_TIMED_TEXT_LANGUAGES      = 21,
58    METADATA_KEY_IS_DRM          = 22,
59    METADATA_KEY_LOCATION        = 23,
60    METADATA_KEY_VIDEO_ROTATION  = 24,
61    METADATA_KEY_CAPTURE_FRAMERATE = 25,
62
63    // Add more here...
64};
65
66class MediaMetadataRetriever: public RefBase
67{
68public:
69    MediaMetadataRetriever();
70    ~MediaMetadataRetriever();
71    void disconnect();
72
73    status_t setDataSource(
74            const sp<IMediaHTTPService> &httpService,
75            const char *dataSourceUrl,
76            const KeyedVector<String8, String8> *headers = NULL);
77
78    status_t setDataSource(int fd, int64_t offset, int64_t length);
79    status_t setDataSource(const sp<IDataSource>& dataSource);
80    sp<IMemory> getFrameAtTime(int64_t timeUs, int option);
81    sp<IMemory> extractAlbumArt();
82    const char* extractMetadata(int keyCode);
83
84private:
85    static const sp<IMediaPlayerService> getService();
86
87    class DeathNotifier: public IBinder::DeathRecipient
88    {
89    public:
90        DeathNotifier() {}
91        virtual ~DeathNotifier();
92        virtual void binderDied(const wp<IBinder>& who);
93    };
94
95    static sp<DeathNotifier>                  sDeathNotifier;
96    static Mutex                              sServiceLock;
97    static sp<IMediaPlayerService>            sService;
98
99    Mutex                                     mLock;
100    sp<IMediaMetadataRetriever>               mRetriever;
101
102};
103
104}; // namespace android
105
106#endif // MEDIAMETADATARETRIEVER_H
107