blob: 6e47741b488b1b9c5b115a8a448cbdc2ddcb45e2 [file] [log] [blame]
Amit Mahajan24c01a22019-09-20 11:13:05 -07001/*
2 * Copyright (C) 2019 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
17package android.telephony;
18
Sarah Chin4affb512020-01-10 16:09:11 -080019import android.annotation.NonNull;
20import android.annotation.Nullable;
21import android.annotation.SystemService;
Amit Mahajan24c01a22019-09-20 11:13:05 -070022import android.app.ActivityThread;
23import android.app.PendingIntent;
Sarah Chin4affb512020-01-10 16:09:11 -080024import android.content.Context;
Amit Mahajan24c01a22019-09-20 11:13:05 -070025import android.net.Uri;
26import android.os.Bundle;
27import android.os.RemoteException;
28import android.os.ServiceManager;
29
30import com.android.internal.telephony.IMms;
31
32/**
33 * Manages MMS operations such as sending multimedia messages.
Sarah Chin4affb512020-01-10 16:09:11 -080034 * Get this object by calling Context#getSystemService(Context#MMS_SERVICE).
Sarah Chin8ac7ce52020-03-18 13:57:18 -070035 * @hide
Amit Mahajan24c01a22019-09-20 11:13:05 -070036 */
Sarah Chin4affb512020-01-10 16:09:11 -080037@SystemService(Context.MMS_SERVICE)
Sarah Chinee13f122020-01-10 19:23:33 +000038public class MmsManager {
Amit Mahajan24c01a22019-09-20 11:13:05 -070039 private static final String TAG = "MmsManager";
Sarah Chin4affb512020-01-10 16:09:11 -080040 private final Context mContext;
Amit Mahajan24c01a22019-09-20 11:13:05 -070041
42 /**
Sarah Chin4affb512020-01-10 16:09:11 -080043 * @hide
Amit Mahajan24c01a22019-09-20 11:13:05 -070044 */
Sarah Chin4affb512020-01-10 16:09:11 -080045 public MmsManager(@NonNull Context context) {
46 mContext = context;
Amit Mahajan24c01a22019-09-20 11:13:05 -070047 }
48
49 /**
50 * Send an MMS message
51 *
52 * @param subId the subscription id
53 * @param contentUri the content Uri from which the message pdu will be read
54 * @param locationUrl the optional location url where message should be sent to
55 * @param configOverrides the carrier-specific messaging configuration values to override for
56 * sending the message.
57 * @param sentIntent if not NULL this <code>PendingIntent</code> is broadcast when the message
58 * is successfully sent, or failed
Tom Taylor03079ec2020-01-24 10:21:50 -080059 * @param messageId an id that uniquely identifies the message requested to be sent.
60 * Used for logging and diagnostics purposes. The id may be 0.
Amit Mahajan24c01a22019-09-20 11:13:05 -070061 */
Sarah Chin4affb512020-01-10 16:09:11 -080062 public void sendMultimediaMessage(int subId, @NonNull Uri contentUri,
63 @Nullable String locationUrl, @Nullable Bundle configOverrides,
Tom Taylor03079ec2020-01-24 10:21:50 -080064 @Nullable PendingIntent sentIntent, long messageId) {
Amit Mahajan24c01a22019-09-20 11:13:05 -070065 try {
66 final IMms iMms = IMms.Stub.asInterface(ServiceManager.getService("imms"));
67 if (iMms == null) {
68 return;
69 }
70
71 iMms.sendMessage(subId, ActivityThread.currentPackageName(), contentUri,
Tom Taylor03079ec2020-01-24 10:21:50 -080072 locationUrl, configOverrides, sentIntent, messageId);
Amit Mahajan24c01a22019-09-20 11:13:05 -070073 } catch (RemoteException e) {
74 // Ignore it
75 }
76 }
77
78 /**
79 * Download an MMS message from carrier by a given location URL
80 *
81 * @param subId the subscription id
82 * @param locationUrl the location URL of the MMS message to be downloaded, usually obtained
83 * from the MMS WAP push notification
84 * @param contentUri the content uri to which the downloaded pdu will be written
85 * @param configOverrides the carrier-specific messaging configuration values to override for
86 * downloading the message.
87 * @param downloadedIntent if not NULL this <code>PendingIntent</code> is
88 * broadcast when the message is downloaded, or the download is failed
Tom Taylor03079ec2020-01-24 10:21:50 -080089 * @param messageId an id that uniquely identifies the message requested to be downloaded.
90 * Used for logging and diagnostics purposes. The id may be 0.
91 * downloaded.
Amit Mahajan24c01a22019-09-20 11:13:05 -070092 * @throws IllegalArgumentException if locationUrl or contentUri is empty
93 */
Sarah Chin4affb512020-01-10 16:09:11 -080094 public void downloadMultimediaMessage(int subId, @NonNull String locationUrl,
95 @NonNull Uri contentUri, @Nullable Bundle configOverrides,
Tom Taylor03079ec2020-01-24 10:21:50 -080096 @Nullable PendingIntent downloadedIntent, long messageId) {
Amit Mahajan24c01a22019-09-20 11:13:05 -070097 try {
98 final IMms iMms = IMms.Stub.asInterface(ServiceManager.getService("imms"));
99 if (iMms == null) {
100 return;
101 }
102 iMms.downloadMessage(subId, ActivityThread.currentPackageName(),
Tom Taylor03079ec2020-01-24 10:21:50 -0800103 locationUrl, contentUri, configOverrides, downloadedIntent,
104 messageId);
Amit Mahajan24c01a22019-09-20 11:13:05 -0700105 } catch (RemoteException e) {
106 // Ignore it
107 }
108 }
Amit Mahajan24c01a22019-09-20 11:13:05 -0700109}