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