IAudioTrack.h revision 4ff14bae91075eb274eb1c2975982358946e7e63
1/* 2 * Copyright (C) 2007 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_IAUDIOTRACK_H 18#define ANDROID_IAUDIOTRACK_H 19 20#include <stdint.h> 21#include <sys/types.h> 22 23#include <utils/RefBase.h> 24#include <utils/Errors.h> 25#include <binder/IInterface.h> 26#include <binder/IMemory.h> 27#include <utils/LinearTransform.h> 28 29namespace android { 30 31// ---------------------------------------------------------------------------- 32 33class IAudioTrack : public IInterface 34{ 35public: 36 DECLARE_META_INTERFACE(AudioTrack); 37 38 /* Get this track's control block */ 39 virtual sp<IMemory> getCblk() const = 0; 40 41 /* After it's created the track is not active. Call start() to 42 * make it active. If set, the callback will start being called. 43 * tid identifies the client callback thread, or 0 if not needed. 44 */ 45 virtual status_t start(pid_t tid) = 0; 46 47 /* Stop a track. If set, the callback will cease being called and 48 * obtainBuffer will return an error. Buffers that are already released 49 * will continue to be processed, unless/until flush() is called. 50 */ 51 virtual void stop() = 0; 52 53 /* Flush a stopped or paused track. All pending/released buffers are discarded. 54 * This function has no effect if the track is not stopped or paused. 55 */ 56 virtual void flush() = 0; 57 58 /* Mute or unmute this track. 59 * While muted, the callback, if set, is still called. 60 */ 61 virtual void mute(bool) = 0; 62 63 /* Pause a track. If set, the callback will cease being called and 64 * obtainBuffer will return an error. Buffers that are already released 65 * will continue to be processed, unless/until flush() is called. 66 */ 67 virtual void pause() = 0; 68 69 /* Attach track auxiliary output to specified effect. Use effectId = 0 70 * to detach track from effect. 71 */ 72 virtual status_t attachAuxEffect(int effectId) = 0; 73 74 75 /* Allocate a shared memory buffer suitable for holding timed audio 76 samples */ 77 virtual status_t allocateTimedBuffer(size_t size, 78 sp<IMemory>* buffer) = 0; 79 80 /* Queue a buffer obtained via allocateTimedBuffer for playback at the given 81 timestamp */ 82 virtual status_t queueTimedBuffer(const sp<IMemory>& buffer, 83 int64_t pts) = 0; 84 85 /* Define the linear transform that will be applied to the timestamps 86 given to queueTimedBuffer (which are expressed in media time). 87 Target specifies whether this transform converts media time to local time 88 or Tungsten time. The values for target are defined in AudioTrack.h */ 89 virtual status_t setMediaTimeTransform(const LinearTransform& xform, 90 int target) = 0; 91}; 92 93// ---------------------------------------------------------------------------- 94 95class BnAudioTrack : public BnInterface<IAudioTrack> 96{ 97public: 98 virtual status_t onTransact( uint32_t code, 99 const Parcel& data, 100 Parcel* reply, 101 uint32_t flags = 0); 102}; 103 104// ---------------------------------------------------------------------------- 105 106}; // namespace android 107 108#endif // ANDROID_IAUDIOTRACK_H 109