Andreas Huber | e46b7be | 2009-07-14 16:56:47 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2009 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 | #ifndef MEDIA_EXTRACTOR_H_ |
| 18 | |
| 19 | #define MEDIA_EXTRACTOR_H_ |
| 20 | |
| 21 | #include <utils/RefBase.h> |
| 22 | |
| 23 | namespace android { |
| 24 | |
| 25 | class DataSource; |
| 26 | class MediaSource; |
| 27 | class MetaData; |
| 28 | |
Andreas Huber | be06d26 | 2009-08-14 14:37:10 -0700 | [diff] [blame] | 29 | class MediaExtractor : public RefBase { |
Andreas Huber | e46b7be | 2009-07-14 16:56:47 -0700 | [diff] [blame] | 30 | public: |
Andreas Huber | be06d26 | 2009-08-14 14:37:10 -0700 | [diff] [blame] | 31 | static sp<MediaExtractor> Create( |
| 32 | const sp<DataSource> &source, const char *mime = NULL); |
Andreas Huber | e46b7be | 2009-07-14 16:56:47 -0700 | [diff] [blame] | 33 | |
Andreas Huber | be06d26 | 2009-08-14 14:37:10 -0700 | [diff] [blame] | 34 | virtual size_t countTracks() = 0; |
| 35 | virtual sp<MediaSource> getTrack(size_t index) = 0; |
Andreas Huber | e981c33 | 2009-10-22 13:49:30 -0700 | [diff] [blame] | 36 | |
| 37 | enum GetTrackMetaDataFlags { |
| 38 | kIncludeExtensiveMetaData = 1 |
| 39 | }; |
| 40 | virtual sp<MetaData> getTrackMetaData( |
| 41 | size_t index, uint32_t flags = 0) = 0; |
Andreas Huber | e46b7be | 2009-07-14 16:56:47 -0700 | [diff] [blame] | 42 | |
Andreas Huber | aee3c63 | 2010-01-11 15:35:19 -0800 | [diff] [blame] | 43 | // Return container specific meta-data. The default implementation |
| 44 | // returns an empty metadata object. |
| 45 | virtual sp<MetaData> getMetaData(); |
| 46 | |
Andreas Huber | 62f7ffe | 2010-05-06 10:18:05 -0700 | [diff] [blame] | 47 | enum Flags { |
Andreas Huber | 10b9b3f | 2010-10-08 10:16:24 -0700 | [diff] [blame] | 48 | CAN_SEEK_BACKWARD = 1, // the "seek 10secs back button" |
| 49 | CAN_SEEK_FORWARD = 2, // the "seek 10secs forward button" |
Andreas Huber | 62f7ffe | 2010-05-06 10:18:05 -0700 | [diff] [blame] | 50 | CAN_PAUSE = 4, |
Andreas Huber | 10b9b3f | 2010-10-08 10:16:24 -0700 | [diff] [blame] | 51 | CAN_SEEK = 8, // the "seek bar" |
Andreas Huber | 62f7ffe | 2010-05-06 10:18:05 -0700 | [diff] [blame] | 52 | }; |
| 53 | |
| 54 | // If subclasses do _not_ override this, the default is |
Andreas Huber | 10b9b3f | 2010-10-08 10:16:24 -0700 | [diff] [blame] | 55 | // CAN_SEEK_BACKWARD | CAN_SEEK_FORWARD | CAN_SEEK | CAN_PAUSE |
Andreas Huber | 62f7ffe | 2010-05-06 10:18:05 -0700 | [diff] [blame] | 56 | virtual uint32_t flags() const; |
| 57 | |
Gloria Wang | d577091 | 2010-06-22 13:55:38 -0700 | [diff] [blame] | 58 | // for DRM |
James Dong | d1ba6ed | 2012-01-10 08:24:37 -0800 | [diff] [blame] | 59 | void setDrmFlag(bool flag) { |
Gloria Wang | 82428a8 | 2011-06-27 11:09:00 -0700 | [diff] [blame] | 60 | mIsDrm = flag; |
| 61 | }; |
James Dong | d1ba6ed | 2012-01-10 08:24:37 -0800 | [diff] [blame] | 62 | bool getDrmFlag() { |
Gloria Wang | 82428a8 | 2011-06-27 11:09:00 -0700 | [diff] [blame] | 63 | return mIsDrm; |
| 64 | } |
Gloria Wang | d577091 | 2010-06-22 13:55:38 -0700 | [diff] [blame] | 65 | virtual char* getDrmTrackInfo(size_t trackID, int *len) { |
| 66 | return NULL; |
| 67 | } |
| 68 | |
Andreas Huber | e46b7be | 2009-07-14 16:56:47 -0700 | [diff] [blame] | 69 | protected: |
| 70 | MediaExtractor() {} |
Andreas Huber | be06d26 | 2009-08-14 14:37:10 -0700 | [diff] [blame] | 71 | virtual ~MediaExtractor() {} |
Andreas Huber | e46b7be | 2009-07-14 16:56:47 -0700 | [diff] [blame] | 72 | |
| 73 | private: |
Gloria Wang | 82428a8 | 2011-06-27 11:09:00 -0700 | [diff] [blame] | 74 | bool mIsDrm; |
| 75 | |
Andreas Huber | e46b7be | 2009-07-14 16:56:47 -0700 | [diff] [blame] | 76 | MediaExtractor(const MediaExtractor &); |
| 77 | MediaExtractor &operator=(const MediaExtractor &); |
| 78 | }; |
| 79 | |
| 80 | } // namespace android |
| 81 | |
| 82 | #endif // MEDIA_EXTRACTOR_H_ |