Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 6656144d authored by jiabin's avatar jiabin Committed by Jiabin Huang
Browse files

Add comment for AAudioStreamBuilder_setChannelCount. 

Clarify how the higher channels behave when the requested channel
count is greater than the supported channel count.

Bug: 253689725
Test: make
Change-Id: If4d1afd94032943feabd7d096db93be21ac93f2f
parent 8b930c0b

media/libaaudio/include/aaudio/AAudio.h

+6 −0
Original line number Diff line number Diff line
@@ -887,6 +887,12 @@ AAUDIO_API void AAudioStreamBuilder_setSampleRate(AAudioStreamBuilder* builder, 
 * will be respected if both this function and {@link AAudioStreamBuilder_setChannelMask} are

 * called.

 *

 * Note that if the channel count is two then it may get mixed to mono when the device only supports

 * one channel. If the channel count is greater than two but the device's supported channel count is

 * less than the requested value, the channels higher than the device channel will be dropped. If

 * higher channels should be mixed or spatialized, use {@link AAudioStreamBuilder_setChannelMask}

 * instead.

 *

 * Available since API level 26.

 *

 * @param builder reference provided by AAudio_createStreamBuilder()