1 /* 2 * Copyright 2013, 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_MUXER_H_ 18 #define MEDIA_MUXER_H_ 19 20 #include <utils/Errors.h> 21 #include <utils/RefBase.h> 22 #include <utils/Vector.h> 23 #include <utils/threads.h> 24 25 #include "foundation/ABase.h" 26 27 namespace android { 28 29 struct ABuffer; 30 struct AMessage; 31 struct MediaAdapter; 32 class MediaBuffer; 33 struct MediaSource; 34 class MetaData; 35 struct MediaWriter; 36 37 // MediaMuxer is used to mux multiple tracks into a video. Currently, we only 38 // support a mp4 file as the output. 39 // The expected calling order of the functions is: 40 // Constructor -> addTrack+ -> start -> writeSampleData+ -> stop 41 // If muxing operation need to be cancelled, the app is responsible for 42 // deleting the output file after stop. 43 struct MediaMuxer : public RefBase { 44 public: 45 // Please update media/java/android/media/MediaMuxer.java if the 46 // OutputFormat is updated. 47 enum OutputFormat { 48 OUTPUT_FORMAT_MPEG_4 = 0, 49 OUTPUT_FORMAT_WEBM = 1, 50 OUTPUT_FORMAT_LIST_END // must be last - used to validate format type 51 }; 52 53 // Construct the muxer with the file descriptor. Note that the MediaMuxer 54 // will close this file at stop(). 55 MediaMuxer(int fd, OutputFormat format); 56 57 virtual ~MediaMuxer(); 58 59 /** 60 * Add a track with its format information. This should be 61 * called before start(). 62 * @param format the track's format. 63 * @return the track's index or negative number if error. 64 */ 65 ssize_t addTrack(const sp<AMessage> &format); 66 67 /** 68 * Start muxing. Make sure all the tracks have been added before 69 * calling this. 70 */ 71 status_t start(); 72 73 /** 74 * Set the orientation hint. 75 * @param degrees The rotation degrees. It has to be either 0, 76 * 90, 180 or 270. 77 * @return OK if no error. 78 */ 79 status_t setOrientationHint(int degrees); 80 81 /** 82 * Set the location. 83 * @param latitude The latitude in degree x 1000. Its value must be in the range 84 * [-900000, 900000]. 85 * @param longitude The longitude in degree x 1000. Its value must be in the range 86 * [-1800000, 1800000]. 87 * @return OK if no error. 88 */ 89 status_t setLocation(int latitude, int longitude); 90 91 /** 92 * Stop muxing. 93 * This method is a blocking call. Depending on how 94 * much data is bufferred internally, the time needed for stopping 95 * the muxer may be time consuming. UI thread is 96 * not recommended for launching this call. 97 * @return OK if no error. 98 */ 99 status_t stop(); 100 101 /** 102 * Send a sample buffer for muxing. 103 * The buffer can be reused once this method returns. Typically, 104 * this function won't be blocked for very long, and thus there 105 * is no need to use a separate thread calling this method to 106 * push a buffer. 107 * @param buffer the incoming sample buffer. 108 * @param trackIndex the buffer's track index number. 109 * @param timeUs the buffer's time stamp. 110 * @param flags the only supported flag for now is 111 * MediaCodec::BUFFER_FLAG_SYNCFRAME. 112 * @return OK if no error. 113 */ 114 status_t writeSampleData(const sp<ABuffer> &buffer, size_t trackIndex, 115 int64_t timeUs, uint32_t flags) ; 116 117 private: 118 const OutputFormat mFormat; 119 sp<MediaWriter> mWriter; 120 Vector< sp<MediaAdapter> > mTrackList; // Each track has its MediaAdapter. 121 sp<MetaData> mFileMeta; // Metadata for the whole file. 122 123 Mutex mMuxerLock; 124 125 enum State { 126 UNINITIALIZED, 127 INITIALIZED, 128 STARTED, 129 STOPPED 130 }; 131 State mState; 132 133 DISALLOW_EVIL_CONSTRUCTORS(MediaMuxer); 134 }; 135 136 } // namespace android 137 138 #endif // MEDIA_MUXER_H_ 139 140