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_AUDIOTRACK_H 1889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#define ANDROID_AUDIOTRACK_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 <media/IAudioFlinger.h> 2489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <media/IAudioTrack.h> 2589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <media/AudioSystem.h> 2689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 2789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/RefBase.h> 2889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/Errors.h> 297562408b2261d38415453378b6188f74fda99d88Mathias Agopian#include <binder/IInterface.h> 307562408b2261d38415453378b6188f74fda99d88Mathias Agopian#include <binder/IMemory.h> 31a636433cbd09c0708b85f337ef45c0cdef3bcb4dGlenn Kasten#include <cutils/sched_policy.h> 3289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#include <utils/threads.h> 3389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectnamespace android { 3589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 3789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 3889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectclass audio_track_cblk_t; 3989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 4089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project// ---------------------------------------------------------------------------- 4189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 42b68a91a70bc8d0d18e7404e14443d4e4020b3635Glenn Kastenclass AudioTrack : virtual public RefBase 4389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project{ 4489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Projectpublic: 4589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum channel_index { 4689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MONO = 0, 4789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project LEFT = 0, 4889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project RIGHT = 1 4989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 5089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 5189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Events used by AudioTrack callback function (audio_track_cblk_t). 5289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 5389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum event_type { 5489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project EVENT_MORE_DATA = 0, // Request to write more data to PCM buffer. 5589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project EVENT_UNDERRUN = 1, // PCM buffer underrun occured. 5689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project EVENT_LOOP_END = 2, // Sample loop end was reached; playback restarted from loop start if loop count was not 0. 5789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project EVENT_MARKER = 3, // Playback head is at the specified marker position (See setMarkerPosition()). 5889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project EVENT_NEW_POS = 4, // Playback head is at a new position (See setPositionUpdatePeriod()). 5989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project EVENT_BUFFER_END = 5 // Playback head is at the end of the buffer. 6089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 6189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 6299e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten /* Client should declare Buffer on the stack and pass address to obtainBuffer() 6399e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * and releaseBuffer(). See also callback_t for EVENT_MORE_DATA. 6489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 6589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 6689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project class Buffer 6789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project { 6889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project public: 6989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum { 7089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project MUTE = 0x00000001 7189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 7299e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten uint32_t flags; // 0 or MUTE 73e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten audio_format_t format; // but AUDIO_FORMAT_PCM_8_BIT -> AUDIO_FORMAT_PCM_16_BIT 74e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten // accessed directly by WebKit ANP callback 750d255b2d9061ba31f13ada3fc0f7e51916407176Jean-Michel Trivi int channelCount; // will be removed in the future, do not use 7699e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten 7799e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten size_t frameCount; // number of sample frames corresponding to size; 7899e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten // on input it is the number of frames desired, 7999e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten // on output is the number of frames actually filled 8099e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten 8199e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten size_t size; // input/output in byte units 8289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project union { 8389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void* raw; 84362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten short* i16; // signed 16-bit 85362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten int8_t* i8; // unsigned 8-bit, offset by 0x80 8689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 8789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 8889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 8989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 9089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* As a convenience, if a callback is supplied, a handler thread 9189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * is automatically created with the appropriate priority. This thread 9299e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * invokes the callback when a new buffer becomes available or various conditions occur. 9389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Parameters: 9489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 9589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * event: type of event notified (see enum AudioTrack::event_type). 9689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * user: Pointer to context for use by the callback receiver. 9789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * info: Pointer to optional parameter according to event type: 9889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - EVENT_MORE_DATA: pointer to AudioTrack::Buffer struct. The callback must not write 9999e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * more bytes than indicated by 'size' field and update 'size' if fewer bytes are 10099e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * written. 10189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - EVENT_UNDERRUN: unused. 10289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - EVENT_LOOP_END: pointer to an int indicating the number of loops remaining. 103362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * - EVENT_MARKER: pointer to an uint32_t containing the marker position in frames. 104362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * - EVENT_NEW_POS: pointer to an uint32_t containing the new position in frames. 10589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - EVENT_BUFFER_END: unused. 10689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 10789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 108d217a8c4632b3e3065f8c2a26b9ce4dc4c97171fGlenn Kasten typedef void (*callback_t)(int event, void* user, void *info); 10989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 11033005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh /* Returns the minimum frame count required for the successful creation of 11133005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh * an AudioTrack object. 11233005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh * Returned status (from utils/Errors.h) can be: 11333005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh * - NO_ERROR: successful operation 11433005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh * - NO_INIT: audio server or audio hardware not initialized 11533005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh */ 11633005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh 11733005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh static status_t getMinFrameCount(int* frameCount, 118fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten audio_stream_type_t streamType = AUDIO_STREAM_DEFAULT, 11933005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh uint32_t sampleRate = 0); 12033005a932c60a0780fe9b7307d5988df3d9f6c26Chia-chi Yeh 12189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Constructs an uninitialized AudioTrack. No connection with 12289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * AudioFlinger takes place. 12389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 12489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AudioTrack(); 12589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 12689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Creates an audio track and registers it with AudioFlinger. 12789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Once created, the track needs to be started before it can be used. 12889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Unspecified values are set to the audio hardware's current 12989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * values. 13089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 13189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Parameters: 13289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 13389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * streamType: Select the type of audio stream this track is attached to 134fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin * (e.g. AUDIO_STREAM_MUSIC). 13589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * sampleRate: Track sampling rate in Hz. 136fce7a473248381cc83a01855f92581077d3c9ee2Dima Zavin * format: Audio format (e.g AUDIO_FORMAT_PCM_16_BIT for signed 13789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 16 bits per sample). 13828b76b334f92a15a2be3cc9e2f7d229a3275d1acGlenn Kasten * channelMask: Channel mask. 139d8d6185c978c9b27ca69e7791785e0983ed9e8b8Eric Laurent * frameCount: Minimum size of track PCM buffer in frames. This defines the 140d8d6185c978c9b27ca69e7791785e0983ed9e8b8Eric Laurent * latency of the track. The actual size selected by the AudioTrack could be 141d8d6185c978c9b27ca69e7791785e0983ed9e8b8Eric Laurent * larger if the requested size is not compatible with current audio HAL 1423acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten * latency. Zero means to use a default value. 1430ca3cf94c0dfc173ad7886ae162c4b67067539f6Eric Laurent * flags: See comments on audio_output_flags_t in <system/audio.h>. 14489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * cbf: Callback function. If not null, this function is called periodically 14589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * to request new PCM data. 146362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * user: Context for use by the callback receiver. 14789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * notificationFrames: The callback function is called each time notificationFrames PCM 148362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * frames have been consumed from track input buffer. 149362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * sessionId: Specific session ID, or zero to use default. 1504a4a0959bca78e03e3c3f486ba17829c28314d8cGlenn Kasten * threadCanCallJava: Whether callbacks are made from an attached thread and thus can call JNI. 1514a4a0959bca78e03e3c3f486ba17829c28314d8cGlenn Kasten * If not present in parameter list, then fixed at false. 15289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 15389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 154fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten AudioTrack( audio_stream_type_t streamType, 15589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate = 0, 156e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten audio_format_t format = AUDIO_FORMAT_DEFAULT, 15728b76b334f92a15a2be3cc9e2f7d229a3275d1acGlenn Kasten audio_channel_mask_t channelMask = 0, 15889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount = 0, 1590ca3cf94c0dfc173ad7886ae162c4b67067539f6Eric Laurent audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, 160a0d68338a88c2ddb4502f95017b546d603ef1ec7Glenn Kasten callback_t cbf = NULL, 161a0d68338a88c2ddb4502f95017b546d603ef1ec7Glenn Kasten void* user = NULL, 162be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int notificationFrames = 0, 1634a4a0959bca78e03e3c3f486ba17829c28314d8cGlenn Kasten int sessionId = 0); 16489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 165c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber // DEPRECATED 166c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber explicit AudioTrack( int streamType, 167c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber uint32_t sampleRate = 0, 168c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber int format = AUDIO_FORMAT_DEFAULT, 169c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber int channelMask = 0, 170c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber int frameCount = 0, 1710ca3cf94c0dfc173ad7886ae162c4b67067539f6Eric Laurent uint32_t flags = (uint32_t) AUDIO_OUTPUT_FLAG_NONE, 172c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber callback_t cbf = 0, 173c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber void* user = 0, 174c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber int notificationFrames = 0, 175ea7939a079b3600cab955760839b021326f8cfc3Glenn Kasten int sessionId = 0); 176c813985abd8ba61e999b3505f6a332574f87a1beAndreas Huber 17789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Creates an audio track and registers it with AudioFlinger. With this constructor, 178362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * the PCM data to be rendered by AudioTrack is passed in a shared memory buffer 17989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * identified by the argument sharedBuffer. This prototype is for static buffer playback. 180362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * PCM data must be present in memory before the AudioTrack is started. 181362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * The write() and flush() methods are not supported in this case. 182362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * It is recommended to pass a callback function to be notified of playback end by an 18389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * EVENT_UNDERRUN event. 18489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 18589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 186fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten AudioTrack( audio_stream_type_t streamType, 18789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate = 0, 188e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten audio_format_t format = AUDIO_FORMAT_DEFAULT, 18928b76b334f92a15a2be3cc9e2f7d229a3275d1acGlenn Kasten audio_channel_mask_t channelMask = 0, 19089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const sp<IMemory>& sharedBuffer = 0, 1910ca3cf94c0dfc173ad7886ae162c4b67067539f6Eric Laurent audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, 192a0d68338a88c2ddb4502f95017b546d603ef1ec7Glenn Kasten callback_t cbf = NULL, 193a0d68338a88c2ddb4502f95017b546d603ef1ec7Glenn Kasten void* user = NULL, 194be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int notificationFrames = 0, 1954a4a0959bca78e03e3c3f486ba17829c28314d8cGlenn Kasten int sessionId = 0); 19689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 19789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Terminates the AudioTrack and unregisters it from AudioFlinger. 198362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * Also destroys all resources associated with the AudioTrack. 19989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 20089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project ~AudioTrack(); 20189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 20289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 20389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Initialize an uninitialized AudioTrack. 20489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Returned status (from utils/Errors.h) can be: 205362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * - NO_ERROR: successful initialization 206362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * - INVALID_OPERATION: AudioTrack is already initialized 20728b76b334f92a15a2be3cc9e2f7d229a3275d1acGlenn Kasten * - BAD_VALUE: invalid parameter (channelMask, format, sampleRate...) 20889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - NO_INIT: audio server or audio hardware not initialized 20989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * */ 210fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten status_t set(audio_stream_type_t streamType = AUDIO_STREAM_DEFAULT, 21189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t sampleRate = 0, 212e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten audio_format_t format = AUDIO_FORMAT_DEFAULT, 21328b76b334f92a15a2be3cc9e2f7d229a3275d1acGlenn Kasten audio_channel_mask_t channelMask = 0, 21489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int frameCount = 0, 2150ca3cf94c0dfc173ad7886ae162c4b67067539f6Eric Laurent audio_output_flags_t flags = AUDIO_OUTPUT_FLAG_NONE, 216a0d68338a88c2ddb4502f95017b546d603ef1ec7Glenn Kasten callback_t cbf = NULL, 217a0d68338a88c2ddb4502f95017b546d603ef1ec7Glenn Kasten void* user = NULL, 21889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int notificationFrames = 0, 21989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project const sp<IMemory>& sharedBuffer = 0, 220be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent bool threadCanCallJava = false, 221ea7939a079b3600cab955760839b021326f8cfc3Glenn Kasten int sessionId = 0); 22289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 22389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 22489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Result of constructing the AudioTrack. This must be checked 225362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * before using any AudioTrack API (except for set()), because using 22689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * an uninitialized AudioTrack produces undefined results. 22789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * See set() method above for possible return codes. 22889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 22989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t initCheck() const; 23089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 231362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Returns this track's estimated latency in milliseconds. 23289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * This includes the latency due to AudioTrack buffer size, AudioMixer (if any) 23389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * and audio hardware driver. 23489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 23589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t latency() const; 23689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 23799e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten /* getters, see constructors and set() */ 23889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 239fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten audio_stream_type_t streamType() const; 240e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten audio_format_t format() const; 24189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int channelCount() const; 24289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t frameCount() const; 243b9980659501d0428d65d8292f3c32da69d37fbd2Glenn Kasten 244b9980659501d0428d65d8292f3c32da69d37fbd2Glenn Kasten /* Return channelCount * (bit depth per channel / 8). 245b9980659501d0428d65d8292f3c32da69d37fbd2Glenn Kasten * channelCount is determined from channelMask, and bit depth comes from format. 246b9980659501d0428d65d8292f3c32da69d37fbd2Glenn Kasten */ 247b9980659501d0428d65d8292f3c32da69d37fbd2Glenn Kasten size_t frameSize() const; 248b9980659501d0428d65d8292f3c32da69d37fbd2Glenn Kasten 24989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project sp<IMemory>& sharedBuffer(); 25089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 25189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 25289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* After it's created the track is not active. Call start() to 25389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * make it active. If set, the callback will start being called. 25489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 25589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void start(); 25689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 25789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Stop a track. If set, the callback will cease being called and 25889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * obtainBuffer returns STOPPED. Note that obtainBuffer() still works 25989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * and will fill up buffers until the pool is exhausted. 26089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 26189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void stop(); 26289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project bool stopped() const; 26389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 264362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Flush a stopped track. All pending buffers are discarded. 265362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * This function has no effect if the track is not stopped. 26689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 26789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void flush(); 26889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 26989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Pause a track. If set, the callback will cease being called and 27089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * obtainBuffer returns STOPPED. Note that obtainBuffer() still works 27189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * and will fill up buffers until the pool is exhausted. 27289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 27389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void pause(); 27489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 275362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Mute or unmute this track. 276362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * While muted, the callback, if set, is still called. 27789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 27889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void mute(bool); 27989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project bool muted() const; 28089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 281362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Set volume for this track, mostly used for games' sound effects 282362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * left and right volumes. Levels must be >= 0.0 and <= 1.0. 28389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 284be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent status_t setVolume(float left, float right); 285a5224f319e2ba4b51ddb4287705ccf8d4b8ecc51Glenn Kasten void getVolume(float* left, float* right) const; 28689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 287362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Set the send level for this track. An auxiliary effect should be attached 288362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * to the track with attachEffect(). Level must be >= 0.0 and <= 1.0. 289be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent */ 2902beeb50b1bba9e92f6cacfeca37fe9fa9d36ead1Eric Laurent status_t setAuxEffectSendLevel(float level); 291a5224f319e2ba4b51ddb4287705ccf8d4b8ecc51Glenn Kasten void getAuxEffectSendLevel(float* level) const; 292be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 293362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Set sample rate for this track, mostly used for games' sound effects 29489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 295573266210fb2b2e7d86fbd46d0dfe16763611d91Eric Laurent status_t setSampleRate(int sampleRate); 296a5224f319e2ba4b51ddb4287705ccf8d4b8ecc51Glenn Kasten uint32_t getSampleRate() const; 29789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 29889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Enables looping and sets the start and end points of looping. 29989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 30089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Parameters: 30189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 30289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * loopStart: loop start expressed as the number of PCM frames played since AudioTrack start. 30389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * loopEnd: loop end expressed as the number of PCM frames played since AudioTrack start. 304362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * loopCount: number of loops to execute. Calling setLoop() with loopCount == 0 cancels any 305362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * pending or active loop. loopCount = -1 means infinite looping. 30689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 30789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * For proper operation the following condition must be respected: 30889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * (loopEnd-loopStart) <= framecount() 30989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 31089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t setLoop(uint32_t loopStart, uint32_t loopEnd, int loopCount); 31189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 312362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Sets marker position. When playback reaches the number of frames specified, a callback with 313362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * event type EVENT_MARKER is called. Calling setMarkerPosition with marker == 0 cancels marker 314362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * notification callback. 31589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * If the AudioTrack has been opened with no callback function associated, the operation will fail. 31689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 31789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Parameters: 31889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 31989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * marker: marker position expressed in frames. 32089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 32189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Returned status (from utils/Errors.h) can be: 32289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - NO_ERROR: successful operation 32389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - INVALID_OPERATION: the AudioTrack has no callback installed. 32489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 32589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t setMarkerPosition(uint32_t marker); 326a5224f319e2ba4b51ddb4287705ccf8d4b8ecc51Glenn Kasten status_t getMarkerPosition(uint32_t *marker) const; 32789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 32889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 329362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Sets position update period. Every time the number of frames specified has been played, 330362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * a callback with event type EVENT_NEW_POS is called. 331362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * Calling setPositionUpdatePeriod with updatePeriod == 0 cancels new position notification 332362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * callback. 33389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * If the AudioTrack has been opened with no callback function associated, the operation will fail. 33489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 33589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Parameters: 33689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 33789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * updatePeriod: position update notification period expressed in frames. 33889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 33989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Returned status (from utils/Errors.h) can be: 34089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - NO_ERROR: successful operation 34189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - INVALID_OPERATION: the AudioTrack has no callback installed. 34289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 34389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t setPositionUpdatePeriod(uint32_t updatePeriod); 344a5224f319e2ba4b51ddb4287705ccf8d4b8ecc51Glenn Kasten status_t getPositionUpdatePeriod(uint32_t *updatePeriod) const; 34589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 34689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* Sets playback head position within AudioTrack buffer. The new position is specified 347362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * in number of frames. 34889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * This method must be called with the AudioTrack in paused or stopped state. 349362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * Note that the actual position set is <position> modulo the AudioTrack buffer size in frames. 350362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * Therefore using this method makes sense only when playing a "static" audio buffer 35189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * as opposed to streaming. 35289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * The getPosition() method on the other hand returns the total number of frames played since 35389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * playback start. 35489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 35589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Parameters: 35689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 35789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * position: New playback head position within AudioTrack buffer. 35889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 35989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Returned status (from utils/Errors.h) can be: 36089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - NO_ERROR: successful operation 36189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - INVALID_OPERATION: the AudioTrack is not stopped. 362362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * - BAD_VALUE: The specified position is beyond the number of frames present in AudioTrack buffer 36389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 36489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t setPosition(uint32_t position); 36589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t getPosition(uint32_t *position); 36689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 367362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Forces AudioTrack buffer full condition. When playing a static buffer, this method avoids 36889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * rewriting the buffer before restarting playback after a stop. 36989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * This method must be called with the AudioTrack in paused or stopped state. 37089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * 37189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Returned status (from utils/Errors.h) can be: 37289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - NO_ERROR: successful operation 37389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * - INVALID_OPERATION: the AudioTrack is not stopped. 37489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 37589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t reload(); 37689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 377362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Returns a handle on the audio output used by this AudioTrack. 378c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 379c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Parameters: 380c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * none. 381c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * 382c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * Returned value: 383c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent * handle on audio hardware output 384c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent */ 385c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent audio_io_handle_t getOutput(); 386c2f1f07084818942352c6bbfb36af9b6b330eb4eEric Laurent 387362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Returns the unique session ID associated with this track. 388be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * 389be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * Parameters: 390be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * none. 391be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * 392be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * Returned value: 393362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * AudioTrack session ID. 394be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent */ 395a5224f319e2ba4b51ddb4287705ccf8d4b8ecc51Glenn Kasten int getSessionId() const; 396be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 397362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Attach track auxiliary output to specified effect. Use effectId = 0 398be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * to detach track from effect. 399be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * 400be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * Parameters: 401be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * 402be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * effectId: effectId obtained from AudioEffect::id(). 403be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * 404be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * Returned status (from utils/Errors.h) can be: 405be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * - NO_ERROR: successful operation 406be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * - INVALID_OPERATION: the effect is not an auxiliary effect. 407be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent * - BAD_VALUE: The specified effect ID is invalid 408be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent */ 409be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent status_t attachAuxEffect(int effectId); 410be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent 411362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten /* Obtains a buffer of "frameCount" frames. The buffer must be 41299e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * filled entirely, and then released with releaseBuffer(). 41399e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * If the track is stopped, obtainBuffer() returns 414362c4e697d8e9c034e964ac7b40227e054491547Glenn Kasten * STOPPED instead of NO_ERROR as long as there are buffers available, 41589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * at which point NO_MORE_BUFFERS is returned. 41689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Buffers will be returned until the pool (buffercount()) 41789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * is exhausted, at which point obtainBuffer() will either block 41889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * or return WOULD_BLOCK depending on the value of the "blocking" 41989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * parameter. 42099e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * 42199e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * Interpretation of waitCount: 42299e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * +n limits wait time to n * WAIT_PERIOD_MS, 42399e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * -1 causes an (almost) infinite wait time, 42499e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * 0 non-blocking. 42589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 42689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 42789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project enum { 428335787fe43596f38ea2fa50b24c54d0823a3fb1dGlenn Kasten NO_MORE_BUFFERS = 0x80000001, // same name in AudioFlinger.h, ok to be different value 42989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project STOPPED = 1 43089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 43189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 43289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t obtainBuffer(Buffer* audioBuffer, int32_t waitCount); 43399e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten 43499e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten /* Release a filled buffer of "frameCount" frames for AudioFlinger to process. */ 43589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void releaseBuffer(Buffer* audioBuffer); 43689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 43789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* As a convenience we provide a write() interface to the audio buffer. 43899e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * This is implemented on top of obtainBuffer/releaseBuffer. For best 43999e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * performance use callbacks. Returns actual number of bytes written >= 0, 44099e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * or one of the following negative status codes: 44199e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * INVALID_OPERATION AudioTrack is configured for shared buffer mode 44299e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * BAD_VALUE size is invalid 44399e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * STOPPED AudioTrack was stopped during the write 44499e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * NO_MORE_BUFFERS when obtainBuffer() returns same 44599e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten * or any other error code returned by IAudioTrack::start() or restoreTrack_l(). 44689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 44789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project ssize_t write(const void* buffer, size_t size); 44889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 44989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* 45089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project * Dumps the state of an audio track. 45189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project */ 45289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t dump(int fd, const Vector<String16>& args) const; 45389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 4544ff14bae91075eb274eb1c2975982358946e7e63John Grossmanprotected: 45589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* copying audio tracks is not allowed */ 45689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AudioTrack(const AudioTrack& other); 45789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AudioTrack& operator = (const AudioTrack& other); 45889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 45989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project /* a small internal class to handle the callback */ 46089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project class AudioTrackThread : public Thread 46189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project { 46289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project public: 46389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AudioTrackThread(AudioTrack& receiver, bool bCanCallJava = false); 4643acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten 4653acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten // Do not call Thread::requestExitAndWait() without first calling requestExit(). 4663acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten // Thread::requestExitAndWait() is not virtual, and the implementation doesn't do enough. 4673acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten virtual void requestExit(); 4683acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten 4693acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten void pause(); // suspend thread from execution at next loop boundary 4703acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten void resume(); // allow thread to execute, if not requested to exit 4713acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten 47289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project private: 47389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project friend class AudioTrack; 47489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project virtual bool threadLoop(); 47589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project AudioTrack& mReceiver; 476a997e7a7c5aa2fc7e95316218316f8b7b98786baGlenn Kasten ~AudioTrackThread(); 4773acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten Mutex mMyLock; // Thread::mLock is private 4783acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten Condition mMyCond; // Thread::mThreadExitedCondition is private 4793acbd053c842e76e1a40fc8a0bf62de87eebf00fGlenn Kasten bool mPaused; // whether thread is currently paused 48089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project }; 48189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 48299e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten // body of AudioTrackThread::threadLoop() 48389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project bool processAudioBuffer(const sp<AudioTrackThread>& thread); 484ea7939a079b3600cab955760839b021326f8cfc3Glenn Kasten 485fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten status_t createTrack_l(audio_stream_type_t streamType, 48634f1d8ecd23169a5f299937e3aaf1bd7937578a0Eric Laurent uint32_t sampleRate, 487e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten audio_format_t format, 48828b76b334f92a15a2be3cc9e2f7d229a3275d1acGlenn Kasten audio_channel_mask_t channelMask, 48934f1d8ecd23169a5f299937e3aaf1bd7937578a0Eric Laurent int frameCount, 4900ca3cf94c0dfc173ad7886ae162c4b67067539f6Eric Laurent audio_output_flags_t flags, 49134f1d8ecd23169a5f299937e3aaf1bd7937578a0Eric Laurent const sp<IMemory>& sharedBuffer, 492291f4d505aff81969e6666049d3cc3446f836af2Glenn Kasten audio_io_handle_t output); 4931703cdfee717b1b312bf8979816a9e2f16a82e5dEric Laurent void flush_l(); 4941703cdfee717b1b312bf8979816a9e2f16a82e5dEric Laurent status_t setLoop_l(uint32_t loopStart, uint32_t loopEnd, int loopCount); 4951703cdfee717b1b312bf8979816a9e2f16a82e5dEric Laurent audio_io_handle_t getOutput_l(); 4961703cdfee717b1b312bf8979816a9e2f16a82e5dEric Laurent status_t restoreTrack_l(audio_track_cblk_t*& cblk, bool fromStart); 4979a2aaf927e56a4b4acab23ef16b3f133a9f48a63Glenn Kasten bool stopped_l() const { return !mActive; } 49889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 49989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project sp<IAudioTrack> mAudioTrack; 50089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project sp<IMemory> mCblkMemory; 50189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project sp<AudioTrackThread> mAudioTrackThread; 50289fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 50389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project float mVolume[2]; 504be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent float mSendLevel; 50589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t mFrameCount; 50689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 50789fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project audio_track_cblk_t* mCblk; 508e1c3962e268ffc12bfd1bd9ea84da1f135f36960Glenn Kasten audio_format_t mFormat; 509fff6d715a8db0daf08a50634f242c40268de3d49Glenn Kasten audio_stream_type_t mStreamType; 51089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint8_t mChannelCount; 51189fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint8_t mMuted; 5120d255b2d9061ba31f13ada3fc0f7e51916407176Jean-Michel Trivi uint8_t mReserved; 51328b76b334f92a15a2be3cc9e2f7d229a3275d1acGlenn Kasten audio_channel_mask_t mChannelMask; 51489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project status_t mStatus; 51589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t mLatency; 51689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 5179a2aaf927e56a4b4acab23ef16b3f133a9f48a63Glenn Kasten bool mActive; // protected by mLock 51889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 51999e53b86eebb605b70dd7591b89bf61a9414ed0eGlenn Kasten callback_t mCbf; // callback handler for events, or NULL 52089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project void* mUserData; 521d1b449aad6c087a69f5ec66b7facb2845b73f1cbEric Laurent uint32_t mNotificationFramesReq; // requested number of frames between each notification callback 522d1b449aad6c087a69f5ec66b7facb2845b73f1cbEric Laurent uint32_t mNotificationFramesAct; // actual number of frames between each notification callback 52389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project sp<IMemory> mSharedBuffer; 52489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project int mLoopCount; 52589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t mRemainingFrames; 52689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t mMarkerPosition; 5272c22aeb65e801f663a754d043062f85e49f77739Jean-Michel Trivi bool mMarkerReached; 52889fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t mNewPosition; 52989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project uint32_t mUpdatePeriod; 530cd07594333cbe8b2c86c6609cce01a74d6cc33f8Jean-Michel Trivi bool mFlushed; // FIXME will be made obsolete by making flush() synchronous 5310ca3cf94c0dfc173ad7886ae162c4b67067539f6Eric Laurent audio_output_flags_t mFlags; 532be916aa1267e2e6b1c148f51d11bcbbc79cb864cEric Laurent int mSessionId; 5332beeb50b1bba9e92f6cacfeca37fe9fa9d36ead1Eric Laurent int mAuxEffectId; 5349a2aaf927e56a4b4acab23ef16b3f133a9f48a63Glenn Kasten mutable Mutex mLock; 535cfe2ba6b01a258e39f9c215ffc7b750e0b68f708Eric Laurent status_t mRestoreStatus; 5364ff14bae91075eb274eb1c2975982358946e7e63John Grossman bool mIsTimed; 537879135196fd1c97deefc538c888037c56c2879a7Glenn Kasten int mPreviousPriority; // before start() 538a636433cbd09c0708b85f337ef45c0cdef3bcb4dGlenn Kasten SchedPolicy mPreviousSchedulingGroup; 53989fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; 54089fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 5414ff14bae91075eb274eb1c2975982358946e7e63John Grossmanclass TimedAudioTrack : public AudioTrack 5424ff14bae91075eb274eb1c2975982358946e7e63John Grossman{ 5434ff14bae91075eb274eb1c2975982358946e7e63John Grossmanpublic: 5444ff14bae91075eb274eb1c2975982358946e7e63John Grossman TimedAudioTrack(); 5454ff14bae91075eb274eb1c2975982358946e7e63John Grossman 5464ff14bae91075eb274eb1c2975982358946e7e63John Grossman /* allocate a shared memory buffer that can be passed to queueTimedBuffer */ 5474ff14bae91075eb274eb1c2975982358946e7e63John Grossman status_t allocateTimedBuffer(size_t size, sp<IMemory>* buffer); 5484ff14bae91075eb274eb1c2975982358946e7e63John Grossman 5494ff14bae91075eb274eb1c2975982358946e7e63John Grossman /* queue a buffer obtained via allocateTimedBuffer for playback at the 550c3ae93f21280859086ae371428ffd32f39e76d50Glenn Kasten given timestamp. PTS units are microseconds on the media time timeline. 5514ff14bae91075eb274eb1c2975982358946e7e63John Grossman The media time transform (set with setMediaTimeTransform) set by the 5524ff14bae91075eb274eb1c2975982358946e7e63John Grossman audio producer will handle converting from media time to local time 5534ff14bae91075eb274eb1c2975982358946e7e63John Grossman (perhaps going through the common time timeline in the case of 5544ff14bae91075eb274eb1c2975982358946e7e63John Grossman synchronized multiroom audio case) */ 5554ff14bae91075eb274eb1c2975982358946e7e63John Grossman status_t queueTimedBuffer(const sp<IMemory>& buffer, int64_t pts); 5564ff14bae91075eb274eb1c2975982358946e7e63John Grossman 5574ff14bae91075eb274eb1c2975982358946e7e63John Grossman /* define a transform between media time and either common time or 5584ff14bae91075eb274eb1c2975982358946e7e63John Grossman local time */ 5594ff14bae91075eb274eb1c2975982358946e7e63John Grossman enum TargetTimeline {LOCAL_TIME, COMMON_TIME}; 5604ff14bae91075eb274eb1c2975982358946e7e63John Grossman status_t setMediaTimeTransform(const LinearTransform& xform, 5614ff14bae91075eb274eb1c2975982358946e7e63John Grossman TargetTimeline target); 5624ff14bae91075eb274eb1c2975982358946e7e63John Grossman}; 56389fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 56489fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project}; // namespace android 56589fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project 56689fa4ad53f2f4d57adbc97ae1149fc00c9b6f3c5The Android Open Source Project#endif // ANDROID_AUDIOTRACK_H 567