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 ArrayList<>();
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 
dispatchDeviceAdded(MediaDevice mediaDevice)77     protected void dispatchDeviceAdded(MediaDevice mediaDevice) {
78         for (MediaDeviceCallback callback : getCallbacks()) {
79             callback.onDeviceAdded(mediaDevice);
80         }
81     }
82 
dispatchDeviceRemoved(MediaDevice mediaDevice)83     protected void dispatchDeviceRemoved(MediaDevice mediaDevice) {
84         for (MediaDeviceCallback callback : getCallbacks()) {
85             callback.onDeviceRemoved(mediaDevice);
86         }
87     }
88 
dispatchDeviceListAdded()89     protected void dispatchDeviceListAdded() {
90         for (MediaDeviceCallback callback : getCallbacks()) {
91             callback.onDeviceListAdded(new ArrayList<>(mMediaDevices));
92         }
93     }
94 
dispatchDeviceListRemoved(List<MediaDevice> devices)95     protected void dispatchDeviceListRemoved(List<MediaDevice> devices) {
96         for (MediaDeviceCallback callback : getCallbacks()) {
97             callback.onDeviceListRemoved(devices);
98         }
99     }
100 
dispatchConnectedDeviceChanged(String id)101     protected void dispatchConnectedDeviceChanged(String id) {
102         for (MediaDeviceCallback callback : getCallbacks()) {
103             callback.onConnectedDeviceChanged(id);
104         }
105     }
106 
dispatchDataChanged()107     protected void dispatchDataChanged() {
108         for (MediaDeviceCallback callback : getCallbacks()) {
109             callback.onDeviceAttributesChanged();
110         }
111     }
112 
dispatchOnRequestFailed(int reason)113     protected void dispatchOnRequestFailed(int reason) {
114         for (MediaDeviceCallback callback : getCallbacks()) {
115             callback.onRequestFailed(reason);
116         }
117     }
118 
getCallbacks()119     private Collection<MediaDeviceCallback> getCallbacks() {
120         return new CopyOnWriteArrayList<>(mCallbacks);
121     }
122 
123     /**
124      * Callback for notifying device is added, removed and attributes changed.
125      */
126     public interface MediaDeviceCallback {
127         /**
128          * Callback for notifying MediaDevice is added.
129          *
130          * @param device the MediaDevice
131          */
onDeviceAdded(MediaDevice device)132         void onDeviceAdded(MediaDevice device);
133 
134         /**
135          * Callback for notifying MediaDevice list is added.
136          *
137          * @param devices the MediaDevice list
138          */
onDeviceListAdded(List<MediaDevice> devices)139         void onDeviceListAdded(List<MediaDevice> devices);
140 
141         /**
142          * Callback for notifying MediaDevice is removed.
143          *
144          * @param device the MediaDevice
145          */
onDeviceRemoved(MediaDevice device)146         void onDeviceRemoved(MediaDevice device);
147 
148         /**
149          * Callback for notifying MediaDevice list is removed.
150          *
151          * @param devices the MediaDevice list
152          */
onDeviceListRemoved(List<MediaDevice> devices)153         void onDeviceListRemoved(List<MediaDevice> devices);
154 
155         /**
156          * Callback for notifying connected MediaDevice is changed.
157          *
158          * @param id the id of MediaDevice
159          */
onConnectedDeviceChanged(String id)160         void onConnectedDeviceChanged(String id);
161 
162         /**
163          * Callback for notifying that MediaDevice attributes
164          * (e.g: device name, connection state, subtitle) is changed.
165          */
onDeviceAttributesChanged()166         void onDeviceAttributesChanged();
167 
168         /**
169          * Callback for notifying that transferring is failed.
170          *
171          * @param reason the reason that the request has failed. Can be one of followings:
172          * {@link android.media.MediaRoute2ProviderService#REASON_UNKNOWN_ERROR},
173          * {@link android.media.MediaRoute2ProviderService#REASON_REJECTED},
174          * {@link android.media.MediaRoute2ProviderService#REASON_NETWORK_ERROR},
175          * {@link android.media.MediaRoute2ProviderService#REASON_ROUTE_NOT_AVAILABLE},
176          * {@link android.media.MediaRoute2ProviderService#REASON_INVALID_COMMAND},
177          */
onRequestFailed(int reason)178         void onRequestFailed(int reason);
179     }
180 }
181