Improve JavaDoc for StreamPlayerListener.progress

[HelgeStenstrom]

java-stream-player/src/main/java/com/goxr3plus/streamplayer/stream/StreamPlayerListener.java

Lines 43 to 49 in 4991e4a

	* Is called several times per second when StreamPlayer run method is
	* running.
	*
	* @param nEncodedBytes the n encoded bytes
	* @param microsecondPosition the microsecond position
	* @param pcmData the pcm data
	* @param properties the properties

Try to answer at least these questions:

• When and how often is progress() called? Who is the caller?
• Clarify nEncodedBytes the n encoded bytes. Does it mean "the number of encoded bytes"? If so, since when? Where are these bytes and where do they come from?
• microsecondPosition the microsecond position: When does the timer start? How often is the value updated? For each call of progress()?
• Is there any guarantee for how it is encoded? If so, how is the pcmData encoded? Apparently it's an array of bytes. How does it encode two or more channels of 16 or more bits per sample?
• What are the properties?

[goxr3plus]

*THe encoded bytes are the bytes that have been encoded since the start of audio it's actually how many bytes have totally been read from the file.

[goxr3plus]

Properties have been there for some reason i think they are used for audio filtering and getting information about the current audio file.

For the others questions i have read the code :)

[goxr3plus]

I am not quite sure about the microsecond position, it's actually what it says i think.

[goxr3plus]

I am not quite sure about the microsecond position, it's actually what it says i think.