Home | History | Annotate | Download | only in media 
      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 struct 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     virtual uint32_t flags() const { return 0; }
     42 };
     43 
     44 struct IStreamListener : public IInterface {
     45     DECLARE_META_INTERFACE(StreamListener);
     46 
     47     enum Command {
     48         EOS,
     49         DISCONTINUITY,
     50     };
     51 
     52     virtual void queueBuffer(size_t index, size_t size) = 0;
     53 
     54     // When signalling a discontinuity you can optionally
     55     // specify an int64_t PTS timestamp in "msg".
     56     // If present, rendering of data following the discontinuity
     57     // will be suppressed until media time reaches this timestamp.
     58     static const char *const kKeyResumeAtPTS;
     59 
     60     // When signalling a discontinuity you can optionally
     61     // specify the type(s) of discontinuity, i.e. if the
     62     // audio format has changed, the video format has changed,
     63     // time has jumped or any combination thereof.
     64     // To do so, include a non-zero int32_t value
     65     // under the key "kKeyDiscontinuityMask" when issuing the DISCONTINUITY
     66     // command.
     67     // If there is a change in audio/video format, The new logical stream
     68     // must start with proper codec initialization
     69     // information for playback to continue, i.e. SPS and PPS in the case
     70     // of AVC video etc.
     71     // If this key is not present, only a time discontinuity is assumed.
     72     // The value should be a bitmask of values from
     73     // ATSParser::DiscontinuityType.
     74     static const char *const kKeyDiscontinuityMask;
     75 
     76     virtual void issueCommand(
     77             Command cmd, bool synchronous, const sp<AMessage> &msg = NULL) = 0;
     78 };
     79 
     80 ////////////////////////////////////////////////////////////////////////////////
     81 
     82 struct BnStreamSource : public BnInterface<IStreamSource> {
     83     virtual status_t onTransact(
     84             uint32_t code, const Parcel &data, Parcel *reply,
     85             uint32_t flags = 0);
     86 };
     87 
     88 struct BnStreamListener : public BnInterface<IStreamListener> {
     89     virtual status_t onTransact(
     90             uint32_t code, const Parcel &data, Parcel *reply,
     91             uint32_t flags = 0);
     92 };
     93 
     94 }  // namespace android
     95 
     96 #endif  // ANDROID_ISTREAMSOURCE_H_
     97