The RtAudio Home Page

Home Class/Enum List File List Compound Members C interface

Duplex Mode

Finally, it is easy to use RtAudio for simultaneous audio input/output, or duplex operation. In this example, we simply pass the input data back to the output.

#include "RtAudio.h"
#include <iostream>
#include <cstdlib>
#include <cstring>
// Pass-through function.
int inout( void *outputBuffer, void *inputBuffer, unsigned int nBufferFrames,
double streamTime, RtAudioStreamStatus status, void *data )
{
// Since the number of input and output channels is equal, we can do
// a simple buffer copy operation here.
if ( status ) std::cout << "Stream over/underflow detected." << std::endl;
unsigned int *bytes = (unsigned int *) data;
memcpy( outputBuffer, inputBuffer, *bytes );
return 0;
}
int main()
{
RtAudio adac;
std::vector<unsigned int> deviceIds = adac.getDeviceIds();
if ( deviceIds.size() < 1 ) {
std::cout << "\nNo audio devices found!\n";
exit( 0 );
}
// Set the same number of channels for both input and output.
unsigned int bufferBytes, bufferFrames = 512;
RtAudio::StreamParameters iParams, oParams;
iParams.deviceId = deviceIds[0]; // first available device
iParams.nChannels = 2;
oParams.deviceId = deviceIds[0]; // first available device
oParams.nChannels = 2;
if ( adac.openStream( &oParams, &iParams, RTAUDIO_SINT32, 44100,
&bufferFrames, &inout, (void *)&bufferBytes ) ) {
std::cout << '\n' << adac.getErrorText() << '\n' << std::endl;
exit( 0 ); // problem with device settings
}
bufferBytes = bufferFrames * 2 * 4;
if ( adac.startStream() ) {
std::cout << adac.getErrorText() << std::endl;
goto cleanup;
}
char input;
std::cout << "\nRunning ... press <enter> to quit.\n";
std::cin.get(input);
// Block released ... stop the stream
if ( adac.isStreamRunning() )
adac.stopStream(); // or could call adac.abortStream();
cleanup:
if ( adac.isStreamOpen() ) adac.closeStream();
return 0;
}
RtAudio.h
RtAudioStreamStatus
unsigned int RtAudioStreamStatus
RtAudio stream status (over- or underflow) flags.
Definition RtAudio.h:178
RtAudio
Realtime audio i/o C++ classes.
Definition RtAudio.h:268
RtAudio::isStreamRunning
bool isStreamRunning(void) const
Returns true if the stream is running and false if it is stopped or not open.
Definition RtAudio.h:922
RtAudio::stopStream
RtAudioErrorType stopStream(void)
Stop a stream, allowing any samples remaining in the output queue to be played.
Definition RtAudio.h:918
RtAudio::getErrorText
const std::string getErrorText(void)
Retrieve the error message corresponding to the last error or warning condition.
Definition RtAudio.h:920
RtAudio::StreamParameters::nChannels
unsigned int nChannels
Definition RtAudio.h:305
RtAudio::closeStream
void closeStream(void)
A function that closes a stream and frees any associated stream memory.
Definition RtAudio.h:916
RtAudio::openStream
RtAudioErrorType openStream(RtAudio::StreamParameters *outputParameters, RtAudio::StreamParameters *inputParameters, RtAudioFormat format, unsigned int sampleRate, unsigned int *bufferFrames, RtAudioCallback callback, void *userData=NULL, RtAudio::StreamOptions *options=NULL)
A public function for opening a stream with the specified parameters.
RtAudio::startStream
RtAudioErrorType startStream(void)
A function that starts a stream.
Definition RtAudio.h:917
RtAudio::isStreamOpen
bool isStreamOpen(void) const
Returns true if a stream is open and false if not.
Definition RtAudio.h:921
RtAudio::getDeviceIds
std::vector< unsigned int > getDeviceIds(void)
A public function that returns a vector of audio device IDs.
Definition RtAudio.h:912
RtAudio::StreamParameters::deviceId
unsigned int deviceId
Definition RtAudio.h:304
RtAudio::StreamParameters
The structure for specifying input or output stream parameters.
Definition RtAudio.h:302

In this example, audio recorded by the stream input will be played out during the next round of audio processing.

Note that a duplex stream can (and often must) make use of two different devices (except when using the Linux Jack and Windows ASIO APIs). However, if the two devices do not share a common internal or external "sync", there may be timing problems due to possible device clock variations.

| ©2001-2023 Gary P. Scavone, McGill University. All Rights Reserved. Maintained by Gary P. Scavone.