Merge "AudioTrack: docs for getUnderrunCount()" into nyc-dev

am: 88353459e2

* commit '88353459e28059d440d76d1e78fb6a2bce157fb3':
  AudioTrack: docs for getUnderrunCount()
This commit is contained in:
Phil Burk
2016-03-01 20:31:18 +00:00
committed by android-build-merger

View File

@@ -1214,13 +1214,12 @@ public class AudioTrack implements AudioRouting
* An underrun occurs if the application does not write audio * An underrun occurs if the application does not write audio
* data quickly enough, causing the buffer to underflow * data quickly enough, causing the buffer to underflow
* and a potential audio glitch or pop. * and a potential audio glitch or pop.
* <p>
* Underruns are less likely when buffer sizes are large. * Underruns are less likely when buffer sizes are large.
* <p> Though the "int" type is signed 32-bits, the value should be reinterpreted * It may be possible to eliminate underruns by recreating the AudioTrack with
* as if it is unsigned 32-bits. * a larger buffer.
* That is, the next position after 0x7FFFFFFF is (int) 0x80000000. * Or by using {@link #setBufferSizeInFrames(int)} to dynamically increase the
* This is a continuously advancing counter. It can wrap around to zero * effective size of the buffer.
* if there are too many underruns. If there were, for example, 68 underruns per
* second then the counter would wrap in 2 years.
*/ */
public int getUnderrunCount() { public int getUnderrunCount() {
return native_get_underrun_count(); return native_get_underrun_count();