1 /* 2 * Copyright (C) 2010 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 ANDROID_ISTREAMSOURCE_H_ 18 19 #define ANDROID_ISTREAMSOURCE_H_ 20 21 #include <binder/IInterface.h> 22 23 namespace android { 24 25 struct AMessage; 26 class IMemory; 27 struct IStreamListener; 28 29 struct IStreamSource : public IInterface { 30 DECLARE_META_INTERFACE(StreamSource); 31 32 virtual void setListener(const sp<IStreamListener> &listener) = 0; 33 virtual void setBuffers(const Vector<sp<IMemory> > &buffers) = 0; 34 35 virtual void onBufferAvailable(size_t index) = 0; 36 37 enum { 38 // Video PES packets contain exactly one (aligned) access unit. 39 kFlagAlignedVideoData = 1, 40 41 // Timestamps are in ALooper::GetNowUs() units. 42 kFlagIsRealTimeData = 2, 43 }; flagsIStreamSource44 virtual uint32_t flags() const { return 0; } 45 }; 46 47 struct IStreamListener : public IInterface { 48 DECLARE_META_INTERFACE(StreamListener); 49 50 enum Command { 51 EOS, 52 DISCONTINUITY, 53 }; 54 55 virtual void queueBuffer(size_t index, size_t size) = 0; 56 57 // When signalling a discontinuity you can optionally 58 // specify an int64_t PTS timestamp in "msg". 59 // If present, rendering of data following the discontinuity 60 // will be suppressed until media time reaches this timestamp. 61 static const char *const kKeyResumeAtPTS; 62 63 // When signalling a discontinuity you can optionally 64 // specify the type(s) of discontinuity, i.e. if the 65 // audio format has changed, the video format has changed, 66 // time has jumped or any combination thereof. 67 // To do so, include a non-zero int32_t value 68 // under the key "kKeyDiscontinuityMask" when issuing the DISCONTINUITY 69 // command. 70 // If there is a change in audio/video format, The new logical stream 71 // must start with proper codec initialization 72 // information for playback to continue, i.e. SPS and PPS in the case 73 // of AVC video etc. 74 // If this key is not present, only a time discontinuity is assumed. 75 // The value should be a bitmask of values from 76 // ATSParser::DiscontinuityType. 77 static const char *const kKeyDiscontinuityMask; 78 79 // Optionally signalled as part of a discontinuity that includes 80 // DISCONTINUITY_TIME. It indicates the media time (in us) to be associated 81 // with the next PTS occuring in the stream. The value is of type int64_t. 82 static const char *const kKeyMediaTimeUs; 83 84 // Optionally signalled as part of a discontinuity that includes 85 // DISCONTINUITY_TIME. It indicates the media time (in us) of a recent 86 // sample from the same content, and is used as a hint for the parser to 87 // handle PTS wraparound. This is required when a new parser is created 88 // to continue parsing content from the same timeline. 89 static const char *const kKeyRecentMediaTimeUs; 90 91 virtual void issueCommand( 92 Command cmd, bool synchronous, const sp<AMessage> &msg = NULL) = 0; 93 }; 94 95 //////////////////////////////////////////////////////////////////////////////// 96 97 struct BnStreamSource : public BnInterface<IStreamSource> { 98 virtual status_t onTransact( 99 uint32_t code, const Parcel &data, Parcel *reply, 100 uint32_t flags = 0); 101 }; 102 103 struct BnStreamListener : public BnInterface<IStreamListener> { 104 virtual status_t onTransact( 105 uint32_t code, const Parcel &data, Parcel *reply, 106 uint32_t flags = 0); 107 }; 108 109 } // namespace android 110 111 #endif // ANDROID_ISTREAMSOURCE_H_ 112