title: Android AudioRecord class - process live mic audio quickly, set up callback function
body: <p>I want to record audio from the mic and access it for possible playback in near real-time. I am unsure of how to use the Android AudioRecord class to record some mic audio and quickly access it. </p>
  
  <p>For the AudioRecord class, the official site says 'the app polls the AudioRecord object in time', and 'the size of the buffer being filled determines the time-length of the recording before over-running unread data'. Later it's suggested that a larger buffer should be used when polling less frequently. They never actually show an example in code. </p>
  
  <p>One example I've seen in a book uses the AudioRecord class to continuously read a buffer freshly populated with live mic audio, and then the app writes this data to an SD file. The pseudo-code looks something like - </p>
  
  <pre><code>set up AudioRecord object with buffer size and recording format info
  set up a file and an output stream
  myAudioRecord.startRecording();
  while(isRecording)
  {
      // myBuffer is being filled with fresh audio
      read audio data into myBuffer
      send contents of myBuffer to SD file
  }
  myAudioRecord.stop();
  </code></pre>
  
  <p>How this code synchronizes its reading with the rate of recording is unclear - is the boolean "isRecording" sequenced on and off properly elsewhere? It seems this code could either read too frequently or too infrequently, depending on how long the reading and writing takes. </p>
  
  <p>The site doc also says the AudioRecord class has a nested class named OnRecordPositionUpdateListener which is defined as an interface. The information suggests that somehow, you specify the period you want for being notified of the progress of the recording, and the name of your event handler, and a call is automatically made to your event handler at the specified frequency. I think the structure, in pseudo-code would be something like - </p>
  
  <pre><code>set target of period update message = myListener
  set period to be about every 250 ms
  other code
  
  myListener()
  {
      if(record button was recently tapped)
          handle message that another 250 ms of fresh audio is available
          ie, read it and send it somewhere
  )
  </code></pre>
  
  <p>I need to find some specific code which allows me to capture and process mic audio with a delay of less than about 500 ms. Android offers another class called MediaRecorder, but it doesn't support streaming, and I may want to stream live mic audio over a Wi-Fi network in near real-time. Where can I find some specific examples?</p>