blob: a4cc3d7a927f8b42a32cedaf2d46dc3c2b5fbc8e [file] [log] [blame]
Glenn Kasten99e53b82012-01-19 08:59:58 -08001/*
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002**
3** Copyright 2007, The Android Open Source Project
4**
5** Licensed under the Apache License, Version 2.0 (the "License");
6** you may not use this file except in compliance with the License.
7** You may obtain a copy of the License at
8**
9** http://www.apache.org/licenses/LICENSE-2.0
10**
11** Unless required by applicable law or agreed to in writing, software
12** distributed under the License is distributed on an "AS IS" BASIS,
13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14** See the License for the specific language governing permissions and
15** limitations under the License.
16*/
17
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -080018//#define LOG_NDEBUG 0
19#define LOG_TAG "AudioTrack"
20
Mark Salyzyn34fb2962014-06-18 16:30:56 -070021#include <inttypes.h>
Glenn Kastenc56f3422014-03-21 17:53:17 -070022#include <math.h>
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -080023#include <sys/resource.h>
Mark Salyzyn34fb2962014-06-18 16:30:56 -070024
Glenn Kasten9f80dd22012-12-18 15:57:32 -080025#include <audio_utils/primitives.h>
26#include <binder/IPCThreadState.h>
27#include <media/AudioTrack.h>
28#include <utils/Log.h>
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -080029#include <private/media/AudioTrackShared.h>
Glenn Kasten1ab85ec2013-05-31 09:18:43 -070030#include <media/IAudioFlinger.h>
Eric Laurente83b55d2014-11-14 10:06:21 -080031#include <media/AudioPolicyHelper.h>
Andy Hungcd044842014-08-07 11:04:34 -070032#include <media/AudioResamplerPublic.h>
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -080033
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +010034#define WAIT_PERIOD_MS 10
35#define WAIT_STREAM_END_TIMEOUT_SEC 120
Andy Hung53c3b5f2014-12-15 16:42:05 -080036static const int kMaxLoopCountNotifications = 32;
Glenn Kasten511754b2012-01-11 09:52:19 -080037
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -080038namespace android {
Chia-chi Yeh33005a92010-06-16 06:33:13 +080039// ---------------------------------------------------------------------------
40
Andy Hunga7f03352015-05-31 21:54:49 -070041// TODO: Move to a separate .h
42
Andy Hung4ede21d2014-12-12 15:37:34 -080043template <typename T>
Andy Hunga7f03352015-05-31 21:54:49 -070044static inline const T &min(const T &x, const T &y) {
Andy Hung4ede21d2014-12-12 15:37:34 -080045 return x < y ? x : y;
46}
47
Andy Hunga7f03352015-05-31 21:54:49 -070048template <typename T>
49static inline const T &max(const T &x, const T &y) {
50 return x > y ? x : y;
51}
52
53static inline nsecs_t framesToNanoseconds(ssize_t frames, uint32_t sampleRate, float speed)
54{
55 return ((double)frames * 1000000000) / ((double)sampleRate * speed);
56}
57
Andy Hung7f1bc8a2014-09-12 14:43:11 -070058static int64_t convertTimespecToUs(const struct timespec &tv)
59{
60 return tv.tv_sec * 1000000ll + tv.tv_nsec / 1000;
61}
62
63// current monotonic time in microseconds.
64static int64_t getNowUs()
65{
66 struct timespec tv;
67 (void) clock_gettime(CLOCK_MONOTONIC, &tv);
68 return convertTimespecToUs(tv);
69}
70
Andy Hung26145642015-04-15 21:56:53 -070071// FIXME: we don't use the pitch setting in the time stretcher (not working);
72// instead we emulate it using our sample rate converter.
73static const bool kFixPitch = true; // enable pitch fix
74static inline uint32_t adjustSampleRate(uint32_t sampleRate, float pitch)
75{
76 return kFixPitch ? (sampleRate * pitch + 0.5) : sampleRate;
77}
78
79static inline float adjustSpeed(float speed, float pitch)
80{
Ricardo Garcia6c7f0622015-04-30 18:39:16 -070081 return kFixPitch ? speed / max(pitch, AUDIO_TIMESTRETCH_PITCH_MIN_DELTA) : speed;
Andy Hung26145642015-04-15 21:56:53 -070082}
83
84static inline float adjustPitch(float pitch)
85{
86 return kFixPitch ? AUDIO_TIMESTRETCH_PITCH_NORMAL : pitch;
87}
88
Andy Hung8edb8dc2015-03-26 19:13:55 -070089// Must match similar computation in createTrack_l in Threads.cpp.
90// TODO: Move to a common library
91static size_t calculateMinFrameCount(
92 uint32_t afLatencyMs, uint32_t afFrameCount, uint32_t afSampleRate,
93 uint32_t sampleRate, float speed)
94{
95 // Ensure that buffer depth covers at least audio hardware latency
96 uint32_t minBufCount = afLatencyMs / ((1000 * afFrameCount) / afSampleRate);
97 if (minBufCount < 2) {
98 minBufCount = 2;
99 }
100 ALOGV("calculateMinFrameCount afLatency %u afFrameCount %u afSampleRate %u "
101 "sampleRate %u speed %f minBufCount: %u",
102 afLatencyMs, afFrameCount, afSampleRate, sampleRate, speed, minBufCount);
103 return minBufCount * sourceFramesNeededWithTimestretch(
104 sampleRate, afFrameCount, afSampleRate, speed);
105}
106
Chia-chi Yeh33005a92010-06-16 06:33:13 +0800107// static
108status_t AudioTrack::getMinFrameCount(
Glenn Kastene33054e2012-11-14 12:54:39 -0800109 size_t* frameCount,
Glenn Kastenfff6d712012-01-12 16:38:12 -0800110 audio_stream_type_t streamType,
Chia-chi Yeh33005a92010-06-16 06:33:13 +0800111 uint32_t sampleRate)
112{
Glenn Kastend65d73c2012-06-22 17:21:07 -0700113 if (frameCount == NULL) {
114 return BAD_VALUE;
115 }
Glenn Kasten04cd0182012-06-25 11:49:27 -0700116
Andy Hung0e48d252015-01-26 11:43:15 -0800117 // FIXME handle in server, like createTrack_l(), possible missing info:
Glenn Kastene0fa4672012-04-24 14:35:14 -0700118 // audio_io_handle_t output
119 // audio_format_t format
120 // audio_channel_mask_t channelMask
Andy Hung0e48d252015-01-26 11:43:15 -0800121 // audio_output_flags_t flags (FAST)
Glenn Kasten3b16c762012-11-14 08:44:39 -0800122 uint32_t afSampleRate;
Glenn Kasten66a04672014-01-08 08:53:44 -0800123 status_t status;
124 status = AudioSystem::getOutputSamplingRate(&afSampleRate, streamType);
125 if (status != NO_ERROR) {
Glenn Kasten70c0bfb2014-01-14 15:47:01 -0800126 ALOGE("Unable to query output sample rate for stream type %d; status %d",
127 streamType, status);
Glenn Kasten66a04672014-01-08 08:53:44 -0800128 return status;
Chia-chi Yeh33005a92010-06-16 06:33:13 +0800129 }
Glenn Kastene33054e2012-11-14 12:54:39 -0800130 size_t afFrameCount;
Glenn Kasten66a04672014-01-08 08:53:44 -0800131 status = AudioSystem::getOutputFrameCount(&afFrameCount, streamType);
132 if (status != NO_ERROR) {
Glenn Kasten70c0bfb2014-01-14 15:47:01 -0800133 ALOGE("Unable to query output frame count for stream type %d; status %d",
134 streamType, status);
Glenn Kasten66a04672014-01-08 08:53:44 -0800135 return status;
Chia-chi Yeh33005a92010-06-16 06:33:13 +0800136 }
137 uint32_t afLatency;
Glenn Kasten66a04672014-01-08 08:53:44 -0800138 status = AudioSystem::getOutputLatency(&afLatency, streamType);
139 if (status != NO_ERROR) {
Glenn Kasten70c0bfb2014-01-14 15:47:01 -0800140 ALOGE("Unable to query output latency for stream type %d; status %d",
141 streamType, status);
Glenn Kasten66a04672014-01-08 08:53:44 -0800142 return status;
Chia-chi Yeh33005a92010-06-16 06:33:13 +0800143 }
144
Andy Hung8edb8dc2015-03-26 19:13:55 -0700145 // When called from createTrack, speed is 1.0f (normal speed).
146 // This is rechecked again on setting playback rate (TODO: on setting sample rate, too).
147 *frameCount = calculateMinFrameCount(afLatency, afFrameCount, afSampleRate, sampleRate, 1.0f);
Chia-chi Yeh33005a92010-06-16 06:33:13 +0800148
Andy Hung0e48d252015-01-26 11:43:15 -0800149 // The formula above should always produce a non-zero value under normal circumstances:
150 // AudioTrack.SAMPLE_RATE_HZ_MIN <= sampleRate <= AudioTrack.SAMPLE_RATE_HZ_MAX.
151 // Return error in the unlikely event that it does not, as that's part of the API contract.
Glenn Kasten66a04672014-01-08 08:53:44 -0800152 if (*frameCount == 0) {
Andy Hung0e48d252015-01-26 11:43:15 -0800153 ALOGE("AudioTrack::getMinFrameCount failed for streamType %d, sampleRate %u",
Glenn Kasten66a04672014-01-08 08:53:44 -0800154 streamType, sampleRate);
155 return BAD_VALUE;
156 }
Andy Hung8edb8dc2015-03-26 19:13:55 -0700157 ALOGV("getMinFrameCount=%zu: afFrameCount=%zu, afSampleRate=%u, afLatency=%u",
158 *frameCount, afFrameCount, afSampleRate, afLatency);
Chia-chi Yeh33005a92010-06-16 06:33:13 +0800159 return NO_ERROR;
160}
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800161
162// ---------------------------------------------------------------------------
163
164AudioTrack::AudioTrack()
Glenn Kasten87913512011-06-22 16:15:25 -0700165 : mStatus(NO_INIT),
Haynes Mathew George9b3359f2016-03-23 19:09:10 -0700166 mState(STATE_STOPPED),
John Grossman4ff14ba2012-02-08 16:37:41 -0800167 mPreviousPriority(ANDROID_PRIORITY_NORMAL),
Haynes Mathew George7064fd22014-01-08 13:59:53 -0800168 mPreviousSchedulingGroup(SP_DEFAULT),
Paul McLeanaa981192015-03-21 09:55:15 -0700169 mPausedPosition(0),
170 mSelectedDeviceId(AUDIO_PORT_HANDLE_NONE)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800171{
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700172 mAttributes.content_type = AUDIO_CONTENT_TYPE_UNKNOWN;
173 mAttributes.usage = AUDIO_USAGE_UNKNOWN;
174 mAttributes.flags = 0x0;
175 strcpy(mAttributes.tags, "");
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800176}
177
178AudioTrack::AudioTrack(
Glenn Kastenfff6d712012-01-12 16:38:12 -0800179 audio_stream_type_t streamType,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800180 uint32_t sampleRate,
Glenn Kastene1c39622012-01-04 09:36:37 -0800181 audio_format_t format,
Glenn Kasten28b76b32012-07-03 17:24:41 -0700182 audio_channel_mask_t channelMask,
Glenn Kastenbce50bf2014-02-27 15:29:51 -0800183 size_t frameCount,
Eric Laurent0ca3cf92012-04-18 09:24:29 -0700184 audio_output_flags_t flags,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800185 callback_t cbf,
186 void* user,
Glenn Kasten838b3d82014-02-27 15:30:41 -0800187 uint32_t notificationFrames,
Glenn Kastend848eb42016-03-08 13:42:11 -0800188 audio_session_t sessionId,
Richard Fitzgeraldad3af332013-03-25 16:54:37 +0000189 transfer_type transferType,
Marco Nelissen462fd2f2013-01-14 14:12:05 -0800190 const audio_offload_info_t *offloadInfo,
Marco Nelissend457c972014-02-11 08:47:07 -0800191 int uid,
Jean-Michel Trivid9d7fa02014-06-24 08:01:46 -0700192 pid_t pid,
Ronghua Wufaeb0f22015-05-21 12:20:21 -0700193 const audio_attributes_t* pAttributes,
194 bool doNotReconnect)
Glenn Kasten87913512011-06-22 16:15:25 -0700195 : mStatus(NO_INIT),
Haynes Mathew George9b3359f2016-03-23 19:09:10 -0700196 mState(STATE_STOPPED),
John Grossman4ff14ba2012-02-08 16:37:41 -0800197 mPreviousPriority(ANDROID_PRIORITY_NORMAL),
Haynes Mathew George7064fd22014-01-08 13:59:53 -0800198 mPreviousSchedulingGroup(SP_DEFAULT),
Paul McLeanaa981192015-03-21 09:55:15 -0700199 mPausedPosition(0),
200 mSelectedDeviceId(AUDIO_PORT_HANDLE_NONE)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800201{
Jean-Michel Trivi0d255b22011-05-24 15:53:33 -0700202 mStatus = set(streamType, sampleRate, format, channelMask,
Eric Laurenta514bdb2010-06-21 09:27:30 -0700203 frameCount, flags, cbf, user, notificationFrames,
Marco Nelissen462fd2f2013-01-14 14:12:05 -0800204 0 /*sharedBuffer*/, false /*threadCanCallJava*/, sessionId, transferType,
Ronghua Wufaeb0f22015-05-21 12:20:21 -0700205 offloadInfo, uid, pid, pAttributes, doNotReconnect);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800206}
207
Andreas Huberc8139852012-01-18 10:51:55 -0800208AudioTrack::AudioTrack(
Glenn Kastenfff6d712012-01-12 16:38:12 -0800209 audio_stream_type_t streamType,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800210 uint32_t sampleRate,
Glenn Kastene1c39622012-01-04 09:36:37 -0800211 audio_format_t format,
Glenn Kasten28b76b32012-07-03 17:24:41 -0700212 audio_channel_mask_t channelMask,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800213 const sp<IMemory>& sharedBuffer,
Eric Laurent0ca3cf92012-04-18 09:24:29 -0700214 audio_output_flags_t flags,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800215 callback_t cbf,
216 void* user,
Glenn Kasten838b3d82014-02-27 15:30:41 -0800217 uint32_t notificationFrames,
Glenn Kastend848eb42016-03-08 13:42:11 -0800218 audio_session_t sessionId,
Richard Fitzgeraldad3af332013-03-25 16:54:37 +0000219 transfer_type transferType,
Marco Nelissen462fd2f2013-01-14 14:12:05 -0800220 const audio_offload_info_t *offloadInfo,
Marco Nelissend457c972014-02-11 08:47:07 -0800221 int uid,
Jean-Michel Trivid9d7fa02014-06-24 08:01:46 -0700222 pid_t pid,
Ronghua Wufaeb0f22015-05-21 12:20:21 -0700223 const audio_attributes_t* pAttributes,
224 bool doNotReconnect)
Glenn Kasten87913512011-06-22 16:15:25 -0700225 : mStatus(NO_INIT),
Haynes Mathew George9b3359f2016-03-23 19:09:10 -0700226 mState(STATE_STOPPED),
John Grossman4ff14ba2012-02-08 16:37:41 -0800227 mPreviousPriority(ANDROID_PRIORITY_NORMAL),
Haynes Mathew George7064fd22014-01-08 13:59:53 -0800228 mPreviousSchedulingGroup(SP_DEFAULT),
Paul McLeanaa981192015-03-21 09:55:15 -0700229 mPausedPosition(0),
230 mSelectedDeviceId(AUDIO_PORT_HANDLE_NONE)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800231{
Jean-Michel Trivi0d255b22011-05-24 15:53:33 -0700232 mStatus = set(streamType, sampleRate, format, channelMask,
Glenn Kasten17a736c2012-02-14 08:52:15 -0800233 0 /*frameCount*/, flags, cbf, user, notificationFrames,
Marco Nelissend457c972014-02-11 08:47:07 -0800234 sharedBuffer, false /*threadCanCallJava*/, sessionId, transferType, offloadInfo,
Ronghua Wufaeb0f22015-05-21 12:20:21 -0700235 uid, pid, pAttributes, doNotReconnect);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800236}
237
238AudioTrack::~AudioTrack()
239{
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800240 if (mStatus == NO_ERROR) {
241 // Make sure that callback function exits in the case where
242 // it is looping on buffer full condition in obtainBuffer().
243 // Otherwise the callback thread will never exit.
244 stop();
245 if (mAudioTrackThread != 0) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100246 mProxy->interrupt();
Glenn Kasten3acbd052012-02-28 10:39:56 -0800247 mAudioTrackThread->requestExit(); // see comment in AudioTrack.h
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800248 mAudioTrackThread->requestExitAndWait();
249 mAudioTrackThread.clear();
250 }
Eric Laurent296fb132015-05-01 11:38:42 -0700251 // No lock here: worst case we remove a NULL callback which will be a nop
252 if (mDeviceCallback != 0 && mOutput != AUDIO_IO_HANDLE_NONE) {
253 AudioSystem::removeAudioDeviceCallback(mDeviceCallback, mOutput);
254 }
Marco Nelissenf8880202014-11-14 07:58:25 -0800255 IInterface::asBinder(mAudioTrack)->unlinkToDeath(mDeathNotifier, this);
Glenn Kasten53cec222013-08-29 09:01:02 -0700256 mAudioTrack.clear();
Eric Laurent3bcffa12014-06-12 18:38:45 -0700257 mCblkMemory.clear();
258 mSharedBuffer.clear();
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800259 IPCThreadState::self()->flushCommands();
Glenn Kasten4c36d6f2015-03-20 09:05:01 -0700260 ALOGV("~AudioTrack, releasing session id %d from %d on behalf of %d",
261 mSessionId, IPCThreadState::self()->getCallingPid(), mClientPid);
Marco Nelissend457c972014-02-11 08:47:07 -0800262 AudioSystem::releaseAudioSessionId(mSessionId, mClientPid);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800263 }
264}
265
266status_t AudioTrack::set(
Glenn Kastenfff6d712012-01-12 16:38:12 -0800267 audio_stream_type_t streamType,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800268 uint32_t sampleRate,
Glenn Kastene1c39622012-01-04 09:36:37 -0800269 audio_format_t format,
Glenn Kasten28b76b32012-07-03 17:24:41 -0700270 audio_channel_mask_t channelMask,
Glenn Kastenbce50bf2014-02-27 15:29:51 -0800271 size_t frameCount,
Eric Laurent0ca3cf92012-04-18 09:24:29 -0700272 audio_output_flags_t flags,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800273 callback_t cbf,
274 void* user,
Glenn Kasten838b3d82014-02-27 15:30:41 -0800275 uint32_t notificationFrames,
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800276 const sp<IMemory>& sharedBuffer,
Eric Laurentbe916aa2010-06-01 23:49:17 -0700277 bool threadCanCallJava,
Glenn Kastend848eb42016-03-08 13:42:11 -0800278 audio_session_t sessionId,
Richard Fitzgeraldad3af332013-03-25 16:54:37 +0000279 transfer_type transferType,
Marco Nelissen462fd2f2013-01-14 14:12:05 -0800280 const audio_offload_info_t *offloadInfo,
Marco Nelissend457c972014-02-11 08:47:07 -0800281 int uid,
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700282 pid_t pid,
Ronghua Wufaeb0f22015-05-21 12:20:21 -0700283 const audio_attributes_t* pAttributes,
284 bool doNotReconnect)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800285{
Glenn Kastenbce50bf2014-02-27 15:29:51 -0800286 ALOGV("set(): streamType %d, sampleRate %u, format %#x, channelMask %#x, frameCount %zu, "
Glenn Kasten4c36d6f2015-03-20 09:05:01 -0700287 "flags #%x, notificationFrames %u, sessionId %d, transferType %d, uid %d, pid %d",
Glenn Kastenbce50bf2014-02-27 15:29:51 -0800288 streamType, sampleRate, format, channelMask, frameCount, flags, notificationFrames,
Glenn Kasten4c36d6f2015-03-20 09:05:01 -0700289 sessionId, transferType, uid, pid);
Glenn Kasten86f04662014-02-24 15:13:05 -0800290
Phil Burk33ff89b2015-11-30 11:16:01 -0800291 mThreadCanCallJava = threadCanCallJava;
292
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800293 switch (transferType) {
294 case TRANSFER_DEFAULT:
295 if (sharedBuffer != 0) {
296 transferType = TRANSFER_SHARED;
297 } else if (cbf == NULL || threadCanCallJava) {
298 transferType = TRANSFER_SYNC;
299 } else {
300 transferType = TRANSFER_CALLBACK;
301 }
302 break;
303 case TRANSFER_CALLBACK:
304 if (cbf == NULL || sharedBuffer != 0) {
305 ALOGE("Transfer type TRANSFER_CALLBACK but cbf == NULL || sharedBuffer != 0");
306 return BAD_VALUE;
307 }
308 break;
309 case TRANSFER_OBTAIN:
310 case TRANSFER_SYNC:
311 if (sharedBuffer != 0) {
312 ALOGE("Transfer type TRANSFER_OBTAIN but sharedBuffer != 0");
313 return BAD_VALUE;
314 }
315 break;
316 case TRANSFER_SHARED:
317 if (sharedBuffer == 0) {
318 ALOGE("Transfer type TRANSFER_SHARED but sharedBuffer == 0");
319 return BAD_VALUE;
320 }
321 break;
322 default:
323 ALOGE("Invalid transfer type %d", transferType);
324 return BAD_VALUE;
325 }
Glenn Kastendd5f4c82014-01-13 10:26:32 -0800326 mSharedBuffer = sharedBuffer;
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800327 mTransfer = transferType;
Ronghua Wufaeb0f22015-05-21 12:20:21 -0700328 mDoNotReconnect = doNotReconnect;
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800329
Eric Laurent97c9f4f2015-08-11 18:04:14 -0700330 ALOGV_IF(sharedBuffer != 0, "sharedBuffer: %p, size: %zu", sharedBuffer->pointer(),
Glenn Kasten85ab62c2012-11-01 11:11:38 -0700331 sharedBuffer->size());
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800332
Mark Salyzyn34fb2962014-06-18 16:30:56 -0700333 ALOGV("set() streamType %d frameCount %zu flags %04x", streamType, frameCount, flags);
Eric Laurent1a9ed112012-03-20 18:36:01 -0700334
Glenn Kasten53cec222013-08-29 09:01:02 -0700335 // invariant that mAudioTrack != 0 is true only after set() returns successfully
Eric Laurent1dd70b92009-04-21 07:56:33 -0700336 if (mAudioTrack != 0) {
Steve Block29357bc2012-01-06 19:20:56 +0000337 ALOGE("Track already in use");
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800338 return INVALID_OPERATION;
339 }
340
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800341 // handle default values first.
Eric Laurente83b55d2014-11-14 10:06:21 -0800342 if (streamType == AUDIO_STREAM_DEFAULT) {
Dima Zavinfce7a472011-04-19 22:30:36 -0700343 streamType = AUDIO_STREAM_MUSIC;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800344 }
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700345 if (pAttributes == NULL) {
Eric Laurent223fd5c2014-11-11 13:43:36 -0800346 if (uint32_t(streamType) >= AUDIO_STREAM_PUBLIC_CNT) {
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700347 ALOGE("Invalid stream type %d", streamType);
348 return BAD_VALUE;
349 }
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700350 mStreamType = streamType;
Eric Laurente83b55d2014-11-14 10:06:21 -0800351
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700352 } else {
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700353 // stream type shouldn't be looked at, this track has audio attributes
354 memcpy(&mAttributes, pAttributes, sizeof(audio_attributes_t));
Jean-Michel Trivifaabb512014-06-11 16:55:06 -0700355 ALOGV("Building AudioTrack with attributes: usage=%d content=%d flags=0x%x tags=[%s]",
356 mAttributes.usage, mAttributes.content_type, mAttributes.flags, mAttributes.tags);
Eric Laurente83b55d2014-11-14 10:06:21 -0800357 mStreamType = AUDIO_STREAM_DEFAULT;
Eric Laurentc6bd5db2015-03-09 16:29:33 -0700358 if ((mAttributes.flags & AUDIO_FLAG_HW_AV_SYNC) != 0) {
359 flags = (audio_output_flags_t)(flags | AUDIO_OUTPUT_FLAG_HW_AV_SYNC);
360 }
Phil Burk33ff89b2015-11-30 11:16:01 -0800361 if ((mAttributes.flags & AUDIO_FLAG_LOW_LATENCY) != 0) {
362 flags = (audio_output_flags_t) (flags | AUDIO_OUTPUT_FLAG_FAST);
363 }
Glenn Kastendd5f4c82014-01-13 10:26:32 -0800364 }
Glenn Kastenea7939a2012-03-14 12:56:26 -0700365
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800366 // these below should probably come from the audioFlinger too...
Glenn Kastene1c39622012-01-04 09:36:37 -0800367 if (format == AUDIO_FORMAT_DEFAULT) {
Dima Zavinfce7a472011-04-19 22:30:36 -0700368 format = AUDIO_FORMAT_PCM_16_BIT;
Phil Burkfdb3c072016-02-09 10:47:02 -0800369 } else if (format == AUDIO_FORMAT_IEC61937) { // HDMI pass-through?
370 mAttributes.flags |= AUDIO_OUTPUT_FLAG_IEC958_NONAUDIO;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800371 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800372
373 // validate parameters
Dima Zavinfce7a472011-04-19 22:30:36 -0700374 if (!audio_is_valid_format(format)) {
Glenn Kastencac3daa2014-02-07 09:47:14 -0800375 ALOGE("Invalid format %#x", format);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800376 return BAD_VALUE;
377 }
Glenn Kastendd5f4c82014-01-13 10:26:32 -0800378 mFormat = format;
Eric Laurentc2f1f072009-07-17 12:17:14 -0700379
Glenn Kasten8ba90322013-10-30 11:29:27 -0700380 if (!audio_is_output_channel(channelMask)) {
381 ALOGE("Invalid channel mask %#x", channelMask);
382 return BAD_VALUE;
383 }
Glenn Kastene3247bf2014-02-24 15:19:07 -0800384 mChannelMask = channelMask;
Andy Hunge5412692014-05-16 11:25:07 -0700385 uint32_t channelCount = audio_channel_count_from_out_mask(channelMask);
Glenn Kastene3247bf2014-02-24 15:19:07 -0800386 mChannelCount = channelCount;
Glenn Kasten8ba90322013-10-30 11:29:27 -0700387
Eric Laurentc2f1f072009-07-17 12:17:14 -0700388 // force direct flag if format is not linear PCM
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100389 // or offload was requested
390 if ((flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD)
391 || !audio_is_linear_pcm(format)) {
392 ALOGV( (flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD)
393 ? "Offload request, forcing to Direct Output"
394 : "Not linear PCM, forcing to Direct Output");
Eric Laurent0ca3cf92012-04-18 09:24:29 -0700395 flags = (audio_output_flags_t)
Glenn Kasten3acbd052012-02-28 10:39:56 -0800396 // FIXME why can't we allow direct AND fast?
Eric Laurent0ca3cf92012-04-18 09:24:29 -0700397 ((flags | AUDIO_OUTPUT_FLAG_DIRECT) & ~AUDIO_OUTPUT_FLAG_FAST);
Eric Laurentc2f1f072009-07-17 12:17:14 -0700398 }
399
Eric Laurentd1f69b02014-12-15 14:33:13 -0800400 // force direct flag if HW A/V sync requested
401 if ((flags & AUDIO_OUTPUT_FLAG_HW_AV_SYNC) != 0) {
402 flags = (audio_output_flags_t)(flags | AUDIO_OUTPUT_FLAG_DIRECT);
403 }
404
Glenn Kastenb7730382014-04-30 15:50:31 -0700405 if (flags & AUDIO_OUTPUT_FLAG_DIRECT) {
Phil Burkfdb3c072016-02-09 10:47:02 -0800406 if (audio_has_proportional_frames(format)) {
Glenn Kastenb7730382014-04-30 15:50:31 -0700407 mFrameSize = channelCount * audio_bytes_per_sample(format);
408 } else {
409 mFrameSize = sizeof(uint8_t);
410 }
Glenn Kastene3aa6592012-12-04 12:22:46 -0800411 } else {
Phil Burkfdb3c072016-02-09 10:47:02 -0800412 ALOG_ASSERT(audio_has_proportional_frames(format));
Glenn Kastenb7730382014-04-30 15:50:31 -0700413 mFrameSize = channelCount * audio_bytes_per_sample(format);
Glenn Kastenb7730382014-04-30 15:50:31 -0700414 // createTrack will return an error if PCM format is not supported by server,
415 // so no need to check for specific PCM formats here
Glenn Kastene3aa6592012-12-04 12:22:46 -0800416 }
417
Eric Laurent0d6db582014-11-12 18:39:44 -0800418 // sampling rate must be specified for direct outputs
419 if (sampleRate == 0 && (flags & AUDIO_OUTPUT_FLAG_DIRECT) != 0) {
420 return BAD_VALUE;
421 }
422 mSampleRate = sampleRate;
Lajos Molnar3a474aa2015-04-24 17:10:07 -0700423 mOriginalSampleRate = sampleRate;
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700424 mPlaybackRate = AUDIO_PLAYBACK_RATE_DEFAULT;
Eric Laurent0d6db582014-11-12 18:39:44 -0800425
Glenn Kastenb5ccb2d2014-01-13 14:42:43 -0800426 // Make copy of input parameter offloadInfo so that in the future:
427 // (a) createTrack_l doesn't need it as an input parameter
428 // (b) we can support re-creation of offloaded tracks
429 if (offloadInfo != NULL) {
430 mOffloadInfoCopy = *offloadInfo;
431 mOffloadInfo = &mOffloadInfoCopy;
432 } else {
433 mOffloadInfo = NULL;
434 }
435
Glenn Kasten66e46352014-01-16 17:44:23 -0800436 mVolume[AUDIO_INTERLEAVE_LEFT] = 1.0f;
437 mVolume[AUDIO_INTERLEAVE_RIGHT] = 1.0f;
Glenn Kasten05632a52012-01-03 14:22:33 -0800438 mSendLevel = 0.0f;
Glenn Kasten396fabd2014-01-08 08:54:23 -0800439 // mFrameCount is initialized in createTrack_l
Glenn Kastenb6037442012-11-14 13:42:25 -0800440 mReqFrameCount = frameCount;
Eric Laurentd1b449a2010-05-14 03:26:45 -0700441 mNotificationFramesReq = notificationFrames;
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800442 mNotificationFramesAct = 0;
Eric Laurentcaf7f482014-11-25 17:50:47 -0800443 if (sessionId == AUDIO_SESSION_ALLOCATE) {
Glenn Kastend848eb42016-03-08 13:42:11 -0800444 mSessionId = (audio_session_t) AudioSystem::newAudioUniqueId(AUDIO_UNIQUE_ID_USE_SESSION);
Eric Laurentcaf7f482014-11-25 17:50:47 -0800445 } else {
446 mSessionId = sessionId;
447 }
Marco Nelissend457c972014-02-11 08:47:07 -0800448 int callingpid = IPCThreadState::self()->getCallingPid();
449 int mypid = getpid();
450 if (uid == -1 || (callingpid != mypid)) {
Marco Nelissen462fd2f2013-01-14 14:12:05 -0800451 mClientUid = IPCThreadState::self()->getCallingUid();
452 } else {
453 mClientUid = uid;
454 }
Marco Nelissend457c972014-02-11 08:47:07 -0800455 if (pid == -1 || (callingpid != mypid)) {
456 mClientPid = callingpid;
457 } else {
458 mClientPid = pid;
459 }
Eric Laurent2beeb502010-07-16 07:43:46 -0700460 mAuxEffectId = 0;
Haynes Mathew Georgeae34ed22016-01-28 11:58:39 -0800461 mOrigFlags = mFlags = flags;
Glenn Kasten4a4a0952012-03-19 11:38:14 -0700462 mCbf = cbf;
Eric Laurentbe916aa2010-06-01 23:49:17 -0700463
Glenn Kastena997e7a2012-08-07 09:44:19 -0700464 if (cbf != NULL) {
Eric Laurent896adcd2012-09-13 11:18:23 -0700465 mAudioTrackThread = new AudioTrackThread(*this, threadCanCallJava);
Glenn Kastena997e7a2012-08-07 09:44:19 -0700466 mAudioTrackThread->run("AudioTrack", ANDROID_PRIORITY_AUDIO, 0 /*stack*/);
Glenn Kastenbfd31842015-03-20 09:01:44 -0700467 // thread begins in paused state, and will not reference us until start()
Glenn Kastena997e7a2012-08-07 09:44:19 -0700468 }
469
Eric Laurent34f1d8e2009-11-04 08:27:26 -0800470 // create the IAudioTrack
Eric Laurent0d6db582014-11-12 18:39:44 -0800471 status_t status = createTrack_l();
Eric Laurent34f1d8e2009-11-04 08:27:26 -0800472
Glenn Kastena997e7a2012-08-07 09:44:19 -0700473 if (status != NO_ERROR) {
474 if (mAudioTrackThread != 0) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100475 mAudioTrackThread->requestExit(); // see comment in AudioTrack.h
476 mAudioTrackThread->requestExitAndWait();
Glenn Kastena997e7a2012-08-07 09:44:19 -0700477 mAudioTrackThread.clear();
478 }
479 return status;
Glenn Kasten5d464eb2012-06-22 17:19:53 -0700480 }
481
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800482 mStatus = NO_ERROR;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800483 mUserData = user;
Andy Hung4ede21d2014-12-12 15:37:34 -0800484 mLoopCount = 0;
485 mLoopStart = 0;
486 mLoopEnd = 0;
Andy Hung53c3b5f2014-12-15 16:42:05 -0800487 mLoopCountNotified = 0;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800488 mMarkerPosition = 0;
Jean-Michel Trivi2c22aeb2009-03-24 18:11:07 -0700489 mMarkerReached = false;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800490 mNewPosition = 0;
491 mUpdatePeriod = 0;
Glenn Kasten200092b2014-08-15 15:13:30 -0700492 mPosition = 0;
493 mReleased = 0;
Andy Hung7f1bc8a2014-09-12 14:43:11 -0700494 mStartUs = 0;
Marco Nelissend457c972014-02-11 08:47:07 -0800495 AudioSystem::acquireAudioSessionId(mSessionId, mClientPid);
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800496 mSequence = 1;
497 mObservedSequence = mSequence;
498 mInUnderrun = false;
Phil Burk1b420972015-04-22 10:52:21 -0700499 mPreviousTimestampValid = false;
Andy Hungc8e09c62015-06-03 23:43:36 -0700500 mTimestampStartupGlitchReported = false;
501 mRetrogradeMotionReported = false;
Phil Burk2812d9e2016-01-04 10:34:30 -0800502 mUnderrunCountOffset = 0;
Andy Hungea2b9c02016-02-12 17:06:53 -0800503 mFramesWritten = 0;
504 mFramesWrittenServerOffset = 0;
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800505
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800506 return NO_ERROR;
507}
508
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800509// -------------------------------------------------------------------------
510
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100511status_t AudioTrack::start()
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800512{
Eric Laurentf5aafb22010-11-18 08:40:16 -0800513 AutoMutex lock(mLock);
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100514
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800515 if (mState == STATE_ACTIVE) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100516 return INVALID_OPERATION;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800517 }
518
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800519 mInUnderrun = true;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800520
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800521 State previousState = mState;
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100522 if (previousState == STATE_PAUSED_STOPPING) {
523 mState = STATE_STOPPING;
524 } else {
525 mState = STATE_ACTIVE;
526 }
Glenn Kasten200092b2014-08-15 15:13:30 -0700527 (void) updateAndGetPosition_l();
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800528 if (previousState == STATE_STOPPED || previousState == STATE_FLUSHED) {
529 // reset current position as seen by client to 0
Glenn Kasten200092b2014-08-15 15:13:30 -0700530 mPosition = 0;
Phil Burk1b420972015-04-22 10:52:21 -0700531 mPreviousTimestampValid = false;
Andy Hungc8e09c62015-06-03 23:43:36 -0700532 mTimestampStartupGlitchReported = false;
533 mRetrogradeMotionReported = false;
Phil Burk1b420972015-04-22 10:52:21 -0700534
Andy Hunge1e98462016-04-12 10:18:51 -0700535 // read last server side position change via timestamp.
536 ExtendedTimestamp ets;
537 if (mProxy->getTimestamp(&ets) == OK &&
538 ets.mTimeNs[ExtendedTimestamp::LOCATION_SERVER] > 0) {
539 // Server side has consumed something, but is it finished consuming?
540 // It is possible since flush and stop are asynchronous that the server
541 // is still active at this point.
542 ALOGV("start: server read:%lld cumulative flushed:%lld client written:%lld",
543 (long long)(mFramesWrittenServerOffset
544 + ets.mPosition[ExtendedTimestamp::LOCATION_SERVER]),
545 (long long)ets.mFlushed,
546 (long long)mFramesWritten);
547 mFramesWrittenServerOffset = -ets.mPosition[ExtendedTimestamp::LOCATION_SERVER];
Andy Hung61be8412015-10-06 10:51:09 -0700548 }
Andy Hunge1e98462016-04-12 10:18:51 -0700549 mFramesWritten = 0;
550 mProxy->clearTimestamp(); // need new server push for valid timestamp
551 mMarkerReached = false;
Andy Hung61be8412015-10-06 10:51:09 -0700552
Andy Hung7f1bc8a2014-09-12 14:43:11 -0700553 // For offloaded tracks, we don't know if the hardware counters are really zero here,
554 // since the flush is asynchronous and stop may not fully drain.
555 // We save the time when the track is started to later verify whether
556 // the counters are realistic (i.e. start from zero after this time).
557 mStartUs = getNowUs();
558
Eric Laurentec9a0322013-08-28 10:23:01 -0700559 // force refresh of remaining frames by processAudioBuffer() as last
560 // write before stop could be partial.
561 mRefreshRemaining = true;
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800562 }
Glenn Kasten200092b2014-08-15 15:13:30 -0700563 mNewPosition = mPosition + mUpdatePeriod;
Glenn Kasten96f60d82013-07-12 10:21:18 -0700564 int32_t flags = android_atomic_and(~CBLK_DISABLED, &mCblk->mFlags);
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800565
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800566 status_t status = NO_ERROR;
567 if (!(flags & CBLK_INVALID)) {
568 status = mAudioTrack->start();
569 if (status == DEAD_OBJECT) {
570 flags |= CBLK_INVALID;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800571 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800572 }
573 if (flags & CBLK_INVALID) {
574 status = restoreTrack_l("start");
575 }
576
Andy Hung79629f02016-03-24 13:57:40 -0700577 // resume or pause the callback thread as needed.
578 sp<AudioTrackThread> t = mAudioTrackThread;
579 if (status == NO_ERROR) {
580 if (t != 0) {
581 if (previousState == STATE_STOPPING) {
582 mProxy->interrupt();
583 } else {
584 t->resume();
585 }
586 } else {
587 mPreviousPriority = getpriority(PRIO_PROCESS, 0);
588 get_sched_policy(0, &mPreviousSchedulingGroup);
589 androidSetThreadPriority(0, ANDROID_PRIORITY_AUDIO);
590 }
591 } else {
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800592 ALOGE("start() status %d", status);
593 mState = previousState;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800594 if (t != 0) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100595 if (previousState != STATE_STOPPING) {
596 t->pause();
597 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800598 } else {
Glenn Kasten87913512011-06-22 16:15:25 -0700599 setpriority(PRIO_PROCESS, 0, mPreviousPriority);
Glenn Kastena6364332012-04-19 09:35:04 -0700600 set_sched_policy(0, mPreviousSchedulingGroup);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800601 }
602 }
603
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100604 return status;
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800605}
606
607void AudioTrack::stop()
608{
609 AutoMutex lock(mLock);
Glenn Kasten397edb32013-08-30 15:10:13 -0700610 if (mState != STATE_ACTIVE && mState != STATE_PAUSED) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800611 return;
612 }
613
Glenn Kasten23a75452014-01-13 10:37:17 -0800614 if (isOffloaded_l()) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100615 mState = STATE_STOPPING;
616 } else {
617 mState = STATE_STOPPED;
Andy Hungc2813e52014-10-16 17:54:34 -0700618 mReleased = 0;
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100619 }
620
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800621 mProxy->interrupt();
622 mAudioTrack->stop();
Andy Hung61be8412015-10-06 10:51:09 -0700623
624 // Note: legacy handling - stop does not clear playback marker
625 // and periodic update counter, but flush does for streaming tracks.
Andy Hung9b461582014-12-01 17:56:29 -0800626
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800627 if (mSharedBuffer != 0) {
Andy Hung9b461582014-12-01 17:56:29 -0800628 // clear buffer position and loop count.
Andy Hung9b461582014-12-01 17:56:29 -0800629 mStaticProxy->setBufferPositionAndLoop(0 /* position */,
630 0 /* loopStart */, 0 /* loopEnd */, 0 /* loopCount */);
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800631 }
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100632
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800633 sp<AudioTrackThread> t = mAudioTrackThread;
634 if (t != 0) {
Glenn Kasten23a75452014-01-13 10:37:17 -0800635 if (!isOffloaded_l()) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100636 t->pause();
637 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800638 } else {
639 setpriority(PRIO_PROCESS, 0, mPreviousPriority);
640 set_sched_policy(0, mPreviousSchedulingGroup);
641 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800642}
643
644bool AudioTrack::stopped() const
645{
Glenn Kasten9a2aaf92012-01-03 09:42:47 -0800646 AutoMutex lock(mLock);
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800647 return mState != STATE_ACTIVE;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800648}
649
650void AudioTrack::flush()
651{
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800652 if (mSharedBuffer != 0) {
653 return;
Glenn Kasten4bae3642012-11-30 13:41:12 -0800654 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800655 AutoMutex lock(mLock);
656 if (mState == STATE_ACTIVE || mState == STATE_FLUSHED) {
657 return;
658 }
659 flush_l();
Eric Laurent1703cdf2011-03-07 14:52:59 -0800660}
661
Eric Laurent1703cdf2011-03-07 14:52:59 -0800662void AudioTrack::flush_l()
663{
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800664 ALOG_ASSERT(mState != STATE_ACTIVE);
Eric Laurentc2f1f072009-07-17 12:17:14 -0700665
Jean-Michel Trivi2c22aeb2009-03-24 18:11:07 -0700666 // clear playback marker and periodic update counter
667 mMarkerPosition = 0;
668 mMarkerReached = false;
669 mUpdatePeriod = 0;
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100670 mRefreshRemaining = true;
Eric Laurentc2f1f072009-07-17 12:17:14 -0700671
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800672 mState = STATE_FLUSHED;
Andy Hungc2813e52014-10-16 17:54:34 -0700673 mReleased = 0;
Glenn Kasten23a75452014-01-13 10:37:17 -0800674 if (isOffloaded_l()) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100675 mProxy->interrupt();
676 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800677 mProxy->flush();
Glenn Kasten4bae3642012-11-30 13:41:12 -0800678 mAudioTrack->flush();
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800679}
680
681void AudioTrack::pause()
682{
Eric Laurentf5aafb22010-11-18 08:40:16 -0800683 AutoMutex lock(mLock);
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100684 if (mState == STATE_ACTIVE) {
685 mState = STATE_PAUSED;
686 } else if (mState == STATE_STOPPING) {
687 mState = STATE_PAUSED_STOPPING;
688 } else {
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800689 return;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800690 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800691 mProxy->interrupt();
692 mAudioTrack->pause();
Haynes Mathew George7064fd22014-01-08 13:59:53 -0800693
Marco Nelissen3a90f282014-03-10 11:21:43 -0700694 if (isOffloaded_l()) {
Glenn Kasten142f5192014-03-25 17:44:59 -0700695 if (mOutput != AUDIO_IO_HANDLE_NONE) {
Andy Hung7f1bc8a2014-09-12 14:43:11 -0700696 // An offload output can be re-used between two audio tracks having
697 // the same configuration. A timestamp query for a paused track
698 // while the other is running would return an incorrect time.
699 // To fix this, cache the playback position on a pause() and return
700 // this time when requested until the track is resumed.
701
702 // OffloadThread sends HAL pause in its threadLoop. Time saved
703 // here can be slightly off.
704
705 // TODO: check return code for getRenderPosition.
706
Haynes Mathew George7064fd22014-01-08 13:59:53 -0800707 uint32_t halFrames;
Haynes Mathew George7064fd22014-01-08 13:59:53 -0800708 AudioSystem::getRenderPosition(mOutput, &halFrames, &mPausedPosition);
709 ALOGV("AudioTrack::pause for offload, cache current position %u", mPausedPosition);
710 }
711 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800712}
713
Eric Laurentbe916aa2010-06-01 23:49:17 -0700714status_t AudioTrack::setVolume(float left, float right)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800715{
Glenn Kastenc56f3422014-03-21 17:53:17 -0700716 // This duplicates a test by AudioTrack JNI, but that is not the only caller
717 if (isnanf(left) || left < GAIN_FLOAT_ZERO || left > GAIN_FLOAT_UNITY ||
718 isnanf(right) || right < GAIN_FLOAT_ZERO || right > GAIN_FLOAT_UNITY) {
Eric Laurentbe916aa2010-06-01 23:49:17 -0700719 return BAD_VALUE;
720 }
721
Eric Laurent1703cdf2011-03-07 14:52:59 -0800722 AutoMutex lock(mLock);
Glenn Kasten66e46352014-01-16 17:44:23 -0800723 mVolume[AUDIO_INTERLEAVE_LEFT] = left;
724 mVolume[AUDIO_INTERLEAVE_RIGHT] = right;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800725
Glenn Kastenc56f3422014-03-21 17:53:17 -0700726 mProxy->setVolumeLR(gain_minifloat_pack(gain_from_float(left), gain_from_float(right)));
Eric Laurentbe916aa2010-06-01 23:49:17 -0700727
Glenn Kasten23a75452014-01-13 10:37:17 -0800728 if (isOffloaded_l()) {
Eric Laurent59fe0102013-09-27 18:48:26 -0700729 mAudioTrack->signal();
730 }
Eric Laurentbe916aa2010-06-01 23:49:17 -0700731 return NO_ERROR;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800732}
733
Glenn Kastenb1c09932012-02-27 16:21:04 -0800734status_t AudioTrack::setVolume(float volume)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800735{
Glenn Kastenb1c09932012-02-27 16:21:04 -0800736 return setVolume(volume, volume);
Eric Laurentbe916aa2010-06-01 23:49:17 -0700737}
738
Eric Laurent2beeb502010-07-16 07:43:46 -0700739status_t AudioTrack::setAuxEffectSendLevel(float level)
Eric Laurentbe916aa2010-06-01 23:49:17 -0700740{
Glenn Kastenc56f3422014-03-21 17:53:17 -0700741 // This duplicates a test by AudioTrack JNI, but that is not the only caller
742 if (isnanf(level) || level < GAIN_FLOAT_ZERO || level > GAIN_FLOAT_UNITY) {
Eric Laurentbe916aa2010-06-01 23:49:17 -0700743 return BAD_VALUE;
744 }
745
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800746 AutoMutex lock(mLock);
Eric Laurentbe916aa2010-06-01 23:49:17 -0700747 mSendLevel = level;
Glenn Kastene3aa6592012-12-04 12:22:46 -0800748 mProxy->setSendLevel(level);
Eric Laurentbe916aa2010-06-01 23:49:17 -0700749
750 return NO_ERROR;
751}
752
Glenn Kastena5224f32012-01-04 12:41:44 -0800753void AudioTrack::getAuxEffectSendLevel(float* level) const
Eric Laurentbe916aa2010-06-01 23:49:17 -0700754{
755 if (level != NULL) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800756 *level = mSendLevel;
Eric Laurentbe916aa2010-06-01 23:49:17 -0700757 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800758}
759
Glenn Kasten3b16c762012-11-14 08:44:39 -0800760status_t AudioTrack::setSampleRate(uint32_t rate)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800761{
Andy Hung5cbb5782015-03-27 18:39:59 -0700762 AutoMutex lock(mLock);
763 if (rate == mSampleRate) {
764 return NO_ERROR;
765 }
Glenn Kastend79072e2016-01-06 08:41:20 -0800766 if (isOffloadedOrDirect_l() || (mFlags & AUDIO_OUTPUT_FLAG_FAST)) {
John Grossman4ff14ba2012-02-08 16:37:41 -0800767 return INVALID_OPERATION;
768 }
Eric Laurent0d6db582014-11-12 18:39:44 -0800769 if (mOutput == AUDIO_IO_HANDLE_NONE) {
770 return NO_INIT;
771 }
Andy Hung5cbb5782015-03-27 18:39:59 -0700772 // NOTE: it is theoretically possible, but highly unlikely, that a device change
773 // could mean a previously allowed sampling rate is no longer allowed.
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800774 uint32_t afSamplingRate;
Eric Laurent0d6db582014-11-12 18:39:44 -0800775 if (AudioSystem::getSamplingRate(mOutput, &afSamplingRate) != NO_ERROR) {
Eric Laurent57326622009-07-07 07:10:45 -0700776 return NO_INIT;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800777 }
Andy Hung26145642015-04-15 21:56:53 -0700778 // pitch is emulated by adjusting speed and sampleRate
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700779 const uint32_t effectiveSampleRate = adjustSampleRate(rate, mPlaybackRate.mPitch);
Andy Hung26145642015-04-15 21:56:53 -0700780 if (rate == 0 || effectiveSampleRate > afSamplingRate * AUDIO_RESAMPLER_DOWN_RATIO_MAX) {
Glenn Kastend65d73c2012-06-22 17:21:07 -0700781 return BAD_VALUE;
782 }
Andy Hung8edb8dc2015-03-26 19:13:55 -0700783 // TODO: Should we also check if the buffer size is compatible?
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800784
Glenn Kastene3aa6592012-12-04 12:22:46 -0800785 mSampleRate = rate;
Andy Hung26145642015-04-15 21:56:53 -0700786 mProxy->setSampleRate(effectiveSampleRate);
Glenn Kastene3aa6592012-12-04 12:22:46 -0800787
Eric Laurent57326622009-07-07 07:10:45 -0700788 return NO_ERROR;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800789}
790
Glenn Kastena5224f32012-01-04 12:41:44 -0800791uint32_t AudioTrack::getSampleRate() const
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800792{
Eric Laurent1703cdf2011-03-07 14:52:59 -0800793 AutoMutex lock(mLock);
Eric Laurent6f59db12013-07-26 17:16:50 -0700794
795 // sample rate can be updated during playback by the offloaded decoder so we need to
796 // query the HAL and update if needed.
797// FIXME use Proxy return channel to update the rate from server and avoid polling here
Eric Laurentab5cdba2014-06-09 17:22:27 -0700798 if (isOffloadedOrDirect_l()) {
Glenn Kasten142f5192014-03-25 17:44:59 -0700799 if (mOutput != AUDIO_IO_HANDLE_NONE) {
Eric Laurent6f59db12013-07-26 17:16:50 -0700800 uint32_t sampleRate = 0;
Jean-Michel Trivib7f24b12014-06-11 10:05:30 -0700801 status_t status = AudioSystem::getSamplingRate(mOutput, &sampleRate);
Eric Laurent6f59db12013-07-26 17:16:50 -0700802 if (status == NO_ERROR) {
803 mSampleRate = sampleRate;
804 }
805 }
806 }
Glenn Kastene3aa6592012-12-04 12:22:46 -0800807 return mSampleRate;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800808}
809
Lajos Molnar3a474aa2015-04-24 17:10:07 -0700810uint32_t AudioTrack::getOriginalSampleRate() const
811{
Lajos Molnar3a474aa2015-04-24 17:10:07 -0700812 return mOriginalSampleRate;
813}
814
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700815status_t AudioTrack::setPlaybackRate(const AudioPlaybackRate &playbackRate)
Andy Hung8edb8dc2015-03-26 19:13:55 -0700816{
Andy Hung8edb8dc2015-03-26 19:13:55 -0700817 AutoMutex lock(mLock);
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700818 if (isAudioPlaybackRateEqual(playbackRate, mPlaybackRate)) {
Andy Hung8edb8dc2015-03-26 19:13:55 -0700819 return NO_ERROR;
820 }
Glenn Kastend79072e2016-01-06 08:41:20 -0800821 if (isOffloadedOrDirect_l()) {
Andy Hung8edb8dc2015-03-26 19:13:55 -0700822 return INVALID_OPERATION;
823 }
824 if (mFlags & AUDIO_OUTPUT_FLAG_FAST) {
825 return INVALID_OPERATION;
826 }
Andy Hung26145642015-04-15 21:56:53 -0700827 // pitch is emulated by adjusting speed and sampleRate
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700828 const uint32_t effectiveRate = adjustSampleRate(mSampleRate, playbackRate.mPitch);
829 const float effectiveSpeed = adjustSpeed(playbackRate.mSpeed, playbackRate.mPitch);
830 const float effectivePitch = adjustPitch(playbackRate.mPitch);
Ricardo Garcia6c7f0622015-04-30 18:39:16 -0700831 AudioPlaybackRate playbackRateTemp = playbackRate;
832 playbackRateTemp.mSpeed = effectiveSpeed;
833 playbackRateTemp.mPitch = effectivePitch;
834
835 if (!isAudioPlaybackRateValid(playbackRateTemp)) {
Andy Hung26145642015-04-15 21:56:53 -0700836 return BAD_VALUE;
837 }
Andy Hung8edb8dc2015-03-26 19:13:55 -0700838 // Check if the buffer size is compatible.
Andy Hung26145642015-04-15 21:56:53 -0700839 if (!isSampleRateSpeedAllowed_l(effectiveRate, effectiveSpeed)) {
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700840 ALOGV("setPlaybackRate(%f, %f) failed", playbackRate.mSpeed, playbackRate.mPitch);
Andy Hung8edb8dc2015-03-26 19:13:55 -0700841 return BAD_VALUE;
842 }
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700843
Ricardo Garcia6c7f0622015-04-30 18:39:16 -0700844 // Check resampler ratios are within bounds
Dan Austine34eae22015-10-27 16:14:52 -0700845 if ((uint64_t)effectiveRate > (uint64_t)mSampleRate * (uint64_t)AUDIO_RESAMPLER_DOWN_RATIO_MAX) {
Ricardo Garcia6c7f0622015-04-30 18:39:16 -0700846 ALOGV("setPlaybackRate(%f, %f) failed. Resample rate exceeds max accepted value",
847 playbackRate.mSpeed, playbackRate.mPitch);
848 return BAD_VALUE;
849 }
850
Dan Austine34eae22015-10-27 16:14:52 -0700851 if ((uint64_t)effectiveRate * (uint64_t)AUDIO_RESAMPLER_UP_RATIO_MAX < (uint64_t)mSampleRate) {
Ricardo Garcia6c7f0622015-04-30 18:39:16 -0700852 ALOGV("setPlaybackRate(%f, %f) failed. Resample rate below min accepted value",
853 playbackRate.mSpeed, playbackRate.mPitch);
854 return BAD_VALUE;
855 }
856 mPlaybackRate = playbackRate;
857 //set effective rates
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700858 mProxy->setPlaybackRate(playbackRateTemp);
Andy Hung26145642015-04-15 21:56:53 -0700859 mProxy->setSampleRate(effectiveRate); // FIXME: not quite "atomic" with setPlaybackRate
Andy Hung8edb8dc2015-03-26 19:13:55 -0700860 return NO_ERROR;
861}
862
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700863const AudioPlaybackRate& AudioTrack::getPlaybackRate() const
Andy Hung8edb8dc2015-03-26 19:13:55 -0700864{
865 AutoMutex lock(mLock);
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -0700866 return mPlaybackRate;
Andy Hung8edb8dc2015-03-26 19:13:55 -0700867}
868
Phil Burkc0adecb2016-01-08 12:44:11 -0800869ssize_t AudioTrack::getBufferSizeInFrames()
870{
871 AutoMutex lock(mLock);
872 if (mOutput == AUDIO_IO_HANDLE_NONE || mProxy.get() == 0) {
873 return NO_INIT;
874 }
Phil Burke8972b02016-03-04 11:29:57 -0800875 return (ssize_t) mProxy->getBufferSizeInFrames();
Phil Burkc0adecb2016-01-08 12:44:11 -0800876}
877
878ssize_t AudioTrack::setBufferSizeInFrames(size_t bufferSizeInFrames)
879{
880 AutoMutex lock(mLock);
881 if (mOutput == AUDIO_IO_HANDLE_NONE || mProxy.get() == 0) {
882 return NO_INIT;
883 }
884 // Reject if timed track or compressed audio.
Glenn Kastend79072e2016-01-06 08:41:20 -0800885 if (!audio_is_linear_pcm(mFormat)) {
Phil Burkc0adecb2016-01-08 12:44:11 -0800886 return INVALID_OPERATION;
887 }
Phil Burke8972b02016-03-04 11:29:57 -0800888 return (ssize_t) mProxy->setBufferSizeInFrames((uint32_t) bufferSizeInFrames);
Phil Burkc0adecb2016-01-08 12:44:11 -0800889}
890
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800891status_t AudioTrack::setLoop(uint32_t loopStart, uint32_t loopEnd, int loopCount)
892{
Glenn Kastend79072e2016-01-06 08:41:20 -0800893 if (mSharedBuffer == 0 || isOffloadedOrDirect()) {
Glenn Kasten083d1c12012-11-30 15:00:36 -0800894 return INVALID_OPERATION;
895 }
896
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800897 if (loopCount == 0) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800898 ;
899 } else if (loopCount >= -1 && loopStart < loopEnd && loopEnd <= mFrameCount &&
900 loopEnd - loopStart >= MIN_LOOP) {
901 ;
902 } else {
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800903 return BAD_VALUE;
904 }
905
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800906 AutoMutex lock(mLock);
907 // See setPosition() regarding setting parameters such as loop points or position while active
908 if (mState == STATE_ACTIVE) {
909 return INVALID_OPERATION;
Eric Laurentc2f1f072009-07-17 12:17:14 -0700910 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800911 setLoop_l(loopStart, loopEnd, loopCount);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800912 return NO_ERROR;
913}
914
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800915void AudioTrack::setLoop_l(uint32_t loopStart, uint32_t loopEnd, int loopCount)
916{
Andy Hung4ede21d2014-12-12 15:37:34 -0800917 // We do not update the periodic notification point.
918 // mNewPosition = updateAndGetPosition_l() + mUpdatePeriod;
919 mLoopCount = loopCount;
920 mLoopEnd = loopEnd;
921 mLoopStart = loopStart;
Andy Hung53c3b5f2014-12-15 16:42:05 -0800922 mLoopCountNotified = loopCount;
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800923 mStaticProxy->setLoop(loopStart, loopEnd, loopCount);
Andy Hung3c09c782014-12-29 18:39:32 -0800924
925 // Waking the AudioTrackThread is not needed as this cannot be called when active.
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800926}
927
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800928status_t AudioTrack::setMarkerPosition(uint32_t marker)
929{
Glenn Kastenfb1fdc92013-07-10 17:03:19 -0700930 // The only purpose of setting marker position is to get a callback
Eric Laurentab5cdba2014-06-09 17:22:27 -0700931 if (mCbf == NULL || isOffloadedOrDirect()) {
Glenn Kastend65d73c2012-06-22 17:21:07 -0700932 return INVALID_OPERATION;
933 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800934
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800935 AutoMutex lock(mLock);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800936 mMarkerPosition = marker;
Jean-Michel Trivi2c22aeb2009-03-24 18:11:07 -0700937 mMarkerReached = false;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800938
Andy Hung3c09c782014-12-29 18:39:32 -0800939 sp<AudioTrackThread> t = mAudioTrackThread;
940 if (t != 0) {
941 t->wake();
942 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800943 return NO_ERROR;
944}
945
Glenn Kastena5224f32012-01-04 12:41:44 -0800946status_t AudioTrack::getMarkerPosition(uint32_t *marker) const
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800947{
Eric Laurentab5cdba2014-06-09 17:22:27 -0700948 if (isOffloadedOrDirect()) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100949 return INVALID_OPERATION;
950 }
Glenn Kastend65d73c2012-06-22 17:21:07 -0700951 if (marker == NULL) {
952 return BAD_VALUE;
953 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800954
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800955 AutoMutex lock(mLock);
Andy Hung90e8a972015-11-09 16:42:40 -0800956 mMarkerPosition.getValue(marker);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800957
958 return NO_ERROR;
959}
960
961status_t AudioTrack::setPositionUpdatePeriod(uint32_t updatePeriod)
962{
Glenn Kastenfb1fdc92013-07-10 17:03:19 -0700963 // The only purpose of setting position update period is to get a callback
Eric Laurentab5cdba2014-06-09 17:22:27 -0700964 if (mCbf == NULL || isOffloadedOrDirect()) {
Glenn Kastend65d73c2012-06-22 17:21:07 -0700965 return INVALID_OPERATION;
966 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800967
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800968 AutoMutex lock(mLock);
Glenn Kasten200092b2014-08-15 15:13:30 -0700969 mNewPosition = updateAndGetPosition_l() + updatePeriod;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800970 mUpdatePeriod = updatePeriod;
Glenn Kasten2b2165c2014-01-13 08:53:36 -0800971
Andy Hung3c09c782014-12-29 18:39:32 -0800972 sp<AudioTrackThread> t = mAudioTrackThread;
973 if (t != 0) {
974 t->wake();
975 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800976 return NO_ERROR;
977}
978
Glenn Kastena5224f32012-01-04 12:41:44 -0800979status_t AudioTrack::getPositionUpdatePeriod(uint32_t *updatePeriod) const
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800980{
Eric Laurentab5cdba2014-06-09 17:22:27 -0700981 if (isOffloadedOrDirect()) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +0100982 return INVALID_OPERATION;
983 }
Glenn Kastend65d73c2012-06-22 17:21:07 -0700984 if (updatePeriod == NULL) {
985 return BAD_VALUE;
986 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800987
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800988 AutoMutex lock(mLock);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -0800989 *updatePeriod = mUpdatePeriod;
990
991 return NO_ERROR;
992}
993
994status_t AudioTrack::setPosition(uint32_t position)
995{
Glenn Kastend79072e2016-01-06 08:41:20 -0800996 if (mSharedBuffer == 0 || isOffloadedOrDirect()) {
Glenn Kastend65d73c2012-06-22 17:21:07 -0700997 return INVALID_OPERATION;
998 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -0800999 if (position > mFrameCount) {
1000 return BAD_VALUE;
1001 }
John Grossman4ff14ba2012-02-08 16:37:41 -08001002
Eric Laurent1703cdf2011-03-07 14:52:59 -08001003 AutoMutex lock(mLock);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001004 // Currently we require that the player is inactive before setting parameters such as position
1005 // or loop points. Otherwise, there could be a race condition: the application could read the
1006 // current position, compute a new position or loop parameters, and then set that position or
1007 // loop parameters but it would do the "wrong" thing since the position has continued to advance
1008 // in the mean time. If we ever provide a sequencer in server, we could allow a way for the app
1009 // to specify how it wants to handle such scenarios.
1010 if (mState == STATE_ACTIVE) {
Glenn Kastend65d73c2012-06-22 17:21:07 -07001011 return INVALID_OPERATION;
1012 }
Andy Hung9b461582014-12-01 17:56:29 -08001013 // After setting the position, use full update period before notification.
Glenn Kasten200092b2014-08-15 15:13:30 -07001014 mNewPosition = updateAndGetPosition_l() + mUpdatePeriod;
Andy Hung9b461582014-12-01 17:56:29 -08001015 mStaticProxy->setBufferPosition(position);
Andy Hung3c09c782014-12-29 18:39:32 -08001016
1017 // Waking the AudioTrackThread is not needed as this cannot be called when active.
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001018 return NO_ERROR;
1019}
1020
Glenn Kasten200092b2014-08-15 15:13:30 -07001021status_t AudioTrack::getPosition(uint32_t *position)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001022{
Glenn Kastend65d73c2012-06-22 17:21:07 -07001023 if (position == NULL) {
1024 return BAD_VALUE;
1025 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001026
Eric Laurent1703cdf2011-03-07 14:52:59 -08001027 AutoMutex lock(mLock);
Andy Hung7a490e72016-03-23 15:58:10 -07001028 // FIXME: offloaded and direct tracks call into the HAL for render positions
1029 // for compressed/synced data; however, we use proxy position for pure linear pcm data
1030 // as we do not know the capability of the HAL for pcm position support and standby.
1031 // There may be some latency differences between the HAL position and the proxy position.
1032 if (isOffloadedOrDirect_l() && !isPurePcmData_l()) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001033 uint32_t dspFrames = 0;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001034
Eric Laurentab5cdba2014-06-09 17:22:27 -07001035 if (isOffloaded_l() && ((mState == STATE_PAUSED) || (mState == STATE_PAUSED_STOPPING))) {
Haynes Mathew George7064fd22014-01-08 13:59:53 -08001036 ALOGV("getPosition called in paused state, return cached position %u", mPausedPosition);
1037 *position = mPausedPosition;
1038 return NO_ERROR;
1039 }
1040
Glenn Kasten142f5192014-03-25 17:44:59 -07001041 if (mOutput != AUDIO_IO_HANDLE_NONE) {
Andy Hung1f1db832015-06-08 13:26:10 -07001042 uint32_t halFrames; // actually unused
1043 (void) AudioSystem::getRenderPosition(mOutput, &halFrames, &dspFrames);
1044 // FIXME: on getRenderPosition() error, we return OK with frame position 0.
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001045 }
Andy Hung7f1bc8a2014-09-12 14:43:11 -07001046 // FIXME: dspFrames may not be zero in (mState == STATE_STOPPED || mState == STATE_FLUSHED)
1047 // due to hardware latency. We leave this behavior for now.
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001048 *position = dspFrames;
1049 } else {
Eric Laurent275e8e92014-11-30 15:14:47 -08001050 if (mCblk->mFlags & CBLK_INVALID) {
Andy Hung1f1db832015-06-08 13:26:10 -07001051 (void) restoreTrack_l("getPosition");
1052 // FIXME: for compatibility with the Java API we ignore the restoreTrack_l()
1053 // error here (e.g. DEAD_OBJECT) and return OK with the last recorded server position.
Eric Laurent275e8e92014-11-30 15:14:47 -08001054 }
1055
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001056 // IAudioTrack::stop() isn't synchronous; we don't know when presentation completes
Glenn Kasten200092b2014-08-15 15:13:30 -07001057 *position = (mState == STATE_STOPPED || mState == STATE_FLUSHED) ?
Andy Hung90e8a972015-11-09 16:42:40 -08001058 0 : updateAndGetPosition_l().value();
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001059 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001060 return NO_ERROR;
1061}
1062
Kévin PETIT377b2ec2014-02-03 12:35:36 +00001063status_t AudioTrack::getBufferPosition(uint32_t *position)
Glenn Kasten9c6745f2012-11-30 13:35:29 -08001064{
Glenn Kastend79072e2016-01-06 08:41:20 -08001065 if (mSharedBuffer == 0) {
Glenn Kasten9c6745f2012-11-30 13:35:29 -08001066 return INVALID_OPERATION;
1067 }
1068 if (position == NULL) {
1069 return BAD_VALUE;
1070 }
Glenn Kasten9c6745f2012-11-30 13:35:29 -08001071
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001072 AutoMutex lock(mLock);
1073 *position = mStaticProxy->getBufferPosition();
Glenn Kasten9c6745f2012-11-30 13:35:29 -08001074 return NO_ERROR;
1075}
Glenn Kasten9c6745f2012-11-30 13:35:29 -08001076
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001077status_t AudioTrack::reload()
1078{
Glenn Kastend79072e2016-01-06 08:41:20 -08001079 if (mSharedBuffer == 0 || isOffloadedOrDirect()) {
Glenn Kasten083d1c12012-11-30 15:00:36 -08001080 return INVALID_OPERATION;
1081 }
1082
Eric Laurent1703cdf2011-03-07 14:52:59 -08001083 AutoMutex lock(mLock);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001084 // See setPosition() regarding setting parameters such as loop points or position while active
1085 if (mState == STATE_ACTIVE) {
Glenn Kastend65d73c2012-06-22 17:21:07 -07001086 return INVALID_OPERATION;
1087 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001088 mNewPosition = mUpdatePeriod;
Andy Hung9b461582014-12-01 17:56:29 -08001089 (void) updateAndGetPosition_l();
1090 mPosition = 0;
Phil Burk1b420972015-04-22 10:52:21 -07001091 mPreviousTimestampValid = false;
Andy Hung53c3b5f2014-12-15 16:42:05 -08001092#if 0
Andy Hung9b461582014-12-01 17:56:29 -08001093 // The documentation is not clear on the behavior of reload() and the restoration
Andy Hung53c3b5f2014-12-15 16:42:05 -08001094 // of loop count. Historically we have not restored loop count, start, end,
1095 // but it makes sense if one desires to repeat playing a particular sound.
1096 if (mLoopCount != 0) {
1097 mLoopCountNotified = mLoopCount;
1098 mStaticProxy->setLoop(mLoopStart, mLoopEnd, mLoopCount);
1099 }
1100#endif
Andy Hung9b461582014-12-01 17:56:29 -08001101 mStaticProxy->setBufferPosition(0);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001102 return NO_ERROR;
1103}
1104
Glenn Kasten38e905b2014-01-13 10:21:48 -08001105audio_io_handle_t AudioTrack::getOutput() const
Eric Laurentc2f1f072009-07-17 12:17:14 -07001106{
Eric Laurent1703cdf2011-03-07 14:52:59 -08001107 AutoMutex lock(mLock);
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001108 return mOutput;
Eric Laurent1703cdf2011-03-07 14:52:59 -08001109}
1110
Paul McLeanaa981192015-03-21 09:55:15 -07001111status_t AudioTrack::setOutputDevice(audio_port_handle_t deviceId) {
1112 AutoMutex lock(mLock);
1113 if (mSelectedDeviceId != deviceId) {
1114 mSelectedDeviceId = deviceId;
Eric Laurent493404d2015-04-21 15:07:36 -07001115 android_atomic_or(CBLK_INVALID, &mCblk->mFlags);
Paul McLeanaa981192015-03-21 09:55:15 -07001116 }
Eric Laurent493404d2015-04-21 15:07:36 -07001117 return NO_ERROR;
Paul McLeanaa981192015-03-21 09:55:15 -07001118}
1119
1120audio_port_handle_t AudioTrack::getOutputDevice() {
1121 AutoMutex lock(mLock);
1122 return mSelectedDeviceId;
1123}
1124
Eric Laurent296fb132015-05-01 11:38:42 -07001125audio_port_handle_t AudioTrack::getRoutedDeviceId() {
1126 AutoMutex lock(mLock);
1127 if (mOutput == AUDIO_IO_HANDLE_NONE) {
1128 return AUDIO_PORT_HANDLE_NONE;
1129 }
1130 return AudioSystem::getDeviceIdForIo(mOutput);
1131}
1132
Eric Laurentbe916aa2010-06-01 23:49:17 -07001133status_t AudioTrack::attachAuxEffect(int effectId)
1134{
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001135 AutoMutex lock(mLock);
Eric Laurent2beeb502010-07-16 07:43:46 -07001136 status_t status = mAudioTrack->attachAuxEffect(effectId);
1137 if (status == NO_ERROR) {
1138 mAuxEffectId = effectId;
1139 }
1140 return status;
Eric Laurentbe916aa2010-06-01 23:49:17 -07001141}
1142
Eric Laurente83b55d2014-11-14 10:06:21 -08001143audio_stream_type_t AudioTrack::streamType() const
1144{
1145 if (mStreamType == AUDIO_STREAM_DEFAULT) {
1146 return audio_attributes_to_stream_type(&mAttributes);
1147 }
1148 return mStreamType;
1149}
1150
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001151// -------------------------------------------------------------------------
1152
Eric Laurent1703cdf2011-03-07 14:52:59 -08001153// must be called with mLock held
Glenn Kasten200092b2014-08-15 15:13:30 -07001154status_t AudioTrack::createTrack_l()
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001155{
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001156 const sp<IAudioFlinger>& audioFlinger = AudioSystem::get_audio_flinger();
1157 if (audioFlinger == 0) {
Glenn Kastene53b9ea2012-03-12 16:29:55 -07001158 ALOGE("Could not get audioflinger");
1159 return NO_INIT;
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001160 }
1161
Eric Laurent296fb132015-05-01 11:38:42 -07001162 if (mDeviceCallback != 0 && mOutput != AUDIO_IO_HANDLE_NONE) {
1163 AudioSystem::removeAudioDeviceCallback(mDeviceCallback, mOutput);
1164 }
Eric Laurente83b55d2014-11-14 10:06:21 -08001165 audio_io_handle_t output;
1166 audio_stream_type_t streamType = mStreamType;
1167 audio_attributes_t *attr = (mStreamType == AUDIO_STREAM_DEFAULT) ? &mAttributes : NULL;
Eric Laurente83b55d2014-11-14 10:06:21 -08001168
Haynes Mathew Georgeae34ed22016-01-28 11:58:39 -08001169 // mFlags (not mOrigFlags) is modified depending on whether fast request is accepted.
1170 // After fast request is denied, we will request again if IAudioTrack is re-created.
1171
Paul McLeanaa981192015-03-21 09:55:15 -07001172 status_t status;
1173 status = AudioSystem::getOutputForAttr(attr, &output,
Glenn Kastend848eb42016-03-08 13:42:11 -08001174 mSessionId, &streamType, mClientUid,
Paul McLeanaa981192015-03-21 09:55:15 -07001175 mSampleRate, mFormat, mChannelMask,
1176 mFlags, mSelectedDeviceId, mOffloadInfo);
Eric Laurente83b55d2014-11-14 10:06:21 -08001177
1178 if (status != NO_ERROR || output == AUDIO_IO_HANDLE_NONE) {
Glenn Kasten4c36d6f2015-03-20 09:05:01 -07001179 ALOGE("Could not get audio output for session %d, stream type %d, usage %d, sample rate %u, format %#x,"
Jean-Michel Trivi5bd3f382014-06-13 16:06:54 -07001180 " channel mask %#x, flags %#x",
Glenn Kasten4c36d6f2015-03-20 09:05:01 -07001181 mSessionId, streamType, mAttributes.usage, mSampleRate, mFormat, mChannelMask, mFlags);
Glenn Kasten38e905b2014-01-13 10:21:48 -08001182 return BAD_VALUE;
1183 }
1184 {
1185 // Now that we have a reference to an I/O handle and have not yet handed it off to AudioFlinger,
1186 // we must release it ourselves if anything goes wrong.
1187
Glenn Kastence8828a2013-09-16 18:07:38 -07001188 // Not all of these values are needed under all conditions, but it is easier to get them all
Andy Hung9f9e21e2015-05-31 21:45:36 -07001189 status = AudioSystem::getLatency(output, &mAfLatency);
Glenn Kastence8828a2013-09-16 18:07:38 -07001190 if (status != NO_ERROR) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001191 ALOGE("getLatency(%d) failed status %d", output, status);
Glenn Kasten38e905b2014-01-13 10:21:48 -08001192 goto release;
Eric Laurentd1b449a2010-05-14 03:26:45 -07001193 }
Andy Hung9f9e21e2015-05-31 21:45:36 -07001194 ALOGV("createTrack_l() output %d afLatency %u", output, mAfLatency);
Eric Laurentd1b449a2010-05-14 03:26:45 -07001195
Andy Hung9f9e21e2015-05-31 21:45:36 -07001196 status = AudioSystem::getFrameCount(output, &mAfFrameCount);
Glenn Kastence8828a2013-09-16 18:07:38 -07001197 if (status != NO_ERROR) {
Jean-Michel Trivib7f24b12014-06-11 10:05:30 -07001198 ALOGE("getFrameCount(output=%d) status %d", output, status);
Glenn Kasten38e905b2014-01-13 10:21:48 -08001199 goto release;
Glenn Kastence8828a2013-09-16 18:07:38 -07001200 }
1201
Andy Hung9f9e21e2015-05-31 21:45:36 -07001202 status = AudioSystem::getSamplingRate(output, &mAfSampleRate);
Glenn Kastence8828a2013-09-16 18:07:38 -07001203 if (status != NO_ERROR) {
Jean-Michel Trivib7f24b12014-06-11 10:05:30 -07001204 ALOGE("getSamplingRate(output=%d) status %d", output, status);
Glenn Kasten38e905b2014-01-13 10:21:48 -08001205 goto release;
Glenn Kastence8828a2013-09-16 18:07:38 -07001206 }
Eric Laurent0d6db582014-11-12 18:39:44 -08001207 if (mSampleRate == 0) {
Andy Hung9f9e21e2015-05-31 21:45:36 -07001208 mSampleRate = mAfSampleRate;
1209 mOriginalSampleRate = mAfSampleRate;
Eric Laurent0d6db582014-11-12 18:39:44 -08001210 }
Glenn Kasten7fd04222016-02-02 12:38:16 -08001211
Glenn Kastend79072e2016-01-06 08:41:20 -08001212 // Client can only express a preference for FAST. Server will perform additional tests.
Phil Burk33ff89b2015-11-30 11:16:01 -08001213 if (mFlags & AUDIO_OUTPUT_FLAG_FAST) {
1214 bool useCaseAllowed =
Glenn Kasten4a4a0952012-03-19 11:38:14 -07001215 // either of these use cases:
1216 // use case 1: shared buffer
Glenn Kasten363fb752014-01-15 12:27:31 -08001217 (mSharedBuffer != 0) ||
Glenn Kastenc6ba8232014-02-27 13:34:29 -08001218 // use case 2: callback transfer mode
Glenn Kasten1dfe2f92015-03-09 12:03:14 -07001219 (mTransfer == TRANSFER_CALLBACK) ||
1220 // use case 3: obtain/release mode
Phil Burk33ff89b2015-11-30 11:16:01 -08001221 (mTransfer == TRANSFER_OBTAIN) ||
1222 // use case 4: synchronous write
1223 ((mTransfer == TRANSFER_SYNC) && mThreadCanCallJava);
1224 // sample rates must also match
1225 bool fastAllowed = useCaseAllowed && (mSampleRate == mAfSampleRate);
1226 if (!fastAllowed) {
Glenn Kasten7fd04222016-02-02 12:38:16 -08001227 ALOGW("AUDIO_OUTPUT_FLAG_FAST denied by client; transfer %d, "
Phil Burk33ff89b2015-11-30 11:16:01 -08001228 "track %u Hz, output %u Hz",
Andy Hung9f9e21e2015-05-31 21:45:36 -07001229 mTransfer, mSampleRate, mAfSampleRate);
Phil Burk33ff89b2015-11-30 11:16:01 -08001230 mFlags = (audio_output_flags_t) (mFlags & ~AUDIO_OUTPUT_FLAG_FAST);
1231 }
Glenn Kasten4a4a0952012-03-19 11:38:14 -07001232 }
1233
Eric Laurentd1b449a2010-05-14 03:26:45 -07001234 mNotificationFramesAct = mNotificationFramesReq;
Glenn Kastene0fa4672012-04-24 14:35:14 -07001235
Glenn Kasten363fb752014-01-15 12:27:31 -08001236 size_t frameCount = mReqFrameCount;
Phil Burkfdb3c072016-02-09 10:47:02 -08001237 if (!audio_has_proportional_frames(mFormat)) {
Glenn Kastene0fa4672012-04-24 14:35:14 -07001238
Glenn Kasten363fb752014-01-15 12:27:31 -08001239 if (mSharedBuffer != 0) {
Glenn Kastene0fa4672012-04-24 14:35:14 -07001240 // Same comment as below about ignoring frameCount parameter for set()
Glenn Kasten363fb752014-01-15 12:27:31 -08001241 frameCount = mSharedBuffer->size();
Glenn Kastene0fa4672012-04-24 14:35:14 -07001242 } else if (frameCount == 0) {
Andy Hung9f9e21e2015-05-31 21:45:36 -07001243 frameCount = mAfFrameCount;
Eric Laurentd1b449a2010-05-14 03:26:45 -07001244 }
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001245 if (mNotificationFramesAct != frameCount) {
1246 mNotificationFramesAct = frameCount;
1247 }
Glenn Kasten363fb752014-01-15 12:27:31 -08001248 } else if (mSharedBuffer != 0) {
Andy Hungabdb9902015-01-12 15:08:22 -08001249 // FIXME: Ensure client side memory buffers need
1250 // not have additional alignment beyond sample
1251 // (e.g. 16 bit stereo accessed as 32 bit frame).
1252 size_t alignment = audio_bytes_per_sample(mFormat);
Glenn Kastenb7730382014-04-30 15:50:31 -07001253 if (alignment & 1) {
Andy Hungabdb9902015-01-12 15:08:22 -08001254 // for AUDIO_FORMAT_PCM_24_BIT_PACKED (not exposed through Java).
Glenn Kastenb7730382014-04-30 15:50:31 -07001255 alignment = 1;
1256 }
Glenn Kastena42ff002012-11-14 12:47:55 -08001257 if (mChannelCount > 1) {
Glenn Kastene0fa4672012-04-24 14:35:14 -07001258 // More than 2 channels does not require stronger alignment than stereo
1259 alignment <<= 1;
1260 }
Narayan Kamath1d6fa7a2014-02-11 13:47:53 +00001261 if (((uintptr_t)mSharedBuffer->pointer() & (alignment - 1)) != 0) {
Glenn Kastena42ff002012-11-14 12:47:55 -08001262 ALOGE("Invalid buffer alignment: address %p, channel count %u",
Glenn Kasten363fb752014-01-15 12:27:31 -08001263 mSharedBuffer->pointer(), mChannelCount);
Glenn Kasten38e905b2014-01-13 10:21:48 -08001264 status = BAD_VALUE;
1265 goto release;
Glenn Kastene0fa4672012-04-24 14:35:14 -07001266 }
1267
1268 // When initializing a shared buffer AudioTrack via constructors,
1269 // there's no frameCount parameter.
1270 // But when initializing a shared buffer AudioTrack via set(),
1271 // there _is_ a frameCount parameter. We silently ignore it.
Andy Hungabdb9902015-01-12 15:08:22 -08001272 frameCount = mSharedBuffer->size() / mFrameSize;
Glenn Kastene0fa4672012-04-24 14:35:14 -07001273 } else {
Andy Hung8edb8dc2015-03-26 19:13:55 -07001274 // For fast tracks the frame count calculations and checks are done by server
1275
1276 if ((mFlags & AUDIO_OUTPUT_FLAG_FAST) == 0) {
1277 // for normal tracks precompute the frame count based on speed.
1278 const size_t minFrameCount = calculateMinFrameCount(
Andy Hung9f9e21e2015-05-31 21:45:36 -07001279 mAfLatency, mAfFrameCount, mAfSampleRate, mSampleRate,
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -07001280 mPlaybackRate.mSpeed);
Andy Hung8edb8dc2015-03-26 19:13:55 -07001281 if (frameCount < minFrameCount) {
1282 frameCount = minFrameCount;
1283 }
1284 }
Eric Laurentd1b449a2010-05-14 03:26:45 -07001285 }
1286
Glenn Kastena075db42012-03-06 11:22:44 -08001287 IAudioFlinger::track_flags_t trackFlags = IAudioFlinger::TRACK_DEFAULT;
Glenn Kasten3acbd052012-02-28 10:39:56 -08001288
1289 pid_t tid = -1;
Glenn Kasten363fb752014-01-15 12:27:31 -08001290 if (mFlags & AUDIO_OUTPUT_FLAG_FAST) {
Glenn Kasten4a4a0952012-03-19 11:38:14 -07001291 trackFlags |= IAudioFlinger::TRACK_FAST;
Phil Burk33ff89b2015-11-30 11:16:01 -08001292 if (mAudioTrackThread != 0 && !mThreadCanCallJava) {
Glenn Kasten3acbd052012-02-28 10:39:56 -08001293 tid = mAudioTrackThread->getTid();
1294 }
Glenn Kasten4a4a0952012-03-19 11:38:14 -07001295 }
1296
Glenn Kasten363fb752014-01-15 12:27:31 -08001297 if (mFlags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001298 trackFlags |= IAudioFlinger::TRACK_OFFLOAD;
1299 }
1300
Eric Laurentab5cdba2014-06-09 17:22:27 -07001301 if (mFlags & AUDIO_OUTPUT_FLAG_DIRECT) {
1302 trackFlags |= IAudioFlinger::TRACK_DIRECT;
1303 }
1304
Glenn Kasten74935e42013-12-19 08:56:45 -08001305 size_t temp = frameCount; // temp may be replaced by a revised value of frameCount,
1306 // but we will still need the original value also
Glenn Kastend848eb42016-03-08 13:42:11 -08001307 audio_session_t originalSessionId = mSessionId;
Eric Laurente83b55d2014-11-14 10:06:21 -08001308 sp<IAudioTrack> track = audioFlinger->createTrack(streamType,
Glenn Kasten363fb752014-01-15 12:27:31 -08001309 mSampleRate,
Andy Hungabdb9902015-01-12 15:08:22 -08001310 mFormat,
Glenn Kastena42ff002012-11-14 12:47:55 -08001311 mChannelMask,
Glenn Kasten74935e42013-12-19 08:56:45 -08001312 &temp,
Glenn Kastene0b07172012-11-06 15:03:34 -08001313 &trackFlags,
Glenn Kasten363fb752014-01-15 12:27:31 -08001314 mSharedBuffer,
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001315 output,
Glenn Kasten3acbd052012-02-28 10:39:56 -08001316 tid,
Eric Laurentbe916aa2010-06-01 23:49:17 -07001317 &mSessionId,
Marco Nelissen462fd2f2013-01-14 14:12:05 -08001318 mClientUid,
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001319 &status);
Glenn Kasten138d6f92015-03-20 10:54:51 -07001320 ALOGE_IF(originalSessionId != AUDIO_SESSION_ALLOCATE && mSessionId != originalSessionId,
1321 "session ID changed from %d to %d", originalSessionId, mSessionId);
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001322
Glenn Kastenc08d20b2014-02-24 15:21:10 -08001323 if (status != NO_ERROR) {
Steve Block29357bc2012-01-06 19:20:56 +00001324 ALOGE("AudioFlinger could not create track, status: %d", status);
Glenn Kasten38e905b2014-01-13 10:21:48 -08001325 goto release;
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001326 }
Glenn Kastenc08d20b2014-02-24 15:21:10 -08001327 ALOG_ASSERT(track != 0);
1328
Glenn Kasten38e905b2014-01-13 10:21:48 -08001329 // AudioFlinger now owns the reference to the I/O handle,
1330 // so we are no longer responsible for releasing it.
1331
Glenn Kasten7fd04222016-02-02 12:38:16 -08001332 // FIXME compare to AudioRecord
Glenn Kastend2c38fc2012-11-01 14:58:02 -07001333 sp<IMemory> iMem = track->getCblk();
1334 if (iMem == 0) {
Steve Block29357bc2012-01-06 19:20:56 +00001335 ALOGE("Could not get control block");
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001336 return NO_INIT;
1337 }
Glenn Kasten0cde0762014-01-16 15:06:36 -08001338 void *iMemPointer = iMem->pointer();
1339 if (iMemPointer == NULL) {
1340 ALOGE("Could not get control block pointer");
1341 return NO_INIT;
1342 }
Glenn Kasten53cec222013-08-29 09:01:02 -07001343 // invariant that mAudioTrack != 0 is true only after set() returns successfully
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001344 if (mAudioTrack != 0) {
Marco Nelissenf8880202014-11-14 07:58:25 -08001345 IInterface::asBinder(mAudioTrack)->unlinkToDeath(mDeathNotifier, this);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001346 mDeathNotifier.clear();
1347 }
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001348 mAudioTrack = track;
Glenn Kastend2c38fc2012-11-01 14:58:02 -07001349 mCblkMemory = iMem;
Eric Laurent3bcffa12014-06-12 18:38:45 -07001350 IPCThreadState::self()->flushCommands();
1351
Glenn Kasten0cde0762014-01-16 15:06:36 -08001352 audio_track_cblk_t* cblk = static_cast<audio_track_cblk_t*>(iMemPointer);
Glenn Kastend2c38fc2012-11-01 14:58:02 -07001353 mCblk = cblk;
Glenn Kasten74935e42013-12-19 08:56:45 -08001354 // note that temp is the (possibly revised) value of frameCount
Glenn Kastenb6037442012-11-14 13:42:25 -08001355 if (temp < frameCount || (frameCount == 0 && temp == 0)) {
1356 // In current design, AudioTrack client checks and ensures frame count validity before
1357 // passing it to AudioFlinger so AudioFlinger should not return a different value except
1358 // for fast track as it uses a special method of assigning frame count.
Mark Salyzyn34fb2962014-06-18 16:30:56 -07001359 ALOGW("Requested frameCount %zu but received frameCount %zu", frameCount, temp);
Glenn Kastenb6037442012-11-14 13:42:25 -08001360 }
1361 frameCount = temp;
Glenn Kasten5f631512014-02-24 15:16:07 -08001362
Glenn Kastena07f17c2013-04-23 12:39:37 -07001363 mAwaitBoost = false;
Glenn Kasten363fb752014-01-15 12:27:31 -08001364 if (mFlags & AUDIO_OUTPUT_FLAG_FAST) {
Glenn Kastene0b07172012-11-06 15:03:34 -08001365 if (trackFlags & IAudioFlinger::TRACK_FAST) {
Mark Salyzyn34fb2962014-06-18 16:30:56 -07001366 ALOGV("AUDIO_OUTPUT_FLAG_FAST successful; frameCount %zu", frameCount);
Phil Burk33ff89b2015-11-30 11:16:01 -08001367 if (!mThreadCanCallJava) {
1368 mAwaitBoost = true;
1369 }
Glenn Kasten3acbd052012-02-28 10:39:56 -08001370 } else {
Haynes Mathew Georgeae34ed22016-01-28 11:58:39 -08001371 ALOGW("AUDIO_OUTPUT_FLAG_FAST denied by server; frameCount %zu", frameCount);
Glenn Kasten363fb752014-01-15 12:27:31 -08001372 mFlags = (audio_output_flags_t) (mFlags & ~AUDIO_OUTPUT_FLAG_FAST);
Glenn Kastene0fa4672012-04-24 14:35:14 -07001373 }
Glenn Kasten3acbd052012-02-28 10:39:56 -08001374 }
Glenn Kasten7fd04222016-02-02 12:38:16 -08001375
1376 // Make sure that application is notified with sufficient margin before underrun.
1377 // The client's AudioTrack buffer is divided into n parts for purpose of wakeup by server, where
1378 // n = 1 fast track with single buffering; nBuffering is ignored
1379 // n = 2 fast track with double buffering
1380 // n = 2 normal track, (including those with sample rate conversion)
1381 // n >= 3 very high latency or very small notification interval (unused).
1382 // FIXME Move the computation from client side to server side,
1383 // and allow nBuffering to be larger than 1 for OpenSL ES, like it can be for Java.
Andy Hung0e48d252015-01-26 11:43:15 -08001384 if (mSharedBuffer == 0 && audio_is_linear_pcm(mFormat)) {
Glenn Kasten7fd04222016-02-02 12:38:16 -08001385 size_t maxNotificationFrames = frameCount;
1386 if (!(trackFlags & IAudioFlinger::TRACK_FAST)) {
1387 const uint32_t nBuffering = 2;
1388 maxNotificationFrames /= nBuffering;
1389 }
1390 if (mNotificationFramesAct == 0 || mNotificationFramesAct > maxNotificationFrames) {
1391 ALOGW("Client adjusted notificationFrames from %u to %zu for frameCount %zu",
1392 mNotificationFramesAct, maxNotificationFrames, frameCount);
1393 mNotificationFramesAct = (uint32_t) maxNotificationFrames;
Andy Hung0e48d252015-01-26 11:43:15 -08001394 }
1395 }
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001396
Glenn Kasten38e905b2014-01-13 10:21:48 -08001397 // We retain a copy of the I/O handle, but don't own the reference
1398 mOutput = output;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001399 mRefreshRemaining = true;
1400
1401 // Starting address of buffers in shared memory. If there is a shared buffer, buffers
1402 // is the value of pointer() for the shared buffer, otherwise buffers points
1403 // immediately after the control block. This address is for the mapping within client
1404 // address space. AudioFlinger::TrackBase::mBuffer is for the server address space.
1405 void* buffers;
Glenn Kasten363fb752014-01-15 12:27:31 -08001406 if (mSharedBuffer == 0) {
Glenn Kasten138d6f92015-03-20 10:54:51 -07001407 buffers = cblk + 1;
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001408 } else {
Glenn Kasten363fb752014-01-15 12:27:31 -08001409 buffers = mSharedBuffer->pointer();
Glenn Kasten138d6f92015-03-20 10:54:51 -07001410 if (buffers == NULL) {
1411 ALOGE("Could not get buffer pointer");
1412 return NO_INIT;
1413 }
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001414 }
1415
Eric Laurent2beeb502010-07-16 07:43:46 -07001416 mAudioTrack->attachAuxEffect(mAuxEffectId);
Andy Hung8edb8dc2015-03-26 19:13:55 -07001417 // FIXME doesn't take into account speed or future sample rate changes (until restoreTrack)
Glenn Kastene0fa4672012-04-24 14:35:14 -07001418 // FIXME don't believe this lie
Andy Hung9f9e21e2015-05-31 21:45:36 -07001419 mLatency = mAfLatency + (1000*frameCount) / mSampleRate;
Glenn Kasten5f631512014-02-24 15:16:07 -08001420
Glenn Kastenb6037442012-11-14 13:42:25 -08001421 mFrameCount = frameCount;
Glenn Kasten093000f2012-05-03 09:35:36 -07001422 // If IAudioTrack is re-created, don't let the requested frameCount
1423 // decrease. This can confuse clients that cache frameCount().
Glenn Kastenb6037442012-11-14 13:42:25 -08001424 if (frameCount > mReqFrameCount) {
1425 mReqFrameCount = frameCount;
Glenn Kasten093000f2012-05-03 09:35:36 -07001426 }
Glenn Kastene3aa6592012-12-04 12:22:46 -08001427
Andy Hungd7bd69e2015-07-24 07:52:41 -07001428 // reset server position to 0 as we have new cblk.
1429 mServer = 0;
1430
Glenn Kastene3aa6592012-12-04 12:22:46 -08001431 // update proxy
Glenn Kasten363fb752014-01-15 12:27:31 -08001432 if (mSharedBuffer == 0) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001433 mStaticProxy.clear();
Andy Hungabdb9902015-01-12 15:08:22 -08001434 mProxy = new AudioTrackClientProxy(cblk, buffers, frameCount, mFrameSize);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001435 } else {
Andy Hungabdb9902015-01-12 15:08:22 -08001436 mStaticProxy = new StaticAudioTrackClientProxy(cblk, buffers, frameCount, mFrameSize);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001437 mProxy = mStaticProxy;
1438 }
seunghak.hane6a9d6582014-11-22 15:22:35 +09001439
1440 mProxy->setVolumeLR(gain_minifloat_pack(
1441 gain_from_float(mVolume[AUDIO_INTERLEAVE_LEFT]),
1442 gain_from_float(mVolume[AUDIO_INTERLEAVE_RIGHT])));
1443
Glenn Kastene3aa6592012-12-04 12:22:46 -08001444 mProxy->setSendLevel(mSendLevel);
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -07001445 const uint32_t effectiveSampleRate = adjustSampleRate(mSampleRate, mPlaybackRate.mPitch);
1446 const float effectiveSpeed = adjustSpeed(mPlaybackRate.mSpeed, mPlaybackRate.mPitch);
1447 const float effectivePitch = adjustPitch(mPlaybackRate.mPitch);
Andy Hung26145642015-04-15 21:56:53 -07001448 mProxy->setSampleRate(effectiveSampleRate);
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -07001449
1450 AudioPlaybackRate playbackRateTemp = mPlaybackRate;
1451 playbackRateTemp.mSpeed = effectiveSpeed;
1452 playbackRateTemp.mPitch = effectivePitch;
1453 mProxy->setPlaybackRate(playbackRateTemp);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001454 mProxy->setMinimum(mNotificationFramesAct);
1455
1456 mDeathNotifier = new DeathNotifier(this);
Marco Nelissenf8880202014-11-14 07:58:25 -08001457 IInterface::asBinder(mAudioTrack)->linkToDeath(mDeathNotifier, this);
Glenn Kastene3aa6592012-12-04 12:22:46 -08001458
Eric Laurent296fb132015-05-01 11:38:42 -07001459 if (mDeviceCallback != 0) {
1460 AudioSystem::addAudioDeviceCallback(mDeviceCallback, mOutput);
1461 }
1462
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001463 return NO_ERROR;
Glenn Kasten38e905b2014-01-13 10:21:48 -08001464 }
1465
1466release:
Glenn Kastend848eb42016-03-08 13:42:11 -08001467 AudioSystem::releaseOutput(output, streamType, mSessionId);
Glenn Kasten38e905b2014-01-13 10:21:48 -08001468 if (status == NO_ERROR) {
1469 status = NO_INIT;
1470 }
1471 return status;
Eric Laurent34f1d8e2009-11-04 08:27:26 -08001472}
1473
Glenn Kastenb46f3942015-03-09 12:00:30 -07001474status_t AudioTrack::obtainBuffer(Buffer* audioBuffer, int32_t waitCount, size_t *nonContig)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001475{
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001476 if (audioBuffer == NULL) {
Glenn Kasten551b5352015-03-20 11:30:28 -07001477 if (nonContig != NULL) {
1478 *nonContig = 0;
1479 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001480 return BAD_VALUE;
Eric Laurent9b7d9502011-03-21 11:49:00 -07001481 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001482 if (mTransfer != TRANSFER_OBTAIN) {
1483 audioBuffer->frameCount = 0;
1484 audioBuffer->size = 0;
1485 audioBuffer->raw = NULL;
Glenn Kasten551b5352015-03-20 11:30:28 -07001486 if (nonContig != NULL) {
1487 *nonContig = 0;
1488 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001489 return INVALID_OPERATION;
1490 }
Eric Laurent9b7d9502011-03-21 11:49:00 -07001491
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001492 const struct timespec *requested;
Eric Laurentdf576992014-01-27 18:13:39 -08001493 struct timespec timeout;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001494 if (waitCount == -1) {
1495 requested = &ClientProxy::kForever;
1496 } else if (waitCount == 0) {
1497 requested = &ClientProxy::kNonBlocking;
1498 } else if (waitCount > 0) {
1499 long long ms = WAIT_PERIOD_MS * (long long) waitCount;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001500 timeout.tv_sec = ms / 1000;
1501 timeout.tv_nsec = (int) (ms % 1000) * 1000000;
1502 requested = &timeout;
1503 } else {
1504 ALOGE("%s invalid waitCount %d", __func__, waitCount);
1505 requested = NULL;
1506 }
Glenn Kastenb46f3942015-03-09 12:00:30 -07001507 return obtainBuffer(audioBuffer, requested, NULL /*elapsed*/, nonContig);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001508}
Eric Laurent1703cdf2011-03-07 14:52:59 -08001509
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001510status_t AudioTrack::obtainBuffer(Buffer* audioBuffer, const struct timespec *requested,
1511 struct timespec *elapsed, size_t *nonContig)
1512{
1513 // previous and new IAudioTrack sequence numbers are used to detect track re-creation
1514 uint32_t oldSequence = 0;
1515 uint32_t newSequence;
1516
1517 Proxy::Buffer buffer;
1518 status_t status = NO_ERROR;
1519
1520 static const int32_t kMaxTries = 5;
1521 int32_t tryCounter = kMaxTries;
1522
1523 do {
1524 // obtainBuffer() is called with mutex unlocked, so keep extra references to these fields to
1525 // keep them from going away if another thread re-creates the track during obtainBuffer()
1526 sp<AudioTrackClientProxy> proxy;
1527 sp<IMemory> iMem;
1528
1529 { // start of lock scope
1530 AutoMutex lock(mLock);
1531
1532 newSequence = mSequence;
1533 // did previous obtainBuffer() fail due to media server death or voluntary invalidation?
1534 if (status == DEAD_OBJECT) {
1535 // re-create track, unless someone else has already done so
1536 if (newSequence == oldSequence) {
1537 status = restoreTrack_l("obtainBuffer");
1538 if (status != NO_ERROR) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001539 buffer.mFrameCount = 0;
1540 buffer.mRaw = NULL;
1541 buffer.mNonContig = 0;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001542 break;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001543 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001544 }
1545 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001546 oldSequence = newSequence;
1547
Eric Laurent4d231dc2016-03-11 18:38:23 -08001548 if (status == NOT_ENOUGH_DATA) {
1549 restartIfDisabled();
1550 }
1551
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001552 // Keep the extra references
1553 proxy = mProxy;
1554 iMem = mCblkMemory;
1555
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001556 if (mState == STATE_STOPPING) {
1557 status = -EINTR;
1558 buffer.mFrameCount = 0;
1559 buffer.mRaw = NULL;
1560 buffer.mNonContig = 0;
1561 break;
1562 }
1563
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001564 // Non-blocking if track is stopped or paused
1565 if (mState != STATE_ACTIVE) {
1566 requested = &ClientProxy::kNonBlocking;
1567 }
1568
1569 } // end of lock scope
1570
1571 buffer.mFrameCount = audioBuffer->frameCount;
1572 // FIXME starts the requested timeout and elapsed over from scratch
1573 status = proxy->obtainBuffer(&buffer, requested, elapsed);
Eric Laurent4d231dc2016-03-11 18:38:23 -08001574 } while (((status == DEAD_OBJECT) || (status == NOT_ENOUGH_DATA)) && (tryCounter-- > 0));
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001575
1576 audioBuffer->frameCount = buffer.mFrameCount;
Andy Hungabdb9902015-01-12 15:08:22 -08001577 audioBuffer->size = buffer.mFrameCount * mFrameSize;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001578 audioBuffer->raw = buffer.mRaw;
1579 if (nonContig != NULL) {
1580 *nonContig = buffer.mNonContig;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001581 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001582 return status;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001583}
1584
Glenn Kasten54a8a452015-03-09 12:03:00 -07001585void AudioTrack::releaseBuffer(const Buffer* audioBuffer)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001586{
Glenn Kasten3f02be22015-03-09 11:59:04 -07001587 // FIXME add error checking on mode, by adding an internal version
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001588 if (mTransfer == TRANSFER_SHARED) {
1589 return;
1590 }
1591
Andy Hungabdb9902015-01-12 15:08:22 -08001592 size_t stepCount = audioBuffer->size / mFrameSize;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001593 if (stepCount == 0) {
1594 return;
1595 }
1596
1597 Proxy::Buffer buffer;
1598 buffer.mFrameCount = stepCount;
1599 buffer.mRaw = audioBuffer->raw;
Glenn Kastene3aa6592012-12-04 12:22:46 -08001600
Eric Laurent1703cdf2011-03-07 14:52:59 -08001601 AutoMutex lock(mLock);
Glenn Kasten200092b2014-08-15 15:13:30 -07001602 mReleased += stepCount;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001603 mInUnderrun = false;
1604 mProxy->releaseBuffer(&buffer);
1605
1606 // restart track if it was disabled by audioflinger due to previous underrun
Eric Laurent4d231dc2016-03-11 18:38:23 -08001607 restartIfDisabled();
1608}
1609
1610void AudioTrack::restartIfDisabled()
1611{
1612 int32_t flags = android_atomic_and(~CBLK_DISABLED, &mCblk->mFlags);
1613 if ((mState == STATE_ACTIVE) && (flags & CBLK_DISABLED)) {
1614 ALOGW("releaseBuffer() track %p disabled due to previous underrun, restarting", this);
1615 // FIXME ignoring status
1616 mAudioTrack->start();
Eric Laurentdf839842012-05-31 14:27:14 -07001617 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001618}
1619
1620// -------------------------------------------------------------------------
1621
Jean-Michel Trivi720ad9d2014-02-04 11:00:59 -08001622ssize_t AudioTrack::write(const void* buffer, size_t userSize, bool blocking)
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001623{
Glenn Kastend79072e2016-01-06 08:41:20 -08001624 if (mTransfer != TRANSFER_SYNC) {
Glenn Kastend65d73c2012-06-22 17:21:07 -07001625 return INVALID_OPERATION;
1626 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001627
Eric Laurentab5cdba2014-06-09 17:22:27 -07001628 if (isDirect()) {
1629 AutoMutex lock(mLock);
1630 int32_t flags = android_atomic_and(
1631 ~(CBLK_UNDERRUN | CBLK_LOOP_CYCLE | CBLK_LOOP_FINAL | CBLK_BUFFER_END),
1632 &mCblk->mFlags);
1633 if (flags & CBLK_INVALID) {
1634 return DEAD_OBJECT;
1635 }
1636 }
1637
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001638 if (ssize_t(userSize) < 0 || (buffer == NULL && userSize != 0)) {
Glenn Kasten99e53b82012-01-19 08:59:58 -08001639 // Sanity-check: user is most-likely passing an error code, and it would
1640 // make the return value ambiguous (actualSize vs error).
Kévin PETIT377b2ec2014-02-03 12:35:36 +00001641 ALOGE("AudioTrack::write(buffer=%p, size=%zu (%zd)", buffer, userSize, userSize);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001642 return BAD_VALUE;
1643 }
1644
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001645 size_t written = 0;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001646 Buffer audioBuffer;
1647
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001648 while (userSize >= mFrameSize) {
1649 audioBuffer.frameCount = userSize / mFrameSize;
Eric Laurentc2f1f072009-07-17 12:17:14 -07001650
Jean-Michel Trivi720ad9d2014-02-04 11:00:59 -08001651 status_t err = obtainBuffer(&audioBuffer,
1652 blocking ? &ClientProxy::kForever : &ClientProxy::kNonBlocking);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001653 if (err < 0) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001654 if (written > 0) {
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001655 break;
Glenn Kastend65d73c2012-06-22 17:21:07 -07001656 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001657 return ssize_t(err);
1658 }
1659
Glenn Kastenae4b8792015-03-20 09:04:21 -07001660 size_t toWrite = audioBuffer.size;
Andy Hungabdb9902015-01-12 15:08:22 -08001661 memcpy(audioBuffer.i8, buffer, toWrite);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001662 buffer = ((const char *) buffer) + toWrite;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001663 userSize -= toWrite;
1664 written += toWrite;
1665
1666 releaseBuffer(&audioBuffer);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001667 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001668
Andy Hungea2b9c02016-02-12 17:06:53 -08001669 if (written > 0) {
1670 mFramesWritten += written / mFrameSize;
1671 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001672 return written;
1673}
1674
1675// -------------------------------------------------------------------------
1676
Glenn Kasten7c7be1e2013-12-19 16:34:04 -08001677nsecs_t AudioTrack::processAudioBuffer()
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001678{
Glenn Kastenfb1fdc92013-07-10 17:03:19 -07001679 // Currently the AudioTrack thread is not created if there are no callbacks.
1680 // Would it ever make sense to run the thread, even without callbacks?
1681 // If so, then replace this by checks at each use for mCbf != NULL.
1682 LOG_ALWAYS_FATAL_IF(mCblk == NULL);
1683
Eric Laurent1703cdf2011-03-07 14:52:59 -08001684 mLock.lock();
Glenn Kastena07f17c2013-04-23 12:39:37 -07001685 if (mAwaitBoost) {
1686 mAwaitBoost = false;
1687 mLock.unlock();
1688 static const int32_t kMaxTries = 5;
1689 int32_t tryCounter = kMaxTries;
1690 uint32_t pollUs = 10000;
1691 do {
1692 int policy = sched_getscheduler(0);
1693 if (policy == SCHED_FIFO || policy == SCHED_RR) {
1694 break;
1695 }
1696 usleep(pollUs);
1697 pollUs <<= 1;
1698 } while (tryCounter-- > 0);
1699 if (tryCounter < 0) {
1700 ALOGE("did not receive expected priority boost on time");
1701 }
Glenn Kastenb0dfd462013-07-10 16:52:47 -07001702 // Run again immediately
1703 return 0;
Glenn Kastena07f17c2013-04-23 12:39:37 -07001704 }
Eric Laurent1703cdf2011-03-07 14:52:59 -08001705
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001706 // Can only reference mCblk while locked
1707 int32_t flags = android_atomic_and(
Glenn Kasten96f60d82013-07-12 10:21:18 -07001708 ~(CBLK_UNDERRUN | CBLK_LOOP_CYCLE | CBLK_LOOP_FINAL | CBLK_BUFFER_END), &mCblk->mFlags);
Glenn Kastena47f3162012-11-07 10:13:08 -08001709
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001710 // Check for track invalidation
1711 if (flags & CBLK_INVALID) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001712 // for offloaded tracks restoreTrack_l() will just update the sequence and clear
1713 // AudioSystem cache. We should not exit here but after calling the callback so
1714 // that the upper layers can recreate the track
Eric Laurentab5cdba2014-06-09 17:22:27 -07001715 if (!isOffloadedOrDirect_l() || (mSequence == mObservedSequence)) {
Lajos Molnarf1063e22015-04-17 15:19:42 -07001716 status_t status __unused = restoreTrack_l("processAudioBuffer");
1717 // FIXME unused status
Andy Hung53c3b5f2014-12-15 16:42:05 -08001718 // after restoration, continue below to make sure that the loop and buffer events
1719 // are notified because they have been cleared from mCblk->mFlags above.
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001720 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001721 }
1722
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001723 bool waitStreamEnd = mState == STATE_STOPPING;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001724 bool active = mState == STATE_ACTIVE;
1725
1726 // Manage underrun callback, must be done under lock to avoid race with releaseBuffer()
1727 bool newUnderrun = false;
1728 if (flags & CBLK_UNDERRUN) {
1729#if 0
1730 // Currently in shared buffer mode, when the server reaches the end of buffer,
1731 // the track stays active in continuous underrun state. It's up to the application
1732 // to pause or stop the track, or set the position to a new offset within buffer.
1733 // This was some experimental code to auto-pause on underrun. Keeping it here
1734 // in "if 0" so we can re-visit this if we add a real sequencer for shared memory content.
1735 if (mTransfer == TRANSFER_SHARED) {
1736 mState = STATE_PAUSED;
1737 active = false;
1738 }
1739#endif
1740 if (!mInUnderrun) {
1741 mInUnderrun = true;
1742 newUnderrun = true;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001743 }
1744 }
Eric Laurentc2f1f072009-07-17 12:17:14 -07001745
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001746 // Get current position of server
Andy Hung90e8a972015-11-09 16:42:40 -08001747 Modulo<uint32_t> position(updateAndGetPosition_l());
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001748
1749 // Manage marker callback
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001750 bool markerReached = false;
Andy Hung90e8a972015-11-09 16:42:40 -08001751 Modulo<uint32_t> markerPosition(mMarkerPosition);
1752 // uses 32 bit wraparound for comparison with position.
1753 if (!mMarkerReached && markerPosition.value() > 0 && position >= markerPosition) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001754 mMarkerReached = markerReached = true;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001755 }
1756
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001757 // Determine number of new position callback(s) that will be needed, while locked
1758 size_t newPosCount = 0;
Andy Hung90e8a972015-11-09 16:42:40 -08001759 Modulo<uint32_t> newPosition(mNewPosition);
1760 uint32_t updatePeriod = mUpdatePeriod;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001761 // FIXME fails for wraparound, need 64 bits
1762 if (updatePeriod > 0 && position >= newPosition) {
Andy Hung90e8a972015-11-09 16:42:40 -08001763 newPosCount = ((position - newPosition).value() / updatePeriod) + 1;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001764 mNewPosition += updatePeriod * newPosCount;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001765 }
1766
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001767 // Cache other fields that will be needed soon
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001768 uint32_t sampleRate = mSampleRate;
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -07001769 float speed = mPlaybackRate.mSpeed;
Andy Hunga7f03352015-05-31 21:54:49 -07001770 const uint32_t notificationFrames = mNotificationFramesAct;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001771 if (mRefreshRemaining) {
1772 mRefreshRemaining = false;
1773 mRemainingFrames = notificationFrames;
1774 mRetryOnPartialBuffer = false;
1775 }
1776 size_t misalignment = mProxy->getMisalignment();
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001777 uint32_t sequence = mSequence;
Glenn Kasten96f04882013-09-20 09:28:56 -07001778 sp<AudioTrackClientProxy> proxy = mProxy;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001779
Andy Hung53c3b5f2014-12-15 16:42:05 -08001780 // Determine the number of new loop callback(s) that will be needed, while locked.
1781 int loopCountNotifications = 0;
1782 uint32_t loopPeriod = 0; // time in frames for next EVENT_LOOP_END or EVENT_BUFFER_END
1783
1784 if (mLoopCount > 0) {
1785 int loopCount;
1786 size_t bufferPosition;
1787 mStaticProxy->getBufferPositionAndLoopCount(&bufferPosition, &loopCount);
1788 loopPeriod = ((loopCount > 0) ? mLoopEnd : mFrameCount) - bufferPosition;
1789 loopCountNotifications = min(mLoopCountNotified - loopCount, kMaxLoopCountNotifications);
1790 mLoopCountNotified = loopCount; // discard any excess notifications
1791 } else if (mLoopCount < 0) {
1792 // FIXME: We're not accurate with notification count and position with infinite looping
1793 // since loopCount from server side will always return -1 (we could decrement it).
1794 size_t bufferPosition = mStaticProxy->getBufferPosition();
1795 loopCountNotifications = int((flags & (CBLK_LOOP_CYCLE | CBLK_LOOP_FINAL)) != 0);
1796 loopPeriod = mLoopEnd - bufferPosition;
1797 } else if (/* mLoopCount == 0 && */ mSharedBuffer != 0) {
1798 size_t bufferPosition = mStaticProxy->getBufferPosition();
1799 loopPeriod = mFrameCount - bufferPosition;
1800 }
1801
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001802 // These fields don't need to be cached, because they are assigned only by set():
Andy Hungabdb9902015-01-12 15:08:22 -08001803 // mTransfer, mCbf, mUserData, mFormat, mFrameSize, mFlags
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001804 // mFlags is also assigned by createTrack_l(), but not the bit we care about.
1805
1806 mLock.unlock();
1807
Andy Hunga7f03352015-05-31 21:54:49 -07001808 // get anchor time to account for callbacks.
1809 const nsecs_t timeBeforeCallbacks = systemTime();
1810
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001811 if (waitStreamEnd) {
Andy Hunga7f03352015-05-31 21:54:49 -07001812 // FIXME: Instead of blocking in proxy->waitStreamEndDone(), Callback thread
1813 // should wait on proxy futex and handle CBLK_STREAM_END_DONE within this function
1814 // (and make sure we don't callback for more data while we're stopping).
1815 // This helps with position, marker notifications, and track invalidation.
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001816 struct timespec timeout;
1817 timeout.tv_sec = WAIT_STREAM_END_TIMEOUT_SEC;
1818 timeout.tv_nsec = 0;
1819
Glenn Kasten96f04882013-09-20 09:28:56 -07001820 status_t status = proxy->waitStreamEndDone(&timeout);
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001821 switch (status) {
1822 case NO_ERROR:
1823 case DEAD_OBJECT:
1824 case TIMED_OUT:
Andy Hung39609a02015-09-03 16:38:38 -07001825 if (status != DEAD_OBJECT) {
1826 // for DEAD_OBJECT, we do not send a EVENT_STREAM_END after stop();
1827 // instead, the application should handle the EVENT_NEW_IAUDIOTRACK.
1828 mCbf(EVENT_STREAM_END, mUserData, NULL);
1829 }
Glenn Kasten96f04882013-09-20 09:28:56 -07001830 {
1831 AutoMutex lock(mLock);
1832 // The previously assigned value of waitStreamEnd is no longer valid,
1833 // since the mutex has been unlocked and either the callback handler
1834 // or another thread could have re-started the AudioTrack during that time.
1835 waitStreamEnd = mState == STATE_STOPPING;
1836 if (waitStreamEnd) {
1837 mState = STATE_STOPPED;
Andy Hungc2813e52014-10-16 17:54:34 -07001838 mReleased = 0;
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001839 }
1840 }
Glenn Kasten96f04882013-09-20 09:28:56 -07001841 if (waitStreamEnd && status != DEAD_OBJECT) {
1842 return NS_INACTIVE;
1843 }
1844 break;
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001845 }
Glenn Kasten96f04882013-09-20 09:28:56 -07001846 return 0;
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001847 }
1848
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001849 // perform callbacks while unlocked
1850 if (newUnderrun) {
1851 mCbf(EVENT_UNDERRUN, mUserData, NULL);
1852 }
Andy Hung53c3b5f2014-12-15 16:42:05 -08001853 while (loopCountNotifications > 0) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001854 mCbf(EVENT_LOOP_END, mUserData, NULL);
Andy Hung53c3b5f2014-12-15 16:42:05 -08001855 --loopCountNotifications;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001856 }
1857 if (flags & CBLK_BUFFER_END) {
1858 mCbf(EVENT_BUFFER_END, mUserData, NULL);
1859 }
1860 if (markerReached) {
1861 mCbf(EVENT_MARKER, mUserData, &markerPosition);
1862 }
1863 while (newPosCount > 0) {
Andy Hung90e8a972015-11-09 16:42:40 -08001864 size_t temp = newPosition.value(); // FIXME size_t != uint32_t
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001865 mCbf(EVENT_NEW_POS, mUserData, &temp);
1866 newPosition += updatePeriod;
1867 newPosCount--;
1868 }
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001869
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001870 if (mObservedSequence != sequence) {
1871 mObservedSequence = sequence;
1872 mCbf(EVENT_NEW_IAUDIOTRACK, mUserData, NULL);
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001873 // for offloaded tracks, just wait for the upper layers to recreate the track
Eric Laurentab5cdba2014-06-09 17:22:27 -07001874 if (isOffloadedOrDirect()) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001875 return NS_INACTIVE;
1876 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001877 }
1878
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001879 // if inactive, then don't run me again until re-started
1880 if (!active) {
1881 return NS_INACTIVE;
Eric Laurent2267ba12011-09-07 11:13:23 -07001882 }
1883
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001884 // Compute the estimated time until the next timed event (position, markers, loops)
1885 // FIXME only for non-compressed audio
1886 uint32_t minFrames = ~0;
1887 if (!markerReached && position < markerPosition) {
Andy Hung90e8a972015-11-09 16:42:40 -08001888 minFrames = (markerPosition - position).value();
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001889 }
1890 if (loopPeriod > 0 && loopPeriod < minFrames) {
Andy Hung2d85f092015-01-07 12:45:13 -08001891 // loopPeriod is already adjusted for actual position.
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001892 minFrames = loopPeriod;
1893 }
Andy Hung2d85f092015-01-07 12:45:13 -08001894 if (updatePeriod > 0) {
Andy Hung90e8a972015-11-09 16:42:40 -08001895 minFrames = min(minFrames, (newPosition - position).value());
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001896 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001897
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001898 // If > 0, poll periodically to recover from a stuck server. A good value is 2.
1899 static const uint32_t kPoll = 0;
1900 if (kPoll > 0 && mTransfer == TRANSFER_CALLBACK && kPoll * notificationFrames < minFrames) {
1901 minFrames = kPoll * notificationFrames;
1902 }
Eric Laurentc2f1f072009-07-17 12:17:14 -07001903
Andy Hunga7f03352015-05-31 21:54:49 -07001904 // This "fudge factor" avoids soaking CPU, and compensates for late progress by server
1905 static const nsecs_t kWaitPeriodNs = WAIT_PERIOD_MS * 1000000LL;
1906 const nsecs_t timeAfterCallbacks = systemTime();
1907
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001908 // Convert frame units to time units
1909 nsecs_t ns = NS_WHENEVER;
1910 if (minFrames != (uint32_t) ~0) {
Andy Hunga7f03352015-05-31 21:54:49 -07001911 ns = framesToNanoseconds(minFrames, sampleRate, speed) + kWaitPeriodNs;
1912 ns -= (timeAfterCallbacks - timeBeforeCallbacks); // account for callback time
1913 // TODO: Should we warn if the callback time is too long?
1914 if (ns < 0) ns = 0;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001915 }
1916
1917 // If not supplying data by EVENT_MORE_DATA, then we're done
1918 if (mTransfer != TRANSFER_CALLBACK) {
1919 return ns;
1920 }
1921
Andy Hunga7f03352015-05-31 21:54:49 -07001922 // EVENT_MORE_DATA callback handling.
1923 // Timing for linear pcm audio data formats can be derived directly from the
1924 // buffer fill level.
1925 // Timing for compressed data is not directly available from the buffer fill level,
1926 // rather indirectly from waiting for blocking mode callbacks or waiting for obtain()
1927 // to return a certain fill level.
1928
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001929 struct timespec timeout;
1930 const struct timespec *requested = &ClientProxy::kForever;
1931 if (ns != NS_WHENEVER) {
1932 timeout.tv_sec = ns / 1000000000LL;
1933 timeout.tv_nsec = ns % 1000000000LL;
1934 ALOGV("timeout %ld.%03d", timeout.tv_sec, (int) timeout.tv_nsec / 1000000);
1935 requested = &timeout;
1936 }
1937
Andy Hungea2b9c02016-02-12 17:06:53 -08001938 size_t writtenFrames = 0;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001939 while (mRemainingFrames > 0) {
1940
1941 Buffer audioBuffer;
1942 audioBuffer.frameCount = mRemainingFrames;
1943 size_t nonContig;
1944 status_t err = obtainBuffer(&audioBuffer, requested, NULL, &nonContig);
1945 LOG_ALWAYS_FATAL_IF((err != NO_ERROR) != (audioBuffer.frameCount == 0),
Mark Salyzyn34fb2962014-06-18 16:30:56 -07001946 "obtainBuffer() err=%d frameCount=%zu", err, audioBuffer.frameCount);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001947 requested = &ClientProxy::kNonBlocking;
1948 size_t avail = audioBuffer.frameCount + nonContig;
Mark Salyzyn34fb2962014-06-18 16:30:56 -07001949 ALOGV("obtainBuffer(%u) returned %zu = %zu + %zu err %d",
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001950 mRemainingFrames, avail, audioBuffer.frameCount, nonContig, err);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001951 if (err != NO_ERROR) {
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01001952 if (err == TIMED_OUT || err == WOULD_BLOCK || err == -EINTR ||
1953 (isOffloaded() && (err == DEAD_OBJECT))) {
Glenn Kasten606fbc12015-10-22 15:28:15 -07001954 // FIXME bug 25195759
1955 return 1000000;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001956 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001957 ALOGE("Error %d obtaining an audio buffer, giving up.", err);
1958 return NS_NEVER;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001959 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001960
Phil Burkfdb3c072016-02-09 10:47:02 -08001961 if (mRetryOnPartialBuffer && audio_has_proportional_frames(mFormat)) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001962 mRetryOnPartialBuffer = false;
1963 if (avail < mRemainingFrames) {
Andy Hunga7f03352015-05-31 21:54:49 -07001964 if (ns > 0) { // account for obtain time
1965 const nsecs_t timeNow = systemTime();
1966 ns = max((nsecs_t)0, ns - (timeNow - timeAfterCallbacks));
1967 }
1968 nsecs_t myns = framesToNanoseconds(mRemainingFrames - avail, sampleRate, speed);
1969 if (ns < 0 /* NS_WHENEVER */ || myns < ns) {
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001970 ns = myns;
1971 }
1972 return ns;
1973 }
Glenn Kastend65d73c2012-06-22 17:21:07 -07001974 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001975
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001976 size_t reqSize = audioBuffer.size;
1977 mCbf(EVENT_MORE_DATA, mUserData, &audioBuffer);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001978 size_t writtenSize = audioBuffer.size;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08001979
1980 // Sanity check on returned size
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001981 if (ssize_t(writtenSize) < 0 || writtenSize > reqSize) {
Mark Salyzyn34fb2962014-06-18 16:30:56 -07001982 ALOGE("EVENT_MORE_DATA requested %zu bytes but callback returned %zd bytes",
1983 reqSize, ssize_t(writtenSize));
Glenn Kasten9f80dd22012-12-18 15:57:32 -08001984 return NS_NEVER;
1985 }
1986
1987 if (writtenSize == 0) {
The Android Open Source Project8555d082009-03-05 14:34:35 -08001988 // The callback is done filling buffers
1989 // Keep this thread going to handle timed events and
1990 // still try to get more data in intervals of WAIT_PERIOD_MS
1991 // but don't just loop and block the CPU, so wait
Andy Hunga7f03352015-05-31 21:54:49 -07001992
1993 // mCbf(EVENT_MORE_DATA, ...) might either
1994 // (1) Block until it can fill the buffer, returning 0 size on EOS.
1995 // (2) Block until it can fill the buffer, returning 0 data (silence) on EOS.
1996 // (3) Return 0 size when no data is available, does not wait for more data.
1997 //
1998 // (1) and (2) occurs with AudioPlayer/AwesomePlayer; (3) occurs with NuPlayer.
1999 // We try to compute the wait time to avoid a tight sleep-wait cycle,
2000 // especially for case (3).
2001 //
2002 // The decision to support (1) and (2) affect the sizing of mRemainingFrames
2003 // and this loop; whereas for case (3) we could simply check once with the full
2004 // buffer size and skip the loop entirely.
2005
2006 nsecs_t myns;
Phil Burkfdb3c072016-02-09 10:47:02 -08002007 if (audio_has_proportional_frames(mFormat)) {
Andy Hunga7f03352015-05-31 21:54:49 -07002008 // time to wait based on buffer occupancy
2009 const nsecs_t datans = mRemainingFrames <= avail ? 0 :
2010 framesToNanoseconds(mRemainingFrames - avail, sampleRate, speed);
2011 // audio flinger thread buffer size (TODO: adjust for fast tracks)
2012 const nsecs_t afns = framesToNanoseconds(mAfFrameCount, mAfSampleRate, speed);
2013 // add a half the AudioFlinger buffer time to avoid soaking CPU if datans is 0.
2014 myns = datans + (afns / 2);
2015 } else {
2016 // FIXME: This could ping quite a bit if the buffer isn't full.
2017 // Note that when mState is stopping we waitStreamEnd, so it never gets here.
2018 myns = kWaitPeriodNs;
2019 }
2020 if (ns > 0) { // account for obtain and callback time
2021 const nsecs_t timeNow = systemTime();
2022 ns = max((nsecs_t)0, ns - (timeNow - timeAfterCallbacks));
2023 }
2024 if (ns < 0 /* NS_WHENEVER */ || myns < ns) {
2025 ns = myns;
2026 }
2027 return ns;
Glenn Kastend65d73c2012-06-22 17:21:07 -07002028 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002029
Glenn Kasten138d6f92015-03-20 10:54:51 -07002030 size_t releasedFrames = writtenSize / mFrameSize;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002031 audioBuffer.frameCount = releasedFrames;
2032 mRemainingFrames -= releasedFrames;
2033 if (misalignment >= releasedFrames) {
2034 misalignment -= releasedFrames;
2035 } else {
2036 misalignment = 0;
2037 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002038
2039 releaseBuffer(&audioBuffer);
Andy Hungea2b9c02016-02-12 17:06:53 -08002040 writtenFrames += releasedFrames;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002041
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002042 // FIXME here is where we would repeat EVENT_MORE_DATA again on same advanced buffer
2043 // if callback doesn't like to accept the full chunk
2044 if (writtenSize < reqSize) {
2045 continue;
2046 }
2047
2048 // There could be enough non-contiguous frames available to satisfy the remaining request
2049 if (mRemainingFrames <= nonContig) {
2050 continue;
2051 }
2052
2053#if 0
2054 // This heuristic tries to collapse a series of EVENT_MORE_DATA that would total to a
2055 // sum <= notificationFrames. It replaces that series by at most two EVENT_MORE_DATA
2056 // that total to a sum == notificationFrames.
2057 if (0 < misalignment && misalignment <= mRemainingFrames) {
2058 mRemainingFrames = misalignment;
Andy Hung8edb8dc2015-03-26 19:13:55 -07002059 return ((double)mRemainingFrames * 1100000000) / ((double)sampleRate * speed);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002060 }
2061#endif
2062
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002063 }
Andy Hungea2b9c02016-02-12 17:06:53 -08002064 if (writtenFrames > 0) {
2065 AutoMutex lock(mLock);
2066 mFramesWritten += writtenFrames;
2067 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002068 mRemainingFrames = notificationFrames;
2069 mRetryOnPartialBuffer = true;
2070
2071 // A lot has transpired since ns was calculated, so run again immediately and re-calculate
2072 return 0;
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002073}
2074
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002075status_t AudioTrack::restoreTrack_l(const char *from)
Eric Laurent1703cdf2011-03-07 14:52:59 -08002076{
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01002077 ALOGW("dead IAudioTrack, %s, creating a new one from %s()",
Eric Laurentab5cdba2014-06-09 17:22:27 -07002078 isOffloadedOrDirect_l() ? "Offloaded or Direct" : "PCM", from);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002079 ++mSequence;
Eric Laurent1703cdf2011-03-07 14:52:59 -08002080
Glenn Kastena47f3162012-11-07 10:13:08 -08002081 // refresh the audio configuration cache in this process to make sure we get new
Glenn Kastend2d089f2014-11-05 11:48:12 -08002082 // output parameters and new IAudioFlinger in createTrack_l()
Glenn Kastena47f3162012-11-07 10:13:08 -08002083 AudioSystem::clearAudioConfigCache();
Eric Laurent9f6530f2011-08-30 10:18:54 -07002084
Ronghua Wufaeb0f22015-05-21 12:20:21 -07002085 if (isOffloadedOrDirect_l() || mDoNotReconnect) {
Andy Hung1f1db832015-06-08 13:26:10 -07002086 // FIXME re-creation of offloaded and direct tracks is not yet implemented;
2087 // reconsider enabling for linear PCM encodings when position can be preserved.
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01002088 return DEAD_OBJECT;
2089 }
2090
Phil Burk2812d9e2016-01-04 10:34:30 -08002091 // Save so we can return count since creation.
2092 mUnderrunCountOffset = getUnderrunCount_l();
2093
Glenn Kasten200092b2014-08-15 15:13:30 -07002094 // save the old static buffer position
Andy Hung4ede21d2014-12-12 15:37:34 -08002095 size_t bufferPosition = 0;
2096 int loopCount = 0;
2097 if (mStaticProxy != 0) {
2098 mStaticProxy->getBufferPositionAndLoopCount(&bufferPosition, &loopCount);
2099 }
Glenn Kasten200092b2014-08-15 15:13:30 -07002100
Haynes Mathew Georgeae34ed22016-01-28 11:58:39 -08002101 mFlags = mOrigFlags;
2102
Glenn Kasten200092b2014-08-15 15:13:30 -07002103 // If a new IAudioTrack is successfully created, createTrack_l() will modify the
Glenn Kastena47f3162012-11-07 10:13:08 -08002104 // following member variables: mAudioTrack, mCblkMemory and mCblk.
Glenn Kasten200092b2014-08-15 15:13:30 -07002105 // It will also delete the strong references on previous IAudioTrack and IMemory.
2106 // If a new IAudioTrack cannot be created, the previous (dead) instance will be left intact.
Glenn Kastenae4b8792015-03-20 09:04:21 -07002107 status_t result = createTrack_l();
Eric Laurentcc21e4f2013-10-16 15:12:32 -07002108
Glenn Kastena47f3162012-11-07 10:13:08 -08002109 if (result == NO_ERROR) {
Andy Hungd7bd69e2015-07-24 07:52:41 -07002110 // take the frames that will be lost by track recreation into account in saved position
2111 // For streaming tracks, this is the amount we obtained from the user/client
2112 // (not the number actually consumed at the server - those are already lost).
2113 if (mStaticProxy == 0) {
2114 mPosition = mReleased;
2115 }
Andy Hung4ede21d2014-12-12 15:37:34 -08002116 // Continue playback from last known position and restore loop.
2117 if (mStaticProxy != 0) {
2118 if (loopCount != 0) {
2119 mStaticProxy->setBufferPositionAndLoop(bufferPosition,
2120 mLoopStart, mLoopEnd, loopCount);
2121 } else {
2122 mStaticProxy->setBufferPosition(bufferPosition);
Andy Hung53c3b5f2014-12-15 16:42:05 -08002123 if (bufferPosition == mFrameCount) {
2124 ALOGD("restoring track at end of static buffer");
2125 }
Eric Laurent1703cdf2011-03-07 14:52:59 -08002126 }
2127 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002128 if (mState == STATE_ACTIVE) {
Glenn Kastena47f3162012-11-07 10:13:08 -08002129 result = mAudioTrack->start();
Andy Hungea2b9c02016-02-12 17:06:53 -08002130 mFramesWrittenServerOffset = mFramesWritten; // server resets to zero so we offset
Eric Laurent1703cdf2011-03-07 14:52:59 -08002131 }
Eric Laurent1703cdf2011-03-07 14:52:59 -08002132 }
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002133 if (result != NO_ERROR) {
2134 ALOGW("restoreTrack_l() failed status %d", result);
2135 mState = STATE_STOPPED;
Andy Hungc2813e52014-10-16 17:54:34 -07002136 mReleased = 0;
Eric Laurent1703cdf2011-03-07 14:52:59 -08002137 }
Eric Laurent1703cdf2011-03-07 14:52:59 -08002138
2139 return result;
2140}
2141
Andy Hung90e8a972015-11-09 16:42:40 -08002142Modulo<uint32_t> AudioTrack::updateAndGetPosition_l()
Glenn Kasten200092b2014-08-15 15:13:30 -07002143{
2144 // This is the sole place to read server consumed frames
Andy Hung90e8a972015-11-09 16:42:40 -08002145 Modulo<uint32_t> newServer(mProxy->getPosition());
2146 const int32_t delta = (newServer - mServer).signedValue();
Glenn Kasten200092b2014-08-15 15:13:30 -07002147 // TODO There is controversy about whether there can be "negative jitter" in server position.
2148 // This should be investigated further, and if possible, it should be addressed.
2149 // A more definite failure mode is infrequent polling by client.
2150 // One could call (void)getPosition_l() in releaseBuffer(),
2151 // so mReleased and mPosition are always lock-step as best possible.
2152 // That should ensure delta never goes negative for infrequent polling
2153 // unless the server has more than 2^31 frames in its buffer,
2154 // in which case the use of uint32_t for these counters has bigger issues.
Andy Hung90e8a972015-11-09 16:42:40 -08002155 ALOGE_IF(delta < 0,
2156 "detected illegal retrograde motion by the server: mServer advanced by %d",
2157 delta);
Chad Brubaker039c27a2015-09-23 15:17:29 -07002158 mServer = newServer;
Andy Hung90e8a972015-11-09 16:42:40 -08002159 if (delta > 0) { // avoid retrograde
2160 mPosition += delta;
2161 }
2162 return mPosition;
Glenn Kasten200092b2014-08-15 15:13:30 -07002163}
2164
Andy Hung8edb8dc2015-03-26 19:13:55 -07002165bool AudioTrack::isSampleRateSpeedAllowed_l(uint32_t sampleRate, float speed) const
2166{
2167 // applicable for mixing tracks only (not offloaded or direct)
2168 if (mStaticProxy != 0) {
2169 return true; // static tracks do not have issues with buffer sizing.
2170 }
Andy Hung8edb8dc2015-03-26 19:13:55 -07002171 const size_t minFrameCount =
Andy Hung9f9e21e2015-05-31 21:45:36 -07002172 calculateMinFrameCount(mAfLatency, mAfFrameCount, mAfSampleRate, sampleRate, speed);
Andy Hung8edb8dc2015-03-26 19:13:55 -07002173 ALOGV("isSampleRateSpeedAllowed_l mFrameCount %zu minFrameCount %zu",
2174 mFrameCount, minFrameCount);
2175 return mFrameCount >= minFrameCount;
2176}
2177
Richard Fitzgeraldad3af332013-03-25 16:54:37 +00002178status_t AudioTrack::setParameters(const String8& keyValuePairs)
2179{
2180 AutoMutex lock(mLock);
Glenn Kasten53cec222013-08-29 09:01:02 -07002181 return mAudioTrack->setParameters(keyValuePairs);
Richard Fitzgeraldad3af332013-03-25 16:54:37 +00002182}
2183
Andy Hungea2b9c02016-02-12 17:06:53 -08002184status_t AudioTrack::getTimestamp(ExtendedTimestamp *timestamp)
2185{
2186 if (timestamp == nullptr) {
2187 return BAD_VALUE;
2188 }
2189 AutoMutex lock(mLock);
Andy Hunge13f8a62016-03-30 14:20:42 -07002190 return getTimestamp_l(timestamp);
2191}
2192
2193status_t AudioTrack::getTimestamp_l(ExtendedTimestamp *timestamp)
2194{
Andy Hungea2b9c02016-02-12 17:06:53 -08002195 if (mCblk->mFlags & CBLK_INVALID) {
2196 const status_t status = restoreTrack_l("getTimestampExtended");
2197 if (status != OK) {
2198 // per getTimestamp() API doc in header, we return DEAD_OBJECT here,
2199 // recommending that the track be recreated.
2200 return DEAD_OBJECT;
2201 }
2202 }
2203 // check for offloaded/direct here in case restoring somehow changed those flags.
2204 if (isOffloadedOrDirect_l()) {
2205 return INVALID_OPERATION; // not supported
2206 }
2207 status_t status = mProxy->getTimestamp(timestamp);
Andy Hunge1e98462016-04-12 10:18:51 -07002208 LOG_ALWAYS_FATAL_IF(status != OK, "status %d not allowed from proxy getTimestamp", status);
Andy Hungea2b9c02016-02-12 17:06:53 -08002209 bool found = false;
Andy Hunge1e98462016-04-12 10:18:51 -07002210 timestamp->mPosition[ExtendedTimestamp::LOCATION_CLIENT] = mFramesWritten;
2211 timestamp->mTimeNs[ExtendedTimestamp::LOCATION_CLIENT] = 0;
2212 // server side frame offset in case AudioTrack has been restored.
2213 for (int i = ExtendedTimestamp::LOCATION_SERVER;
2214 i < ExtendedTimestamp::LOCATION_MAX; ++i) {
2215 if (timestamp->mTimeNs[i] >= 0) {
2216 // apply server offset (frames flushed is ignored
2217 // so we don't report the jump when the flush occurs).
2218 timestamp->mPosition[i] += mFramesWrittenServerOffset;
2219 found = true;
Andy Hungea2b9c02016-02-12 17:06:53 -08002220 }
2221 }
2222 return found ? OK : WOULD_BLOCK;
2223}
2224
Glenn Kastence703742013-07-19 16:33:58 -07002225status_t AudioTrack::getTimestamp(AudioTimestamp& timestamp)
2226{
Glenn Kasten53cec222013-08-29 09:01:02 -07002227 AutoMutex lock(mLock);
Phil Burk1b420972015-04-22 10:52:21 -07002228
2229 bool previousTimestampValid = mPreviousTimestampValid;
2230 // Set false here to cover all the error return cases.
2231 mPreviousTimestampValid = false;
2232
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002233 switch (mState) {
2234 case STATE_ACTIVE:
2235 case STATE_PAUSED:
2236 break; // handle below
2237 case STATE_FLUSHED:
2238 case STATE_STOPPED:
2239 return WOULD_BLOCK;
2240 case STATE_STOPPING:
2241 case STATE_PAUSED_STOPPING:
2242 if (!isOffloaded_l()) {
2243 return INVALID_OPERATION;
2244 }
2245 break; // offloaded tracks handled below
2246 default:
2247 LOG_ALWAYS_FATAL("Invalid mState in getTimestamp(): %d", mState);
2248 break;
Glenn Kastenfe346c72013-08-30 13:28:22 -07002249 }
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002250
Eric Laurent275e8e92014-11-30 15:14:47 -08002251 if (mCblk->mFlags & CBLK_INVALID) {
Andy Hung6653c932015-06-08 13:27:48 -07002252 const status_t status = restoreTrack_l("getTimestamp");
2253 if (status != OK) {
2254 // per getTimestamp() API doc in header, we return DEAD_OBJECT here,
2255 // recommending that the track be recreated.
2256 return DEAD_OBJECT;
2257 }
Eric Laurent275e8e92014-11-30 15:14:47 -08002258 }
2259
Glenn Kasten200092b2014-08-15 15:13:30 -07002260 // The presented frame count must always lag behind the consumed frame count.
2261 // To avoid a race, read the presented frames first. This ensures that presented <= consumed.
Andy Hung6ae58432016-02-16 18:32:24 -08002262
2263 status_t status;
Andy Hung818e7a32016-02-16 18:08:07 -08002264 if (isOffloadedOrDirect_l()) {
Andy Hung6ae58432016-02-16 18:32:24 -08002265 // use Binder to get timestamp
2266 status = mAudioTrack->getTimestamp(timestamp);
2267 } else {
2268 // read timestamp from shared memory
2269 ExtendedTimestamp ets;
2270 status = mProxy->getTimestamp(&ets);
2271 if (status == OK) {
2272 status = ets.getBestTimestamp(&timestamp);
2273 }
2274 if (status == INVALID_OPERATION) {
2275 status = WOULD_BLOCK;
2276 }
2277 }
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002278 if (status != NO_ERROR) {
Glenn Kastendfc34da2014-09-19 09:05:05 -07002279 ALOGV_IF(status != WOULD_BLOCK, "getTimestamp error:%#x", status);
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002280 return status;
2281 }
2282 if (isOffloadedOrDirect_l()) {
2283 if (isOffloaded_l() && (mState == STATE_PAUSED || mState == STATE_PAUSED_STOPPING)) {
2284 // use cached paused position in case another offloaded track is running.
2285 timestamp.mPosition = mPausedPosition;
2286 clock_gettime(CLOCK_MONOTONIC, &timestamp.mTime);
2287 return NO_ERROR;
2288 }
2289
2290 // Check whether a pending flush or stop has completed, as those commands may
Andy Hungc8e09c62015-06-03 23:43:36 -07002291 // be asynchronous or return near finish or exhibit glitchy behavior.
2292 //
2293 // Originally this showed up as the first timestamp being a continuation of
2294 // the previous song under gapless playback.
2295 // However, we sometimes see zero timestamps, then a glitch of
2296 // the previous song's position, and then correct timestamps afterwards.
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002297 if (mStartUs != 0 && mSampleRate != 0) {
2298 static const int kTimeJitterUs = 100000; // 100 ms
2299 static const int k1SecUs = 1000000;
2300
2301 const int64_t timeNow = getNowUs();
2302
2303 if (timeNow < mStartUs + k1SecUs) { // within first second of starting
2304 const int64_t timestampTimeUs = convertTimespecToUs(timestamp.mTime);
2305 if (timestampTimeUs < mStartUs) {
2306 return WOULD_BLOCK; // stale timestamp time, occurs before start.
2307 }
2308 const int64_t deltaTimeUs = timestampTimeUs - mStartUs;
Andy Hung8edb8dc2015-03-26 19:13:55 -07002309 const int64_t deltaPositionByUs = (double)timestamp.mPosition * 1000000
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -07002310 / ((double)mSampleRate * mPlaybackRate.mSpeed);
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002311
2312 if (deltaPositionByUs > deltaTimeUs + kTimeJitterUs) {
2313 // Verify that the counter can't count faster than the sample rate
Andy Hungc8e09c62015-06-03 23:43:36 -07002314 // since the start time. If greater, then that means we may have failed
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002315 // to completely flush or stop the previous playing track.
Andy Hungc8e09c62015-06-03 23:43:36 -07002316 ALOGW_IF(!mTimestampStartupGlitchReported,
2317 "getTimestamp startup glitch detected"
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002318 " deltaTimeUs(%lld) deltaPositionUs(%lld) tsmPosition(%u)",
2319 (long long)deltaTimeUs, (long long)deltaPositionByUs,
2320 timestamp.mPosition);
Andy Hungc8e09c62015-06-03 23:43:36 -07002321 mTimestampStartupGlitchReported = true;
2322 if (previousTimestampValid
2323 && mPreviousTimestamp.mPosition == 0 /* should be true if valid */) {
2324 timestamp = mPreviousTimestamp;
2325 mPreviousTimestampValid = true;
2326 return NO_ERROR;
2327 }
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002328 return WOULD_BLOCK;
2329 }
Andy Hungc8e09c62015-06-03 23:43:36 -07002330 if (deltaPositionByUs != 0) {
2331 mStartUs = 0; // don't check again, we got valid nonzero position.
2332 }
2333 } else {
2334 mStartUs = 0; // don't check again, start time expired.
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002335 }
Andy Hungc8e09c62015-06-03 23:43:36 -07002336 mTimestampStartupGlitchReported = false;
Andy Hung7f1bc8a2014-09-12 14:43:11 -07002337 }
2338 } else {
Glenn Kasten200092b2014-08-15 15:13:30 -07002339 // Update the mapping between local consumed (mPosition) and server consumed (mServer)
2340 (void) updateAndGetPosition_l();
2341 // Server consumed (mServer) and presented both use the same server time base,
2342 // and server consumed is always >= presented.
2343 // The delta between these represents the number of frames in the buffer pipeline.
2344 // If this delta between these is greater than the client position, it means that
2345 // actually presented is still stuck at the starting line (figuratively speaking),
2346 // waiting for the first frame to go by. So we can't report a valid timestamp yet.
Andy Hung90e8a972015-11-09 16:42:40 -08002347 // Note: We explicitly use non-Modulo comparison here - potential wrap issue when
2348 // mPosition exceeds 32 bits.
2349 // TODO Remove when timestamp is updated to contain pipeline status info.
2350 const int32_t pipelineDepthInFrames = (mServer - timestamp.mPosition).signedValue();
2351 if (pipelineDepthInFrames > 0 /* should be true, but we check anyways */
2352 && (uint32_t)pipelineDepthInFrames > mPosition.value()) {
Glenn Kasten200092b2014-08-15 15:13:30 -07002353 return INVALID_OPERATION;
2354 }
2355 // Convert timestamp position from server time base to client time base.
2356 // TODO The following code should work OK now because timestamp.mPosition is 32-bit.
2357 // But if we change it to 64-bit then this could fail.
Andy Hung90e8a972015-11-09 16:42:40 -08002358 // Use Modulo computation here.
2359 timestamp.mPosition = (mPosition - mServer + timestamp.mPosition).value();
Glenn Kasten200092b2014-08-15 15:13:30 -07002360 // Immediately after a call to getPosition_l(), mPosition and
2361 // mServer both represent the same frame position. mPosition is
2362 // in client's point of view, and mServer is in server's point of
2363 // view. So the difference between them is the "fudge factor"
2364 // between client and server views due to stop() and/or new
2365 // IAudioTrack. And timestamp.mPosition is initially in server's
2366 // point of view, so we need to apply the same fudge factor to it.
Glenn Kastenfe346c72013-08-30 13:28:22 -07002367 }
Phil Burk1b420972015-04-22 10:52:21 -07002368
2369 // Prevent retrograde motion in timestamp.
2370 // This is sometimes caused by erratic reports of the available space in the ALSA drivers.
2371 if (status == NO_ERROR) {
2372 if (previousTimestampValid) {
Andy Hung90e8a972015-11-09 16:42:40 -08002373#define TIME_TO_NANOS(time) ((int64_t)time.tv_sec * 1000000000 + time.tv_nsec)
2374 const int64_t previousTimeNanos = TIME_TO_NANOS(mPreviousTimestamp.mTime);
2375 const int64_t currentTimeNanos = TIME_TO_NANOS(timestamp.mTime);
Phil Burk1b420972015-04-22 10:52:21 -07002376#undef TIME_TO_NANOS
2377 if (currentTimeNanos < previousTimeNanos) {
2378 ALOGW("retrograde timestamp time");
2379 // FIXME Consider blocking this from propagating upwards.
2380 }
2381
2382 // Looking at signed delta will work even when the timestamps
2383 // are wrapping around.
Andy Hung90e8a972015-11-09 16:42:40 -08002384 int32_t deltaPosition = (Modulo<uint32_t>(timestamp.mPosition)
2385 - mPreviousTimestamp.mPosition).signedValue();
Phil Burk1b420972015-04-22 10:52:21 -07002386 // position can bobble slightly as an artifact; this hides the bobble
2387 static const int32_t MINIMUM_POSITION_DELTA = 8;
Phil Burk4c5a3672015-04-30 16:18:53 -07002388 if (deltaPosition < 0) {
2389 // Only report once per position instead of spamming the log.
2390 if (!mRetrogradeMotionReported) {
2391 ALOGW("retrograde timestamp position corrected, %d = %u - %u",
2392 deltaPosition,
2393 timestamp.mPosition,
2394 mPreviousTimestamp.mPosition);
2395 mRetrogradeMotionReported = true;
2396 }
2397 } else {
2398 mRetrogradeMotionReported = false;
2399 }
Phil Burk1b420972015-04-22 10:52:21 -07002400 if (deltaPosition < MINIMUM_POSITION_DELTA) {
2401 timestamp = mPreviousTimestamp; // Use last valid timestamp.
2402 }
2403 }
2404 mPreviousTimestamp = timestamp;
2405 mPreviousTimestampValid = true;
2406 }
2407
Glenn Kastenfe346c72013-08-30 13:28:22 -07002408 return status;
Glenn Kastence703742013-07-19 16:33:58 -07002409}
2410
Richard Fitzgeraldad3af332013-03-25 16:54:37 +00002411String8 AudioTrack::getParameters(const String8& keys)
2412{
Glenn Kasten2c6c5292014-01-13 10:29:08 -08002413 audio_io_handle_t output = getOutput();
Glenn Kasten142f5192014-03-25 17:44:59 -07002414 if (output != AUDIO_IO_HANDLE_NONE) {
Glenn Kasten2c6c5292014-01-13 10:29:08 -08002415 return AudioSystem::getParameters(output, keys);
Richard Fitzgeraldb1a270d2013-05-14 12:12:21 +01002416 } else {
2417 return String8::empty();
2418 }
Richard Fitzgeraldad3af332013-03-25 16:54:37 +00002419}
2420
Glenn Kasten23a75452014-01-13 10:37:17 -08002421bool AudioTrack::isOffloaded() const
2422{
2423 AutoMutex lock(mLock);
2424 return isOffloaded_l();
2425}
2426
Eric Laurentab5cdba2014-06-09 17:22:27 -07002427bool AudioTrack::isDirect() const
2428{
2429 AutoMutex lock(mLock);
2430 return isDirect_l();
2431}
2432
2433bool AudioTrack::isOffloadedOrDirect() const
2434{
2435 AutoMutex lock(mLock);
2436 return isOffloadedOrDirect_l();
2437}
2438
2439
Glenn Kasten7c7be1e2013-12-19 16:34:04 -08002440status_t AudioTrack::dump(int fd, const Vector<String16>& args __unused) const
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002441{
2442
2443 const size_t SIZE = 256;
2444 char buffer[SIZE];
2445 String8 result;
2446
2447 result.append(" AudioTrack::dump\n");
Glenn Kasten85ab62c2012-11-01 11:11:38 -07002448 snprintf(buffer, 255, " stream type(%d), left - right volume(%f, %f)\n", mStreamType,
Glenn Kasten877a0ac2014-04-30 17:04:13 -07002449 mVolume[AUDIO_INTERLEAVE_LEFT], mVolume[AUDIO_INTERLEAVE_RIGHT]);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002450 result.append(buffer);
Kévin PETIT377b2ec2014-02-03 12:35:36 +00002451 snprintf(buffer, 255, " format(%d), channel count(%d), frame count(%zu)\n", mFormat,
Glenn Kastenb6037442012-11-14 13:42:25 -08002452 mChannelCount, mFrameCount);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002453 result.append(buffer);
Andy Hung8edb8dc2015-03-26 19:13:55 -07002454 snprintf(buffer, 255, " sample rate(%u), speed(%f), status(%d)\n",
Ricardo Garcia5a8a95d2015-04-18 14:47:04 -07002455 mSampleRate, mPlaybackRate.mSpeed, mStatus);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002456 result.append(buffer);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002457 snprintf(buffer, 255, " state(%d), latency (%d)\n", mState, mLatency);
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002458 result.append(buffer);
2459 ::write(fd, result.string(), result.size());
2460 return NO_ERROR;
2461}
2462
Phil Burk2812d9e2016-01-04 10:34:30 -08002463uint32_t AudioTrack::getUnderrunCount() const
2464{
2465 AutoMutex lock(mLock);
2466 return getUnderrunCount_l();
2467}
2468
2469uint32_t AudioTrack::getUnderrunCount_l() const
2470{
2471 return mProxy->getUnderrunCount() + mUnderrunCountOffset;
2472}
2473
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002474uint32_t AudioTrack::getUnderrunFrames() const
2475{
2476 AutoMutex lock(mLock);
2477 return mProxy->getUnderrunFrames();
2478}
2479
Eric Laurent296fb132015-05-01 11:38:42 -07002480status_t AudioTrack::addAudioDeviceCallback(const sp<AudioSystem::AudioDeviceCallback>& callback)
2481{
2482 if (callback == 0) {
2483 ALOGW("%s adding NULL callback!", __FUNCTION__);
2484 return BAD_VALUE;
2485 }
2486 AutoMutex lock(mLock);
2487 if (mDeviceCallback == callback) {
2488 ALOGW("%s adding same callback!", __FUNCTION__);
2489 return INVALID_OPERATION;
2490 }
2491 status_t status = NO_ERROR;
2492 if (mOutput != AUDIO_IO_HANDLE_NONE) {
2493 if (mDeviceCallback != 0) {
2494 ALOGW("%s callback already present!", __FUNCTION__);
2495 AudioSystem::removeAudioDeviceCallback(mDeviceCallback, mOutput);
2496 }
2497 status = AudioSystem::addAudioDeviceCallback(callback, mOutput);
2498 }
2499 mDeviceCallback = callback;
2500 return status;
2501}
2502
2503status_t AudioTrack::removeAudioDeviceCallback(
2504 const sp<AudioSystem::AudioDeviceCallback>& callback)
2505{
2506 if (callback == 0) {
2507 ALOGW("%s removing NULL callback!", __FUNCTION__);
2508 return BAD_VALUE;
2509 }
2510 AutoMutex lock(mLock);
2511 if (mDeviceCallback != callback) {
2512 ALOGW("%s removing different callback!", __FUNCTION__);
2513 return INVALID_OPERATION;
2514 }
2515 if (mOutput != AUDIO_IO_HANDLE_NONE) {
2516 AudioSystem::removeAudioDeviceCallback(mDeviceCallback, mOutput);
2517 }
2518 mDeviceCallback = 0;
2519 return NO_ERROR;
2520}
2521
Andy Hunge13f8a62016-03-30 14:20:42 -07002522status_t AudioTrack::pendingDuration(int32_t *msec, ExtendedTimestamp::Location location)
2523{
2524 if (msec == nullptr ||
2525 (location != ExtendedTimestamp::LOCATION_SERVER
2526 && location != ExtendedTimestamp::LOCATION_KERNEL)) {
2527 return BAD_VALUE;
2528 }
2529 AutoMutex lock(mLock);
2530 // inclusive of offloaded and direct tracks.
2531 //
2532 // It is possible, but not enabled, to allow duration computation for non-pcm
2533 // audio_has_proportional_frames() formats because currently they have
2534 // the drain rate equivalent to the pcm sample rate * framesize.
2535 if (!isPurePcmData_l()) {
2536 return INVALID_OPERATION;
2537 }
2538 ExtendedTimestamp ets;
2539 if (getTimestamp_l(&ets) == OK
2540 && ets.mTimeNs[location] > 0) {
2541 int64_t diff = ets.mPosition[ExtendedTimestamp::LOCATION_CLIENT]
2542 - ets.mPosition[location];
2543 if (diff < 0) {
2544 *msec = 0;
2545 } else {
2546 // ms is the playback time by frames
2547 int64_t ms = (int64_t)((double)diff * 1000 /
2548 ((double)mSampleRate * mPlaybackRate.mSpeed));
2549 // clockdiff is the timestamp age (negative)
2550 int64_t clockdiff = (mState != STATE_ACTIVE) ? 0 :
2551 ets.mTimeNs[location]
2552 + ets.mTimebaseOffset[ExtendedTimestamp::TIMEBASE_MONOTONIC]
2553 - systemTime(SYSTEM_TIME_MONOTONIC);
2554
2555 //ALOGV("ms: %lld clockdiff: %lld", (long long)ms, (long long)clockdiff);
2556 static const int NANOS_PER_MILLIS = 1000000;
2557 *msec = (int32_t)(ms + clockdiff / NANOS_PER_MILLIS);
2558 }
2559 return NO_ERROR;
2560 }
2561 if (location != ExtendedTimestamp::LOCATION_SERVER) {
2562 return INVALID_OPERATION; // LOCATION_KERNEL is not available
2563 }
2564 // use server position directly (offloaded and direct arrive here)
2565 updateAndGetPosition_l();
2566 int32_t diff = (Modulo<uint32_t>(mFramesWritten) - mPosition).signedValue();
2567 *msec = (diff <= 0) ? 0
2568 : (int32_t)((double)diff * 1000 / ((double)mSampleRate * mPlaybackRate.mSpeed));
2569 return NO_ERROR;
2570}
2571
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002572// =========================================================================
2573
Glenn Kasten7c7be1e2013-12-19 16:34:04 -08002574void AudioTrack::DeathNotifier::binderDied(const wp<IBinder>& who __unused)
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002575{
2576 sp<AudioTrack> audioTrack = mAudioTrack.promote();
2577 if (audioTrack != 0) {
2578 AutoMutex lock(audioTrack->mLock);
2579 audioTrack->mProxy->binderDied();
2580 }
2581}
2582
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002583// =========================================================================
2584
2585AudioTrack::AudioTrackThread::AudioTrackThread(AudioTrack& receiver, bool bCanCallJava)
Glenn Kasten598de6c2013-10-16 17:02:13 -07002586 : Thread(bCanCallJava), mReceiver(receiver), mPaused(true), mPausedInt(false), mPausedNs(0LL),
2587 mIgnoreNextPausedInt(false)
Glenn Kasten3acbd052012-02-28 10:39:56 -08002588{
2589}
2590
2591AudioTrack::AudioTrackThread::~AudioTrackThread()
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002592{
2593}
2594
2595bool AudioTrack::AudioTrackThread::threadLoop()
2596{
Glenn Kasten3acbd052012-02-28 10:39:56 -08002597 {
2598 AutoMutex _l(mMyLock);
2599 if (mPaused) {
2600 mMyCond.wait(mMyLock);
2601 // caller will check for exitPending()
2602 return true;
2603 }
Glenn Kasten598de6c2013-10-16 17:02:13 -07002604 if (mIgnoreNextPausedInt) {
2605 mIgnoreNextPausedInt = false;
2606 mPausedInt = false;
2607 }
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002608 if (mPausedInt) {
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002609 if (mPausedNs > 0) {
2610 (void) mMyCond.waitRelative(mMyLock, mPausedNs);
2611 } else {
2612 mMyCond.wait(mMyLock);
2613 }
Eric Laurent9d2c78c2013-09-23 12:29:42 -07002614 mPausedInt = false;
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002615 return true;
2616 }
Glenn Kasten3acbd052012-02-28 10:39:56 -08002617 }
Eric Laurent7985dcb2014-10-07 15:45:14 -07002618 if (exitPending()) {
2619 return false;
2620 }
Glenn Kasten7c7be1e2013-12-19 16:34:04 -08002621 nsecs_t ns = mReceiver.processAudioBuffer();
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002622 switch (ns) {
2623 case 0:
2624 return true;
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002625 case NS_INACTIVE:
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002626 pauseInternal();
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002627 return true;
2628 case NS_NEVER:
2629 return false;
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002630 case NS_WHENEVER:
Andy Hung3c09c782014-12-29 18:39:32 -08002631 // Event driven: call wake() when callback notifications conditions change.
2632 ns = INT64_MAX;
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002633 // fall through
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002634 default:
Mark Salyzyn34fb2962014-06-18 16:30:56 -07002635 LOG_ALWAYS_FATAL_IF(ns < 0, "processAudioBuffer() returned %" PRId64, ns);
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002636 pauseInternal(ns);
Glenn Kasten9f80dd22012-12-18 15:57:32 -08002637 return true;
Glenn Kastenca8b2802012-04-23 13:58:16 -07002638 }
The Android Open Source Project89fa4ad2009-03-03 19:31:44 -08002639}
2640
Glenn Kasten3acbd052012-02-28 10:39:56 -08002641void AudioTrack::AudioTrackThread::requestExit()
2642{
2643 // must be in this order to avoid a race condition
2644 Thread::requestExit();
Glenn Kasten598de6c2013-10-16 17:02:13 -07002645 resume();
Glenn Kasten3acbd052012-02-28 10:39:56 -08002646}
2647
2648void AudioTrack::AudioTrackThread::pause()
2649{
2650 AutoMutex _l(mMyLock);
2651 mPaused = true;
2652}
2653
2654void AudioTrack::AudioTrackThread::resume()
2655{
2656 AutoMutex _l(mMyLock);
Glenn Kasten598de6c2013-10-16 17:02:13 -07002657 mIgnoreNextPausedInt = true;
Eric Laurent9d2c78c2013-09-23 12:29:42 -07002658 if (mPaused || mPausedInt) {
Glenn Kasten3acbd052012-02-28 10:39:56 -08002659 mPaused = false;
Eric Laurent9d2c78c2013-09-23 12:29:42 -07002660 mPausedInt = false;
Glenn Kasten3acbd052012-02-28 10:39:56 -08002661 mMyCond.signal();
2662 }
2663}
2664
Andy Hung3c09c782014-12-29 18:39:32 -08002665void AudioTrack::AudioTrackThread::wake()
2666{
2667 AutoMutex _l(mMyLock);
Andy Hunga8d08902015-07-22 11:52:13 -07002668 if (!mPaused) {
2669 // wake() might be called while servicing a callback - ignore the next
2670 // pause time and call processAudioBuffer.
Andy Hung3c09c782014-12-29 18:39:32 -08002671 mIgnoreNextPausedInt = true;
Andy Hunga8d08902015-07-22 11:52:13 -07002672 if (mPausedInt && mPausedNs > 0) {
2673 // audio track is active and internally paused with timeout.
2674 mPausedInt = false;
2675 mMyCond.signal();
2676 }
Andy Hung3c09c782014-12-29 18:39:32 -08002677 }
2678}
2679
Glenn Kasten5a6cd222013-09-20 09:20:45 -07002680void AudioTrack::AudioTrackThread::pauseInternal(nsecs_t ns)
2681{
2682 AutoMutex _l(mMyLock);
2683 mPausedInt = true;
2684 mPausedNs = ns;
2685}
2686
Glenn Kasten40bc9062015-03-20 09:09:33 -07002687} // namespace android