mediametadataretriever.h revision 66ac4df65516ebfd0e500bfca75dc4b5ef8d674e 
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_IS_DRM_CRIPPLED = 11,
46    METADATA_KEY_CODEC           = 12,
47    METADATA_KEY_RATING          = 13,
48    METADATA_KEY_COMMENT         = 14,
49    METADATA_KEY_COPYRIGHT       = 15,
50    METADATA_KEY_BIT_RATE        = 16,
51    METADATA_KEY_FRAME_RATE      = 17,
52    METADATA_KEY_VIDEO_FORMAT    = 18,
53    METADATA_KEY_VIDEO_HEIGHT    = 19,
54    METADATA_KEY_VIDEO_WIDTH     = 20,
55    METADATA_KEY_WRITER          = 21,
56    METADATA_KEY_MIMETYPE        = 22,
57    METADATA_KEY_DISC_NUMBER     = 23,
58    METADATA_KEY_ALBUMARTIST     = 24,
59    // Add more here...
60};
61
62// The intended mode of operations:$
63// METADATA_MODE_NOOP: Experimental - just add and remove data source.$
64// METADATA_MODE_FRAME_CAPTURE_ONLY: For capture frame/thumbnail only.$
65// METADATA_MODE_METADATA_RETRIEVAL_ONLY: For meta data retrieval only.$
66// METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL: For both frame capture
67//   and meta data retrieval.$
68enum {
69    METADATA_MODE_NOOP                                 = 0x00,
70    METADATA_MODE_FRAME_CAPTURE_ONLY                   = 0x01,
71    METADATA_MODE_METADATA_RETRIEVAL_ONLY              = 0x02,
72    METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL = 0x03
73};
74
75class MediaMetadataRetriever: public RefBase
76{
77public:
78    MediaMetadataRetriever();
79    ~MediaMetadataRetriever();
80    void disconnect();
81    status_t setDataSource(const char* dataSourceUrl);
82    status_t setDataSource(int fd, int64_t offset, int64_t length);
83    status_t setMode(int mode);
84    status_t getMode(int* mode);
85    sp<IMemory> captureFrame();
86    sp<IMemory> extractAlbumArt();
87    const char* extractMetadata(int keyCode);
88
89private:
90    static const sp<IMediaPlayerService>& getService();
91
92    class DeathNotifier: public IBinder::DeathRecipient
93    {
94    public:
95        DeathNotifier() {}
96        virtual ~DeathNotifier();
97        virtual void binderDied(const wp<IBinder>& who);
98    };
99
100    static sp<DeathNotifier>                  sDeathNotifier;
101    static Mutex                              sServiceLock;
102    static sp<IMediaPlayerService>            sService;
103
104    Mutex                                     mLock;
105    sp<IMediaMetadataRetriever>               mRetriever;
106
107};
108
109}; // namespace android
110
111#endif // MEDIAMETADATARETRIEVER_H
112