/*
* Copyright (C) 2010 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.
*/
/** \file BufferQueue_test.cpp */
#define LOG_NDEBUG 0
#define LOG_TAG "BufferQueue_test"
#ifdef ANDROID
#include <utils/Log.h>
#else
#define ALOGV printf
#endif
#include <assert.h>
#include <math.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <SLES/OpenSLES.h>
#include "OpenSLESUT.h"
#include <gtest/gtest.h>
typedef struct {
short left;
short right;
} stereo;
// volume of sine wave in range 0.0 to 1.0
static float gVolume = 1.0f;
// 1 second of stereo audio at 44.1 kHz
static stereo stereoBuffer1[44100 * 1];
static const SLuint32 invalidNumBuffers[] = { 0, 0xFFFFFFFF, 0x80000000, 0x10002, 0x102,
0x101, 0x100 };
static const SLuint32 validNumBuffers[] = { 1, 2, 3, 4, 5, 6, 7, 8, 255 };
//-----------------------------------------------------------------
/* Checks for error. If any errors exit the application! */
void CheckErr(SLresult res) {
if (SL_RESULT_SUCCESS != res) {
const char *str = slesutResultToString(res);
if (NULL == str)
str = "unknown";
fprintf(stderr, "CheckErr failure: %s (0x%x), exiting\n", str, res);
//Fail the test case
FAIL();
}
}
static const SLInterfaceID ids[1] = { SL_IID_BUFFERQUEUE };
static const SLboolean flags[1] = { SL_BOOLEAN_TRUE };
static const SLInterfaceID ids_mutesolo[2] = { SL_IID_BUFFERQUEUE, SL_IID_MUTESOLO };
static const SLboolean flags_mutesolo[2] = { SL_BOOLEAN_TRUE, SL_BOOLEAN_TRUE };
static const SLInterfaceID ids_seek[2] = { SL_IID_BUFFERQUEUE, SL_IID_SEEK };
static const SLboolean flags_seek[2] = { SL_BOOLEAN_TRUE, SL_BOOLEAN_TRUE };
// The fixture for testing class BufferQueue
class TestBufferQueue: public ::testing::Test {
public:
SLresult res;
SLObjectItf outputmixObject;
SLObjectItf engineObject;
SLDataSource audiosrc;
SLDataSink audiosnk;
SLDataFormat_PCM pcm;
SLDataLocator_OutputMix locator_outputmix;
SLDataLocator_BufferQueue locator_bufferqueue;
SLBufferQueueItf playerBufferQueue;
SLBufferQueueState bufferqueueState;
SLPlayItf playerPlay;
SLObjectItf playerObject;
SLEngineItf engineEngine;
SLuint32 playerState;
protected:
TestBufferQueue() {
}
virtual ~TestBufferQueue() {
}
/*Test setup*/
virtual void SetUp() {
// create engine
res = slCreateEngine(&engineObject, 0, NULL, 0, NULL, NULL);
CheckErr(res);
res = (*engineObject)->Realize(engineObject, SL_BOOLEAN_FALSE);
CheckErr(res);
res = (*engineObject)->GetInterface(engineObject, SL_IID_ENGINE, &engineEngine);
CheckErr(res);
// create output mix
res = (*engineEngine)->CreateOutputMix(engineEngine, &outputmixObject, 0, NULL, NULL);
CheckErr(res);
res = (*outputmixObject)->Realize(outputmixObject, SL_BOOLEAN_FALSE);
CheckErr(res);
locator_bufferqueue.locatorType = SL_DATALOCATOR_BUFFERQUEUE;
locator_bufferqueue.numBuffers = 0;
locator_outputmix.locatorType = SL_DATALOCATOR_OUTPUTMIX;
locator_outputmix.outputMix = outputmixObject;
pcm.formatType = SL_DATAFORMAT_PCM;
pcm.numChannels = 2;
pcm.samplesPerSec = SL_SAMPLINGRATE_44_1;
pcm.bitsPerSample = SL_PCMSAMPLEFORMAT_FIXED_16;
pcm.containerSize = 16;
pcm.channelMask = SL_SPEAKER_FRONT_LEFT | SL_SPEAKER_FRONT_RIGHT;
pcm.endianness = SL_BYTEORDER_LITTLEENDIAN;
audiosrc.pLocator = &locator_bufferqueue;
audiosrc.pFormat = &pcm;
audiosnk.pLocator = &locator_outputmix;
audiosnk.pFormat = NULL;
// initialize the test tone to be a sine sweep from 441 Hz to 882 Hz
unsigned nframes = sizeof(stereoBuffer1) / sizeof(stereoBuffer1[0]);
float nframes_ = (float) nframes;
SLuint32 i;
for (i = 0; i < nframes; ++i) {
float i_ = (float) i;
float pcm_ = sin((i_ * (1.0f + 0.5f * (i_ / nframes_)) * 0.01 * M_PI * 2.0));
int pcm = (int) (pcm_ * 32766.0 * gVolume);
ASSERT_TRUE(-32768 <= pcm && pcm <= 32767) << "pcm out of bound " << pcm;
stereoBuffer1[i].left = pcm;
stereoBuffer1[nframes - 1 - i].right = pcm;
}
}
virtual void TearDown() {
// Clean up the mixer and the engine
// (must be done in that order, and after player destroyed)
if (outputmixObject){
(*outputmixObject)->Destroy(outputmixObject);
outputmixObject = NULL;
}
if (engineObject){
(*engineObject)->Destroy(engineObject);
engineObject = NULL;
}
}
void DestroyPlayer() {
if (playerObject){
//printf("destroy player\n");
(*playerObject)->Destroy(playerObject);
playerObject = NULL;
}
}
/* Test case for creating audio player with various invalid values for numBuffers*/
void InvalidBuffer() {
for (unsigned i = 0; i < sizeof(invalidNumBuffers) / sizeof(invalidNumBuffers[0]); ++i) {
SLuint32 numBuffers = invalidNumBuffers[i];
locator_bufferqueue.numBuffers = numBuffers;
//printf("create audio player - invalid\n");
SLresult result = (*engineEngine)->CreateAudioPlayer(engineEngine, &playerObject,
&audiosrc, &audiosnk, 1, ids, flags);
ASSERT_EQ(SL_RESULT_PARAMETER_INVALID, result);
ASSERT_EQ(NULL, playerObject);
}
}
/*Prepare the buffer*/
void PrepareValidBuffer(SLuint32 numBuffers) {
locator_bufferqueue.numBuffers = numBuffers;
//printf("create audio player - valid\n");
res = (*engineEngine)->CreateAudioPlayer(engineEngine, &playerObject, &audiosrc, &audiosnk,
1, ids, flags);
CheckErr(res);
res = (*playerObject)->Realize(playerObject, SL_BOOLEAN_FALSE);
CheckErr(res);
// get the play interface
res = (*playerObject)->GetInterface(playerObject, SL_IID_PLAY, &playerPlay);
CheckErr(res);
// verify that player is initially stopped
res = (*playerPlay)->GetPlayState(playerPlay, &playerState);
CheckErr(res);
ASSERT_EQ(SL_PLAYSTATE_STOPPED, playerState);
// get the buffer queue interface
res = (*playerObject)->GetInterface(playerObject, SL_IID_BUFFERQUEUE, &playerBufferQueue);
CheckErr(res);
// verify that buffer queue is initially empty
res = (*playerBufferQueue)->GetState(playerBufferQueue, &bufferqueueState);
CheckErr(res);
ASSERT_EQ((SLuint32) 0, bufferqueueState.count);
ASSERT_EQ((SLuint32) 0, bufferqueueState.playIndex);
}
void EnqueueMaxBuffer(SLuint32 numBuffers) {
SLuint32 j;
for (j = 0; j < numBuffers; ++j) {
res = (*playerBufferQueue)->Enqueue(playerBufferQueue, "test", 4);
CheckErr(res);
// verify that each buffer is enqueued properly and increments the buffer count
res = (*playerBufferQueue)->GetState(playerBufferQueue, &bufferqueueState);
CheckErr(res);
ASSERT_EQ(j + 1, bufferqueueState.count);
ASSERT_EQ((SLuint32) 0, bufferqueueState.playIndex);
}
}
void EnqueueExtraBuffer(SLuint32 numBuffers) {
// enqueue one more buffer and make sure it fails
res = (*playerBufferQueue)->Enqueue(playerBufferQueue, "test", 4);
ASSERT_EQ(SL_RESULT_BUFFER_INSUFFICIENT, res);
// verify that the failed enqueue did not affect the buffer count
res = (*playerBufferQueue)->GetState(playerBufferQueue, &bufferqueueState);
CheckErr(res);
ASSERT_EQ(numBuffers, bufferqueueState.count);
ASSERT_EQ((SLuint32) 0, bufferqueueState.playIndex);
}
void SetPlayerState(SLuint32 state) {
res = (*playerPlay)->SetPlayState(playerPlay, state);
CheckErr(res);
//verify the state can set correctly
GetPlayerState(state);
}
void GetPlayerState(SLuint32 state) {
res = (*playerPlay)->GetPlayState(playerPlay, &playerState);
CheckErr(res);
ASSERT_EQ(state, playerState);
}
void ClearQueue() {
// now clear the buffer queue
res = (*playerBufferQueue)->Clear(playerBufferQueue);
CheckErr(res);
// make sure the clear works
res = (*playerBufferQueue)->GetState(playerBufferQueue, &bufferqueueState);
CheckErr(res);
ASSERT_EQ((SLuint32) 0, bufferqueueState.count);
ASSERT_EQ((SLuint32) 0, bufferqueueState.playIndex);
}
void CheckBufferCount(SLuint32 ExpectedCount, SLuint32 ExpectedPlayIndex) {
// changing the play state should not affect the buffer count
res = (*playerBufferQueue)->GetState(playerBufferQueue, &bufferqueueState);
CheckErr(res);
ASSERT_EQ(ExpectedCount, bufferqueueState.count);
ASSERT_EQ(ExpectedPlayIndex, bufferqueueState.playIndex);
}
void PlayBufferQueue() {
// enqueue a buffer
res = (*playerBufferQueue)->Enqueue(playerBufferQueue, stereoBuffer1,
sizeof(stereoBuffer1));
CheckErr(res);
// set play state to playing
res = (*playerPlay)->SetPlayState(playerPlay, SL_PLAYSTATE_PLAYING);
CheckErr(res);
// state should be playing immediately after enqueue
res = (*playerPlay)->GetPlayState(playerPlay, &playerState);
CheckErr(res);
ASSERT_EQ(SL_PLAYSTATE_PLAYING, playerState);
// buffer should still be on the queue
res = (*playerBufferQueue)->GetState(playerBufferQueue, &bufferqueueState);
CheckErr(res);
ASSERT_EQ((SLuint32) 1, bufferqueueState.count);
ASSERT_EQ((SLuint32) 0, bufferqueueState.playIndex);
//ALOGV("Before 1.5 sec");
// wait 1.5 seconds
usleep(1500000);
//ALOGV("After 1.5 sec");
// state should still be playing
res = (*playerPlay)->GetPlayState(playerPlay, &playerState);
//ALOGV("GetPlayState");
CheckErr(res);
ASSERT_EQ(SL_PLAYSTATE_PLAYING, playerState);
// buffer should be removed from the queue
res = (*playerBufferQueue)->GetState(playerBufferQueue, &bufferqueueState);
CheckErr(res);
ASSERT_EQ((SLuint32) 0, bufferqueueState.count);
ASSERT_EQ((SLuint32) 1, bufferqueueState.playIndex);
//ALOGV("TestEnd");
}
};
TEST_F(TestBufferQueue, testInvalidBuffer){
//ALOGV("Test Fixture: InvalidBuffer");
InvalidBuffer();
}
TEST_F(TestBufferQueue, testMuteSolo) {
// create audio player with buffer queue data source in stereo PCM format and ask for mute solo
locator_bufferqueue.numBuffers = 1;
SLresult result = (*engineEngine)->CreateAudioPlayer(engineEngine, &playerObject, &audiosrc,
&audiosnk, 2, ids_mutesolo, flags_mutesolo);
ASSERT_EQ(SL_RESULT_SUCCESS, result);
ASSERT_TRUE(NULL != playerObject);
DestroyPlayer();
// create audio player with buffer queue data source in mono PCM format and ask for mute solo
pcm.numChannels = 1;
pcm.channelMask = SL_SPEAKER_FRONT_CENTER;
result = (*engineEngine)->CreateAudioPlayer(engineEngine, &playerObject, &audiosrc, &audiosnk,
2, ids_mutesolo, flags_mutesolo);
ASSERT_EQ(SL_RESULT_FEATURE_UNSUPPORTED, result);
ASSERT_EQ(NULL, playerObject);
DestroyPlayer();
}
TEST_F(TestBufferQueue, testSeek) {
// can create audio player with buffer queue data source and ask for seek
locator_bufferqueue.numBuffers = 1;
SLresult result = (*engineEngine)->CreateAudioPlayer(engineEngine, &playerObject,
&audiosrc, &audiosnk, 2, ids_seek, flags_seek);
ASSERT_EQ(SL_RESULT_FEATURE_UNSUPPORTED, result);
ASSERT_EQ(NULL, playerObject);
DestroyPlayer();
}
TEST_F(TestBufferQueue, testValidBuffer) {
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
PrepareValidBuffer(numBuffers);
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testEnqueueMaxBuffer) {
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
PrepareValidBuffer(numBuffers);
EnqueueMaxBuffer(numBuffers);
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testEnqueueExtraBuffer) {
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
PrepareValidBuffer(numBuffers);
EnqueueMaxBuffer(numBuffers);
EnqueueExtraBuffer(numBuffers);
GetPlayerState(SL_PLAYSTATE_STOPPED);
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testEnqueueAtStopped) {
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
PrepareValidBuffer(numBuffers);
SetPlayerState(SL_PLAYSTATE_STOPPED);
EnqueueMaxBuffer(numBuffers);
CheckBufferCount(numBuffers, (SLuint32) 0);
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testEnqueueAtPaused) {
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
PrepareValidBuffer(numBuffers);
SetPlayerState(SL_PLAYSTATE_PAUSED);
EnqueueMaxBuffer(numBuffers);
CheckBufferCount(numBuffers, (SLuint32) 0);
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testClearQueue) {
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
PrepareValidBuffer(numBuffers);
EnqueueMaxBuffer(numBuffers);
ClearQueue();
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testStateTransitionEmptyQueue) {
static const SLuint32 newStates[] = {
SL_PLAYSTATE_PAUSED, // paused -> paused
SL_PLAYSTATE_STOPPED, // paused -> stopped
SL_PLAYSTATE_PAUSED, // stopped -> paused
SL_PLAYSTATE_PLAYING, // paused -> playing
SL_PLAYSTATE_PLAYING, // playing -> playing
SL_PLAYSTATE_STOPPED, // playing -> stopped
SL_PLAYSTATE_STOPPED, // stopped -> stopped
SL_PLAYSTATE_PLAYING, // stopped -> playing
SL_PLAYSTATE_PAUSED // playing -> paused
};
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
SLuint32 j;
PrepareValidBuffer(numBuffers);
/* Set initial state to paused*/
SetPlayerState(SL_PLAYSTATE_PAUSED);
for (j = 0; j < sizeof(newStates) / sizeof(newStates[0]); ++j) {
SetPlayerState(newStates[j]);
CheckBufferCount((SLuint32) 0, (SLuint32) 0);
}
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testStateTransitionNonEmptyQueue) {
static const SLuint32 newStates[] = {
SL_PLAYSTATE_PAUSED, // paused -> paused
SL_PLAYSTATE_STOPPED, // paused -> stopped
SL_PLAYSTATE_STOPPED, // stopped -> stopped
SL_PLAYSTATE_PAUSED // stopped -> paused
};
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
SLuint32 j;
/* Prepare the player */
PrepareValidBuffer(numBuffers);
EnqueueMaxBuffer(numBuffers);
SetPlayerState(SL_PLAYSTATE_PAUSED);
for (j = 0; j < sizeof(newStates) / sizeof(newStates[0]); ++j) {
SetPlayerState(newStates[j]);
CheckBufferCount(numBuffers, (SLuint32) 0);
}
DestroyPlayer();
}
}
TEST_F(TestBufferQueue, testStatePlayBuffer){
for (unsigned i = 0; i < sizeof(validNumBuffers) / sizeof(validNumBuffers[0]); ++i) {
SLuint32 numBuffers = validNumBuffers[i];
PrepareValidBuffer(numBuffers);
PlayBufferQueue();
DestroyPlayer();
}
}
int main(int argc, char **argv) {
testing::InitGoogleTest(&argc, argv);
#if 1 // temporary workaround if hardware volume control is not working
const char *VOLUME = getenv("BufferQueue_test_VOLUME");
if (NULL != VOLUME) {
float volume = atof(VOLUME);
if (volume >= 0.0f && volume <= 1.0f) {
gVolume = volume;
}
}
#endif
return RUN_ALL_TESTS();
}