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.NonNull;
20 import android.annotation.SystemApi;
21 import android.car.CarOccupantZoneManager;
22 
23 /**
24  * Interface to listen for audio media requests in primary zone
25  *
26  * @hide
27  */
28 @SystemApi
29 public interface PrimaryZoneMediaAudioRequestCallback {
30 
31     /**
32      * Called on request for media for occupant in primary zone
33      *
34      * @param info Occupant zone information that should be shared in car primary zone
35      * @param requestId Unique id of the request that can be used to enable the audio sharing
36      */
onRequestMediaOnPrimaryZone(@onNull CarOccupantZoneManager.OccupantZoneInfo info, long requestId)37     void onRequestMediaOnPrimaryZone(@NonNull CarOccupantZoneManager.OccupantZoneInfo info,
38             long requestId);
39 
40     /**
41      * Called on media request status changes
42      *
43      * @param info Occupant zone of the original request source
44      * @param requestId Request id whose status has changed
45      * @param status New status of the request, can be any of:
46      *                {@link android.car.media.CarAudioManager#AUDIO_REQUEST_STATUS_APPROVED},
47      *                {@link android.car.media.CarAudioManager#AUDIO_REQUEST_STATUS_REJECTED},
48      *                {@link android.car.media.CarAudioManager#AUDIO_REQUEST_STATUS_CANCELLED},
49      *                {@link android.car.media.CarAudioManager#AUDIO_REQUEST_STATUS_STOPPED}
50      */
onMediaAudioRequestStatusChanged(@onNull CarOccupantZoneManager.OccupantZoneInfo info, long requestId, @CarAudioManager.MediaAudioRequestStatus int status)51     void onMediaAudioRequestStatusChanged(@NonNull CarOccupantZoneManager.OccupantZoneInfo info,
52             long requestId, @CarAudioManager.MediaAudioRequestStatus int status);
53 }
54