1 /*
2  * Copyright (C) 2015 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 androidx.appcompat.mms;
18 
19 import android.app.PendingIntent;
20 import android.content.Context;
21 import android.net.Uri;
22 import android.os.Bundle;
23 import android.telephony.SmsManager;
24 import android.util.SparseArray;
25 
26 /**
27  * The public interface of MMS library
28  */
29 public class MmsManager {
30     /**
31      * Default subscription ID
32      */
33     public static final int DEFAULT_SUB_ID = -1;
34 
35     // Whether to force legacy MMS sending
36     private static volatile boolean sForceLegacyMms = false;
37 
38     // Cached computed overrides for carrier configuration values
39     private static SparseArray<Bundle> sConfigOverridesMap = new SparseArray<>();
40 
41     /**
42      * Set the flag about whether to force to use legacy system APIs instead of system MMS API
43      *
44      * @param forceLegacyMms value to set
45      */
setForceLegacyMms(boolean forceLegacyMms)46     public static void setForceLegacyMms(boolean forceLegacyMms) {
47         sForceLegacyMms = forceLegacyMms;
48     }
49 
50     /**
51      * Set the size of thread pool for request execution.
52      *
53      * Default is 4
54      *
55      * Note: if system MMS API is used, this has no effect
56      *
57      * @param size thread pool size
58      */
setThreadPoolSize(int size)59     public static void setThreadPoolSize(int size) {
60         MmsService.setThreadPoolSize(size);
61     }
62 
63     /**
64      * Set whether to use wake lock while sending or downloading MMS.
65      *
66      * Default value is true
67      *
68      * Note: if system MMS API is used, this has no effect
69      *
70      * @param useWakeLock true to use wake lock, false otherwise
71      */
setUseWakeLock(final boolean useWakeLock)72     public static void setUseWakeLock(final boolean useWakeLock) {
73         MmsService.setUseWakeLock(useWakeLock);
74     }
75 
76     /**
77      * Set the optional carrier config values loader
78      *
79      * Note: if system MMS API is used, this is used to compute the overrides
80      * of carrier configuration values
81      *
82      * @param loader the carrier config values loader
83      */
setCarrierConfigValuesLoader(CarrierConfigValuesLoader loader)84     public static void setCarrierConfigValuesLoader(CarrierConfigValuesLoader loader) {
85         if (loader == null) {
86             throw new IllegalArgumentException("Carrier configuration loader can not be empty");
87         }
88         synchronized (sConfigOverridesMap) {
89             MmsService.setCarrierConfigValuesLoader(loader);
90             sConfigOverridesMap.clear();
91         }
92     }
93 
94     /**
95      * Set the optional APN settings loader
96      *
97      * Note: if system MMS API is used, this has no effect
98      *
99      * @param loader the APN settings loader
100      */
setApnSettingsLoader(ApnSettingsLoader loader)101     public static void setApnSettingsLoader(ApnSettingsLoader loader) {
102         if (loader == null) {
103             throw new IllegalArgumentException("APN settings loader can not be empty");
104         }
105         MmsService.setApnSettingsLoader(loader);
106     }
107 
108     /**
109      * Set user agent info loader
110      *
111      * Note: if system MMS API is used, this is used to compute the overrides
112      * of carrier configuration values
113 
114      * @param loader the user agent info loader
115      */
setUserAgentInfoLoader(final UserAgentInfoLoader loader)116     public static void setUserAgentInfoLoader(final UserAgentInfoLoader loader) {
117         if (loader == null) {
118             throw new IllegalArgumentException("User agent info loader can not be empty");
119         }
120         synchronized (sConfigOverridesMap) {
121             MmsService.setUserAgentInfoLoader(loader);
122             sConfigOverridesMap.clear();
123         }
124     }
125 
126     /**
127      * Send MMS via platform MMS API (if platform supports and not forced to
128      * use legacy APIs) or legacy APIs
129      *
130      * @param subId the subscription ID of the SIM to use
131      * @param context the Context to use
132      * @param contentUri the content URI of the PDU to be sent
133      * @param locationUrl the optional location URL to use for sending
134      * @param sentIntent the pending intent for returning results
135      */
sendMultimediaMessage(int subId, Context context, Uri contentUri, String locationUrl, PendingIntent sentIntent)136     public static void sendMultimediaMessage(int subId, Context context, Uri contentUri,
137             String locationUrl, PendingIntent sentIntent) {
138         if (Utils.hasMmsApi() && !sForceLegacyMms) {
139             subId = Utils.getEffectiveSubscriptionId(subId);
140             final SmsManager smsManager = Utils.getSmsManager(subId);
141             smsManager.sendMultimediaMessage(context, contentUri, locationUrl,
142                     getConfigOverrides(subId), sentIntent);
143         } else {
144             MmsService.startRequest(context, new SendRequest(locationUrl, contentUri, sentIntent));
145         }
146     }
147 
148     /**
149      * Download MMS via platform MMS API (if platform supports and not forced to
150      * use legacy APIs) or legacy APIs
151      *
152      * @param subId the subscription ID of the SIM to use
153      * @param context the Context to use
154      * @param contentUri the content URI of the PDU to be sent
155      * @param locationUrl the optional location URL to use for sending
156      * @param downloadedIntent the pending intent for returning results
157      */
downloadMultimediaMessage(int subId, Context context, String locationUrl, Uri contentUri, PendingIntent downloadedIntent)158     public static void downloadMultimediaMessage(int subId, Context context, String locationUrl,
159             Uri contentUri, PendingIntent downloadedIntent) {
160         if (Utils.hasMmsApi() && !sForceLegacyMms) {
161             subId = Utils.getEffectiveSubscriptionId(subId);
162             final SmsManager smsManager = Utils.getSmsManager(subId);
163             smsManager.downloadMultimediaMessage(context, locationUrl, contentUri,
164                     getConfigOverrides(subId), downloadedIntent);
165         } else {
166             MmsService.startRequest(context,
167                     new DownloadRequest(locationUrl, contentUri, downloadedIntent));
168         }
169     }
170 
171     /**
172      * Get carrier configuration values overrides when platform MMS API is called.
173      * We only need to compute this if customized carrier config values loader or
174      * user agent info loader are set
175      *
176      * @param subId the ID of the SIM to use
177      * @return a Bundle containing the overrides
178      */
getConfigOverrides(final int subId)179     private static Bundle getConfigOverrides(final int subId) {
180         if (!Utils.hasMmsApi()) {
181             // If MMS API is not present, it is not necessary to compute overrides
182             return null;
183         }
184         Bundle overrides = null;
185         synchronized (sConfigOverridesMap) {
186             overrides = sConfigOverridesMap.get(subId);
187             if (overrides == null) {
188                 overrides = new Bundle();
189                 sConfigOverridesMap.put(subId, overrides);
190                 computeOverridesLocked(subId, overrides);
191             }
192         }
193         return overrides;
194     }
195 
196     /**
197      * Compute the overrides, incorporating the user agent info
198      *
199      * @param subId the subId of the SIM to use
200      * @param overrides the computed values overrides
201      */
computeOverridesLocked(final int subId, final Bundle overrides)202     private static void computeOverridesLocked(final int subId, final Bundle overrides) {
203         // Overrides not computed yet
204         final CarrierConfigValuesLoader carrierConfigValuesLoader =
205                 MmsService.getCarrierConfigValuesLoader();
206         if (carrierConfigValuesLoader != null &&
207                 !(carrierConfigValuesLoader instanceof DefaultCarrierConfigValuesLoader)) {
208             // Compute the overrides for carrier config values first if the config loader
209             // is not the default one.
210             final Bundle systemValues = Utils.getSmsManager(subId).getCarrierConfigValues();
211             final Bundle callerValues =
212                     MmsService.getCarrierConfigValuesLoader().get(subId);
213             if (systemValues != null && callerValues != null) {
214                 computeConfigDelta(systemValues, callerValues, overrides);
215             } else if (systemValues == null && callerValues != null) {
216                 overrides.putAll(callerValues);
217             }
218         }
219         final UserAgentInfoLoader userAgentInfoLoader = MmsService.getUserAgentInfoLoader();
220         if (userAgentInfoLoader != null &&
221                 !(userAgentInfoLoader instanceof DefaultUserAgentInfoLoader)) {
222             // Also set the user agent and ua prof url via the overrides
223             // if the user agent loader is not the default one.
224             overrides.putString(UserAgentInfoLoader.CONFIG_USER_AGENT,
225                     userAgentInfoLoader.getUserAgent());
226             overrides.putString(UserAgentInfoLoader.CONFIG_UA_PROF_URL,
227                     userAgentInfoLoader.getUAProfUrl());
228         }
229     }
230 
231     /**
232      * Compute the delta between two sets of carrier configuration values: system and caller
233      *
234      * @param systemValues the system config values
235      * @param callerValues the caller's config values
236      * @param delta the delta of values (caller - system), using caller value to override system's
237      */
computeConfigDelta(final Bundle systemValues, final Bundle callerValues, final Bundle delta)238     private static void computeConfigDelta(final Bundle systemValues, final Bundle callerValues,
239             final Bundle delta) {
240         for (final String key : callerValues.keySet()) {
241             final Object callerValue = callerValues.get(key);
242             final Object systemValue = systemValues.get(key);
243             if ((callerValue != null && systemValue != null && !callerValue.equals(systemValue)) ||
244                     (callerValue != null && systemValue == null) ||
245                     (callerValue == null && systemValue != null)) {
246                 if (callerValue == null || callerValue instanceof String) {
247                     delta.putString(key, (String) callerValue);
248                 } else if (callerValue instanceof Integer) {
249                     delta.putInt(key, (Integer) callerValue);
250                 } else if (callerValue instanceof Boolean) {
251                     delta.putBoolean(key, (Boolean) callerValue);
252                 }
253             }
254         }
255     }
256 }
257