Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document more about volume provider ID.

Browse Source 
Document more about what getVolumeControlId returns.

This CL is to address API Review issue.

Bug: 148403124
Test: N/A
Change-Id: I382cbe3efe2fd5732f50493bc6d243ae54c5a257
This commit is contained in:
Kyunglyul Hyun
2020-02-18 17:25:59 +09:00
parent 3c51ff6bd8
commit d5daf35181
2 changed files with 11 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
media/java/android/media/VolumeProvider.java
View File

@@ -89,7 +89,7 @@ public abstract class VolumeProvider {
* this provider.
* @param maxVolume The maximum allowed volume.
* @param currentVolume The current volume on the output.
* @param volumeControlId The volume control id of this provider.
* @param volumeControlId The volume control ID of this provider.
*/
public VolumeProvider(@ControlType int volumeControl, int maxVolume, int currentVolume,
@Nullable String volumeControlId) {
@@ -142,10 +142,10 @@ public abstract class VolumeProvider {
}
/**
* Gets the volume control id. It can be used to identify which volume provider is
* Gets the volume control ID. It can be used to identify which volume provider is
* used by the session.
*
* @return the volume control id or {@code null} if it isn't set.
* @return the volume control ID or {@code null} if it isn't set.
*/
@Nullable
public final String getVolumeControlId() {

9
media/java/android/media/session/MediaController.java
View File

@@ -1056,8 +1056,15 @@ public final class MediaController {
/**
* Gets the volume control ID for this session. It can be used to identify which
* volume provider is used by the session.
* <p>
* When the session starts to use {@link #PLAYBACK_TYPE_REMOTE remote volume handling},
* a volume provider should be set and it may set the volume control ID of the provider
* if the session wants to inform which volume provider is used.
* It can be {@code null} if the session didn't set the volume control ID or it uses
* {@link #PLAYBACK_TYPE_LOCAL local playback}.
* </p>
*
* @return the volume control ID for this session or {@code null} if it's local playback
* @return the volume control ID for this session or {@code null} if it uses local playback
* or not set.
* @see VolumeProvider#getVolumeControlId()
*/