189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project/* 289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * you may not use this file except in compliance with the License. 689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * You may obtain a copy of the License at 789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 1089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 1189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 1289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * See the License for the specific language governing permissions and 1489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * limitations under the License. 1589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 1689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 1789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#ifndef ANDROID_IAUDIOTRACK_H 1889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#define ANDROID_IAUDIOTRACK_H 1989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <stdint.h> 2189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <sys/types.h> 2289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/RefBase.h> 2489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/Errors.h> 257562408b2261d38415453378b6188f74fda99d88Mathias Agopian#include <binder/IInterface.h> 267562408b2261d38415453378b6188f74fda99d88Mathias Agopian#include <binder/IMemory.h> 27ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald#include <utils/String8.h> 2853cec22821072719ee02c856e9ac2dda2496c570Glenn Kasten#include <media/AudioTimestamp.h> 2989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectnamespace android { 3189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 3389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass IAudioTrack : public IInterface 3589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 36e53b9ead781c36e96d6b6f012ddffc93a3d80f0dGlenn Kastenpublic: 3789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project DECLARE_META_INTERFACE(AudioTrack); 3889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 391099586bd48a8a90bb1cc4e7c279703bc7259214Glenn Kasten /* Get this track's control block */ 401099586bd48a8a90bb1cc4e7c279703bc7259214Glenn Kasten virtual sp<IMemory> getCblk() const = 0; 411099586bd48a8a90bb1cc4e7c279703bc7259214Glenn Kasten 4289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* After it's created the track is not active. Call start() to 433acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten * make it active. 4489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 453acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten virtual status_t start() = 0; 4689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 4789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Stop a track. If set, the callback will cease being called and 48e53b9ead781c36e96d6b6f012ddffc93a3d80f0dGlenn Kasten * obtainBuffer will return an error. Buffers that are already released 4999e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * will continue to be processed, unless/until flush() is called. 5089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 5189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void stop() = 0; 5289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 5399e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten /* Flush a stopped or paused track. All pending/released buffers are discarded. 5499e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * This function has no effect if the track is not stopped or paused. 5589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 5689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void flush() = 0; 5789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 5889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Pause a track. If set, the callback will cease being called and 59e53b9ead781c36e96d6b6f012ddffc93a3d80f0dGlenn Kasten * obtainBuffer will return an error. Buffers that are already released 6099e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * will continue to be processed, unless/until flush() is called. 6189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 6289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual void pause() = 0; 6389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 64be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent /* Attach track auxiliary output to specified effect. Use effectId = 0 65be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * to detach track from effect. 66be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent */ 67be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent virtual status_t attachAuxEffect(int effectId) = 0; 68be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 69ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald /* Send parameters to the audio hardware */ 70ad3af3305f024bcbbd55c894a4995e449498e1baRichard Fitzgerald virtual status_t setParameters(const String8& keyValuePairs) = 0; 7153cec22821072719ee02c856e9ac2dda2496c570Glenn Kasten 72200092b7f21d2b98f30b800e79d152636f9ba225Glenn Kasten /* Return NO_ERROR if timestamp is valid. timestamp is undefined otherwise. */ 7353cec22821072719ee02c856e9ac2dda2496c570Glenn Kasten virtual status_t getTimestamp(AudioTimestamp& timestamp) = 0; 7459fe010bcc072597852454a2ec53d7b0a2002a3bEric Laurent 7559fe010bcc072597852454a2ec53d7b0a2002a3bEric Laurent /* Signal the playback thread for a change in control block */ 7659fe010bcc072597852454a2ec53d7b0a2002a3bEric Laurent virtual void signal() = 0; 7789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 7889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 7989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 8089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass BnAudioTrack : public BnInterface<IAudioTrack> 8289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 8389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 8489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual status_t onTransact( uint32_t code, 8589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const Parcel& data, 8689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project Parcel* reply, 8789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t flags = 0); 8889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 8989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 9089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 9189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 9289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 9389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 9489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif // ANDROID_IAUDIOTRACK_H 95