mediametadataretriever.h revision 7be6407f2ad7f2b0782d195d9f792072c084d6f5 
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    // Add more here...
58};
59
60// The intended mode of operations:$
61// METADATA_MODE_NOOP: Experimental - just add and remove data source.$
62// METADATA_MODE_FRAME_CAPTURE_ONLY: For capture frame/thumbnail only.$
63// METADATA_MODE_METADATA_RETRIEVAL_ONLY: For meta data retrieval only.$
64// METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL: For both frame capture
65//   and meta data retrieval.$
66enum {
67    METADATA_MODE_NOOP                                 = 0x00,
68    METADATA_MODE_FRAME_CAPTURE_ONLY                   = 0x01,
69    METADATA_MODE_METADATA_RETRIEVAL_ONLY              = 0x02,
70    METADATA_MODE_FRAME_CAPTURE_AND_METADATA_RETRIEVAL = 0x03
71};
72
73class MediaMetadataRetriever: public RefBase
74{
75public:
76    MediaMetadataRetriever();
77    ~MediaMetadataRetriever();
78    void disconnect();
79    status_t setDataSource(const char* dataSourceUrl);
80    status_t setDataSource(int fd, int64_t offset, int64_t length);
81    status_t setMode(int mode);
82    status_t getMode(int* mode);
83    sp<IMemory> captureFrame();
84    sp<IMemory> extractAlbumArt();
85    const char* extractMetadata(int keyCode);
86
87private:
88    static const sp<IMediaPlayerService>& getService();
89
90    class DeathNotifier: public IBinder::DeathRecipient
91    {
92    public:
93        DeathNotifier() {}
94        virtual ~DeathNotifier();
95        virtual void binderDied(const wp<IBinder>& who);
96    };
97
98    static sp<DeathNotifier>                  sDeathNotifier;
99    static Mutex                              sServiceLock;
100    static sp<IMediaPlayerService>            sService;
101
102    Mutex                                     mLock;
103    sp<IMediaMetadataRetriever>               mRetriever;
104
105};
106
107}; // namespace android
108
109#endif // MEDIAMETADATARETRIEVER_H
110