1 /*
2  * Copyright 2018 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 package com.android.settingslib.media;
17 
18 import android.app.Notification;
19 import android.content.Context;
20 import android.util.Log;
21 
22 import java.util.ArrayList;
23 import java.util.Collection;
24 import java.util.List;
25 import java.util.concurrent.CopyOnWriteArrayList;
26 
27 /**
28  * MediaManager provide interface to get MediaDevice list.
29  */
30 public abstract class MediaManager {
31 
32     private static final String TAG = "MediaManager";
33 
34     protected final Collection<MediaDeviceCallback> mCallbacks = new CopyOnWriteArrayList<>();
35     protected final List<MediaDevice> mMediaDevices = new CopyOnWriteArrayList<>();
36 
37     protected Context mContext;
38     protected Notification mNotification;
39 
MediaManager(Context context, Notification notification)40     MediaManager(Context context, Notification notification) {
41         mContext = context;
42         mNotification = notification;
43     }
44 
registerCallback(MediaDeviceCallback callback)45     protected void registerCallback(MediaDeviceCallback callback) {
46         if (!mCallbacks.contains(callback)) {
47             mCallbacks.add(callback);
48         }
49     }
50 
unregisterCallback(MediaDeviceCallback callback)51     protected void unregisterCallback(MediaDeviceCallback callback) {
52         if (mCallbacks.contains(callback)) {
53             mCallbacks.remove(callback);
54         }
55     }
56 
57     /**
58      * Start scan connected MediaDevice
59      */
startScan()60     public abstract void startScan();
61 
62     /**
63      * Stop scan MediaDevice
64      */
stopScan()65     public abstract void stopScan();
66 
findMediaDevice(String id)67     protected MediaDevice findMediaDevice(String id) {
68         for (MediaDevice mediaDevice : mMediaDevices) {
69             if (mediaDevice.getId().equals(id)) {
70                 return mediaDevice;
71             }
72         }
73         Log.e(TAG, "findMediaDevice() can't found device");
74         return null;
75     }
76 
dispatchDeviceListAdded()77     protected void dispatchDeviceListAdded() {
78         for (MediaDeviceCallback callback : getCallbacks()) {
79             callback.onDeviceListAdded(new ArrayList<>(mMediaDevices));
80         }
81     }
82 
dispatchDeviceListRemoved(List<MediaDevice> devices)83     protected void dispatchDeviceListRemoved(List<MediaDevice> devices) {
84         for (MediaDeviceCallback callback : getCallbacks()) {
85             callback.onDeviceListRemoved(devices);
86         }
87     }
88 
dispatchConnectedDeviceChanged(String id)89     protected void dispatchConnectedDeviceChanged(String id) {
90         for (MediaDeviceCallback callback : getCallbacks()) {
91             callback.onConnectedDeviceChanged(id);
92         }
93     }
94 
dispatchOnRequestFailed(int reason)95     protected void dispatchOnRequestFailed(int reason) {
96         for (MediaDeviceCallback callback : getCallbacks()) {
97             callback.onRequestFailed(reason);
98         }
99     }
100 
getCallbacks()101     private Collection<MediaDeviceCallback> getCallbacks() {
102         return new CopyOnWriteArrayList<>(mCallbacks);
103     }
104 
105     /**
106      * Callback for notifying device is added, removed and attributes changed.
107      */
108     public interface MediaDeviceCallback {
109 
110         /**
111          * Callback for notifying MediaDevice list is added.
112          *
113          * @param devices the MediaDevice list
114          */
onDeviceListAdded(List<MediaDevice> devices)115         void onDeviceListAdded(List<MediaDevice> devices);
116 
117         /**
118          * Callback for notifying MediaDevice list is removed.
119          *
120          * @param devices the MediaDevice list
121          */
onDeviceListRemoved(List<MediaDevice> devices)122         void onDeviceListRemoved(List<MediaDevice> devices);
123 
124         /**
125          * Callback for notifying connected MediaDevice is changed.
126          *
127          * @param id the id of MediaDevice
128          */
onConnectedDeviceChanged(String id)129         void onConnectedDeviceChanged(String id);
130 
131         /**
132          * Callback for notifying that transferring is failed.
133          *
134          * @param reason the reason that the request has failed. Can be one of followings:
135          * {@link android.media.MediaRoute2ProviderService#REASON_UNKNOWN_ERROR},
136          * {@link android.media.MediaRoute2ProviderService#REASON_REJECTED},
137          * {@link android.media.MediaRoute2ProviderService#REASON_NETWORK_ERROR},
138          * {@link android.media.MediaRoute2ProviderService#REASON_ROUTE_NOT_AVAILABLE},
139          * {@link android.media.MediaRoute2ProviderService#REASON_INVALID_COMMAND},
140          */
onRequestFailed(int reason)141         void onRequestFailed(int reason);
142     }
143 }
144