1 /* 2 * Copyright (C) 2021 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.car.audio; 18 19 import static android.car.builtin.media.AudioManagerHelper.usageToXsdString; 20 import static android.media.audio.common.AudioContentType.UNKNOWN; 21 22 import static com.android.car.internal.ExcludeFromCodeCoverageGeneratedReport.DUMP_INFO; 23 24 import android.annotation.NonNull; 25 import android.hardware.audio.common.PlaybackTrackMetadata; 26 27 import com.android.car.internal.ExcludeFromCodeCoverageGeneratedReport; 28 import com.android.car.internal.util.IndentingPrintWriter; 29 30 import java.util.Arrays; 31 import java.util.List; 32 import java.util.Objects; 33 34 /** 35 * Ducking information for a given car audio zone based on its focus state. 36 */ 37 public final class CarDuckingInfo { 38 public final int mZoneId; 39 public final List<String> mAddressesToDuck; 40 public final List<String> mAddressesToUnduck; 41 public final List<PlaybackTrackMetadata> mPlaybackMetaDataHoldingFocus; 42 CarDuckingInfo( int zoneId, @NonNull List<String> addressesToDuck, @NonNull List<String> addressesToUnduck, @NonNull List<PlaybackTrackMetadata> playbackMetaDataHoldingFocus)43 public CarDuckingInfo( 44 int zoneId, 45 @NonNull List<String> addressesToDuck, 46 @NonNull List<String> addressesToUnduck, 47 @NonNull List<PlaybackTrackMetadata> playbackMetaDataHoldingFocus) { 48 mZoneId = zoneId; 49 mAddressesToDuck = Objects.requireNonNull(addressesToDuck); 50 mAddressesToUnduck = Objects.requireNonNull(addressesToUnduck); 51 mPlaybackMetaDataHoldingFocus = Objects.requireNonNull(playbackMetaDataHoldingFocus); 52 } 53 getZoneId()54 public int getZoneId() { 55 return mZoneId; 56 } 57 getAddressesToDuck()58 public @NonNull List<String> getAddressesToDuck() { 59 return mAddressesToDuck; 60 } 61 getAddressesToUnduck()62 public @NonNull List<String> getAddressesToUnduck() { 63 return mAddressesToUnduck; 64 } 65 getPlaybackMetaDataHoldingFocus()66 public @NonNull List<PlaybackTrackMetadata> getPlaybackMetaDataHoldingFocus() { 67 return mPlaybackMetaDataHoldingFocus; 68 } 69 70 @ExcludeFromCodeCoverageGeneratedReport(reason = DUMP_INFO) dump(IndentingPrintWriter writer)71 void dump(IndentingPrintWriter writer) { 72 writer.printf("Ducking Info for zone %d \n", mZoneId); 73 writer.increaseIndent(); 74 writer.printf("Addresses to duck: %s\n", 75 String.join(", ", mAddressesToDuck)); 76 writer.printf("Addresses to unduck: %s\n", 77 String.join(", ", mAddressesToUnduck)); 78 writer.println("Audio Attributes holding focus:"); 79 writer.increaseIndent(); 80 for (int index = 0; index < mPlaybackMetaDataHoldingFocus.size(); index++) { 81 PlaybackTrackMetadata playbackTrackMetaData = mPlaybackMetaDataHoldingFocus.get(index); 82 writer.printf( 83 "usage=%s, content type=%s, tags=%s\n", 84 usageToXsdString(playbackTrackMetaData.usage), 85 (playbackTrackMetaData.contentType != UNKNOWN 86 ? playbackTrackMetaData.contentType 87 : ""), 88 (playbackTrackMetaData.tags.length != 0 89 ? Arrays.toString(playbackTrackMetaData.tags) 90 : "")); 91 } 92 writer.decreaseIndent(); 93 writer.println(); 94 writer.decreaseIndent(); 95 } 96 } 97