/* * Copyright (C) 2017 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ // Play sine waves using an AAudio callback. #ifndef AAUDIO_SIMPLE_PLAYER_H #define AAUDIO_SIMPLE_PLAYER_H #include <sched.h> #include <unistd.h> #include <aaudio/AAudio.h> #include "AAudioArgsParser.h" #include "SineGenerator.h" //#define SHARING_MODE AAUDIO_SHARING_MODE_EXCLUSIVE #define SHARING_MODE AAUDIO_SHARING_MODE_SHARED #define PERFORMANCE_MODE AAUDIO_PERFORMANCE_MODE_NONE // Arbitrary period for glitches #define FORCED_UNDERRUN_PERIOD_FRAMES (2 * 48000) // How long to sleep in a callback to cause an intentional glitch. For testing. #define FORCED_UNDERRUN_SLEEP_MICROS (10 * 1000) #define MAX_TIMESTAMPS 16 typedef struct Timestamp { int64_t position; int64_t nanoseconds; } Timestamp; /** * Simple wrapper for AAudio that opens an output stream either in callback or blocking write mode. */ class AAudioSimplePlayer { public: AAudioSimplePlayer() {} ~AAudioSimplePlayer() { close(); }; /** * Call this before calling open(). * @param requestedSharingMode */ void setSharingMode(aaudio_sharing_mode_t requestedSharingMode) { mRequestedSharingMode = requestedSharingMode; } /** * Call this before calling open(). * @param requestedPerformanceMode */ void setPerformanceMode(aaudio_performance_mode_t requestedPerformanceMode) { mRequestedPerformanceMode = requestedPerformanceMode; } // TODO Extract a common base class for record and playback. /** * Only call this after open() has been called. */ int32_t getSampleRate() const { if (mStream == nullptr) { return AAUDIO_ERROR_INVALID_STATE; } return AAudioStream_getSampleRate(mStream); } /** * Only call this after open() has been called. */ int32_t getChannelCount() { if (mStream == nullptr) { return AAUDIO_ERROR_INVALID_STATE; } return AAudioStream_getChannelCount(mStream); } /** * Open a stream */ aaudio_result_t open(const AAudioParameters ¶meters, AAudioStream_dataCallback dataCallback = nullptr, AAudioStream_errorCallback errorCallback = nullptr, void *userContext = nullptr) { aaudio_result_t result = AAUDIO_OK; // Use an AAudioStreamBuilder to contain requested parameters. AAudioStreamBuilder *builder = nullptr; result = AAudio_createStreamBuilder(&builder); if (result != AAUDIO_OK) return result; parameters.applyParameters(builder); // apply args AAudioStreamBuilder_setDirection(builder, AAUDIO_DIRECTION_OUTPUT); if (dataCallback != nullptr) { AAudioStreamBuilder_setDataCallback(builder, dataCallback, userContext); } if (errorCallback != nullptr) { AAudioStreamBuilder_setErrorCallback(builder, errorCallback, userContext); } //AAudioStreamBuilder_setFramesPerDataCallback(builder, CALLBACK_SIZE_FRAMES); //AAudioStreamBuilder_setBufferCapacityInFrames(builder, 48 * 8); // Open an AAudioStream using the Builder. result = AAudioStreamBuilder_openStream(builder, &mStream); if (result == AAUDIO_OK) { int32_t sizeInBursts = parameters.getNumberOfBursts(); if (sizeInBursts > 0) { int32_t framesPerBurst = AAudioStream_getFramesPerBurst(mStream); AAudioStream_setBufferSizeInFrames(mStream, sizeInBursts * framesPerBurst); } } AAudioStreamBuilder_delete(builder); return result; } aaudio_result_t open(int channelCount, int sampSampleRate, aaudio_format_t format, AAudioStream_dataCallback dataProc, AAudioStream_errorCallback errorProc, void *userContext) { aaudio_result_t result = AAUDIO_OK; // Use an AAudioStreamBuilder to contain requested parameters. AAudioStreamBuilder *builder = nullptr; result = AAudio_createStreamBuilder(&builder); if (result != AAUDIO_OK) return result; AAudioStreamBuilder_setDirection(builder, AAUDIO_DIRECTION_OUTPUT); AAudioStreamBuilder_setPerformanceMode(builder, mRequestedPerformanceMode); AAudioStreamBuilder_setSharingMode(builder, mRequestedSharingMode); AAudioStreamBuilder_setChannelCount(builder, channelCount); AAudioStreamBuilder_setSampleRate(builder, sampSampleRate); AAudioStreamBuilder_setFormat(builder, format); if (dataProc != nullptr) { AAudioStreamBuilder_setDataCallback(builder, dataProc, userContext); } if (errorProc != nullptr) { AAudioStreamBuilder_setErrorCallback(builder, errorProc, userContext); } //AAudioStreamBuilder_setFramesPerDataCallback(builder, CALLBACK_SIZE_FRAMES); //AAudioStreamBuilder_setBufferCapacityInFrames(builder, 48 * 8); // Open an AAudioStream using the Builder. result = AAudioStreamBuilder_openStream(builder, &mStream); AAudioStreamBuilder_delete(builder); return result; } aaudio_result_t close() { if (mStream != nullptr) { AAudioStream_close(mStream); mStream = nullptr; } return AAUDIO_OK; } // Write zero data to fill up the buffer and prevent underruns. aaudio_result_t prime() { int32_t samplesPerFrame = AAudioStream_getChannelCount(mStream); const int numFrames = 32; float zeros[numFrames * samplesPerFrame]; memset(zeros, 0, sizeof(zeros)); aaudio_result_t result = numFrames; while (result == numFrames) { result = AAudioStream_write(mStream, zeros, numFrames, 0); } return result; } // Start the stream. AAudio will start calling your callback function. aaudio_result_t start() { aaudio_result_t result = AAudioStream_requestStart(mStream); if (result != AAUDIO_OK) { printf("ERROR - AAudioStream_requestStart() returned %d %s\n", result, AAudio_convertResultToText(result)); } return result; } // Stop the stream. AAudio will stop calling your callback function. aaudio_result_t stop() { aaudio_result_t result = AAudioStream_requestStop(mStream); if (result != AAUDIO_OK) { printf("ERROR - AAudioStream_requestStop() returned %d %s\n", result, AAudio_convertResultToText(result)); } int32_t xRunCount = AAudioStream_getXRunCount(mStream); printf("AAudioStream_getXRunCount %d\n", xRunCount); return result; } // Pause the stream. AAudio will stop calling your callback function. aaudio_result_t pause() { aaudio_result_t result = AAudioStream_requestPause(mStream); if (result != AAUDIO_OK) { printf("ERROR - AAudioStream_requestPause() returned %d %s\n", result, AAudio_convertResultToText(result)); } int32_t xRunCount = AAudioStream_getXRunCount(mStream); printf("AAudioStream_getXRunCount %d\n", xRunCount); return result; } // Flush the stream. AAudio will stop calling your callback function. aaudio_result_t flush() { aaudio_result_t result = AAudioStream_requestFlush(mStream); if (result != AAUDIO_OK) { printf("ERROR - AAudioStream_requestFlush() returned %d %s\n", result, AAudio_convertResultToText(result)); } return result; } AAudioStream *getStream() const { return mStream; } private: AAudioStream *mStream = nullptr; aaudio_sharing_mode_t mRequestedSharingMode = SHARING_MODE; aaudio_performance_mode_t mRequestedPerformanceMode = PERFORMANCE_MODE; }; typedef struct SineThreadedData_s { SineGenerator sineOscillators[MAX_CHANNELS]; Timestamp timestamps[MAX_TIMESTAMPS]; int64_t framesTotal = 0; int64_t nextFrameToGlitch = FORCED_UNDERRUN_PERIOD_FRAMES; int32_t minNumFrames = INT32_MAX; int32_t maxNumFrames = 0; int32_t timestampCount = 0; // in timestamps int32_t sampleRate = 48000; int32_t prefixToneFrames = 0; bool sweepSetup = false; int scheduler = 0; bool schedulerChecked = false; bool forceUnderruns = false; AAudioSimplePlayer simplePlayer; int32_t callbackCount = 0; WakeUp waker{AAUDIO_OK}; /** * Set sampleRate first. */ void setupSineBlip() { for (int i = 0; i < MAX_CHANNELS; ++i) { double centerFrequency = 880.0 * (i + 2); sineOscillators[i].setup(centerFrequency, sampleRate); sineOscillators[i].setSweep(centerFrequency, centerFrequency, 0.0); } } void setupSineSweeps() { for (int i = 0; i < MAX_CHANNELS; ++i) { double centerFrequency = 220.0 * (i + 2); sineOscillators[i].setup(centerFrequency, sampleRate); double minFrequency = centerFrequency * 2.0 / 3.0; // Change range slightly so they will go out of phase. double maxFrequency = centerFrequency * 3.0 / 2.0; double sweepSeconds = 5.0 + i; sineOscillators[i].setSweep(minFrequency, maxFrequency, sweepSeconds); } sweepSetup = true; } } SineThreadedData_t; // Callback function that fills the audio output buffer. aaudio_data_callback_result_t SimplePlayerDataCallbackProc( AAudioStream *stream, void *userData, void *audioData, int32_t numFrames ) { // should not happen but just in case... if (userData == nullptr) { printf("ERROR - SimplePlayerDataCallbackProc needs userData\n"); return AAUDIO_CALLBACK_RESULT_STOP; } SineThreadedData_t *sineData = (SineThreadedData_t *) userData; // Play an initial high tone so we can tell whether the beginning was truncated. if (!sineData->sweepSetup && sineData->framesTotal >= sineData->prefixToneFrames) { sineData->setupSineSweeps(); } if (sineData->forceUnderruns) { if (sineData->framesTotal > sineData->nextFrameToGlitch) { usleep(FORCED_UNDERRUN_SLEEP_MICROS); printf("Simulate glitch at %lld\n", (long long) sineData->framesTotal); sineData->nextFrameToGlitch += FORCED_UNDERRUN_PERIOD_FRAMES; } } if (!sineData->schedulerChecked) { sineData->scheduler = sched_getscheduler(gettid()); sineData->schedulerChecked = true; } if (sineData->timestampCount < MAX_TIMESTAMPS) { Timestamp *timestamp = &sineData->timestamps[sineData->timestampCount]; aaudio_result_t result = AAudioStream_getTimestamp(stream, CLOCK_MONOTONIC, ×tamp->position, ×tamp->nanoseconds); if (result == AAUDIO_OK && // valid? (sineData->timestampCount == 0 || // first one? (timestamp->position != (timestamp - 1)->position))) { // advanced position? sineData->timestampCount++; // keep this one } } if (numFrames > sineData->maxNumFrames) { sineData->maxNumFrames = numFrames; } if (numFrames < sineData->minNumFrames) { sineData->minNumFrames = numFrames; } int32_t samplesPerFrame = AAudioStream_getChannelCount(stream); int numActiveOscilators = (samplesPerFrame > MAX_CHANNELS) ? MAX_CHANNELS : samplesPerFrame; switch (AAudioStream_getFormat(stream)) { case AAUDIO_FORMAT_PCM_I16: { int16_t *audioBuffer = (int16_t *) audioData; for (int i = 0; i < numActiveOscilators; ++i) { sineData->sineOscillators[i].render(&audioBuffer[i], samplesPerFrame, numFrames); } } break; case AAUDIO_FORMAT_PCM_FLOAT: { float *audioBuffer = (float *) audioData; for (int i = 0; i < numActiveOscilators; ++i) { sineData->sineOscillators[i].render(&audioBuffer[i], samplesPerFrame, numFrames); } } break; default: return AAUDIO_CALLBACK_RESULT_STOP; } sineData->callbackCount++; sineData->framesTotal += numFrames; return AAUDIO_CALLBACK_RESULT_CONTINUE; } void SimplePlayerErrorCallbackProc( AAudioStream *stream __unused, void *userData __unused, aaudio_result_t error) { // should not happen but just in case... if (userData == nullptr) { printf("ERROR - MyPlayerErrorCallbackProc needs userData\n"); return; } SineThreadedData_t *sineData = (SineThreadedData_t *) userData; android::status_t ret = sineData->waker.wake(error); printf("Error Callback, error: %d, futex wake returns %d\n", error, ret); } #endif //AAUDIO_SIMPLE_PLAYER_H