1e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman/* 2e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * Copyright (C) 2007 The Android Open Source Project 3e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * 4e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * Licensed under the Apache License, Version 2.0 (the "License"); 5e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * you may not use this file except in compliance with the License. 6e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * You may obtain a copy of the License at 7e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * 8e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * http://www.apache.org/licenses/LICENSE-2.0 9e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * 10e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * Unless required by applicable law or agreed to in writing, software 11e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * distributed under the License is distributed on an "AS IS" BASIS, 12e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * See the License for the specific language governing permissions and 14e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * limitations under the License. 15e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman */ 16e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 17e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#ifndef ANDROID_IAUDIOTRACK_H 18e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#define ANDROID_IAUDIOTRACK_H 19e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 20e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <stdint.h> 21e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <sys/types.h> 22e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 23e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <utils/RefBase.h> 24e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <utils/Errors.h> 25e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <binder/IInterface.h> 26e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <binder/IMemory.h> 27e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <utils/String8.h> 28e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <media/AudioTimestamp.h> 29e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#include <media/VolumeShaper.h> 30e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 31e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramannamespace android { 32e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 33e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 34e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 35e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanclass IAudioTrack : public IInterface 36e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman{ 37e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanpublic: 38e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman DECLARE_META_INTERFACE(AudioTrack); 39e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 40e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Get this track's control block */ 41e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual sp<IMemory> getCblk() const = 0; 42e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 43e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* After it's created the track is not active. Call start() to 44e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * make it active. 45e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman */ 46e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t start() = 0; 47e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 48e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Stop a track. If set, the callback will cease being called and 49e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * obtainBuffer will return an error. Buffers that are already released 50e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * will continue to be processed, unless/until flush() is called. 51e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman */ 52e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void stop() = 0; 53e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 54e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Flush a stopped or paused track. All pending/released buffers are discarded. 55e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * This function has no effect if the track is not stopped or paused. 56e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman */ 57e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void flush() = 0; 58e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 59e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Pause a track. If set, the callback will cease being called and 60e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * obtainBuffer will return an error. Buffers that are already released 61e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * will continue to be processed, unless/until flush() is called. 62e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman */ 63e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void pause() = 0; 64e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 65e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Attach track auxiliary output to specified effect. Use effectId = 0 66e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman * to detach track from effect. 67e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman */ 68e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t attachAuxEffect(int effectId) = 0; 69e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 70e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Send parameters to the audio hardware */ 71e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t setParameters(const String8& keyValuePairs) = 0; 72e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 73e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Return NO_ERROR if timestamp is valid. timestamp is undefined otherwise. */ 74e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t getTimestamp(AudioTimestamp& timestamp) = 0; 75e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 76e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Signal the playback thread for a change in control block */ 77e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual void signal() = 0; 78e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 79e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* Sets the volume shaper */ 80e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual VolumeShaper::Status applyVolumeShaper( 81e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const sp<VolumeShaper::Configuration>& configuration, 82e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const sp<VolumeShaper::Operation>& operation) = 0; 83e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 84e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman /* gets the volume shaper state */ 85e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual sp<VolumeShaper::State> getVolumeShaperState(int id) = 0; 86e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; 87e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 88e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 89e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 90e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanclass BnAudioTrack : public BnInterface<IAudioTrack> 91e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman{ 92e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatramanpublic: 93e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman virtual status_t onTransact( uint32_t code, 94e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman const Parcel& data, 95e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman Parcel* reply, 96e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman uint32_t flags = 0); 97e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; 98e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 99e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman// ---------------------------------------------------------------------------- 100e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 101e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman}; // namespace android 102e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman 103e2b43843fd12783188edd2c54188ea8d26864788Vijay Venkatraman#endif // ANDROID_IAUDIOTRACK_H 104