mediametadataretriever.h revision 4948818cb91176df74c972ac27b2f392b5d148bc 
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 IMediaPlayerService;
29class IMediaMetadataRetriever;
30
31// Keep these in synch with the constants defined in MediaMetadataRetriever.java
32// class.
33enum {
34    METADATA_KEY_CD_TRACK_NUMBER = 0,
35    METADATA_KEY_ALBUM           = 1,
36    METADATA_KEY_ARTIST          = 2,
37    METADATA_KEY_AUTHOR          = 3,
38    METADATA_KEY_COMPOSER        = 4,
39    METADATA_KEY_DATE            = 5,
40    METADATA_KEY_GENRE           = 6,
41    METADATA_KEY_TITLE           = 7,
42    METADATA_KEY_YEAR            = 8,
43    METADATA_KEY_DURATION        = 9,
44    METADATA_KEY_NUM_TRACKS      = 10,
45    METADATA_KEY_WRITER          = 11,
46    METADATA_KEY_MIMETYPE        = 12,
47    METADATA_KEY_ALBUMARTIST     = 13,
48    METADATA_KEY_DISC_NUMBER     = 14,
49    METADATA_KEY_COMPILATION     = 15,
50    METADATA_KEY_HAS_AUDIO       = 16,
51    METADATA_KEY_HAS_VIDEO       = 17,
52    METADATA_KEY_VIDEO_WIDTH     = 18,
53    METADATA_KEY_VIDEO_HEIGHT    = 19,
54    METADATA_KEY_BITRATE         = 20,
55    METADATA_KEY_TIMED_TEXT_LANGUAGES      = 21,
56    METADATA_KEY_IS_DRM          = 22,
57    METADATA_KEY_LOCATION        = 23,
58
59    // Add more here...
60};
61
62class MediaMetadataRetriever: public RefBase
63{
64public:
65    MediaMetadataRetriever();
66    ~MediaMetadataRetriever();
67    void disconnect();
68
69    status_t setDataSource(
70            const char *dataSourceUrl,
71            const KeyedVector<String8, String8> *headers = NULL);
72
73    status_t setDataSource(int fd, int64_t offset, int64_t length);
74    sp<IMemory> getFrameAtTime(int64_t timeUs, int option);
75    sp<IMemory> extractAlbumArt();
76    const char* extractMetadata(int keyCode);
77
78private:
79    static const sp<IMediaPlayerService>& getService();
80
81    class DeathNotifier: public IBinder::DeathRecipient
82    {
83    public:
84        DeathNotifier() {}
85        virtual ~DeathNotifier();
86        virtual void binderDied(const wp<IBinder>& who);
87    };
88
89    static sp<DeathNotifier>                  sDeathNotifier;
90    static Mutex                              sServiceLock;
91    static sp<IMediaPlayerService>            sService;
92
93    Mutex                                     mLock;
94    sp<IMediaMetadataRetriever>               mRetriever;
95
96};
97
98}; // namespace android
99
100#endif // MEDIAMETADATARETRIEVER_H
101