1 /*
2  * Copyright (C) 2023 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 android.car.media;
18 
19 import android.annotation.FlaggedApi;
20 import android.annotation.NonNull;
21 import android.annotation.SystemApi;
22 import android.car.feature.Flags;
23 
24 import java.util.List;
25 
26 /**
27  * Callback for car audio zone configuration changes status
28  *
29  * @hide
30  */
31 @SystemApi
32 @FlaggedApi(Flags.FLAG_CAR_AUDIO_DYNAMIC_DEVICES)
33 public interface AudioZoneConfigurationsChangeCallback {
34 
35     /**
36      * Called on audio configuration updates
37      *
38      * <p>Can be used to determine when dynamic audio configurations
39      * (i.e. config has dynamic devices) have become active, inactive, due to dynamic devices
40      * changing connected status.
41      *
42      * <p>Configuration changes relating to selections via the
43      * {@link CarAudioManager#switchAudioZoneToConfig} API will not be reported via this callback.
44      * Instead, {@link ISwitchAudioZoneConfigCallback} will be used.
45      *
46      * @param configs List of configuration whose status has changed
47      * @param status Status that has changed, can be any of
48      *   {@link CarAudioManager#CONFIG_STATUS_CHANGED}
49      *   or {@link CarAudioManager#CONFIG_STATUS_AUTO_SWITCHED}
50      */
onAudioZoneConfigurationsChanged(@onNull List<CarAudioZoneConfigInfo> configs, @CarAudioManager.AudioConfigStatus int status)51     default void onAudioZoneConfigurationsChanged(@NonNull List<CarAudioZoneConfigInfo> configs,
52             @CarAudioManager.AudioConfigStatus int status)  {
53     }
54 }
55